Theta Build
iOS ThetaプラグインのBuildに必要なパッケージは以下の通りです。
| プロジェクト | 説明 |
|---|---|
| DConnectSDK | dConnectSDKライブラリやリソース。 |
| dConnectDeviceTheta | iOS Thetaプラグインのライブラリやリソース。 |
| 項目 | 説明 |
|---|---|
| RICOH THETA SDK for iOS | iOS端末からRICOH THETAにアクセスするためのAPIを提供するSDK。 |
iOS DeviceConnectでは複数のXcodeプロジェクトが関わってくるため、それらプロジェクトを一元管理する為の共同作業スペースとしてXcodeのWorkspaceを用意します。
「iOS ThetaのBuildに必要なパッケージ」で挙げた物のbuildを行う為にまずWorkspaceに「必要なパッケージ」のXcodeプロジェクトをImportする必要があります。
まず、Finder上のDConnectSDKのプロジェクトファイル「DConnectSDK.xcodeproj」を、先ほど用意したWorkspaceのプロジェクトナビゲーターにドラッグ＆ドロップしてプロジェクトをImportします。
正しくImportされた場合、ナビゲーターにDConnectSDKプロジェクトのファイル一式が表示されます。
そしてDConnectSDKと同じ手順でiOS Thetaデバイスプラグインのプロジェクトファイル「dConnectDeviceTheta.xcodeproj」をWorkspaceにImportします。
最終的にDConnectSDKとiOS Thetaプラグインのファイル一式がナビゲーターに表示されれば完了です。
下記のページにて、所定の手順に従い、iOS用のSDKをダウンロードしてください。
※開発当時は0.2.1バージョンを使用しています。
https://developers.theta360.com/ja/docs/sdk/download.html
ダウンロード後、PC上の任意の場所に解凍してください。
以下、解凍したフォルダのパスを{THETA SDK}とします。
現在の最新版 (v0.3.0) では、下記のフォルダにSDKのソースファイルが配置されています。
{THETA SDK}/RICOH_THETA_SDK_for_iOS.0.3.0/lib
Thetaプロジェクトにlibディレクトリをコピーし、このディレクトリのソースコードをXcode上でdConnectDeviceThetaのプロジェクトにインポートします。
{レポジトリフォルダ}/dConnectDevicePlugin/dConnectDeviceTheta/dConnectDeviceTheta/Classes/lib
以上により、外部SDKへの依存関係が解決されます。
「プロジェクトのImport」で必要なパッケージをbuildする為のプロジェクトをImportしたことで、プロジェクトのファイル一式に加え、Workspaceにbuildターゲットという物が追加されます。
必要なパッケージの内、どれをbuildするかを選択するのに今回使うのがbuildターゲットとなります。
必要なパッケージの間にはbuildの依存関係があり、特にDConnectSDKはデバイスプラグインに先立ってbuildしなければなりません。
buildの依存関係を解決する形でのbuildターゲットのbuild順序は以下の様になります。
- DConnectSDK_framework
- DConnectSDK_resources
- dConnectDeviceTheta_framework
- dConnectDeviceTheta_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 Thetaプラグインのプロジェクトが入ったディレクトリの下に、必要に応じて以下のような名称のディレクトリが生成されます。
- build
そして、DConnectSDKやiOS Thetaプラグイン毎のプロジェクトディレクトリ以下、フレームワーク（.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/dConnectDeviceTheta.framework
- （Debug時）build/Debug-framework/dConnectDeviceTheta.framework
- （Release時）build/Release-resources/dConnectDeviceTheta_resources.bundle
- （Debug時）build/Debug-resources/dConnectDeviceTheta_resources.bundle
アプリを開発する際は、上記フレームワークとリンクさせ、バンドルをコピーさせるようにアプリのbuildターゲットで設定します。