Release Notes for PhoneGap ({VERSION})
PhoneGap is a static library and static framework that enables users to include the PhoneGap API in their iPhone application projects easily, and also create new PhoneGap-based iPhone application projects through an Xcode project template.
1.0.0 (20110728)
- CHANGED: Update media implementation to match documentation. Significant modifications to match documentation. Using media.js from Android so significant changes to the code to match that architecture. Created wrapper for AVAudioPlayer and Recorder to store the mediaId. Kept iOS only prepare() method but removed downloadCompleteCallback. Added seekTo method.
- CHANGED: Default-Landscape.png width increased to 1024px for #185 fix below
- FIX: #188 Xcode 3 Template does not weak-link UIKit, AVFoundation and CoreMedia by default
- FIX: #183 make fails when a user's Developer (Xcode) folder has spaces in it
- FIX: #180 Add README.md to the installer package
- FIX: #186 return null when no organization information. iOS was incorrectly returning an organization object with all null values when there was no organization information. It now correctly returns null.
- FIX: #182 updated getCurrentPosition to update _position variable. Fixed bug where seekTo was setting the _position value in milliseconds rather than seconds. getCurrentPosition was not setting _position to -1 when media was not playing.
- FIX: #191 (CRASH) PhoneGap app re-suspends when resumed after Airplane Mode toggled
- FIX: #196 PhoneGapInstaller.pkg should be signed
- FIX: #185 splash screen ignores supported device orientations (fixed for Universal only - iPhone only on iPad has an iOS bug)
- REMOVED: Installer readme.html is now generated from README.md markdown in the root
- REMOVED: Default~ipad.png is removed from the project templates
- ADDED: Prevents iframes from executing PhoneGap calls via gap urls
- ADDED: Added warning log if splash-screen image is missing.
- NOTE: 1.0.0rc3 tagged in the repo is essentially this release
1.0.0rc2 (20110719)
- FIX: #167 Generated (by script) Xcode 3 template file fails in Xcode 4
- FIX: #162 better accessibility for timed audio
- FIX: #168 Warning in Xcode 3 project that you haven't added phonegap.*.js, warning never goes away
- FIX: iPhone splash screen not showing (no issue #, fixed in splash screen new feature below)
- ADDED: New PhoneGap.plist options: AutoHideSplashScreen (bool=true), ShowSplashScreenSpinner (bool=true). If AutoHideSplashScreen is false, you can control hiding the splash screen in JavaScript by calling navigator.splashscreen.hide().
- ADDED: #164 Add phonegap version inside the JavaScript file itself
- ADDED: #166 Create uninstaller for PhoneGapInstaller
- ADDED: #6 implemented Camera.EncodingType to return images as jpg or png from getPicture.
- CHANGED: Sample splash screen images are annotated
- REMOVED: #165 Remove minification of phonegap.*.js file
1.0.0rc1 (20110712)
- FIX: Splash screen fixes for iPad
- REMOVED: Deprecated items removed: Notification activityStart/activityStop, Notification loadingStart/loadingStop, Network.isReachable, debug.log, File.writeAsText, PhoneGapCommand base class for Plugins, unused Image and Movie plugins removed
- RESTORED: Camera core plugin has been un-deprecated until a suitable replacement can be found to grab photos from the Camera Roll/Photo Library.
- NEW: phonegap.js naming convention: now phonegap-1.0.0rc.js, was phonegap.1.0.0rc1.js
- NEW: Camera core plugin supports image scaling
- NEW: Contacts core plugin updated to W3C June 2011 Spec
- NEW: Contacts core plugin supports display and edit contact
- NEW: Capture core plugin supports localized files for a11y prompt in Audio capture.
- NEW: EnableViewportScale key in PhoneGap.plist (to enable viewport initial-scale metadata tag)
- NEW: Plugins: PhoneGap.exec supports service names in Reverse Domain Name (RDN) notation i.e "com.phonegap.MyPlugin"
- NEW: Plugins: PhoneGap.exec should support new signature: PhoneGap.exec(successCallback, failCallback, serviceName, action, [arg0, arg1])
- NEW: Plugins: Ability to override onMemoryWarning() to handle app memory warnings
- NEW: Plugins: Ability to override onAppTerminate() to handle app termination
- NEW: Plugins: Ability to override handleOpenURL:(NSNotification*) to handle launch of the app from a custom URL
- UPGRADERS: Create a new project, and copy in the new phonegap-1.0.0rc1.*.js and PhoneGap.plist into your existing project
0.9.6 (20110628)
- Xcode 3 Template includes the CoreMedia framework (as a weak reference for iOS 3.x) for the W3C Media Capture API
- Xcode 4 Template includes the CoreMedia framework (as a required reference, template spec limitation) for the W3C Network API. You must change this to an 'optional' reference to target iOS 3.x devices, if not they will crash.
- UPGRADERS: add the existing framework "CoreMedia" to your project, set it to weak/optional in your Target, copy the new phonegap.*.js files in manually to your www folder, and update your script references. Copy the .js files from /Users/Shared/PhoneGap/Frameworks/PhoneGap.framework/www. Copy the "Capture.bundle" from /Users/Shared/PhoneGap/Frameworks/PhoneGap.framework and add it to your project as well (or copy from a new project)
- UPGRADERS: set the existing frameworks "UIKit" and "AVFoundation" to weak/optional (for iOS 3.x support)
- CoreTelephony.framework can be removed in all projects, it is not needed anymore for the W3C Network Information API
- Plugins MUST add their plugin mapping to PhoneGap.plist Plugins key, if not they will not work.
- DEPRECATED: Camera.getPicture will be removed in 1.0 and put in the plugins repo, use the Media Capture API instead
- DEPRECATED: Network.isReachable will be removed in 1.0, use the Network Information API instead
- DEPRECATED: Notification activityStart, activityStop, loadingStart, loadingStop core plugin functions will be removed in 1.0 and put in the plugins repo
- DEPRECATED: Plugin base class 'PhoneGapCommand' will be removed in 1.0, use the base class 'PGPlugin' instead
20110519
- Xcode 3 Template includes the CoreTelephony framework (as a weak reference for iOS 3.x) for the W3C Network Information API
- Xcode 4 Template includes the CoreTelephony framework (as a required reference, template spec limitation) for the W3C Network Information API. You must change this to an 'optional' reference to target iOS 3.x devices, if not they will crash.
- UPGRADERS: add the existing framework "CoreTelephony" to your project, set it to weak/optional in your Target, copy the new phonegap.*.js files in manually to your www folder, and update your script references. Copy the .js files from /Users/Shared/PhoneGap/Frameworks/PhoneGap.framework/www
20110516
- Xcode 3 Template does not copy the PhoneGap javascript files anymore into your www folder, the javascript files are now part of the template (Xcode 3 UPGRADERS: you will need to grab the .js files manually from ~/Documents/PhoneGapLib/javascripts after building your project at least once)
- PhoneGapLib use is considered deprecated, for a future installer the Xcode 3 Template will use the PhoneGap.framework exclusively
- Xcode 4 Template has an improved build script - it will detect whether the 'www' folder reference was added and will warn you if it has not been added (Xcode 4 UPGRADERS: you will need to grab the .js files manually from /Users/Shared/PhoneGap/Frameworks/PhoneGap.framework/www)
20110503
- Added Xcode 4 Template (need to add in www folder reference manually - sample 'www' folder created after first run)
- Added PhoneGap static framework generation (as the UniversalFramework target in PhoneGapLib xcodeproj)
- Modified Xcode 3 Template (for compatibility with the Xcode 4 template)
- Installed PhoneGap static framework in /Users/Shared/PhoneGap/Frameworks/PhoneGap.framework (for non-admin privilege users, this may change in further updates)
20110306
- Updated PhoneGap application template to handle project and PhoneGapLib locations with spaces in it
- Removed iPad template
- Updated compiler of application template and PhoneGapLib to LLVM GCC 4.2
- Cleaned up static analyzer warnings.
20110306
- Updated PhoneGap application template to handle project and PhoneGapLib locations with spaces in it
- Removed iPad template
- Updated compiler of application template and PhoneGapLib to LLVM GCC 4.2
- Cleaned up static analyzer warnings.
20110126
- phonegap.js is minified using the YUI compressor, and also renamed to phonegap.{ver}.min.js where {ver} is the version number of PhoneGapLib from the VERSION file
- the PhoneGap template is changed as well, at build time it will replace any references to 'src="phonegap.js"' to the new versioned js file (and copy the new phonegap.{ver}.min.js file). This replacement will look in all files in the 'www' folder.
- note that with the new PhoneGapLib phonegap.{ver}.min.js renaming, existing PhoneGap templates must copy the new "Copy PhoneGap Javascript" post-build script from the new template (in Xcode, under Targets/[ProjectName])
20101102
- Updated the Base SDK to "Latest iOS" (iOS 4.2 is the minimum to submit to the App Store) for the project files. This setting requires the latest Xcode 3.2.5 (included with the iOS 4.2 SDK)
20101019
- Updated the Base SDK to iOS 4.1 (the minimum to submit to the App Store) for the project files
20100902
- Updated the Base SDK to iOS 4.0 (the minimum to submit to the App Store) for the project files
- Added PhoneGapBuildSettings.xcconfig to the template. To override your PHONEGAPLIB folder on a project by project basis, modify the PHONEGAPLIB value in this file.
20100416
- Removed keys from PhoneGap.plist (AutoRotate, StartOrientation, RotateOrientation).
- To support orientation in your app: edit/add the UISupportedInterfaceOrientations (iPhone) or UISupportedInterfaceOrientations~ipad (iPad) key into your app's [appname]-Info.plist, with an array of strings that show what orientation your app supports. The supported values are: UIInterfaceOrientationPortrait, UIInterfaceOrientationLandscapeLeft, UIInterfaceOrientationPortraitUpsideDown, UIInterfaceOrientationLandscapeRight.
- The first value in the array is the orientation that your app starts in. If you have more than one value in the array, it will autorotate (to the other supported orientations).
20100406
- added iPad universal xcodeproj file (3.2 OS required)
20091103
- fixed permissions and initial run problems
20091030