Skip to content
This repository
tree: d93c03cbf9

Fetching latest commit…

Cannot retrieve the latest commit at this time

..
ActionSheet Manually recreated ActionSheet pull request 346 / Linted .js file
AdPlugin PayPal Plugin update to 1.4.1
ApplicationPreferences Fixed a small error in js file, thx Michael DeSimone
AudioEncode Added the AudioEncode iOS plugin. This plugin lets you easily convert…
AudioRecord No Change
Badge Fixing what I broke.
BarcodeScanner No Change
BundleFileReader add MIT license notice to iphone bundle file reader plugin
CalendarPlugin modified readme for updated cordova use
ChildBrowser
ClipboardPlugin
DatePicker More refactoring of the DatePicker implmentation. Created one init me…
EmailComposer iOS > EmailComposer > FIX: Without email account there is an error, t…
ExternalScreen put license back into file
FileUploader Rollback iphone/FileUploader to PhoneGap
GapSocket Updated iOS GapSocketCommand plugin to support 1.0.0rc1
Globalization Add Globalization Plugin
GoogleAnalytics Adds the ability to set custom variables in the iPhone GoogleAnalytic…
HockeyApp No Change
InAppPurchaseManager
Keychain Re-Fixing.
LocalNotification
Localizable Updated Localizable to 1.0.0
LowLatencyAudio added LowLatencyAudio plugins for iOS and Android, with usage examples
MapKitPlug "Plugins" is in the PhoneGap.plist file.
MessageBox Added additional type: "decimalpad" to show the UIKeyboardTypeDecimal…
NativeControls NativeControls plugin was a bit behind iOS updated version
NotificationEx Updated README for NotificationEx plugin to include License information
PayPalPlugin PayPal Plugin update to 1.4.1
PrintPlugin Added instructions to README to help with EXC_BAD_ACCESS issue when u…
Prompt Removing unused import
PushNotification remove log function from pushnotification ios plugin
SMSComposer Commented the missing function viewUpdate() and added a navigator.not…
ScreenShot Fixes #25 - Also removed deprecated PhoneGapCommand, using PGPlugin (…
ShareKitPlugin cleanup sharekit readme
SoundPlug #import <AudioToolbox/AudioServices.h>
SplashScreen Updated SpashScreen to 1.0.0, and added a parameter so it takes an image
TestFlight
Torch
Twitter Merge pull request #327 from brianantonelli/master
UniqueIdentifier moved iPhone version to correct folder
VolumeSlider Update iPhone/VolumeSlider/README.md
__orphanage Update orphaned files to support conditional PHONEGAP_FRAMEWORK
networkActivityIndicator Updated some more stuff to 1.0.0
README.md Version support notes for /iPhone repository
README.md

This code is completely dependent on the <= PhoneGap 1.4.1 project, also hosted on GitHub ( https://github.com/apache/incubator-cordova-ios/tree/1.4.1 )

This folder is for <= Phonegap 1.4.1 /iPhone specific plugins. Please include a ReadMe.md in your plugin, and preferably some sample code for how to use it.

Please submit PhoneGap/Cordova 1.5.0+ plugin versions for iOS under the /iOS repository.

Reference: https://github.com/phonegap/phonegap-plugins/blob/master/iOS/README.md

Reference: https://github.com/phonegap/phonegap-plugins/issues/487

The MIT License

Copyright (c) 2010 Nitobi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Plugin Installation. The exact manner of using a plugin in iPhone PhoneGap will likely vary with each plugin, so the following is a general rule for how to set things up to use a plugin.

A simple plugin will likely be just 3 files, generally PluginName.m, PluginName.h, and PluginName.js The .m/.h files need to be added to your XCode project and this must be done through XCode so that XCode is aware that these files are to be compiled and linked to the application. You can do this by manually copying the files into your project's plugins folder and from within XCode select your plugins folder, right click and choose 'Add Existing Files...' and select the files you already put in the plugins folder.

You may also choose to save a step and simply select your XCode project plugins folder, right click and choose 'Add Existing Files...' and find the files within your plugin repo, then choose copy so XCode will duplicate the files for you.

The PluginName.js is generally moved into the www folder manually and NOT a part of the XCode project. You can do this on the file-system directly by copying the file over. Be sure to include the PluginName.js with a script tag in your html file that will interact with it, and do this AFTER including phonegap.js

Generally you will see instructions on how to interact with the plugin, but this is up to the authors/contributors.

Some general rules for interacting with plugins:

  • do NOT call plugin methods until after the 'deviceready' event has fired.
  • some plugins need to be explicitly installed. ex. ChildBrowser.install();
  • plugins are usually installed in the DOM at window.plugins.pluginName
  • do NOT call prototype methods, call instance methods ex. EmailComposer.prototype.showEmailComposer( ... // WRONG, this is the definition of the method, and not the actual instance method. ex. window.plugins.emailComposer.showEmailComposer( ... // CORRECT, this is calling an instance method.

  • if using the Xcode 4 Template using the PhoneGap.framework, see https://github.com/phonegap/phonegap-plugins/issues/21

Something went wrong with that request. Please try again.