App Maker CLI

CLI streamlines the process of setting up applications in a local development environment and facilitates the seamless deployment of post-development modifications on the platform. With just a few straightforward steps, users can easily configure new projects or work on existing ones.

Installation

Below is the command to install the CLI:

$ curl -s https://abp.akinon.net/api/public/cli.sh | bash

Publishing Project

All processes, except for the Env. version, remain the same. Instead of specifying the Env. version, you will now need to input tags into the form for the Akinon repository.

NOTE

To ensure accurate deployment, it's crucial to tag both the environment version and the project package thoroughly. For example, consider this format: v2.3.2 represents the environment version, while -build.1 signifies the steadily build number for the project package. This approach aligns well with semantic versioning principles.

The tagging process is carried out as follows:

Desired changes that need to be sent are added to the git stage either individually or in bulk. Below, an explanation of the bulk submission method is provided.

git add.
git commit -m "new feature"

A tag is assigned for deployment:

git tag <tag>

NOTE

There is no predefined structure for the tag format. You have the flexibility to define it according to your own development practices.

Finally, the tagged changes are pushed to the repository:

git push akinon main --tags

Command List

The following are the primary commands of the tool that act as a wizard during development processes:

Command	Action
`login`	Log in to the App Maker platform.
`logout`	Log out from the App Maker platform.
`project --help`	Access project-specific commands.
`project create`	Create a new project using the default template.
`project install`	Perform a native installation for an existing project.
`project upgrade`	Upgrade the current environment version of the project to a new one.
`project info`	Display the meta information of the project.
`project run <platform>`	Run the application on a specific platform.
`project diff <platform>`	View changes in the native environment.
`project reset <platform>`	Undo changes made in the native environment of the project.
`plugin --help`	Access plugin-specific commands.
`plugin add <name>`	Add a plugin to the project. Remember to run `project install` afterward.
`plugin create`	Create boilerplate code to develop a plugin.
`plugin pack`	Package a plugin for publishing on App Maker.
`plugin publish`	Publishes a plugin on App Maker.
`plugin preview`	Preview the potential effects of native configurations.
`plugin run`	Apply changes permanently.
`config pm`	Change the package manager (yarn, npm).
`config show`	Display config details for App Maker.
`git connect`	Connect to your git repository.
`git disconnect`	Disconnect from your git repository.
`git check`	Check your git configs.
`publickey add`	Add a public key to access the repositories.
`publickey list`	Display a list of your public keys.
`publickey remove`	Remove one of your public keys.

`login`

Example

$ appmaker login

`logout`

Safely log out of the CLI.

Example

$ appmaker logout

`project create`

Creates a new project within the current directory, using the default App Maker template.

Example:

$ appmaker project create

NOTE

To deploy this new application, it needs to be published on the platform.

Options

Name	Type	Description
`--platform`	array	This specifies the target platform(s) to be built. (`ios`, `android`, `huawei`)

NOTE

If no platform is specified, the default platform will be set to ios and android.

Example:

$ appmaker project create --platform android ios

$ appmaker project create --platform huawei

`project install`

Performs a native setup on the application's project package, allowing the application to run.

Example

$ cd example-project-package
$ appmaker project install

Options

Name	Type	Description
`--exclude-plugins`	boolean	Excludes previously added plugins from being used within the project.
`--platform`	array	This specifies the target platform(s) to be built. (`ios`, `android`, `huawei`)

NOTE

If no platform is specified, the default platform will be set to ios and android.

Example

$ appmaker project install --exclude-plugins

`project run <platform>`

Runs the application on a desired platform.

Example:

$ cd example-app
$ appmaker project run android

Platforms

Name	Description
ios	Run the project on iOS.
android	Runs the project on Android.
start	Runs the development server.

`project upgrade`

Upgrades the project's current environment version to a newer one.

Example:

$ cd example-app
$ appmaker project upgrade

Options

Name	Type	Description
`--platform`	array	This specifies the target platform(s) to be built. (`ios`, `android`, `huawei`)

NOTE

If no platform is specified, the default platform will be set to ios and android.

Upgrading Project

When the command is run, it performs a version check by referencing the value in the "envVersion" field within the akinon.json file. Regardless of whether the application has been published or not, the command proceeds to complete the process based on the following rules:

If there is no new version available, the command concludes by displaying a message indicating that the application is up-to-date.
If a new version is available;
- If the published version is on the level of minor (v0.*.0) or minor (v0.0.*), the project automatically initiates the upgrading process.
- If the published version is on the level of major (v*.0.0), the process continues in an interactive manner.

`project info`

Displays the meta information of the project.

Example

$ cd example-app
$ appmaker project info

`project diff <platform>`

Displays the differences in the project's native environment, presented in a before/after format.

NOTE

Users have the option to undo these changes using the project reset command.

Example

$ cd example-app
$ appmaker project diff ios

Sample Output

--- a/Info.plist
+++ b/Info.plist
@@ -60,6 +60,6 @@
        <key>UIViewControllerBasedStatusBarAppearance</key>
        <false/>
        <key>UIUserInterfaceStyle</key>
-       <string>Light</string>
+       <string>Dark</string>
 </dict>
 </plist>

NOTE

This feature can only be used on the iOS platform.

`project reset <platform>`

Reverts the changes made in the native environment of the project.

$ cd example-app
$ appmaker project reset ios

NOTE

This feature can only be used on the iOS platform.

`plugin add <name>`

Adds a ready-to-use plugin to the project (akinon.json). Once the plugin information is added, execute the command appmaker project install to automatically install the required JavaScript and native dependencies for the plugin. (It's important to note that the project install command needs to be manually triggered to complete the installation process.)

Example

$ cd example-app
$ appmaker plugin add example-plugin

akinon.json:

{
  ...
  "plugins": {
    "example-plugin": {
      "version": "0.0.1", --> sample version
      "name": "example-plugin",
      "moduleName": "ExamplePlugin",
      "config": {}
    }
  }
  ...
}

NOTE

If no specific version is mentioned in the command, the latest version number of the plugin will be added.

After that, run the command below:

$ appmaker project install

Installing Plugins with a Specific Version

If a user wants to install a specific version of a plugin in their project, they need to follow this method:

$ appmaker plugin add example-plugin@1.2.3

akinon.json

{
  ...
  "plugins": {
    "example-plugin": {
      "version": "1.2.3",
      ...
    }
  }
  ...
}

The user can specify one part of the version (e.g., 1.2) during installation, and the installation process will automatically fetch and install the latest version for the remaining parts.

Example:

Let's assume the user wants to install the following versions of the plugin:

0.5
3.4
3.5
4.0
2.3

If the user wants to install the latest version (1.3.5) from those starting with 1.3.*:

$ appmaker plugin add example-plugin@1.3

akinon.json

{
  ...
  "plugins": {
    "example-plugin": {
      "version": "1.3.5",
      ...
    }
  }
  ...
}

Or, to install the latest version that starts with 1.*.*:

$ appmaker plugin add example-plugin@1

akinon.json

{
  ...
  "plugins": {
    "example-plugin": {
      "version": "1.4.0",
      ...
    }
  }
  ...
}

Afterward, the following command needs to be run.

$ appmaker project install

`plugin create`

Sets up plugin-boilerplate under the .plugins/ directory in order to develop a plugin from scratch.

Example

$ cd example-app
$ appmaker plugin create
$ ? Enter plugin name: my-first-plugin

NOTE

The plugin create command works differently from the project add command. To use a previously created plugin within a project, it needs to be added separately using the project add command.

`plugin pack`

Packs the plugin in a ready-to-publish manner and includes it in the root directory of the related plugin.

Example

$ cd example-app/.plugins/my-first-plugin
$ appmaker plugin pack

To specify a new version before packaging, users can use the options that correspond to practices of semantic version.

SemVer Options

Name	Description
`--major`	Major `(1.3.4 -> 2.0.0)`
`--minor`	Minor `(0.1.1 -> 0.2.0)`
`--patch`	Patch `(0.0.1 -> 0.0.2)`

Example

Assuming the current version is "0.0.1," when you run the following command:

$ appmaker plugin pack --patch

The output for the "example-app/.plugins/my-first-plugin/" directory will be as follows:

- my-first-plugin-0.0.2.tgz (npm)
- my-first-plugin-v0.0.2.tgz (yarn)

NOTE

Each specified option will be applied to the "version" field of the package.json file.

`plugin publish`

Uploads a packaged plugin to App Maker. Before publishing, the plugin needs to be packed using the "appmaker plugin pack" command.

NOTE

Once a plugin is successfully published, the packaged version is deleted from the system.

Example

$ cd example-app/.plugins/my-first-plugin
$ appmaker plugin publish

NOTE

If a README.md file exists in the plugin's root directory, its contents will be automatically submitted to the platform along with the plugin during the publishing process.

Plugin Publication Location

Published plugins are stored in the account of the organization to which you are connected on App Maker. To access all published plugins, users can visit App Maker and click on Organization > Dependency Management.

Plugin Access Permissions

All plugins are only accessible to the organization they are linked with. Other organizations cannot access or use these published plugins.

`plugin preview <platform>`

Allows to preview the potential impacts of native configurations ("ios", "android" and "huawei") made during the development of a plugin without affecting the default version.

Example

$ cd example-app
$ appmaker plugin preview ios
$ appmaker plugin preview android
$ appmaker plugin preview huawei

`plugin run <platform>`

Permanently applies the changes from the output of the preview command to the project. It effectively sets up the plugin within the project, making it ready for the build process.

Example

$ cd example-app
$ appmaker plugin run ios
$ appmaker plugin run android
$ appmaker plugin run huawei

`config show`

Displays the global config information.

Example:

$ appmaker config show

`config pm`

Changes your package manager. It shows list of package managers (yarn, npm)

Example:

$ appmaker publickey list

`plugin publish`

Enables users to upload a packaged plugin to App Maker. Prior to publishing a plugin, it must be packed using the "appmaker plugin pack" command.

NOTE

Once successfully published, the packaged version of the plugin is automatically deleted from the system. A readme file will be automatically included and packaged along with the plugin's own files.

`publickey add`

This command initiates a prompt requesting the user to select an SSH public key that generated before in the ~/.ssh/ directory. It expects a valid SSH Public Key to be provided, and an error will occur if one is not entered.

NOTE

Users can only add up to 5 SSH Public Keys.

Example:

$ appmaker publickey add

`publickey list`

Displays a table listing the SSH Public Keys.

Example:

$ appmaker publickey list

`publickey remove`

Displays a list of the user's SSH keys, and the user can select and delete a key of their choice.

NOTE

If the user does not have any SSH public keys, the program will display an error message.

Example:

$ appmaker publickey remove

`git connect`

This command facilitates the interactive connection of a project to a managed git repository hosted on amazon-codecommit. It assists in configuring necessary settings, including SSH keys, repository details, and more.

Example:

$ appmaker git connect

NOTE

You can also connect multiple public keys to a single project in your local environment.

`git check`

Performs the following checks:

Is CodeCommit's host information added to the SSH Config file?
Is CodeCommit host information added to the SSH known_hosts file?

If run from within the project, it also verifies the following:

Has git init been used for the project?
Have Akinon remote URLs been added?

If everything is in order, it will display:

Everything is OK!

If not, it will display:

Please run the "git connect" command.

Example:

$ appmaker git check

`git disconnect`

This command facilitates the interactive disconnection of a project from a managed git repository. It performs the following actions:

Deletes specific GIT configurations.

If executed from within the project, it also:

Deletes the Akinon repository's remote URL.

As a result, the following message will be displayed:

Project and system disconnected from the managed git repository.

Example:

$ appmaker git disconnect

Installation​

Publishing Project​

NOTE

NOTE

Command List​

login​

logout​

project create​

NOTE

NOTE

project install​

NOTE

project run <platform>​

project upgrade​

NOTE

Upgrading Project​

project info​

project diff <platform>​

NOTE

NOTE

project reset <platform>​

NOTE

plugin add <name>​

NOTE

Installing Plugins with a Specific Version​

plugin create​

NOTE

plugin pack​

NOTE

plugin publish​

NOTE

NOTE

Plugin Publication Location​

Plugin Access Permissions​

plugin preview <platform>​

plugin run <platform>​

config show​

config pm​

plugin publish​

NOTE

publickey add​

NOTE

publickey list​

publickey remove​

NOTE

git connect​

NOTE

git check​

git disconnect​

Installation

Publishing Project

Command List

`login`

`logout`

`project create`

`project install`

`project run <platform>`

`project upgrade`

Upgrading Project

`project info`

`project diff <platform>`

`project reset <platform>`

`plugin add <name>`

Installing Plugins with a Specific Version

`plugin create`

`plugin pack`

`plugin publish`

Plugin Publication Location

Plugin Access Permissions

`plugin preview <platform>`

`plugin run <platform>`

`config show`

`config pm`

`plugin publish`

`publickey add`

`publickey list`

`publickey remove`

`git connect`

`git check`

`git disconnect`