You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2012/06/29 19:03:05 UTC
[1/6] ios commit: Removed Upgrade Guide and Cleaver Guide from repo -
they are all in docs.phonegap.com now
Updated Branches:
refs/heads/master 8a087bd0b -> 0c2187b70
Removed Upgrade Guide and Cleaver Guide from repo - they are all in docs.phonegap.com now
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/0c2187b7
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/tree/0c2187b7
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/diff/0c2187b7
Branch: refs/heads/master
Commit: 0c2187b702a5f96752cb76cec60d69c24da421e7
Parents: 237a906
Author: Shazron Abdullah <sh...@apache.org>
Authored: Fri Jun 29 10:02:55 2012 -0700
Committer: Shazron Abdullah <sh...@apache.org>
Committed: Fri Jun 29 10:02:55 2012 -0700
----------------------------------------------------------------------
Makefile | 10 --
guides/Cordova Upgrade Guide.md | 159 ----------------------------------
2 files changed, 0 insertions(+), 169 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/blob/0c2187b7/Makefile
----------------------------------------------------------------------
diff --git a/Makefile b/Makefile
index a2149c7..ce16f2d 100644
--- a/Makefile
+++ b/Makefile
@@ -207,8 +207,6 @@ installer: check-utils clean check-wkhtmltopdf md-to-html cordova-lib xcode3-tem
@osacompile -o ./dist/files/Uninstall\ Cordova.app Uninstall\ Cordova.applescript > /dev/null 2>> $(PKG_ERROR_LOG)
@# convert the html docs to pdf, concatenate readme and license
@$(WKHTMLTOPDF) --footer-center "Cordova ${CDV_VER} Release Notes" CordovaInstaller/docs/releasenotes.html dist/files/ReleaseNotes.pdf > /dev/null 2>> $(PKG_ERROR_LOG)
- @$(WKHTMLTOPDF) --footer-center "How to use Cordova ${CDV_VER} as a Component" CordovaInstaller/docs/cleaver.html 'dist/files/Guides/How to Use Cordova as a Component.pdf' > /dev/null 2>> $(PKG_ERROR_LOG)
- @$(WKHTMLTOPDF) --footer-center "Cordova ${CDV_VER} Upgrade Guide" CordovaInstaller/docs/upgrade.html 'dist/files/Guides/Cordova Upgrade Guide.pdf' > /dev/null 2>> $(PKG_ERROR_LOG)
@$(WKHTMLTOPDF) --footer-center "Cordova ${CDV_VER} Plugin Upgrade Guide" CordovaInstaller/docs/plugin_upgrade.html 'dist/files/Guides/Cordova Plugin Upgrade Guide.pdf' > /dev/null 2>> $(PKG_ERROR_LOG)
@$(WKHTMLTOPDF) --footer-center "Cordova ${CDV_VER} Settings File" CordovaInstaller/docs/settings_file.html 'dist/files/Guides/Cordova Settings File.pdf' > /dev/null 2>> $(PKG_ERROR_LOG)
@$(WKHTMLTOPDF) --footer-center "Cordova ${CDV_VER} JavaScript Exception Logging" CordovaInstaller/docs/exception_logging.html 'dist/files/Guides/Cordova JavaScript Exception Logging.pdf' > /dev/null 2>> $(PKG_ERROR_LOG)
@@ -298,14 +296,6 @@ md-to-html: check-markdown
@echo '<html><body style="font-family: Helvetica Neue; font-size:10pt;">' > CordovaInstaller/docs/readme.html
@$(MARKDOWN) README.md >> CordovaInstaller/docs/readme.html
@echo '</body></html>' >> CordovaInstaller/docs/readme.html
- @# generate 'How to Use Cordova as a Component' html from markdown
- @echo '<html><body style="font-family: Helvetica Neue; font-size:10pt;">' > CordovaInstaller/docs/cleaver.html
- @$(MARKDOWN) 'guides/How to Use Cordova as a Component.md' >> CordovaInstaller/docs/cleaver.html
- @echo '</body></html>' >> CordovaInstaller/docs/cleaver.html
- @# generate 'Cordova Upgrade Guide' html from markdown
- @echo '<html><body style="font-family: Helvetica Neue;font-size:10pt;">' > CordovaInstaller/docs/upgrade.html
- @$(MARKDOWN) 'guides/Cordova Upgrade Guide.md' >> CordovaInstaller/docs/upgrade.html
- @echo '</body></html>' >> CordovaInstaller/docs/upgrade.html
@# generate 'Cordova Plugin Upgrade Guide' html from markdown
@echo '<html><body style="font-family: Helvetica Neue;font-size:10pt;">' > CordovaInstaller/docs/plugin_upgrade.html
@$(MARKDOWN) 'guides/Cordova Plugin Upgrade Guide.md' >> CordovaInstaller/docs/plugin_upgrade.html
http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/blob/0c2187b7/guides/Cordova Upgrade Guide.md
----------------------------------------------------------------------
diff --git a/guides/Cordova Upgrade Guide.md b/guides/Cordova Upgrade Guide.md
deleted file mode 100644
index 33df4d7..0000000
--- a/guides/Cordova Upgrade Guide.md
+++ /dev/null
@@ -1,159 +0,0 @@
-<!--
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements. See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership. The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License. You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied. See the License for the
-# specific language governing permissions and limitations
-# under the License.
-#
--->
-# Cordova Upgrade Guide #
-
----
-This document is **deprecated** and will be **removed** in Cordova 2.0. Please go to [http://docs.phonegap.com/en/edge/guide_upgrading_index.md.html](http://docs.phonegap.com/en/edge/guide_upgrading_index.md.html) for the latest and up to date upgrade instructions.
----
-
-Please note that **Xcode 4 is required**. To submit to the Apple App Store, you must use the latest shipped version of the iOS SDK, which is iOS 5.1. The iOS 5.1 SDK requires Xcode 4.
-
-This document is for developers who need to upgrade their Cordova-based projects to a newer Cordova version. Starting with Cordova 1.4.0, Cordova has been re-factored to use Cleaver (Cordova as a Component), and some classes that were used before have been removed - namely PhoneGapDelegate and PhoneGapViewController.
-
-- To upgrade from 1.3.0 to 1.9.0, go through the 1.4.x, 1.5.0, 1.6.0, 1.7.x, 1.8.x then finally the 1.9.0 instructions
-- To upgrade from 1.4.x to 1.9.0, go through the 1.5.0, 1.6.0, 1.7.x, 1.8.x then finally the 1.9.0 instructions
-- To upgrade from 1.5.0 to 1.9.0, go through the 1.6.0, 1.7.x, 1.8.x then finally the 1.9.0 instructions
-- To upgrade from 1.6.0 to 1.9.0, go through the 1.7.x, 1.8.x then finally the 1.9.0 instructions
-- To upgrade from 1.7.x to 1.9.0, go through the 1.8.x then finally the 1.9.0 instructions
-- To upgrade from 1.8.x to 1.9.0, go through the 1.9.0 instructions
-
-## Upgrading Cordova 1.8.x projects to 1.9.0 ##
-
-1. **Install** Cordova 1.9.0
-2. **Create a new project** - you will have to grab assets from this new project
-3. **Copy** the **www/cordova-1.9.0.js** file from the new project into your **www** folder, and delete your **www/cordova-1.8.x.js** file
-4. **Update** the Cordova script reference in your **www/index.html** file (and any other files that contain the script reference) to point to the new **cordova-1.9.0.js** file
-
-**Note:**
-
-1.9.0 supports the new **"BackupWebStorage"** boolean setting in Cordova.plist. By default, this setting is turned on, set it to "false" to turn it off - especially for iOS 6 - see [Release Notes - Safari and UIKit Section](https://developer.apple.com/library/prerelease/ios/#releasenotes/General/RN-iOSSDK-6_0/_index.html)
-
-
-## Upgrading Cordova 1.7.0 projects to 1.8.x ##
-
-1. **Install** Cordova 1.8.0
-2. **Create a new project** - you will have to grab assets from this new project
-3. **Copy** the **www/cordova-1.8.0.js** file from the new project into your **www** folder, and delete your **www/cordova-1.7.x.js** file
-4. **Update** the Cordova script reference in your **www/index.html** file (and any other files that contain the script reference) to point to the new **cordova-1.8.0.js** file
-
-If you intend on using the **Capture API**, you will need the new **iPad retina-display** assets:
-
-1. **Copy** the **Resources/Capture.bundle** item from the new project into your project folder, over-writing your existing **Resources/Capture.bundle** item
-2. In your project, select the **Capture.bundle** item into Xcode into your Project Navigator, and press the **Delete** key, then select **Remove Reference** from the dialog that pops up.
-3. Drag the new **Capture.bundle** from Step 1. above into Xcode into your Project Navigator, and select the **Create groups for any added folders** radio-button
-
-
-## Upgrading Cordova 1.6.x projects to 1.7.0 ##
-
-1. **Install** Cordova 1.7.0
-2. **Create a new project** - you will have to grab assets from this new project
-3. **Copy** the **www/cordova-1.7.0.js** file from the new project into your **www** folder, and delete your **www/cordova-1.6.0.js** file
-4. **Update** the Cordova script reference in your **www/index.html** file (and any other files that contain the script reference) to point to the new **cordova-1.7.0.js** file
-
-## Upgrading Cordova 1.5.0 projects to 1.6.x ##
-
-1. **Install** Cordova 1.6.1
-2. **Make a backup** of **AppDelegate.m**, **AppDelegate.h**, **MainViewController.m**, **MainViewController.h**, and **Cordova.plist** 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.5.0 based project folder on disk, **replacing** any old files (**backup** your files first from step 2 above):
-
- AppDelegate.h
- AppDelegate.m
- MainViewController.h
- MainViewController.m
- Cordova.plist
-5. **Add** all the new **MainViewController** and **AppDelegate** files into your Xcode project
-6. **Copy** the **www/cordova-1.6.1.js** file from the new project into your **www** folder, and delete your **www/cordova-1.5.0.js** file
-7. **Update** the Cordova script reference in your **www/index.html** file (and any other files that contain the script reference) to point to the new **cordova-1.6.1.js** file
-8. **Add** the new **Cordova.plist** file into your project - this is because the core plugin service names needed to be changed to match the ones from Android and Blackberry, for a unified Cordova JavaScript file (cordova-js).
-9. **Integrate** any settings, **Plugins** and **ExternalHosts** entries that you had in your **backed-up Cordova.plist** into the new **Cordova.plist**
-10. **Integrate** any project specific code that you have in your **backed-up AppDelegate.h and AppDelegate.m** into the new AppDelegate files. Any **UIWebViewDelegate** or **CDVCommandDelegate** code in **AppDelegate.m** will need to go into MainViewController.m now (see commented out sections in that file)
-11. **Integrate** any project specific code that you have in your **backed-up MainViewController.h and MainViewController.m** into the new MainViewController files
-12. Click on the **project icon** in the Project Navigator, select your **Project**, then select the **"Build Settings"** tab
-13. Enter **"Compiler for C/C++/Objective-C"** in the search field
-14. Select the **"Apple LLVM Compiler 3.1"** value
-
-
-## Upgrading Cordova 1.4.x projects to 1.5.0 ##
-
-1. **Install** Cordova 1.5.0
-2. **Create a new project** and run it once - you will have to grab assets from this new project
-3. **Copy** the **www/cordova-1.5.0.js** file from the new project into your **www** folder, and delete your **www/phonegap-1.4.x.js** file
-4. **Update** the Cordova script reference in your **www/index.html** file (and any other files that contain the script reference) to point to the new Cordova **cordova-1.5.0.js** file
-5. Find **"PhoneGap.framework"** in your Project Navigator, select it
-6. Press the **Delete** key and delete the **"PhoneGap.framework"** reference in the Project Navigator
-7. Press the key combination **Option-Command-A**, which should drop down a sheet to add files to your project (the **"Add Files..." sheet**). Make sure the **"Created groups for any added folders"** radio-button is selected
-8. Press the key combination **Shift-Command-G**, which should drop down another sheet for you to go to a folder (the **"Go to the folder:" sheet**)
-9. Enter **"/Users/Shared/Cordova/Frameworks/Cordova.framework"** in the **"Go to the folder:" sheet** and then press the **"Go"** button
-10. Press the **"Add"** button in the **"Add Files..." sheet**
-11. **Select "Cordova.framework"** in the Project Navigator
-12. Press the key combination **Option-Command-1** to show the **File Inspector**
-13. Choose **"Absolute Path"** in the **File Inspector** for the drop-down menu for **Location**
-14. Press the key combination **Option-Command-A**, which should drop down a sheet to add files to your project (the **"Add Files..." sheet**). Make sure the **"Created groups for any added folders"** radio-button is selected
-15. Press the key combination **Shift-Command-G**, which should drop down another sheet for you to go to a folder (the **"Go to the folder:" sheet**)
-16. Enter **"~/Documents/CordovaLib/Classes/deprecated"** in the **"Go to the folder:" sheet** and then press the **"Go"** button
-17. Press the **"Add"** button in the **"Add Files..." sheet**
-18. In your **AppDelegate.h, AppDelegate.m, and MainViewController.h** files - replace the whole **#ifdef PHONEGAP_FRAMEWORK** block with:
-
- #import "CDVDeprecated.h"
-19. Click on the **project icon** in the Project Navigator, select your **Target**, then select the **"Build Settings"** tab
-20. Search for **"Framework Search Paths"**
-21. Replace the existing value with **"/Users/Shared/Cordova/Frameworks"**
-22. Search for **"Preprocessor Macros"**
-23. For the first (combined) value, replace the value with **"CORDOVA_FRAMEWORK=YES"**
-24. Select the **"Build Phases"** tab
-25. Expand **"Run Script"**
-26. Replace any occurrences of **PhoneGap** with **Cordova**
-27. Find your **"PhoneGap.plist"** file in the Project Navigator, and click on the filename once to enter name edit mode
-28. Rename **"PhoneGap.plist"** to **"Cordova.plist"**
-29. Right-click on **"Cordova.plist"** and choose **"Open As" --> "Source Code"**
-30. Press **Option-Command-F**, choose **"Replace"** from the drop-down on the top left of the Source window
-31. Enter **com.phonegap** for the Find string, and **org.apache.cordova** for the Replace string - then press the **"Replace All"** button
-32. Enter **PG** for the Find string, and **CDV** for the Replace string - then press the **"Replace All"** button
-33. Press **Command-B** to build, you will still have deprecations that you can get rid of in the future (see **CDVDeprecated.h** - replace classes in your code that use PG* to CDV*, for example)
-
-## Upgrading Cordova 1.4.0 projects to 1.4.1 ##
-
-1. **Install** Cordova 1.4.1
-2. **Make a backup** of **MainViewController.m**
-3. **Create a new project** - you will have to grab assets from this new project
-4. **Copy** the **MainViewController.m** file from the **new** project into your 1.4.0 based project folder on disk, **replacing** the old file (**backup** your files first from step 2 above).
-5. **Add** the **MainViewController.m** file into your Xcode project
-6. **Integrate** any project specific code that you have in your **backed-up MainViewController.m** into the new file
-7. Updating the phonegap-X.X.X.js file is optional, nothing has changed in the JavaScript between 1.4.0 and 1.4.1
-
-## Upgrading Cordova 1.3.0 projects to 1.4.0 ##
-
-1. **Install** Cordova 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 2 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 Cordova 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
\ No newline at end of file