corber
v1.4.4
Published
Tooling for cordova and crosswalk hybrid applications built with Ember
Downloads
426
Maintainers
Readme
Corber
Corber is a CLI that improves the hybrid app build experience for Vue, Ember, Glimmer, and React apps using Cordova.
Corber handles framework and app builds and validations with a single command: corber build
- without affecting existing web flows. The CLI also includes on-device livereload for development and utility functions for icons, plugins, and more. And when needed, it can proxy to the Cordova CLI.
It is a continuation of the ember-cordova project. ember-cordova users can find details here, and continue to access the existing ember addon and documentation. For migration instructions, see Migrating from Ember Cordova.
Installation
# Yarn
yarn global add corber
# NPM
npm install -g corber
Initialize Corber
- Change to your project directory.
- Run
corber init
. - Select iOS and press space to select the platform.
Configure Your Project for Corber
Vue CLI 3
- Open
vue.config.js
. (Create file in project root if it doesn't exist. See Example Vue Config.) - Require
corber-webpack-plugin
and assign it asCorberWebpackPlugin
. - Add
new CorberWebpackPlugin()
to theconfigureWebpack.plugins
array.
For Vue CLI 2 or Non-Vue CLI, see Configure Vue CLI 2 or Non-Vue CLI projects.
Ember
- Open
config/environment.js
. - Set
locationType
tohash
. - Update
rootURL
orbaseURL
to remove its leading slash, if it has one.
Extending Frameworks
Corber comes with built-in support for Vue, Ember, and React, but can be extended to work with the framework of your choice. See Extending Corber to Support Other Frameworks.
Run App on an Emulator with Live Reload
- Run
corber start
. - Select an emulator.
Build, Flash, and Run App on Your Device
- Run
corber build
. (Ignore error code 65 error, signing will be set in step 3.) - Run
corber open
to open the Xcode project. - First Time Only: In Xcode, select the Project Navigator, select your project, and under Signing, set your Team.
- Connect your iPhone via its USB cable. (Accept the "Trust This Computer?" alert if prompted.)
- In Xcode, select your connected device in the toolbar.
- Press the Play button to flash and run the app on your device.
For Android builds see Android Setup. For full documentation, please visit corber.io.
Contributing
Pull requests are very welcome. You can read our style guides here.
If you are unsure about your contribution idea, please feel free to open an issue for feedback.
Find an issue with our documentation? All docs are hosted on this repo under the gh-pages
branch.
Credits
Corber is maintained by Isle of Code.