Command Line Interface (CLI)
The Cloud App Command Line Interface (CLI) is the tool used to create, develop, and build Cloud Apps. For information on installing the CLI, see the Getting Started guide.
Once the CLI is installed, you can type the command eca
in your terminal or command prompt. The CLI will print a list of available commands. Each command can be run by typing eca <command name>
, i.e. eca init
.
$ eca Available Commands init Initialize current directory start Install dependencies, configure and start development server --no-install : Do not install dependencies --no-open-browser : Do not open browser after starting --browser : Overwrite the default browser generate Generate code in an initialized project extract-labels Extract labels into json files for translation build Build production-ready assets for app help Display this list of available commands version Display the installed version of the CLI test Build and start the test server
init
The init
command creates a new Cloud App or initializes one which has be cloned from another repository.
New Cloud App
To create a new Cloud App, create a new directory and change into that directory. Then run the eca init
command and follow the prompts.
$ mkdir my-new-app $ cd my-new-app $ eca init
Initialize an existing app
To initialize a Cloud App that you have cloned from another repository, run the eca init
command in the root repository’s directory. Then follow the prompts.
$ git clone https://github.com/exlibrisgroup/cloudapp-tutorials Cloning into 'cloudapp-tutorials'... $ cd cloudapp-tutorials $ eca init Existing app detected. ✔ Do you want to reconfigure this existing app? … yes
start
The start
command is used to launch the local development server. The local development server allows you to develop your Cloud App using your sandbox (or production) Alma instance while the Cloud App code runs locally. The start command installs dependencies and then wraps the ng serve
command from the Angular CLI.
The start command supports these flags:
--no-install
: Do not install/update dependencies--no-open-browser
: Do not open the default browser with the login page of the Alma instance--browser
: Overwrite the default browser. (From CLI version 0.3.0) The environment variableECA_BROWSER
is also supported, and it is overridden by this flag. The following are supported:- firefox
- “google chrome” (chrome on Windows)
- “microsoft edge” (msedge on Windows)
- safari
build
The build
command is used to build the Cloud App and prepare it for deployment to a production server. It wraps the ng build command from the Angular CLI. It is recommended that you build your Cloud App before you submit it for publishing to ensure there are no compile-time errors. For more information see the “Deploying Cloud Apps” documentation.
generate
The generate
command is used to create new files in the Cloud App project such as new components. It wraps the ng generate
command from the Angular CLI. For more information see the tutorial on “Adding additional routes.”
extract-labels
The extract-labels
command is used to extract the strings used in the Cloud App and prepare files for translations. It wraps the ngx-translate-extract tool. For more information see the tutorial on “Making your app ready for translations.”
version
Prints the installed version of the CLI. (From version 0.3.0)
test
Start the test runner. See Testing Cloud Apps for more information.