Getting Started with iOS

このガイドは、 Apache Cordova のための開発環境セットアップ方法、また Apache Cordova のサンプルアプリの動かし方を解説します。

必要なもの

  • Xcode 4.3+
  • Xcode コマンドラインツール
  • Intel ベースの Mac OS X Lion 以上 (10.7+)
  • デバイスへのインストールに必要なもの:
    • Apple iOS デバイス (iPhone, iPad, iPod Touch)
    • iOS デベロッパー証明書

SDK と Apache Cordova のインストール

  • Mac App Store または Apple Developer Downloads から Xcode をインストールします。
  • Xcode コマンドラインツール (Xcode Preferences -> Downloads -> Components -> Command Line Tools -> Install) をインストールします。
  • Apache Cordova の最新版をダウンロードします。
    • ダウンロードしたものを解凍します
    • Apache Corder iOS は lib/ios ディレクトリ以下にあります

CordovaLib のインストール

  1. Cordova を ダウンロード します
  2. ダウンロードしたものを、ハードディスクの恒久的な場所に 解凍 します (例: ~/Documents/CordovaLib-2.X.X)
  3. Step 3 はありません

新規プロジェクトの作成

  • Terminal.app を起動します
  • (上の CordovaLib のインストール セクションで解凍した恒久的な場所にある) bin フォルダーを Dock にある Terminal.app のアイコンにドラッグします。これにより、新しいターミナルのウィンドウが開きます

  • ./create <project_folder_path> <bundle_id> <project_name> を入力し、 "Enter" を押します

    <project_folder_path> は新しい Cordova iOS プロジェクトへのパスを表します (もし既に存在する場合は、空である必要があります)
<package_name> はリバースドメインスタイルのパッケージ名を表します
<project_name> はプロジェクト名を表します

  • たった今作成した新しいプロジェクトフォルダーを 見つけます

  • フォルダーの中の .xcodeproj を 起動します

シミュレーターへのデプロイ

  • ツールバーにあるドロップダウンメニューから Target を "HelloWorld" (あなたのプロジェクト名) に変更します

  • ツールバーにあるドロップダウンメニューから Active SDK を iOS [version] Simulator に変更します

  • プロジェクトウィンドウのツールバーにある Run ボタンをクリックします

デバイスへのデプロイ

  • Resources グループの中にある HelloWorld-Info.plist を開きます
  • BundleIdentifier を Apple から提供された Identifer 、または自分の Identifer に変更します
    • もし開発者ライセンスを持っている場合は、 Assistant よりアプリを登録できます
  • ツールバーにあるドロップダウンメニューから Target を "HelloWorld" (あなたのプロジェクト名) に変更します

  • ツールバーにあるドロップダウンメニューから Active SDK を [あなたのDevice名] に変更します

    • デバイスを USB で接続する必要があります

  • プロジェクトウィンドウのツールバーにある Run ボタンをクリックします

結果

  • 緑色の点滅した "device is ready" のメッセージを伴った画面が見えるはずです

Xcode の問題

もしヘッダーが無いなどに関連した編集での問題がある場合、ビルドプロダクトは 同じビルドディレクトリでビルドする 必要があります。"Xcode Preferences -> Locations -> Derived Data -> Advanced…" の設定を "Unique" に変更する必要があるかもしれません。これは Xcode をインストールした直後のデフォルト設定ですが、もし古いバージョンからアップグレードした場合は昔の設定が残っており、その場合はアップデートする必要があります。

アプリを作成

これで Xcode プロジェクトのセットアップが完了し、シミュレーターまたはデバイスでビルドし動かすことが出来ます。 アプリを書くために、 Xcode を使用する必要はありません。 あなたの好きなテキストエディターを使い、 Xcode 、またはプロジェクトフォルダ (cordova サブフォルダー) 内で コマンドラインツール でリビルド作業を行えます。 Xcode は自動的に www ディレクトリ内にあるファイルの変化を検出します。

コマンドラインツールの問題

もし "Error: No developer directory found at /Developer. Run /usr/bin/xcode-select to update the developer directory path." というエラーを見る場合、 Developer フォルダーを設定するために以下を実行してください:

sudo /usr/bin/xcode-select -switch /Applications/Xcode.app/Contents/Developer