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

新規プロジェクトの作成

• 'Cordova-2.0.0.pkg' インストーラーを実行し、インストールを完了します

• bin フォルダー (ソース、もしくは .dmg から) をハードドライブ上にコピーします

  

• Terminal.app を起動します

• コピーした 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] (http://developer.apple.com/iphone/manage/overview/index.action) よりアプリを登録できます
• ツールバーにあるドロップダウンメニューから Target を "HelloWorld" (あなたのプロジェクト名) に変更します

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

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

  

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

結果

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

  

Xcode の問題

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

また、 Cordova-2.0.0.pkg をインストールする時、 Xcode が起動していないことを確認擦る必要があります。もし起動していた場合は、 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