@ngx-rocket/scripts

:rocket: ngx-rocket/scripts

Support scripts for ngX-Rocket projects.

In order to simplify the workflow of applications generated with ngX-Rocket generator, we made this repo to gather all additional scripts and build tools.

Since this module is an independant package, you can even use for projects not built from ngX-Rocket if you find it useful.

Installation

npm install --save @ngx-rocket/scripts

Usage

This modules provides CLI commands to be used in NPM scripts, along with some Cordova hooks (see hooks folder).

Export environment variables to a JSON or JavaScript file

ngx-scripts env <env_var> [<env_var2> ...] [--out <file>] [--format json|js]

Default output file is src/environments/.env.ts with JavaScript format.

Execute Cordova commands

ngx-scripts cordova <command> [options] [-- <cordova_options>]

Unless the --fast option is provided, the Angular app is rebuilt before executing the command, using npm run build. Any accepted Cordova option can be passed through after --.

Options

• --fast: Skip Angular app rebuild
• --base-href <ref>: Change application base URL (default is ./)
• --copy <path>: Copy built apps to the specified path (only works with cordova build)
• --dev: Build Angular app in dev mode (default is prod)
• -e, --env <name>: Target environment for npm run build
• --device: Deploy Cordova build to a device
• --emulate: Deploy Cordova build to an emulator
• --debug: Create a Cordova debug build
• --release: Create a Cordova release build
• --verbose: Show Cordova debug output
• --yarn: Use Yarn instead of NPM to run the build script

Note: Yarn is automatically used instead of NPM is the environment variable NGX_PACKAGE_MANAGER is set to yarn or if the current project was generated with ngX-Rocket using Yarn option (option is saved in .yo-rc.json).

Examples

ngx-scripts cordova prepare
ngx-scripts cordova run ios --dev --debug --emulate
ngx-scripts cordova build ios --env prod --device --release -- --developmentTeam="ABCD" --provisioningProfile="UUID"

Clean Cordova (platforms, plugins) and dist folders

clean [--cordova] [--dist] [--path <path>]

Options

• --cordova: Remove only Cordova folders
• --dist: Remove only dist folder
• --path <path>: Remove only specified path

Unpin Ionic dependencies

ngx-scripts unpin-ionic-dependencies

This removes peerDependencies from ionic-angular's package.json.

The Ionic team insist on fixing their dependencies to exact versions which prevents getting bugfixes and new features outside of their release schedule (see this issue for example).

Running this allows you using higher dependencies versions that specified in Ionic without warnings all the way.

License

MIT

Changelog

2.1.0

• Added --base-href option that defaults to ./ for cordova builds (https://github.com/ngx-rocket/generator-ngx-rocket/issues/249)