Upgrading Cordova iOS

Xcode 4 が必須 であることに注意してください。 Apple App Store に提出するためには、最新バージョンの iOS SDK (iOS 5.1) を使用する必要があります。 iOS 5.1 は Xcode 4 を必要とします。

1.8.x から 1.9.0 へのアップグレード

  1. Cordova 1.9.0 を インストール します
  2. 新規プロジェクトを作成します - この新規プロジェクトからアセットを持っていきます
  3. 新規プロジェクトから www/cordova-1.9.0.js ファイルを www フォルダーに コピー し、 www/cordova-1.8.x.js ファイルを削除します
  4. www/index.html ファイル (また、他に Cordova script を参照しているファイル) の Cordova script 参照部分を、新しい cordova-1.9.0.js ファイルを参照するように 更新 します

注意:

1.9.0 は、 Cordova.plist で新しい boolean の "BackupWebStorage" 設定値をサポートします。デフォルトでは、これは有効に設定されています。 "false" と設定することで無効にすることができます (特に iOS 6 のため) 。詳しくは Release Notes - Safari and UIKit Section を参照してください

1.7.0 から 1.8.x へのアップグレード

  1. Cordova 1.8.0 を インストール します
  2. 新規プロジェクトを作成します - この新規プロジェクトからアセットを持っていきます
  3. 新規プロジェクトから www/cordova-1.8.0.js ファイルを www フォルダーに コピー し、 www/cordova-1.7.x.js ファイルを削除します
  4. www/index.html ファイル (また、他に Cordova script を参照しているファイル) の Cordova script 参照部分を、新しい cordova-1.8.0.js ファイルを参照するように 更新 します

もし Capture API を使う場合は、新しい iPad retina-display アセットが必要です:

  1. 新規プロジェクトから Resources/Capture.bundle を既存プロジェクトの Resources/Capture.bundle に上書きコピーします
  2. 既存プロジェクトで、 Xcode の Project Navigator の中の Capture.bundle を選択し、 Delete キーを押します。ポップアップダイアログで、 Remove Reference を選択します
  3. ステップ1から新しい Capture.bundle を Xcode の Project Navigator 上にドラッグし、 Create groups for any added folders ラジオボタンを選択します

1.6.x から 1.7.0 へのアップグレード

  1. Cordova 1.7.0 を インストール します
  2. 新規プロジェクトを作成します - この新規プロジェクトからアセットを持っていきます
  3. 新規プロジェクトから www/cordova-1.7.0.js ファイルを www フォルダーに コピー し、 www/cordova-1.6.0.js ファイルを削除します
  4. www/index.html ファイル (また、他に Cordova script を参照しているファイル) の Cordova script 参照部分を、新しい cordova-1.7.0.js ファイルを参照するように 更新 します

1.5.0 から 1.6.x へのアップグレード

  1. Cordova 1.6.1 を インストール します
  2. プロジェクト内の AppDelegate.m, AppDelegate.h, MainViewController.m, MainViewController.h, Cordova.plist の バックアップを作成します
  3. 新規プロジェクトを作成します - この新規プロジェクトからアセットを持って行きます

  4. 以下のファイルを 新しい プロジェクトから1.5.0ベースのプロジェクトのフォルダーにコピーし、古いファイルは 置き換え ます (上のステップ2でファイルを バックアップ します):

    AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
Cordova.plist

  5. すべての新しい MainViewController と AppDelegate ファイルを Xcode プロジェクトに 追加 します

  6. 新規プロジェクトから www/cordova-1.6.1.js ファイルを www フォルダーに コピー し、 www/cordova-1.5.0.js ファイルを削除します

  7. www/index.html ファイル (また、他に Cordova script を参照しているファイル) の Cordova script 参照部分を、新しい cordova-1.6.1.js ファイルを参照するように 更新 します

  8. 新しい Cordova.plist ファイルをプロジェクトに 追加 します - これは、 Android や Blackberry のものと一致するような、統一した Cordova JavaScript ファイル (cordova-js) にするよう、コアプラグインサービス名を変更するためです

  9. バックアップした Cordova.plist にあった各設定, Plugins, ExternalHosts を新しい Cordova.plist に 統合 します

  10. バックアップした AppDelegate.h 及び AppDelegate.m にあったプロジェクト固有のコードを新しい AppDelegate ファイルに 統合 します。 AppDelegate.m の中の UIWebViewDelegate または CDVCommandDelegate にあったコードは MainViewController.m に移動します (詳しくはファイル中のコメントアウトされた箇所を参照してください)

  11. バックアップした MainViewController.h 及び MainViewController.m にあったプロジェクト固有のコードを新しい MainViewController ファイルに 統合 します

  12. Project Navigator の Project アイコン をクリックし、 Project を選択し、 "Build Settings" タブを選択します

  13. 検索フィールドに "Compiler for C/C++/Objective-C" と入力します

  14. "Apple LLVM Compiler 3.1" を選択します

1.4.x から 1.5.0 へのアップグレード

  1. Cordova 1.5.0 を インストール します
  2. 新規プロジェクトを作成し 一度実行します - この新規プロジェクトからアセットを持って行きます
  3. 新規プロジェクトから www/cordova-1.5.0.js ファイルを www フォルダーに コピー し、 www/cordova-1.5.x.js ファイルを削除します
  4. www/index.html ファイル (また、他に Cordova script を参照しているファイル) の Cordova script 参照部分を、新しい cordova-1.5.0.js ファイルを参照するように 更新 します
  5. Project Navigator から "PhoneGap.framework" を探し、選択します
  6. Delete キーを押して、 Project Navigator の中の "PhoneGap.framework" の参照を削除します
  7. Option-Command-A キーを押します。ファイルをプロジェクトに追加するためのドロップダウン画面 ("Add Files.." 画面) が開きます。 "Created groups for any added folders" のラジオボタンが選択されていることを確認します
  8. Shift-Command-G キーを押します。フォルダー移動のための別のドロップダウン画面 ("Go to the folder:" 画面) が開きます
  9. "/Users/Shared/Cordova/Frameworks/Cordova.framework" と入力し、 "Go" ボタンをクリックします
  10. "Add Files.." 画面 で "Add" ボタンをクリックします
  11. Project Navigator で "Cordova.framework" を選択 します
  12. File Inspector を開くため、 Option-Command-1 キーを押します
  13. Location のドロップダウンメニューのため、 File Inspector から "Absolute Path" を選択します
  14. Option-Command-A キーを押します。ファイルをプロジェクトに追加するためのドロップダウン画面 ("Add Files.." 画面) が開きます。 "Created groups for any added folders" のラジオボタンが選択されていることを確認します
  15. Shift-Command-G キーを押します。フォルダー移動のための別のドロップダウン画面 ("Go to the folder:" 画面) が開きます
  16. "~/Documents/CordovaLib/Classes/deprecated" と入力し、 "Go" ボタンをクリックします
  17. "Add Files.." 画面 で "Add" ボタンをクリックします

  18. AppDelegate.h, AppDelegate.m, MainViewController.h ファイルの #ifdef PHONEGAP_FRAMEWORK の部分を以下に置き換えます:

    #import "CDVDeprecated.h"

  19. Project Navigator の Project アイコン をクリックし、 Target を選択し、 "Build Settings" タブを選択します

  20. "Framework Search Paths" を探します

  21. 値を "/Users/Shared/Cordova/Frameworks" に置き換えます

  22. "Preprocessor Macros" を探します

  23. 最初の (複合の) 値を "CORDOVA_FRAMEWORK=YES" に置き換えます

  24. "Build Phases" タブを選択します

  25. "Run Script" を展開します

  26. すべての PhoneGap を Cordova に置き換えます

  27. Project Navigator から "PhoneGap.plist" を探し、ファイル名をクリックしてファイル名が編集可能な状態にします

  28. ファイル名の "PhoneGap.plist" を "Cordova.plist" に変更します

  29. "Cordova.plist" を右クリックし、"Open As" --> "Source Code" を選択します

  30. Option-Command-F キーを押し、 Source ウィンドウ左上のドロップダウンから "Replace" を選択します

  31. 検索文字に com.phonegap 、置換文字に org.apache.cordova を入力します。 "Replace All" ボタンをクリックします

  32. 検索文字に PG 、置換文字に CDV を入力します。 "Replace All" ボタンをクリックします

  33. Command-B キーを押してビルドします。まだいくつかの非推奨コードが残っていますが、これらは取り除くことができます (CDVDeprecated.h を参照してください。ソースコードの中のクラスを、 PG* から CDV* に変更するなどが方法として挙げられます)

1.4.0 から 1.4.1 へのアップグレード

  1. Cordova 1.4.1 を インストール します
  2. MainViewController.m の バックアップを作成します
  3. 新規プロジェクトを作成します - この新規プロジェクトからアセットを持って行きます
  4. MainViewController.m を 新しい プロジェクトから1.4.0ベースのプロジェクトのフォルダーにコピーし、古いファイルは 置き換え ます (上のステップ2でファイルを バックアップ します)
  5. MainViewController.m を Xcode プロジェクトに 追加 します
  6. バックアップした MainViewController.m にあったプロジェクト固有のコードを新しいファイルに 統合 します
  7. phonegap-X.X.X.js ファイルは任意で更新してください。 JavaScript の中身は、1.4.0と1.4.1で違いがありません

1.3.0 から 1.4.0 へのアップグレード

  1. Cordova 1.4.0 を インストール します
  2. AppDelegate.m と AppDelegate.h の バックアップを作成します
  3. 新規プロジェクトを作成します - この新規プロジェクトからアセットを持って行きます

  4. 以下のファイルを 新しい プロジェクトから1.3.0ベースのプロジェクトのフォルダーにコピーし、古いファイルは 置き換え ます (上のステップ2でファイルを バックアップ します):

    AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib

  5. すべての新しい MainViewController ファイルを Xcode プロジェクトに 追加 します

  6. 新規プロジェクトから www/phonegap-1.4.0.js ファイルを www フォルダーに コピー し、 www/phonegap-1.3.0.js ファイルを削除します

  7. www/index.html ファイル (また、他に Cordova script を参照しているファイル) の Cordova script 参照部分を、新しい phonegap-1.4.0.js ファイルを参照するように 更新 します

  8. PhoneGap.plist ファイルの Plugins の下に新しい要素を 追加 します - キーは com.phonegap.battery で値は PGBattery です

  9. バックアップした AppDelegate.h 及び AppDelegate.m にあったプロジェクト固有のコードを新しい AppDelegate ファイルに 統合 します