Linking Build
iOS LinkingデバイスプラグインのBuildに必要なパッケージは以下の通りです。
| プロジェクト | 説明 |
|---|---|
| DConnectSDK | dConnectSDKライブラリやリソース。 |
| DCMDevicePluginSDK | 共通化された拡張プロファイルを持つライブラリ。 |
| dConnectDeviceLinking | iOS Linkingデバイスプラグインのライブラリやリソース。 |
| 項目 | 説明 |
|---|---|
| Linking SDK for iOS | iOS端末からLinkingデバイスにアクセスするためのAPIを提供するSDK。 |
iOS DeviceConnectでは複数のXcodeプロジェクトが関わってくるため、それらプロジェクトを一元管理する為の共同作業スペースとしてXcodeのWorkspaceを用意します。
Workspaceの名称と保存場所は特に問いません。
「iOS LinkingデバイスプラグインのBuildに必要なパッケージ」で挙げた物のbuildを行う為にまずWorkspaceに「必要なパッケージ」のXcodeプロジェクトをImportする必要があります。
まず、Finder上のDConnectSDKのプロジェクトファイル「DConnectSDK.xcodeproj」を、先ほど用意したWorkspaceのプロジェクトナビゲーターにドラッグ＆ドロップしてプロジェクトをImportします。
正しくImportされた場合、ナビゲーターにDConnectSDKプロジェクトのファイル一式が表示されます。
そして、DConnectSDKと同じ手順で DCMDevicePluginSDKのプロジェクトファイル「DCMDevicePluginSDK.xcodeproj」とiOS Linkingデバイスプラグインのプロジェクトファイル「dConnectDeviceLinking.xcodeproj」をWorkspaceにImportします。
最終的にDConnectSDK、DCMDevicePluginSDKとiOS Linkingデバイスプラグインのファイル一式がナビゲーターに表示されれば完了です。
下記のページにて、所定の手順に従い、iOS用のSDKをダウンロードしてください。
※開発当時は2.0.0バージョンを使用しています。
ダウンロード後、PC上の任意の場所で解凍してください。以下、解凍したフォルダのパスを{Linking SDK}とします。
現在の最新版 (v2.0.0) では、下記のフォルダにSDKのフレームワークが配置されています。
{Linking SDK}/Release.zip
Release.zipを解凍し、できたReleaseディレクトリごと、{レポジトリフォルダ}/dConnectDevicePlugin/dConnectDeviceLinking/Libsにコピーします。
「プロジェクトのImport」で必要なパッケージをbuildする為のプロジェクトをImportしたことで、プロジェクトのファイル一式に加え、Workspaceにbuildターゲットという物が追加されます。
必要なパッケージの内、どれをbuildするかを選択するのに今回使うのがbuildターゲットとなります。
必要なパッケージの間にはbuildの依存関係があり、特にDConnectSDKはデバイスプラグインに先立ってbuildしなければなりません。
buildの依存関係を解決する形でのbuildターゲットのbuild順序は以下の様になります。
- DConnectSDK_framework
- DCMDevicePluginSDK_framework
- dConnectDeviceLinking_framework
そして作業している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 環境変数を”Debug”なり”Release”なりに設定する事でDebug・Release buildを切り替える事ができます（何も設定されていない場合はDebug buildになります）。
DConnectSDKとiOS Linkingデバイスプラグインのプロジェクトが入ったディレクトリの下に、必要に応じて以下のような名称のディレクトリが生成されます。
- bin
そして、DConnectSDKやiOS Linkingデバイスプラグイン毎のプロジェクトディレクトリ以下、フレームワーク（.framework拡張子ファイル）やバンドル（.bundle拡張子ファイル）がbuildされています。
buildに失敗する場合は設定ミスの可能性があるので確認してください。
- bin/DConnectSDK.framework
- bin/DConnectSDK_resources.bundle
- bin/DCMDevicePluginSDK.framework
- bin/dConnectDeviceLinking.framework
- bin/dConnectDeviceLinking_resources.bundle
アプリを開発する際は、上記フレームワークとリンクさせ、バンドルをコピーさせるようにアプリのbuildターゲットで設定します。