diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md index 2f5526b29..9124e180e 100644 --- a/docs/INSTALLATION.md +++ b/docs/INSTALLATION.md @@ -15,6 +15,7 @@ - [Xcode](#xcode) - [Bitcode](#bitcode) - [CocoaPods](#cocoapods) + - [Common CocoaPod Installation issues](#common-cocoapod-installation-issues) - [Additional Resources](#additional-resources) ## Installation Requirements @@ -237,6 +238,23 @@ cordova plugin add phonegap-plugin-push@1.8.1 If you are installing this plugin using a `local file reference` or a `git url`, you will have to specify the version of this plugin explicitly (see above) if you don't fulfill the `cordova-cli` and `cordova-ios` requirements. +#### Common CocoaPod Installation issues + +If you are attempting to install this plugin and you run into this error: + +``` +Installing "phonegap-plugin-push" for ios +Failed to install 'phonegap-plugin-push':Error: pod: Command failed with exit code 1 + at ChildProcess.whenDone (/Users/smacdona/code/push151/platforms/ios/cordova/node_modules/cordova-common/src/superspawn.js:169:23) + at emitTwo (events.js:87:13) + at ChildProcess.emit (events.js:172:7) + at maybeClose (internal/child_process.js:818:16) + at Process.ChildProcess._handle.onexit (internal/child_process.js:211:5) +Error: pod: Command failed with exit code 1 +``` + +Please run the command `pod repo update` and re-install the plugin. + ## Additional Resources The push plugin enables you to play sounds and display different icons during push (Android only). These additional resources need to be added to your projects `platforms` directory in order for them to be included into your final application binary. One way of doing it is to create a hook to do the copying for you on each build.