Description

• Add a new native application version to the currently activated Cauldron

Syntax

ern cauldron add nativeapp <descriptor>

Arguments

<descriptor>

• A complete native application descriptor representing the native application version to be added to the Cauldron.

Example

ern cauldron add nativeapp MyNativeApp:ios:17.14.0

Options

--platformVersion/-v

• Use specified platform version

--copyFromVersion/-c <version>

• Copy the data of a native application version stored in the Cauldron.

• Possible values for this option are :

  • A specific version, for example 1.2.3

  • latest if you want to copy the data from the latest version of the native application

  • none if you don't want any copy from action

• The --copyFromVersion/-c <version> option also copies the list of native dependencies and MiniApps as well as the container version to the new native application version.

• If you use the --copyFromVersion/-c <version> option, you do not need to add all MiniApps again after creating a new native application version in the Cauldron.

• This option is commonly used.

--description

• Description of the native application version

--config

• Configuration to set for this new native application version

• If not provided, the configuration of the version copied from will be used (if any).

• There is three different ways to provide the configuration :

  • As a json string

    For example --config '{"configKey": "configValue"}'

  • As a file path

    For example --config /etc/config.json

    In that case, the configuration will be read from the file

  • As a Cauldron file path

    For example --extra cauldron://config/myapp-android.json

    In that case, the configuration will be read from the file stored in Cauldron.

    For this way to work, the file must exist in Cauldron (you can add a file to the cauldron by using the [ern cauldron add file] command).

Remarks

• The ern cauldron add nativeapp <descriptor> command is usually used when the development of a new version of the native application is started.

• The new native application version is identified by the complete native application description in the Cauldron.

Related commands

​ern cauldron update nativeapp | Add a new native application version to the currently activated Cauldron