incubator-callback-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From shaz...@apache.org
Subject git commit: Added the "PhoneGap Upgrade Guide" doc.
Date Sat, 28 Jan 2012 01:44:40 GMT
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 <shazron@apache.org>
Authored: Fri Jan 27 17:44:21 2012 -0800
Committer: Shazron Abdullah <shazron@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


Mime
View raw message