iOS プラットフォーム ガイド

このガイドは、iPhone や iPad などの iOS デバイスのための Cordova アプリを展開する SDK の開発環境を設定する方法を示します。詳細なプラットフォーム固有の情報は、次を参照してください。

上記のコマンド ライン ツールはコルドバ 3.0 より前のバージョンを参照してください。現在のインタ フェースについての情報は、コマンド ライン インターフェイスを参照してください。

要件、およびサポート

Apple ® ツール インテル ベースの Mac OS X オペレーティング システム上でのみ実行 iOS アプリケーションを構築するために必要です。 OS X バージョン 10.9 (異端者) でのみ実行されます Xcode ® 6.0 (最低限必要なバージョン) 以上に設定すると、iOS 8 が含まれています SDK (ソフトウェア開発キット)。 アップルのアプリ Store℠ にアプリを提出するには、アップル ツールの最新バージョンが必要です。

多くの iOS SDK と Xcode のインストール iOS エミュレーターを使用してコルドバ機能をテストできますが、実際のデバイスを完全に App Store に提出する前にすべてのアプリのデバイス機能をテストする必要があります。 デバイスを少なくともいる必要があります iOS 6.x がインストールされて、コルドバ 3.0 現在サポートされている最小の iOS のバージョン。サポート デバイスなどがすべて計算された ® モデル、iPhone ® 3 gs と、上記と iPod ® タッチ第 3 世代またはそれ以降。 アプリをインストールするデバイス上に、アップルのiOS デベロッパー プログラム, そのコスト $99 1 年ごとのメンバーが必要です。 このガイド開発者プログラムに登録する必要はありません iOS エミュレーターにアプリケーションを展開する方法を示しています。

Ios の simios-deployツール - iOS のシミュレータに iOS アプリと iOS デバイスをコマンドラインから起動することができます。

SDK をインストールします。

Xcode をダウンロードする 2 つの方法があります。

Xcode をインストールすると、いくつかのコマンド ライン ツールはコルドバを実行するを有効にする必要があります。 Xcodeメニューから環境設定の [ダウンロード] タブを選択します。 [コンポーネント] パネルからコマンド ライン ツールの一覧の横にある [インストール] ボタンを押します。

インストール展開ツール

Comman ライン ・ ターミナルから実行します。

    $ npm install -g ios-sim
    $ npm install -g ios-deploy

新しいプロジェクトを作成します。

コルドバのコマンド ライン インターフェイスで説明されているように、新しいプロジェクトをセットアップするコルドバユーティリティを使用します。たとえば、ソース コード ディレクトリ: で

    $ コルドバ作成こんにちは com.example.hello"HelloWorld"$ cd こんにちは $ コルドバ プラットフォームは、ios を追加 $ コルドバ準備 # または"構築コルドバ"

アプリを展開します。

接続されている iOS デバイス上のアプリを展開。

    $ cordova run ios --device

デフォルト iOS エミュレーター上でアプリケーションを展開するには

    $ cordova emulate ios

使用することができますcordova run ios --listを見るすべての利用可能なターゲットとcordova run ios --target=target_name 、特定のデバイスまたはエミュレーターでアプリケーションを実行する (たとえば、cordova run ios --target="iPhone-6").

コルドバ実行 - ヘルプは、追加のビルドを表示し、オプションを実行するもできます。

SDK でプロジェクトを開く

Ios プラットフォームをプロジェクトに追加すると、Xcode の内でからそれを開くことができます。Hello/platforms/ios/hello.xcodeprojファイルを開くをダブルクリックします。このような画面になります。

エミュレーターに展開します。

: IOS のエミュレーターでアプリケーションをプレビューするには

  1. .Xcodeprojファイルが左側のパネルで選択されていることを確認してください。

  2. 右側のパネルでこんにちはアプリを選択します。

  3. ツールバーの配色メニューから目的のデバイスを選択します、iPhone などとして 6.0 シミュレータはここに強調:

  4. スキームの左側に同じツールバーに表示される実行ボタンを押します。 ビルド、配置、エミュレーターでアプリケーションを実行します。 独立したエミュレータ アプリケーションは、アプリを表示するが開きます。

    1 つだけのエミュレーターでは一度に実行可能性がありますので、別のエミュレーターでアプリケーションをテストする場合は、エミュレーターのアプリケーションを終了し、Xcode の内で別のターゲットを実行する必要があります。

Xcode は、iPhone および iPad の最新バージョン用のエミュレーターが付属しています。 古いバージョンはから入手できます、 Xcode → 設定 → ダウンロード → コンポーネントパネル。

デバイスへの配置します。

デバイスに展開する様々 な要件の詳細については、Apple のアプリ配布のワークフローについてあなたのアプリをデバイスの起動セクションを参照してください。 簡単に言えば、展開する前に以下を行う必要があります。

  1. アップルの iOS 開発者プログラムに参加します。

  2. プロビジョニング プロファイル iOS プロビジョニング ポータル内を作成します。 その開発のプロビジョニングのアシスタントを使用して作成し、プロファイルをインストールすることができ、Xcode の証明書が必要です。

  3. プロジェクトの設定内の [コード署名] セクションのコード署名 Idプロビジョニング プロファイル名に設定されていることを確認します。

デバイスに展開します。

  1. Mac にデバイスを接続するのに USB ケーブルを使用します。

  2. Xcode ウィンドウ方式のドロップ ダウン リストで、プロジェクトの名前を選択します。

  3. デバイスのドロップ ダウン リストからお使いのデバイスを選択します。それが USB 経由で接続されているがまだ表示されない場合、すべてのエラーを解決するために主催者ボタンを押します。

  4. ビルド、配置、およびお使いのデバイスでアプリケーションを実行する実行ボタンを押します。

一般的な問題

警告: アプリケーション プログラミング インターフェイス (API) を変更または別の API に置き換え、それとしてマークされますが使用されなくなりました。 API は、短期的に動作しますが、最終的に削除されます。 これらの非推奨インターフェイスは Apache コルドバに反映され、Xcode 問題それらについての警告をビルドしてアプリケーションを配置するとき。

Xcode の警告invokeString方法についてカスタム URL からアプリケーションを起動する機能にかかわる。 カスタム URL から読み込むためのメカニズムが変更されており、このコードはまだ存在している後方コルドバの古いバージョンで作成されたアプリの機能を提供します。 これらの警告を無視することができますので、サンプル アプリはこの機能を使用しません。 これらの警告が表示されないように、非推奨となった invokeString API を参照するコードを削除します。

  • Classes/MainViewController.mファイルを編集して、コードの次のブロックを囲む /* および */ 下図のように、そのタイプのコメントコマンドのファイルを保存します。

    (void)webViewDidFinishLoad:(UIWebView*)theWebView
    {
    // only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
    /*
    if (self.invokeString) {
      // this is passed before the deviceready event is fired, so you can access it in js when you receive deviceready
      NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url.");
      NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString];
      [theWebView stringByEvaluatingJavaScriptFromString:jsString];
    }
    */
    // Black base color for background matches the native apps
    theWebView.backgroundColor = [UIColor blackColor];
    
    return [super webViewDidFinishLoad:theWebView];
    }
    
  • 下図のように、2 つのスラッシュを挿入して次の行をコメント アウト、 Classes/AppViewDelegate.mファイルを編集し、コマンドのファイルを保存する入力します。

    //self.viewController.invokeString = invokeString;
    
  • コマンド + bボタンを押して、プロジェクトをリビルドし、警告を除去します。

不足しているヘッダー: 不足しているヘッダーに関するコンパイル エラー ビルドの場所との問題に起因して Xcode 設定を介して固定することができます。

  1. Xcode → 設定 → 場所を選択します.

  2. 派生データ] セクションで、詳細設定ボタンを押しますをここに示すようにビルド場所としてユニークなを選択します。

これは新しい Xcode のインストールの既定の設定が異なる Xcode の旧バージョンからのアップグレード、次を設定可能性があります。

詳細は、Apple のドキュメントを参照してください。

(Mac ® OS X ® アップル ®、Xcode ® アプリ Store℠、iPad ®、iPhone ®、iPod ® ファインダー ® はアップル社の商標です)