@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 CLI or 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 file

ngx-scripts env2json <env_var> [<env_var2> ...] [-o <file.json>]

Default output file is src/environments/.env.json.

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
• --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
• --yarn: Use Yarn instead of NPM to run the build script

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

1.1.0

• Added yarn usage detection (https://github.com/ngx-rocket/generator-ngx-rocket/issues/49)
• Fixed passing Cordova arbitrary options
• Added --verbose option for Cordova