Updated Branches: refs/heads/master 90dd91ae8 -> 8b8ae8a11
[CB-1171] Update CordovaWebView Guide for 2.1 Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/8b8ae8a1 Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/8b8ae8a1 Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/8b8ae8a1 Branch: refs/heads/master Commit: 8b8ae8a113ea2367d6fe42be6e75c284db8d1da1 Parents: 90dd91a Author: shazron <shaz...@gmail.com> Authored: Wed Aug 1 17:21:06 2012 -0700 Committer: shazron <shaz...@gmail.com> Committed: Wed Aug 1 17:21:06 2012 -0700 ---------------------------------------------------------------------- docs/en/edge/guide/cordova-webview/ios.md | 64 +++++++++++++----------- 1 files changed, 35 insertions(+), 29 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/8b8ae8a1/docs/en/edge/guide/cordova-webview/ios.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/cordova-webview/ios.md b/docs/en/edge/guide/cordova-webview/ios.md index c5193b3..30f1509 100644 --- a/docs/en/edge/guide/cordova-webview/ios.md +++ b/docs/en/edge/guide/cordova-webview/ios.md @@ -24,40 +24,35 @@ Beginning with Cordova 1.4, you can use Cordova as a component in your iOS appli New Cordova-based applications created using the Xcode template provided in Cordova 1.4 or greater use Cleaver, and this template is considered the reference implementation for Cleaver. -Beginning with Cordova 2.0.0, we only support the sub-project based Cleaver implementation from now on. +Beginning with Cordova 2.0.0 and greater, we only support the sub-project based Cleaver implementation from now on. Prerequisites ------------- -1. **Cordova 2.0.0** or greater +1. **Cordova 2.1.0** or greater 2. **Xcode 4.3** or greater -3. `Cordova.plist` file +3. `Cordova.plist` file (from a [newly created](guide_command-line_index.md.html#Command-Line%20Usage_ios) Cordova project) Adding Cleaver to your Xcode project (CordovaLib sub-project) ------------------------------------------------------------- -0. **Install** Cordova -1. **Copy** the `Cordova.plist` file into your project folder on disk -2. **Drag and drop** the `Cordova.plist` file into the Project Navigator of Xcode -3. **Choose** the radio-button **"Create groups for any added folders"** -4. 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 -5. 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**) -6. Enter `~/Documents/CordovaLib/` in the **"Go to the folder:" sheet** and then press the **"Go"** button -7. Select the `VERSION` file in the the **"Add Files..." sheet** -8. Press the **"Add"** button in the **"Add Files..." sheet** -9. 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 -10. 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**) -11. Enter `~/Documents/CordovaLib/CordovaLib.xcodeproj` in the **"Go to the folder:" sheet** and then press the **"Go"** button -12. Press the **"Add"** button in the **"Add Files..." sheet** -13. Select `CordovaLib.xcodeproj` in the Project Navigator -14. Press the key combination **Option-Command-1** to show the **File Inspector** -15. Choose **"Relative to CORDOVALIB"** in the **File Inspector** for the drop-down menu for **Location** -16. Click on the **project icon** in the Project Navigator, select your **Project**, then select the **"Build Settings"** tab -17. Add `-all_load` and `-Obj-C` - for the **"Other Linker Flags"** value -18. Click on the **project icon** in the Project Navigator, select your **Target**, then select the **"Build Phases"** tab -19. Expand **"Link Binaries with Libraries"** -20. Click on the **"+" button**, and add these **frameworks** (and optionally in the Project Navigator, **move** them under the Frameworks group): +1. **Download and extract the Cordova source** to a **permanent folder location** on your hard drive (say to ~/Documents/Cordova) +2. **Quit Xcode** if it is running. +3. **Navigate** to the directory where you put the downloaded source above, using **Terminal.app**. +4. Type **make** and press **Enter**. This will update the $(CORDOVALIB) build setting in Xcode to point to the CordovaLib in the permanent folder location above. +5. **Copy** the `Cordova.plist` file into your project folder on disk (see **Prerequisites** above) +6. **Drag and drop** the `Cordova.plist` file into the Project Navigator of Xcode +7. **Choose** the radio-button **"Create groups for any added folders"**, select the **Finish** button +8. **Drag and drop** the `CordovaLib.xcodeproj` file into the Project Navigator of Xcode (from the permanent folder location above, and it should be in the CordovaLib sub-folder) +9. Select `CordovaLib.xcodeproj` in the Project Navigator +10. Press the key combination **Option-Command-1** to show the **File Inspector** +11. Choose **"Relative to CORDOVALIB"** in the **File Inspector** for the drop-down menu for **Location** +12. Select the **project icon** in the Project Navigator, select your **Target**, then select the **"Build Settings"** tab +13. Add `-all_load` and `-Obj-C` - for the **"Other Linker Flags"** value +14. Click on the **project icon** in the Project Navigator, select your **Target**, then select the **"Build Phases"** tab +15. Expand **"Link Binaries with Libraries"** +16. Select the **"+" button**, and add these **frameworks** (and optionally in the Project Navigator, **move** them under the Frameworks group): AddressBook.framework AddressBookUI.framework @@ -70,12 +65,23 @@ Adding Cleaver to your Xcode project (CordovaLib sub-project) MobileCoreServices.framework CoreMedia.framework -21. Expand **"Target Dependencies"** - the top box labeled like this if you have multiple boxes! -22. Click on the **"+" button**, and add the `CordovaLib` build product -23. Expand **"Link Binaries with Libraries"** - the top box labeled like +17. Expand **"Target Dependencies"** - the top box labeled like this if you have multiple boxes! +18. Select the **"+" button**, and add the `CordovaLib` build product +19. Expand **"Link Binaries with Libraries"** - the top box labeled like this if you have multiple boxes! -24. Click on the **"+" button**, and add `libCordova.a` - +20. Select the **"+" button**, and add `libCordova.a` +21. Set the Xcode preference **"Xcode Preferences -> Locations -> Derived Data -> Advancedâ¦"** to **"Unique"** +22. Select the **project icon** in the Project Navigator, select your **Target**, then select the **"Build Settings"** tab +23. Search for **"Header Search Paths"**. For that setting, add these three values below (with quotes): + + "$(TARGET_BUILD_DIR)/usr/local/lib/include" + + "$(OBJROOT)/UninstalledProducts/include" + + "$(BUILT_PRODUCTS_DIR)" + + With **Cordova 2.1.0**, CordovaLib has been upgraded to use **Automatic Reference Counting (ARC)**. You don't need to upgrade to **ARC** to use CordovaLib, but if you want to upgrade your project to use **ARC**, please use the Xcode migration wizard from the menu: **Edit -> Refactor -> Convert to Objective-C ARCâ¦**, **de-select libCordova.a**, then run the wizard to completion. + Using CDVViewController in your code ------------------------------------
