license: 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.

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

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

  • iOS 構成
  • IOS のアップグレード
  • iOS の web 表示
  • iOS のプラグイン
  • iOS コマンド ライン ツール

上記のコマンド ライン ツールはコルドバ 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 エミュレーターにアプリケーションを展開する方法を示しています。

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

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

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

SDK でプロジェクトを開く

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

    $ cordova create hello com.example.hello "HelloWorld"
    $ cd hello
    $ cordova platform add ios
    $ cordova prepare              # or "cordova build"

作成後は、Xcode の内でからそれを開くことができます。ダブルクリックして開き、 hello/platforms/ios/hello.xcodeproj ファイル。このような画面になります。

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

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

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

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

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

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

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

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

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

デバイスに展開するさまざまな要件の詳細については Apple のiOS 用ツール ワークフロー ガイド構成の開発と配布の資産セクションを参照してください。 簡単に言えば、展開する前に以下を行う必要があります。

  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 {//___PROJECTNAME__ Info.plist を処理するプロトコルを指定した場合にのみ有効/* 場合 (self.invokeString) {//deviceready NSLog を受信したときの js でアクセスすることができますので、deviceready イベントが発生する前に渡されます (@"非推奨: window.invokeString - 常によばれるカスタム スキームの url を使用してアプリを起動したとき、代わりに window.handleOpenURL(url) 関数を使用します");。NSString * jsString = [NSString stringWithFormat:@"var invokeString = \"% @\「;」、self.invokeString];[theWebView stringByEvaluatingJavaScriptFromString:jsString];} *//黒の基本色/背景に一致するネイティブ アプリ theWebView.backgroundColor = [UIColor blackColor];[スーパー 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 ® ファインダー ® はアップル社の商標です)