Registry / devops / gulp-phonegap-build

gulp-phonegap-build

JSON →
library0.1.5jsnpmunverified

This Gulp plugin was designed to automate the process of uploading application files to the now-defunct build.phonegap.com service and triggering cloud builds. While the package itself is available on npm at version 0.1.5, the core service it integrates with, Adobe PhoneGap Build, was officially discontinued by Adobe on October 1, 2020. This renders the plugin non-functional for its original purpose. The project was in 'BETA' and under 'active development' at the time of its last update, forking from `grunt-phonegap-build` to provide similar functionality for Gulp users. Its key differentiators were its direct integration with Gulp streams and the ability to configure various PhoneGap Build parameters like app ID, user credentials, target platforms, and signing keys directly within a `gulpfile.js`.

devops
npm install gulp-phonegap-build
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · GULP-PHONEGAP-BUIL
G
gulp-phonegap-build
devopsjavascriptv0.1.5
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

phonegapBuild
✓ const phonegapBuild = require('gulp-phonegap-build');
✗ import phonegapBuild from 'gulp-phonegap-build';
The plugin is designed for CommonJS environments typical of Gulpfiles from its era (Node.js >= 0.8.0). ESM `import` syntax is not supported and will not work.

This quickstart demonstrates how to define a Gulp task using `gulp-phonegap-build` to upload files, trigger a build for specific platforms, and download the resulting app binaries, configured with a token for authentication. Note that this code will no longer function due to the PhoneGap Build service shutdown.

var gulp = require('gulp'); var phonegapBuild = require('gulp-phonegap-build'); // NOTE: This plugin is non-functional as the Adobe PhoneGap Build service was discontinued on Oct 1, 2020. // The example below demonstrates its intended usage for historical context. gulp.task('phonegap-build-example', function () { gulp.src('dist/**/*', {dot: true}) // {dot: true} is important to include files like .pgbomit .pipe(phonegapBuild({ "isRepository": false, // Set to true if using a GitHub repository "appId": "9876", // Replace with your actual PhoneGap Build App ID "user": { "token": "ABCD123409876XYZ" // Replace with your PhoneGap Build authentication token }, "platforms": ['ios', 'android'], // Required to trigger builds due to API quirk "download": { "ios": 'dist/ios.ipa', "android": 'dist/android.apk' } })) .on('error', function(err) { console.error('PhoneGap Build task failed:', err.message); }); }); gulp.task('default', ['phonegap-build-example']);
Debug
Known issues
breakingThe Adobe PhoneGap Build cloud service, which this Gulp plugin integrates with, was officially discontinued on October 1, 2020. Consequently, `gulp-phonegap-build` is entirely non-functional as its target API no longer exists. There is no direct replacement service under the PhoneGap brand.
fix
Migrate to alternative cross-platform development solutions like Apache Cordova (for local builds), Ionic Appflow, React Native, Flutter, or Progressive Web Apps.
affects: >=0.1.0
gotchaEven when the service was active, omitting the `platforms` array in the configuration would prevent builds from being triggered due to an undocumented quirk in the PhoneGap API. This was a common source of confusion.
fix
Always specify `platforms: ['ios', 'android']` (or other relevant platforms) in the plugin configuration to ensure builds are triggered. (This is now moot due to service shutdown.)
affects: >=0.1.0
gotchaWhen sourcing files for upload using `gulp.src`, the `{dot: true}` option was crucial to include hidden configuration files (e.g., `.pgbomit`) that PhoneGap Build might have relied upon. Forgetting this option could lead to unexpected build failures or misconfigurations on the PhoneGap Build server.
fix
Ensure `gulp.src('path/to/files/**/*', {dot: true})` is used to include all necessary files, including dotfiles. (This is now moot due to service shutdown.)
affects: >=0.1.0
Errors
Common errors & fixes
Error: read ECONNRESET
Network connection issues, server-side closure, or the PhoneGap Build service being unavailable.
fix
This error, particularly after October 2020, likely indicates that the `build.phonegap.com` service is no longer operational. The plugin cannot recover from this, and the underlying service is permanently offline.
Error: access denied
Incorrect authentication credentials (user, password, or token) or the PhoneGap Build service denying access due to its shutdown.
fix
Prior to the shutdown, verify `user` and `appId` configurations. After October 2020, this error confirms the service is defunct, and the plugin is no longer usable.
Upgrade
Version history
0.1.5latest on npm
Audit
Dependencies
gulprequiredThis is a Gulp plugin and requires Gulp to be installed as a peer dependency for task runner integration.
Agent activity
4 hits · last 30 days
node
4
Resources
githubhttps://github.com/marcbuils/gulp-phonegap-build ↗
packagehttps://www.npmjs.com/package/gulp-phonegap-build ↗
homepagehttp://marcbuils.github.io/gulp-phonegap-build ↗
gulp-phonegap-build — npm install gulp-phonegap-build · libregistry