Skip to main content

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:

CommandAction
loginLog in to the App Maker platform.
logoutLog out from the App Maker platform.
clear-cacheClear the cache memory of the dependency management.
project --helpAccess project-specific commands.
project createCreate a new project using the default template.
project installPerform a native installation for an existing project.
project upgradeUpgrade the current environment version of the project to a new one.
project infoDisplay 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 --helpAccess plugin-specific commands.
plugin add <name>Add a plugin to the project. Remember to run project install afterward.
plugin createCreate boilerplate code to develop a plugin.
plugin packPackage a plugin for publishing on App Maker.
plugin publishPublishes a plugin on App Maker.
plugin previewPreview the potential effects of native configurations.
plugin runApply changes permanently.
config pmChange the package manager (yarn, npm).
config showDisplay config details for App Maker.
git connectConnect to your git repository.
git disconnectDisconnect from your git repository.
git checkCheck your Git configs.
publickey addAdd a public key to access the repositories.
publickey listDisplay a list of your public keys.
publickey removeRemove one of your public keys.

login

Log in to the App Maker platform.

Example

$ app-maker login

logout

Safely log out of the CLI.

Example

$ app-maker logout

clear-cache

Clears the cache memory of the dependency management.

Example:

$ app-maker clear-cache

project create

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

Example:

$ app-maker project create
NOTE

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

Options

NameTypeDescription
--platformarrayThis 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:

$ app-maker project create --platform android ios

OR

$ app-maker 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
$ app-maker project install

Options

NameTypeDescription
--exclude-pluginsbooleanExcludes previously added plugins from being used within the project.
--platformarrayThis 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

$ app-maker project install --exclude-plugins

project run <platform>

Runs the application on a desired platform.

Example:

$ cd example-app
$ app-maker project run android

Platforms

NameDescription
iosRun the project on iOS.
androidRuns the project on Android.
startRuns the development server.

project upgrade

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

Example:

$ cd example-app
$ app-maker project upgrade

Options

NameTypeDescription
--platformarrayThis 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
$ app-maker 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
$ app-maker 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
$ app-maker 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 app-maker 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
$ app-maker 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:

$ app-maker 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:

$ app-maker 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:

2.0.5
1.3.4
1.3.5
1.4.0
0.2.3

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

$ app-maker 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.*.*:

$ app-maker plugin add example-plugin@1

akinon.json

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

Afterward, the following command needs to be run.

$ app-maker project install

plugin create

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

Example

$ cd example-app
$ app-maker 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
$ app-maker plugin pack

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

SemVer Options

NameDescription
--majorMajor (1.3.4 -> 2.0.0)
--minorMinor (0.1.1 -> 0.2.0)
--patchPatch (0.0.1 -> 0.0.2)

Example

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

$ app-maker 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 "app-maker 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
$ app-maker 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
$ app-maker plugin preview ios
$ app-maker plugin preview android
$ app-maker 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
$ app-maker plugin run ios
$ app-maker plugin run android
$ app-maker plugin run huawei

config show

Displays the global config information.

Example:

$ app-maker config show

config pm

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

Example:

$ app-maker 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 "app-maker 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:

$ app-maker publickey add

publickey list

Displays a table listing the SSH Public Keys.

Example:

$ app-maker 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:

$ app-maker publickey remove

git connect

This command facilitates the 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:

$ app-maker git connect

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:

$ app-maker git check

git disconnect

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:

$ app-maker git disconnect