grunt-phonegap-build

This is a grunt-task to upload a ZIP archive to build.phonegap.com and trigger a new build.

Current version & development

The current version is 0.0.8, this project is in BETA and under active development.

Configuration

First of all, you need a ZIP file, containing the contents of the PhoneGap app to be built. This can be created using grunt-zipstream for example. The ZIP file should have the "index.html" and the "Config.xml" in the root level and all required resources below, for example:

├── Config.xml
├── css
│   ├── app.css
│   ├── foundation.min.css
│   ├── lungo.css
│   ├── lungo.icon.brand.css
│   ├── lungo.icon.css
│   └── theme.lungo.css
├── icon.png
├── js
│   ├── app.js
│   ├── controller.js
│   ├── directives.js
│   ├── filters.js
│   ├── services.js
├── images
│   └── background.jpg
├── index.html

Then, some configuration for phonegap-build is needed:

General options

1. appId: The App ID of the application on build.phonegap.com (see details of your app there to get it)
2. user: The email and password or the Github authentication token (all three optional) you log in with on build.phonegap.com. If you leave out your password it will prompt you when grunt runs.
3. timeout: (optional, default: 60 seconds) a timeout. You may need to increase this value if you are trying to upload a large app or have a slow connection.
4. pollRate: (optional, default: 15 seconds) The rate at which the plugin will poll when checking to see if the apps have been built.

For file-based applications (using a *.zip file)

1. archive: The path (or filename, if it's in the same directory as the Gruntfile) to the ZIP archive

For repository-based applications (using a github repository)

1. isRepository: True to set the build method to "pull from repository"

When unlocking keys

1. keys: A map of platform name [ios, android, ...] to parameters required to unlock the keys. For example:

   keys: {
     ios: { "password": "foobar" },
     android: { "key_pw": "foobar", "keystore_pw": "foobar" }
   }
   

When downloading apps

1. download: A map of platform name [ios, android, ...] to path to save the app to. For example:

   download: {
     ios: 'dist/ios.ipa',
     android: 'dist/android.apk'
   }
   

That's all. Once you configured the build-phonegap, you can run

$ grunt phonegap-build

or if you have a "zip" target to create the archive before:

$ grunt zip phonegap-build

to create a new build. Note: This is a multitask, so you can specify different configurations for it (e.g. test and production). You need to specify at least one configuration Here is an example for a Gruntfile.js:

module.exports = function(grunt) {

  // Project configuration.
  grunt.initConfig({
    "phonegap-build": {
      debug: {
        options: {
          archive: "app.zip",
          "appId": "1234",
          "user": {
            "email": "[e-mail]",
            "password": "yourPassw0rd"
          }
        }
      },
      release: {
        options: {
          "isRepository": "true",
          "appId": "9876",
          "user": {
            "token": "ABCD123409876XYZ"
          }
        }
      }
    },
    zip: {
      app: {
        file: {
          src: ["index.html", "js/**/*.js", "css/**/*.js", "icon.png", "images/background.jpg"],
          dest: "app.zip"
        }
     }
    }
  });

  // Load tasks.
  grunt.loadNpmTasks('grunt-zipstream');
  grunt.loadNpmTasks('grunt-phonegap-build');

  // Default task.
  grunt.registerTask('default', 'zip phonegap-build:debug');
};

This example also aliased

$ grunt

to run "zip" and then "phonegap-build" for you.