IRKit Build
- 1. Buildに必要なパッケージ
- 2. Xcode側の準備
- 3. プロジェクトのImport
- 4. 必要なパッケージのBuild
- 5. Buildされたパッケージの確認
- 6. IRKitのAPI Keyの取得方法
iOS IRKitプラグインのBuildに必要なパッケージは以下の通りになります。
| プロジェクト | 説明 |
|---|---|
| DConnectSDK | dConnectSDKライブラリやリソース。 |
| dConnectDeviceIRKit | iOS IRKitデバイスプラグイン。 |
iOS DeviceConnectでは複数のXcodeプロジェクトが関わってくるので、それらプロジェクトを一元管理する為の共同作業スペースとしてXcodeのWorkspaceを用意します。
Workspaceの名称と保存場所は特に問いません。
「iOS IRKitのBuildに必要なパッケージ」で挙げた物のbuildを行う為にまず、Workspaceに「必要なパッケージ」のXcodeプロジェクトをImportする必要があります。
まず、Finder上のdConnectSDKのプロジェクトファイル「dConnectSDK.xcodeproj」を、先ほど用意したWorkspaceのプロジェクトナビゲーターにドラッグ＆ドロップしてプロジェクトをImportすること。
正しくImportされた場合、ナビゲーターにdConnectSDKプロジェクトのファイル一式が表示されます。
そしてdConnectSDKと同じ手順でiOS IRKitデバイスプラグインのプロジェクトファイル「dConnectDeviceIRKit.xcodeproj」をWorkspaceにImportする。
最終的にdConnectSDKとiOS IRKitデバイスプラグインのファイル一式がナビゲーターに表示されれば完了です。
「プロジェクトのImport」で必要なパッケージをbuildする為のプロジェクトをImportしたことで、プロジェクトのファイル一式に加え、Workspaceにbuildターゲットという物が追加されます。
必要なパッケージの内、どれをbuildするかを選択するのに今回使うのがbuildターゲットとなります。
必要なパッケージの間にはbuildの依存関係があり、特にDConnectSDKはデバイスプラグインに先立ってbuildしなければならない。
buildの依存関係を解決する形でのbuildターゲットのbuild順序は以下の様になります。
- DConnectSDK_framework
- DConnectSDK_framework
- dConnectDeviceIRKit_framework
- dConnectDeviceIRKit_resources
そして作業しているXcodeのWorkspace内でのbuildターゲットの切り替え方法だが、Xcodeのウィンドウの左上、RunやStopボタンの右にあるのが現在選択されているターゲットであり、そのターゲットをクリックする事で表示されるWorkspace内のbuildターゲット一覧から対象のbuildターゲットを選択する事でbuildターゲットの切り替えを行う事ができます。
あとは先ほど示したbuildターゲットのbuild順序でbuildを行うこと。
buildを行うにはRunボタンを押すか、ショートカット⌘+Bを使う等して実行する事ができます。
また、各プロジェクトにはDebugとReleaseというbuild設定があります。Debug build設定は開発段階のデバッグに適したパッケージのbuildを行い、Release build設定はデバッグ情報を除いて処理速度や成果物のデータサイズが快適化される形式でのパッケージのbuildを行います。
このDebugやReleaseのbuild設定を切り替える方法だが、DConnectSDKを例に挙げれば、DConnectSDKのプロジェクトファイルを選択し各種プロジェクト情報を表示させます。
更にbuildターゲットの各種build情報を表示させるが、buildターゲットの一覧が非表示の際はその一覧を表示させた上で、フレームワーク（.framework拡張子ファイル）のbuildターゲットであるDConnectSDK_frameworkを選択し各種build設定を表示してください。
buildターゲットDConnectSDK_frameworkを選択したらBuild Phaseタブを選択し、表示されたbuildの各フェーズの内、スクリプトを走らせるフェーズを表示します。
そのスクリプトの内、CONFIGURATION build環境変数を”Debug”なり”Release”なりに設定する事でDebug・Release buildを切り替える事ができます（何も設定されていない場合はDebug buildになります）。
DConnectSDKとiOS IRKitデバイスプラグインのプロジェクトが入ったディレクトリの下に、必要に応じて以下のような名称のディレクトリが生成されます。
- build
そして、DConnectSDKやiOS IRKitデバイスプラグイン毎のプロジェクトディレクトリ以下、フレームワーク（.framework拡張子ファイル）やバンドル（.bundle拡張子ファイル）がbuildされます。
buildに失敗する場合は設定ミスの可能性があるので確認してください。
- （Release時）build/Release-framework/DConnectSDK.framework
- （Debug時）build/Debug-framework/DConnectSDK.framework
- （Release時）build/Release-resources/DConnectSDK_resources.bundle
- （Debug時）build/Debug-resources/DConnectSDK_resources.bundle
- （Release時）build/Release-framework/dConnectDeviceIRKit.framework
- （Debug時）build/Debug-framework/dConnectDeviceIRKit.framework
- （Release時）build/Release-resources/dConnectDeviceIRKit_resources.bundle
- （Debug時）build/Debug-resources/dConnectDeviceIRKit_resources.bundle
アプリを開発する際は、上記フレームワークとリンクさせ、バンドルをコピーさせるようにアプリのbuildターゲットで設定します。
IRKitでは、API Keyを取得しなければなりません。
こちらの方法でAPI Keyを取得してください。
http://getirkit.com/#IRKit-Internet-POST-1-apps
プロジェクトのResourcesのdConnectDeviceIRKit-Info.plistの以下の部分を書き換える必要があります。
