Gulp plugin for building an android Cordova project
Clone or download
Latest commit d2199f5 Oct 5, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.editorconfig Meta tweaks Oct 5, 2018
.gitattributes tweaks Mar 7, 2016
.gitignore tweaks Mar 7, 2016
.npmrc Meta tweaks Oct 5, 2018
index.js Fix outputting apk files Oct 5, 2018
license tweaks Mar 7, 2016
package.json
readme.md find outputs for ant-style builds (#25) May 26, 2016

readme.md

gulp-cordova-build-android

Build the cordova project for the Android platform.

Installation

npm install --save-dev gulp-cordova-build-android

Usage

const gulp = require('gulp');
const create = require('gulp-cordova-create');
const plugin = require('gulp-cordova-plugin');
const android = require('gulp-cordova-build-android');

gulp.task('build', () => {
    return gulp.src('dist')
        .pipe(create())
        .pipe(plugin('org.apache.cordova.dialogs'))
        .pipe(plugin('org.apache.cordova.camera'))
        .pipe(android())
        .pipe(gulp.dest('apk'));
});

This plugin will build the cordova project for the Android platform.

Because the plugin returns the apk files, you can pipe it to gulp.dest. This will store all the apk files in the apk directory.

Build a release apk

By setting release to true, the plugin will build a release version of the APK. This will create an unsigned apk file.

const gulp = require('gulp');
const create = require('gulp-cordova-create');
const plugin = require('gulp-cordova-plugin');
const android = require('gulp-cordova-build-android');

gulp.task('build', () => {
    return gulp.src('dist')
        .pipe(create())
        .pipe(plugin('org.apache.cordova.dialogs'))
        .pipe(plugin('org.apache.cordova.camera'))
        .pipe(android({release: true}))
        .pipe(gulp.dest('apk'));
});

Sign the apk

To produce a signed apk you need to pass signing options to the plugin. If you pass signing options to the plugin you do not need to specify that it is a release build as the plugin will do a release build automatically

const gulp = require('gulp');
const create = require('gulp-cordova-create');
const plugin = require('gulp-cordova-plugin');
const android = require('gulp-cordova-build-android');

gulp.task('build', () => {
    return gulp.src('dist')
        .pipe(create())
        .pipe(android({storeFile: '/Path/to/key.keystore', keyAlias: 'my_alias'}))
        .pipe(gulp.dest('apk'));
});

When running the build task, it will now ask for the key store password and for the key password.

API

android([options])

options

release

Type: boolean

Set the build to be a release build.

storeFile

Required
Type: string

Absolute path to your key file.

storePassword

Type: string

The key store password.

keyAlias

Required
Type: string

The alias of the key.

keyPassword

Type: string

The password of the key alias.

storeType

Type: string

The format of the key file. The default is to auto-detect based on the file extension.

version

Type: string

Version of cordova-android platform plugin.

buildMethod

Type: string
Default: gradle

Build method to use. Either ant or gradle.

Related

See gulp-cordova for the full list of available packages.

License

MIT © Sam Verschueren