gtr

gulp-taco-remote

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

Showing:

Popularity

Downloads/wk

1

GitHub Stars

1

Maintenance

Last Commit

5yrs ago

Contributors

1

Package

Dependencies

10

Size (min+gzip)

30.9KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Deprecated!
WARNING: This project has been renamed to gulp-remotebuild. Install using gulp-taco-remote instead.

Readme

gulp-remotebuild

npm version Node.js dependencies npm downloads

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: '6.1.1',
  host          : 'localhost:3000',
  logLevel      : 'warn',
  mount         : 'cordova',
  options       : '--device',
  pollInterval  : 1000
}
NameDescription
buildTimeoutSeconds to wait for build to complete
configurationdebug for debug build, release for production build
cordovaVersionCordova CLI version to use during build
host Host name and port number of the remotebuild box
logLevelLog level
mountWeb mount point for remotebuild, i.e. https://localhost:3000/cordova/
optionsOptions to send to Cordova CLI
pollIntervalInterval to poll for build completion

FAQs

Instead of REST APIs, why not connect via taco-cli?

taco-cli is a CLI built by Microsoft and it talks to remotebuild box.

Since Gulp prefer vinyl objects and taco-cli requires physical file system, bridging Gulp to taco-cli would increase the build time. Per discussion with remotebuild dev, the REST API provided by remotebuild is stable.

Thus, in the current moment, we prefer talking to remotebuild box via REST API instead of taco-cli.

See the discussions at [https://github.com/Microsoft/remotebuild/issues/23].

Known issues

  • Secured remotebuild is not supported yet
  • Currently, only build command is supported
  • Currently, only tested against remotebuild on Mac
  • Does not support incremental build

Contributions

Like us? Star us.

Found a bug? File us an issue.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100