From 244670854d2f5658dbe2a5d7caa6b5abfd0a6101 Mon Sep 17 00:00:00 2001 From: Zalmoxisus Date: Sun, 24 Jan 2016 15:06:01 +0200 Subject: [PATCH] Build cordova app --- config.xml | 1 + gulp/tasks/build.js | 4 + gulp/tasks/copy.js | 1 + gulp/tasks/views.js | 1 + gulpfile.babel.js | 1 + hooks/README.md | 196 ++++++++++++++++++++++++++++++++++++++ hooks/build.sh | 1 + package.json | 1 + webpack/cordova.config.js | 16 ++++ www/.gitkeep | 0 10 files changed, 222 insertions(+) create mode 100644 hooks/README.md create mode 100755 hooks/build.sh create mode 100644 webpack/cordova.config.js create mode 100644 www/.gitkeep diff --git a/config.xml b/config.xml index 48624a9..bfbff82 100644 --- a/config.xml +++ b/config.xml @@ -8,6 +8,7 @@ Apache Cordova Team + diff --git a/gulp/tasks/build.js b/gulp/tasks/build.js index 53fd3b0..b333dbd 100644 --- a/gulp/tasks/build.js +++ b/gulp/tasks/build.js @@ -5,6 +5,7 @@ import prodConfig from '../../webpack/prod.config'; import appConfig from '../../webpack/app.config'; import electronConfig from '../../webpack/electron.config'; import webConfig from '../../webpack/web.config'; +import cordovaConfig from '../../webpack/cordova.config'; const build = (config, callback) => { let myConfig = Object.create(config); @@ -29,3 +30,6 @@ gulp.task('webpack:build:electron', (callback) => { gulp.task('webpack:build:web', (callback) => { build(webConfig, callback); }); +gulp.task('webpack:build:cordova', (callback) => { + build(cordovaConfig, callback); +}); diff --git a/gulp/tasks/copy.js b/gulp/tasks/copy.js index 92980d7..5bb408c 100644 --- a/gulp/tasks/copy.js +++ b/gulp/tasks/copy.js @@ -15,6 +15,7 @@ gulp.task('copy:build:extension', copy('./build/extension', 'browser/extension/manifest.prod.json')); gulp.task('copy:build:app', copy('./build/app', 'chromeApp/manifest.json')); gulp.task('copy:build:web', copy('./build/web')); +gulp.task('copy:build:cordova', copy('./www')); gulp.task('copy:build:electron', () => { gulp.src(['./src/electron/**', '!./src/electron/resources', '!./src/electron/resources/**']) diff --git a/gulp/tasks/views.js b/gulp/tasks/views.js index 7095e26..5a8dee0 100644 --- a/gulp/tasks/views.js +++ b/gulp/tasks/views.js @@ -19,3 +19,4 @@ gulp.task('views:build:app', () => { }); gulp.task('views:build:electron', compile('./build/electron', paths[1])); gulp.task('views:build:web', compile('./build/web', paths[1])); +gulp.task('views:build:cordova', compile('./www', paths[1])); diff --git a/gulpfile.babel.js b/gulpfile.babel.js index 7924daf..d184e92 100644 --- a/gulpfile.babel.js +++ b/gulpfile.babel.js @@ -4,6 +4,7 @@ requireDir('./gulp/tasks'); gulp.task('default', ['replace-webpack-code', 'webpack-dev-server', 'views:dev', 'copy:dev']); gulp.task('build:web', ['webpack:build:web', 'views:build:web', 'copy:build:web']); +gulp.task('build:cordova', ['webpack:build:cordova', 'views:build:cordova', 'copy:build:cordova']); gulp.task('build:electron', ['webpack:build:electron', 'views:build:electron', 'copy:build:electron']); gulp.task('build:extension', diff --git a/hooks/README.md b/hooks/README.md new file mode 100644 index 0000000..62e58b4 --- /dev/null +++ b/hooks/README.md @@ -0,0 +1,196 @@ + +# Cordova Hooks + +Cordova Hooks represent special scripts which could be added by application and plugin developers or even by your own build system to customize cordova commands. Hook scripts could be defined by adding them to the special predefined folder (`/hooks`) or via configuration files (`config.xml` and `plugin.xml`) and run serially in the following order: +* Application hooks from `/hooks`; +* Application hooks from `config.xml`; +* Plugin hooks from `plugins/.../plugin.xml`. + +__Remember__: Make your scripts executable. + +__Note__: `.cordova/hooks` directory is also supported for backward compatibility, but we don't recommend using it as it is deprecated. + +## Supported hook types +The following hook types are supported: + + after_build/ + after_compile/ + after_docs/ + after_emulate/ + after_platform_add/ + after_platform_rm/ + after_platform_ls/ + after_plugin_add/ + after_plugin_ls/ + after_plugin_rm/ + after_plugin_search/ + after_plugin_install/ <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being installed + after_prepare/ + after_run/ + after_serve/ + before_build/ + before_compile/ + before_docs/ + before_emulate/ + before_platform_add/ + before_platform_rm/ + before_platform_ls/ + before_plugin_add/ + before_plugin_ls/ + before_plugin_rm/ + before_plugin_search/ + before_plugin_install/ <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being installed + before_plugin_uninstall/ <-- Plugin hooks defined in plugin.xml are executed exclusively for a plugin being uninstalled + before_prepare/ + before_run/ + before_serve/ + pre_package/ <-- Windows 8 and Windows Phone only. + +## Ways to define hooks +### Via '/hooks' directory +To execute custom action when corresponding hook type is fired, use hook type as a name for a subfolder inside 'hooks' directory and place you script file here, for example: + + # script file will be automatically executed after each build + hooks/after_build/after_build_custom_action.js + + +### Config.xml + +Hooks can be defined in project's `config.xml` using `` elements, for example: + + + + + + + + + + ... + + + + + + + ... + + +### Plugin hooks (plugin.xml) + +As a plugin developer you can define hook scripts using `` elements in a `plugin.xml` like that: + + + + + + + + ... + + +`before_plugin_install`, `after_plugin_install`, `before_plugin_uninstall` plugin hooks will be fired exclusively for the plugin being installed/uninstalled. + +## Script Interface + +### Javascript + +If you are writing hooks in Javascript you should use the following module definition: +```javascript +module.exports = function(context) { + ... +} +``` + +You can make your scipts async using Q: +```javascript +module.exports = function(context) { + var Q = context.requireCordovaModule('q'); + var deferral = new Q.defer(); + + setTimeout(function(){ + console.log('hook.js>> end'); + deferral.resolve(); + }, 1000); + + return deferral.promise; +} +``` + +`context` object contains hook type, executed script full path, hook options, command-line arguments passed to Cordova and top-level "cordova" object: +```json +{ + "hook": "before_plugin_install", + "scriptLocation": "c:\\script\\full\\path\\appBeforePluginInstall.js", + "cmdLine": "The\\exact\\command\\cordova\\run\\with arguments", + "opts": { + "projectRoot":"C:\\path\\to\\the\\project", + "cordova": { + "platforms": ["wp8"], + "plugins": ["com.plugin.withhooks"], + "version": "0.21.7-dev" + }, + "plugin": { + "id": "com.plugin.withhooks", + "pluginInfo": { + ... + }, + "platform": "wp8", + "dir": "C:\\path\\to\\the\\project\\plugins\\com.plugin.withhooks" + } + }, + "cordova": {...} +} + +``` +`context.opts.plugin` object will only be passed to plugin hooks scripts. + +You can also require additional Cordova modules in your script using `context.requireCordovaModule` in the following way: +```javascript +var Q = context.requireCordovaModule('q'); +``` + +__Note__: new module loader script interface is used for the `.js` files defined via `config.xml` or `plugin.xml` only. +For compatibility reasons hook files specified via `/hooks` folders are run via Node child_process spawn, see 'Non-javascript' section below. + +### Non-javascript + +Non-javascript scripts are run via Node child_process spawn from the project's root directory and have the root directory passes as the first argument. All other options are passed to the script using environment variables: + +* CORDOVA_VERSION - The version of the Cordova-CLI. +* CORDOVA_PLATFORMS - Comma separated list of platforms that the command applies to (e.g.: android, ios). +* CORDOVA_PLUGINS - Comma separated list of plugin IDs that the command applies to (e.g.: org.apache.cordova.file, org.apache.cordova.file-transfer) +* CORDOVA_HOOK - Path to the hook that is being executed. +* CORDOVA_CMDLINE - The exact command-line arguments passed to cordova (e.g.: cordova run ios --emulate) + +If a script returns a non-zero exit code, then the parent cordova command will be aborted. + +## Writing hooks + +We highly recommend writing your hooks using Node.js so that they are +cross-platform. Some good examples are shown here: + +[http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/](http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/) + +Also, note that even if you are working on Windows, and in case your hook scripts aren't bat files (which is recommended, if you want your scripts to work in non-Windows operating systems) Cordova CLI will expect a shebang line as the first line for it to know the interpreter it needs to use to launch the script. The shebang line should match the following example: + + #!/usr/bin/env [name_of_interpreter_executable] diff --git a/hooks/build.sh b/hooks/build.sh new file mode 100755 index 0000000..d2f053b --- /dev/null +++ b/hooks/build.sh @@ -0,0 +1 @@ +npm run build:cordova; diff --git a/package.json b/package.json index 83e2d08..3ed43cc 100644 --- a/package.json +++ b/package.json @@ -7,6 +7,7 @@ "start:electron": "rm -rf ./build/electron/ && gulp build:electron && electron ./build/electron/", "build:electron": "rm -rf ./build/electron/ && rm -rf ./build/executables/ && gulp build:electron && gulp pack:electron", "build:web": "gulp build:web", + "build:cordova": "gulp build:cordova", "build:extension": "gulp build:extension", "build:app": "gulp build:app", "build:firefox": "gulp build:firefox", diff --git a/webpack/cordova.config.js b/webpack/cordova.config.js new file mode 100644 index 0000000..b546a31 --- /dev/null +++ b/webpack/cordova.config.js @@ -0,0 +1,16 @@ +import path from 'path'; +import baseConfig from './base.config'; + +export default baseConfig({ + input: { + app: [path.join(__dirname, '../src/web/index')] + }, + output: { + path: path.join(__dirname, '../www/js') + }, + globals: { + 'process.env': { + NODE_ENV: '"production"' + } + } +}); diff --git a/www/.gitkeep b/www/.gitkeep new file mode 100644 index 0000000..e69de29