CLI Reference
Init, Development, Building
Plugins and Platforms
Other Useful Commands
Defaults
Override default CLI flags in .ember-cli
, which lives in your project root. For example, to change the default platform from ios to android:
#.ember-cli
platform: 'android',
reloadUrl: 'http://mycomputer:4200'
corber init
Identifies your project type, create a new folder at corber
including Corber configuration, and initializes a Cordova project at corber/cordova
.
Options | default | desc |
---|---|---|
name | your app name | |
cordova-id | io.corber.yourAppName | |
template-path | path to cordova template |
Examples
corber init new-android-project --name=AppName --cordova-id=com.isleofcode.app --template-path=../template
cordova-id flag
io.corber.yourAppName is the default cordova-id, which ultimately represents your iOS and Android project ids. Android projects require reverse domain app ids.
By release, you should update id to com.yourdomain.foo. This is achieved by setting the id
property on the widget
node in the corber/cordova/config.xml
.
<?xml version='1.0' encoding='utf-8'?>
<widget id="com.myappdevcompany.phoneapp" version="1.0.0" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
<name>phoneApp</name>
<description>
A sample Apache Cordova application that responds to the deviceready event.
</description>
...
corber start
The start command supports iOS and Android. It boots an emulator, installs / launches an application to the emulator and starts your frameworks development server for livereload.
To learn more, read here
Options | default | desc |
---|---|---|
platform | ios | platform |
skip-cordova-build (alias: scb) | false | only performs framework build |
reload-url | auto detected ip | network ip of your machine |
Examples
corber start
corber start --platform=android
corber build
Runs a Corber build by building your JavaScript application, copying assets to the Cordova web directory, and building the Cordova application. To learn more, read here.
Options | default | desc |
---|---|---|
environment | development | JS Framework env |
platform | ios | target platform |
release | debug | |
cordova-output-path | corber/cordova/www | |
skip-framework-build (alias: sfb) | false | only performs cordova build |
skip-cordova-build (alias: scb) | false | only performs framework build |
The build command also takes all of the non gradle-specific cordova build opts (e.g. provisioningProfile, codeSignIdentity).
Examples
corber build
corber build --environment=production --platform=ios
corber build --environment=production --platform=ios --release
corber open
Opens the built iOS project in Xcode. Does not support Android - Android projects will require you to manually open Android Studio.
Examples
corber open
corber serve
Hot reload. To learn more, read here.
You may want to look at the start command, which is newer and provides a more integrated experience for emulator usage.
Options | default | desc |
---|---|---|
platform | ios | cordova platform |
reload-url | auto detected ip | network ip of your machine |
cordova-output-path | corber/cordova/www | |
skip-framework-build (alias: sfb) | false | only performs cordova build |
skip-cordova-build (alias: scb) | false | only performs framework build |
Examples
corber serve
corber serve --platform=android --reload-url=192.168.1.1
corber serve --platform=browser --env "development"
corber plugin
Add or remove cordova plugins.
Options | default | desc |
---|---|---|
save | true | store plugin info in config.xml . See committing & cloning |
Examples
corber plugin add cordova-plugin-name
corber plugin rm cordova-plugin-name
Aliases
- add/a
- remove/rm/r
corber platform
Add or remove cordova platforms.
Options | default | desc |
---|---|---|
save | true | store plugin info in config.xml . See committing & cloning |
uiwebview | false | initialize ios with UIWebView vs WKWebView |
crosswalk | false | initialize android with Crosswalk vs Android WebView |
Examples
corber platform add ios
corber platform remove ios
corber platform add android --crosswalk
Aliases
- add/a
- remove/rm/r
corber prepare
Installs all plugins and platforms in config.xml. Similar to npm install
, but for your Cordova context.
Examples
corber prepare
corber proxy
Passes commands straight to cordova, without interference.
Because this proxies to cordova-cli, you will need cordova-cli installed (this is not required for usage anywhere else). Our hope is you won’t need this command very much. If you do, consider opening an issue to let us know.
When running a proxy command, file paths are relative to your corber/cordova directory.
For example, running corber proxy plugin add ../local-plugin-path
from your project root will likely fail, while corber proxy plugin add ../../../local-plugin-path
would succeed.
(hint: try using corber plugin add ../local-plugin-path
instead)
Examples
corber proxy info
corber proxy run ios --nobuild
corber make-icons
Automatically generate platform icons from a single svg. For more information, see icon & splash generation.
Options | default | desc |
---|---|---|
source | corber/icon.svg | splash svg |
platform | all | platform to build assets for |
Examples
corber make-icons
corber make-splashes
Automatically generate platform splashscreens from a single svg. For more information, see icon & splash generation.
Options | default | desc |
---|---|---|
source | corber/splash.svg | splash svg |
platform | all | platform to build assets for |
Examples
corber make-splashes
corber lint-index
Validates there are no leading /
paths in your generated app. While Corber will validate your framework config pre build, sometimes items such as hardcoded CDN urls will slip through.
lint-index is automatically run on builds at WARN level.
Examples
corber lint-index