gulp-remotebuild

Gulp plug-in to build Cordova iOS app remotely using Visual Studio Tools for Apache Cordova.

You can also use this plug-in and TACO to aid continuous integration.

This Gulp plug-in is largely based on this REST API doc.

How to use

Install remotebuild on your Mac or MacInCloud.

const taco = require('./gulp-remotebuild');

return gulp.src('./**/*')
  .pipe(taco.build({
    configuration: process.env.node_env === 'production' ? 'release' : 'debug',
    host         : 'localhost:3000'
  }))
  .pipe(gulp.dest('dist/'));

It will send all your files (excluding bin, bld and platforms) to your Mac, build it, and send the .ipa file back to your Gulp box.

[16:09:20] Starting 'default'...
[16:09:22] taco.json requested for Cordova version 6.1.1
[16:09:23] Compressing 1,221 files
[16:09:25] Compressing 5,259 files
[16:09:27] Compressing 9,944 files
[16:09:28] Compressing 12,292 files
[16:09:28] Building on localhost:3000 against Cordova version 6.1.1
[16:09:32] remotebuild: Uploaded build request payload.
[16:09:45] remotebuild: Acquiring Cordova.
[16:09:47] remotebuild: Updating platform.
[16:09:59] remotebuild: Build completed successfully.
[16:10:00] Extracting myapp.plist (831 B)
[16:10:00] Extracting myapp.ipa (1.5 MB)
[16:10:00] Extracting myapp.app.dSYM.zip (527.4 KB)
[16:10:00] Finished 'default' after 39 s

Files outputted at /dist/.

02/08/2017  06:08 PM           527,375 myapp.app.dSYM.zip
02/08/2017  06:08 PM         1,499,789 myapp.ipa
02/08/2017  06:08 PM               831 myapp.plist
02/08/2017  06:08 PM           254,170 taco-build.log

Options

Default options are as below:

{
  buildTimeout  : 300000,
  configuration : 'debug',
  cordovaVersion: '5.1.1',
  host          : 'localhost:3000',
  logLevel      : 'warn',
  mount         : 'cordova',
  options       : '--device',
  pollInterval  : 1000
}

| Name | Description | | ---------------- | ----------------------------------------------------------------------- | | buildTimeout | Seconds to wait for build to complete | | configuration | debug for debug build, release for production build | | cordovaVersion | Cordova CLI version to use during build | | host | Host name and port number of the remotebuild box | | logLevel | Log level | | mount | Web mount point for remotebuild, i.e. https://localhost:3000/cordova/ | | options | Options to send to Cordova CLI | | pollInterval | Interval to poll for build completion |

Known issues

• Secured remotebuild is not supported yet
• Currently, only build command is supported

Contributions

Like us? Star us.

Found a bug? File us an issue.