Updated Branches: refs/heads/master 39fa0927c -> 89ea74327
Added the "PhoneGap Upgrade Guide" doc. Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/commit/89ea7432 Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/tree/89ea7432 Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/diff/89ea7432 Branch: refs/heads/master Commit: 89ea74327ce11f97026a54e4de058ddb69bdcbcd Parents: 39fa092 Author: Shazron Abdullah <shaz...@apache.org> Authored: Fri Jan 27 17:44:21 2012 -0800 Committer: Shazron Abdullah <shaz...@apache.org> Committed: Fri Jan 27 17:44:21 2012 -0800 ---------------------------------------------------------------------- Makefile | 10 ++++++++-- PhoneGap Upgrade Guide.md | 23 +++++++++++++++++++++++ PhoneGapInstaller/docs/finishup.md | 6 +++--- PhoneGapInstaller/docs/releasenotes.md | 4 ++++ 4 files changed, 38 insertions(+), 5 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/blob/89ea7432/Makefile ---------------------------------------------------------------------- diff --git a/Makefile b/Makefile index 314e558..8bc32d0 100644 --- a/Makefile +++ b/Makefile @@ -109,6 +109,7 @@ clean-phonegap-framework: clean-markdown: @$(RM_RF) PhoneGapInstaller/docs/readme.html @$(RM_RF) PhoneGapInstaller/docs/cleaver.html + @$(RM_RF) PhoneGapInstaller/docs/upgrade.html clean-installer: @$(RM_F) PhoneGapInstaller/docs/*.rtf @@ -181,6 +182,7 @@ installer: clean markdown phonegap-lib xcode3-template xcode4-template phonegap- @textutil -convert rtf PhoneGapInstaller/docs/releasenotes.html -output dist/files/ReleaseNotes.rtf @textutil -convert rtf -font 'Courier New' LICENSE -output PhoneGapInstaller/docs/LICENSE.rtf @$(CONVERTPDF) -f PhoneGapInstaller/docs/cleaver.html -o 'dist/files/How to Use PhoneGap as a Component.pdf' + @$(CONVERTPDF) -f PhoneGapInstaller/docs/upgrade.html -o 'dist/files/PhoneGap Upgrade Guide.pdf' @textutil -cat rtf PhoneGapInstaller/docs/finishup.rtf PhoneGapInstaller/docs/readme.rtf PhoneGapInstaller/docs/LICENSE.rtf -output dist/files/Readme.rtf @# restore backed-up markdown files @$(MV) -f PhoneGapInstaller/docs/releasenotes.md.bak PhoneGapInstaller/docs/releasenotes.md @@ -223,10 +225,14 @@ markdown: unzip Markdown_1.0.1.zip -d . > /dev/null; \ fi @# generate readme html from markdown - @echo '<html><body style="font-family: Helvetica Neue;">' > PhoneGapInstaller/docs/readme.html + @echo '<html><body style="font-family: Helvetica Neue; font-size:10pt;">' > PhoneGapInstaller/docs/readme.html @perl Markdown_1.0.1/Markdown.pl README.md >> PhoneGapInstaller/docs/readme.html @echo '</body></html>' >> PhoneGapInstaller/docs/readme.html @# generate 'How to Use PhoneGap as a Component' html from markdown - @echo '<html><body style="font-family: Helvetica Neue;">' > PhoneGapInstaller/docs/cleaver.html + @echo '<html><body style="font-family: Helvetica Neue; font-size:10pt;">' > PhoneGapInstaller/docs/cleaver.html @perl Markdown_1.0.1/Markdown.pl 'How to Use PhoneGap as a Component.md' >> PhoneGapInstaller/docs/cleaver.html @echo '</body></html>' >> PhoneGapInstaller/docs/cleaver.html + @# generate 'PhoneGap Upgrade Guide' html from markdown + @echo '<html><body style="font-family: Helvetica Neue;font-size:10pt;">' > PhoneGapInstaller/docs/upgrade.html + @perl Markdown_1.0.1/Markdown.pl 'PhoneGap Upgrade Guide.md' >> PhoneGapInstaller/docs/upgrade.html + @echo '</body></html>' >> PhoneGapInstaller/docs/upgrade.html http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/blob/89ea7432/PhoneGap Upgrade Guide.md ---------------------------------------------------------------------- diff --git a/PhoneGap Upgrade Guide.md b/PhoneGap Upgrade Guide.md new file mode 100644 index 0000000..89c3755 --- /dev/null +++ b/PhoneGap Upgrade Guide.md @@ -0,0 +1,23 @@ +# PhoneGap Upgrade Guide # + +This document is for developers who need to upgrade their PhoneGap-based projects to a newer PhoneGap version. Starting with PhoneGap 1.4.0, PhoneGap has been re-factored to use Cleaver (PhoneGap as a Component), and some classes that were used before have been deprecated - namely PhoneGapDelegate and PhoneGapViewController. + +Your existing 1.3.0 based projects will still work with 1.4.0, but it is recommended that you upgrade, since the classes mentioned above will be removed in a future version. + +## Upgrading PhoneGap 1.3.0 projects to 1.4.0 ## + +1. **Install** PhoneGap 1.4.0 +2. **Make a backup** of **AppDelegate.m** and **AppDelegate.h** in your project +3. **Create a new project** - you will have to grab assets from this new project +4. **Copy** these files from the **new** project into your 1.3.0 based project folder on disk, **replacing** any old files (**backup** your files first from step 1 above): + + AppDelegate.h + AppDelegate.m + MainViewController.h + MainViewController.m + MainViewController.xib +5. **Add** all the **MainViewController** files into your Xcode project +6. **Copy** the **www/phonegap-1.4.0.js** file from the new project into your **www** folder, and delete your **www/phonegap-1.3.0.js** file +7. **Update** the PhoneGap script reference in your **www/index.html** file (and any other files that contain the script reference) to point to the new **phonegap-1.4.0.js** file +8. **Add** a new entry under **Plugins** in your **PhoneGap.plist** file - key is **com.phonegap.battery** and the value is **PGBattery** +9. **Integrate** any project specific code that you have in your **backed-up AppDelegate.h and AppDelegate.m** into the new AppDelegate files http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/blob/89ea7432/PhoneGapInstaller/docs/finishup.md ---------------------------------------------------------------------- diff --git a/PhoneGapInstaller/docs/finishup.md b/PhoneGapInstaller/docs/finishup.md index fbcc06a..359e62d 100644 --- a/PhoneGapInstaller/docs/finishup.md +++ b/PhoneGapInstaller/docs/finishup.md @@ -12,7 +12,7 @@ ## Upgraders -1. Recommended steps: [Upgrading your iOS PhoneGap Project](http://wiki.phonegap.com/Upgrading%20your%20iOS%20PhoneGap%20Project) +1. Please see the "PhoneGap Upgrade Guide" included in the .dmg distribution 2. See the FAQ in the README.rtf as well <br /> @@ -62,7 +62,7 @@ That's it! Modify the contents of the "www" directory to add your HTML, CSS and * [www.phonegap.com](http://www.phonegap.com) * [docs.phonegap.com](http://docs.phonegap.com) -* [github.com/phonegap/phonegap-iphone](http://github.com/phonegap/phonegap-iphone) -* [File issues and feature requests](http://github.com/phonegap/phonegap-iphone/issues) +* [github.com/apache/incubator-cordova-ios](github.com/apache/incubator-cordova-ios) +* [File issues and feature requests](https://issues.apache.org/jira/browse/CB) <br /> http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/blob/89ea7432/PhoneGapInstaller/docs/releasenotes.md ---------------------------------------------------------------------- diff --git a/PhoneGapInstaller/docs/releasenotes.md b/PhoneGapInstaller/docs/releasenotes.md index f560be7..9dc8163 100644 --- a/PhoneGapInstaller/docs/releasenotes.md +++ b/PhoneGapInstaller/docs/releasenotes.md @@ -10,11 +10,13 @@ PhoneGap is a static library and static framework that enables users to include * Added stand-alone PGViewController (Cleaver - PhoneGap as a Component) * Fixed iOS 5 quirks with presenting/dismissing modal viewcontrollers. * Added 'How to Use PhoneGap as a Component' doc to the .dmg (as a PDF) +* Added 'PhoneGap Upgrade Guide' doc to the .dmg (as a PDF) * Added for legacy support of deprecated PhoneGapDelegate - in core plugins. * Removed PhoneGapLibTest project and folder * Updated the app icons, splash-screens, and template icons for the Xcode template to Cordova ones. * Added Battery core plugin to PhoneGap.plist +<br /> ### 1.3.0 (20111219) ### * added battery into PhoneGap framework compilation @@ -30,6 +32,8 @@ PhoneGap is a static library and static framework that enables users to include * Fixed CB-96 PGWhitelist does not handle IPv4 host addresses with wild-cards * Added 'resign' and 'active' lifecycle events. +<br /> + ### 1.2.0 (20111103) ### * Update for iOS 5 - Switched to using LLVM Compiler and fixed associated warnings. Added armv6 to architectures so can use devices running < iOS5
