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 よりアプリを登録できます
- ツールバーにあるドロップダウンメニューから 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