Hitoe Build
hitoeAPI.frameworkは、Xcode7.2.1以下でのみ動作する。
Hitoeと接続中にiOS端末のBluetoothをOFFにすると、アプリのプロセスをキルし、もう一度接続作業を行わないとデータの送受信ができない。
iOS HitoeプラグインのBuildに必要なパッケージは以下の通りです。
| プロジェクト | 説明 |
|---|---|
| DConnectSDK | dConnectSDKライブラリやリソース。 |
| DCMDevicePluginSDK | 共通化された拡張プロファイルを持つライブラリ。 |
| dConnectDeviceHitoe | iOS Hitoeプラグインのライブラリやリソース。 |
| 項目 | 説明 |
|---|---|
| Hitoe SDK for iOS | iOS端末からHitoeにアクセスするためのAPIを提供するSDK。 |
iOS DeviceConnectでは複数のXcodeプロジェクトが関わってくるため、それらプロジェクトを一元管理する為の共同作業スペースとしてXcodeのWorkspaceを用意します。
Workspaceの名称と保存場所は特に問いません。
「iOS HitoeのBuildに必要なパッケージ」で挙げた物のbuildを行う為にまずWorkspaceに「必要なパッケージ」のXcodeプロジェクトをImportする必要があります。
まず、Finder上のDConnectSDKのプロジェクトファイル「DConnectSDK.xcodeproj」を、先ほど用意したWorkspaceのプロジェクトナビゲーターにドラッグ＆ドロップしてプロジェクトをImportします。
正しくImportされた場合、ナビゲーターにDConnectSDKプロジェクトのファイル一式が表示されます。
そしてDConnectSDKと同じ手順でiOS Hitoeデバイスプラグインのプロジェクトファイル「dConnectDeviceHitoe.xcodeproj」をWorkspaceにImportします。
最終的にDConnectSDKとiOS Hitoeプラグインのファイル一式がナビゲーターに表示されれば完了です。
下記のページにて、所定の手順に従い、iOS用のSDKをダウンロードしてください。
https://dev.smt.docomo.ne.jp/?p=docs.api.page&api_name=iot_control&p_name=sdk#tag01
ダウンロード後、hitoeAPI.frameworkを以下の場所に配置してください。
{DeviceConnect-iOSルートディレクトリ}/dConnectDevicePlugin/dConnectDeviceHitoe
「プロジェクトのImport」で必要なパッケージをbuildする為のプロジェクトをImportしたことで、プロジェクトのファイル一式に加え、Workspaceにbuildターゲットという物が追加されます。
必要なパッケージの内、どれをbuildするかを選択するのに今回使うのがbuildターゲットとなります。
必要なパッケージの間にはbuildの依存関係があり、特にDConnectSDKはデバイスプラグインに先立ってbuildしなければなりません。
buildの依存関係を解決する形でのbuildターゲットのbuild順序は以下の様になります。
- DConnectSDK_framework
- DConnectSDK_resources
- DCMDevicePluginSDK_framework
- dConnectDeviceHitoe_framework
- dConnectDeviceHitoe_resources
そして作業しているXcodeのWorkspace内でのbuildターゲットの切り替え方法は、Xcodeのウィンドウの左上、RunやStopボタンの右にあるのが現在選択されているターゲットであり、そのターゲットをクリックする事で表示されるWorkspace内のbuildターゲット一覧から対象のbuildターゲットを選択する事でbuildターゲットの切り替えを行う事ができます。
あとは先ほど示したbuildターゲットのbuild順序でbuildを行う。buildを行うにはRunボタンを押すか、ショートカット⌘+Bを使う等して実行する事ができます。
また、各プロジェクトにはDebugとReleaseというbuild設定が有る。Debugbuild設定は開発段階のデバッグに適したパッケージのbuildを行い、Releasebuild設定はデバッグ情報を除いて処理速度や成果物のデータサイズが快適化される形式でのパッケージのbuildを行います。
このDebugやReleaseのbuild設定を切り替える方法だが、DConnectSDKを例に挙げれば、DConnectSDKのプロジェクトファイルを選択し各種プロジェクト情報を表示させます。
更にbuildターゲットの各種build情報を表示させるが、buildターゲットの一覧が非表示の際はその一覧を表示させた上で、フレームワーク（.framework拡張子ファイル）のbuildターゲットであるDConnectSDK_frameworkを選択し各種build設定を表示します。
buildターゲットDConnectSDK_frameworkを選択したらBuild Phaseタブを選択し、表示されたbuildの各フェーズの内、スクリプトを走らせるフェーズを表示します。そのスクリプトの内、CONFIGURATIONbuild環境変数を”Debug”なり”Release”なりに設定する事でDebug・Release buildを切り替える事ができます（何も設定されていない場合はDebugbuildになります）。
DConnectSDKとiOS Hitoeプラグインのプロジェクトが入ったディレクトリの下に、必要に応じて以下のような名称のディレクトリが生成されます。
- build
そして、DConnectSDKやiOS Hitoeプラグイン毎のプロジェクトディレクトリ以下、フレームワーク（.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/DCMDevicePluginSDK.framework
- （Debug時）build/Debug-framework/DCMDevicePluginSDK.framework
- （Release時）build/Release-framework/dConnectDeviceHitoe.framework
- （Debug時）build/Debug-framework/dConnectDeviceHitoe.framework
- （Release時）build/Release-resources/dConnectDeviceHitoe_resources.bundle
- （Debug時）build/Debug-resources/dConnectDeviceHitoe_resources.bundle
アプリを開発する際は、上記フレームワークとリンクさせ、バンドルをコピーさせるようにアプリのbuildターゲットで設定します。