gulp-cordova-preference

    1.1.0 • Public • Published

    gulp-cordova-preference Build Status

    Set a preference of your cordova project

    Installation

    npm install --save-dev gulp-cordova-preference

    Usage

    This plugin can be used in two different ways. The first way is by passing an object with key-value pairs as parameter. The key will be used as name of the preference, the value will be used as value.

    var gulp = require('gulp'),
        create = require('gulp-cordova-create'),
        pref = require('gulp-cordova-preference');
     
    gulp.task('build', function() {
        return gulp.src('dist')
            .pipe(create())
            .pipe(pref({
                'AndroidLaunchMode': 'singleTop',
                'ShowTitle': true
            });
    });

    Tip: You can add the preferences in a file called prefs.json and call the plugin with pref(require('./prefs.json')).

    The second way is by providing two parameters, the first one being the name of the preference, the second one as the value of the preference.

    var gulp = require('gulp'),
        create = require('gulp-cordova-create'),
        pref = require('gulp-cordova-preference');
     
    gulp.task('build', function() {
        return gulp.src('dist')
            .pipe(create())
            .pipe(pref('AndroidLaunchMode', 'singleTop'))
            .pipe(pref('ShowTitle', true));
    });

    If a preference with the name ShowTitle or AndroidLaunchMode already exists, it will overwrite the old value with the new value.

    Notice that the second way of adding preferences to your config file is slower because it has to parse the XML file every time the plugin is executed. If you pass in an object with key-value pairs, it will only parse the config file once.

    API

    preference(prefs)

    prefs

    Required
    Type: object

    A key-value pair object where the key is the name of the preference and the value the value.

    preference(name, value)

    name

    Required
    Type: string

    The name of the preference.

    value

    Required
    Type: string

    The value of the preference.

    Related

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

    Author

    License

    MIT © Sam Verschueren

    Install

    npm i gulp-cordova-preference

    DownloadsWeekly Downloads

    7

    Version

    1.1.0

    License

    MIT

    Last publish

    Collaborators

    • samverschueren