Click here for description of English.
DeviceConnect-AndroidはAndroid版のDevice Connectシステムのプラットフォームになります。
ここでは、以下のことについて解説していきます。
- クイックスタート
- プロジェクトの説明
- Device Connectアプリケーションの開発
- Device Connect SDKのJavadoc出力
- ビルドマニュアル
Device Connect システムについての詳細な説明は、こちらを参照してください。
Device Connect Managerをビルドして、簡単に動作させるまでを解説します。
ここでは、以下のコマンドがインストールされていることを前提としています。
- curl
- git
- adb
- Android SDK
DeviceConnect-Androidのソースコードをダウンロードしてください。
$ git clone https://github.com/DeviceConnect/DeviceConnect-Android.git
ビルド前にANDROID_HOMEの環境変数にAndroidSDKへのパスが設定されていることを確認してください。
$ echo 'export ANDROID_HOME=<path>' >> ~/.bash_profile
<path>には、AndroidSDKへのパスを指定してください。
Device Connect Managerをビルドしてapkを作成します。
$ cd DeviceConnect-Android/dConnectManager/dConnectManager
$ ./gradlew assembleDebug
Device Connect Managerを端末にインストールします。
$ adb install app/build/outputs/apk/app-debug.apk
DeviceConnect-Androidのソースコードをダウンロードしてください。
> git clone https://github.com/DeviceConnect/DeviceConnect-Android.git
ビルド前にANDROID_HOMEの環境変数にAndroidSDKへのパスが設定されていることを確認してください。
> setx ANDROID_HOME <path>
<path>には、AndroidSDKへのパスを指定してください。
Device Connect Managerをビルドしてapkを作成します。
> cd DeviceConnect-Android/dConnectManager/dConnectManager
> gradlew.bat assembleDebug
Device Connect Managerを端末にインストールします。
> adb install app/build/outputs/apk/app-debug.apk
Android端末のアプリケーション一覧画面から、Device Connect Managerのアイコンをタップして、起動します。
Device Connect Managerの画面が開いたら、メニューバーに存在するスイッチをONに変更し、Device Connect Managerを起動します。
画面にHostが表示されれば、起動したことが確認できます。
Hostが表示されない場合には、サービスを検索ボタンを押下してください。
外部のPCからアクセスしたい場合には、Device Connect Managerの設定画面で外部IPを許可を有効にしてからDevice Connect Managerを再起動します。
IPアドレスをDevice Connect Managerの設定画面で表示されているHostの値に設定して、以下のCURLコマンドを実行します。
curl -X GET \
-H 'Origin: localhost' \
https://192.168.xxx.xxx:4035/gotapi/availability
以下のようなレスポンスが返却されれば、Device Connect Managerが起動していることを確認することができます。
{
"result" : 0,
"product" : "Device Connect Manager",
"version":"v2.1.0
}
| プロジェクト名 | 内容 |
|---|---|
| dConnectDeviceAllJoyn | AllJoynのデバイスプラグイン。 |
| dConnectDeviceAndroidWear | AndroidWearのデバイスプラグイン。 |
| dConnectDeviceChromeCast | Chromecastのデバイスプラグイン。 |
| dConnectDeviceFaBo | FaBoのデバイスプラグイン。 |
| dConnectDeviceFPLUG | F-PLUGのデバイスプラグイン。 |
| dConnectDeviceHeartRate | Mio AlphaなどのHeartRateのデバイスプラグイン。 |
| dConnectDeviceHitoe | Hitoeのデバイスプラグイン。 |
| dConnectDeviceHOGP | HOGPのデバイスプラグイン。 |
| dConnectDeviceHost | Androidのデバイスプラグイン。 |
| dConnectDeviceHue | Hueのデバイスプラグイン。 |
| dConnectDeviceHVC | HVC-Cのデバイスプラグイン。 |
| dConnectDeviceHVCC2W | HVC-C2Wのデバイスプラグイン。 |
| dConnectDeviceHVCP | HVC-Pのデバイスプラグイン。 |
| dConnectDeviceIRKit | IRKitのデバイスプラグイン。 |
| dConnectDeviceKadecot | Kadecotのデバイスプラグイン。 |
| dConnectDeviceLinking | Linkingのデバイスプラグイン。 |
| dConnectDevicePebble | Pebbleのデバイスプラグイン。 |
| dConnectDeviceSonyCamera | QX10などのSonyCameraのデバイスプラグイン。 |
| dConnectDeviceSonySW | SonySmartWatchデバイスプラグイン。 ※SmartWatch3は未対応。 |
| dConnectDeviceSphero | Spheroのデバイスプラグイン。 |
| dConnectDeviceTheta | THETAのデバイスプラグイン。 |
| dConnectDeviceUVC | UVCカメラのデバイスプラグイン。 |
| dConnectDeviceTest | DeviceConnectのテスト用のデバイスプラグイン。 |
| dConnectDevicePluginSDK | DevicePluginを作成するためのSDK。 dConnectSDKForAndroidが必要。 |
| プロジェクト名 | 内容 |
|---|---|
| dConnectManager | DeviceConnectのプラットフォーム本体。 |
| dConnectServer | DeviceConnectのWebサーバのインターフェースを定義したライブラリ。 |
| dConnectServerNanoHttpd | dConnectServerのインターフェースを実装したWebサーバのライブラリ。 |
| プロジェクト名 | 内容 |
|---|---|
| dConnectApp | DeviceConnectの動作確認用アプリ。 |
| dConnectSDKForAndroid | DeviceConnectのSDK。DevicePlugin開発とアプリ開発用に使用するSDK。 |
Android版Device Connectを使用したアプリケーション開発および、デバイスプラグイン開発に関しましては、以下のページを参考にしてください。
-
アプリケーション開発マニュアル
Device Connect Managerを使用したアプリケーションを開発したい場合には、こちらのアプリケーション開発マニュアルをご参照ください。 -
デバイスプラグイン開発マニュアル
Device Connect Managerに対応したデバイスプラグインを開発したい場合には、こちらのデバイスプラグイン開発マニュアルをご参照ください。
$ cd DeviceConnect-Android/dConnectSDK/dConnectSDKForAndroid
$ ./gradlew generateJavadocForSDK
> cd DeviceConnect-Android/dConnectSDK/dConnectSDKForAndroid
> gradlew.bat generateJavadocForSDK
gradleを実行したディレクトリにDeviceConnectSDK-Javadocが作成され、Device Connect SDKのJavadocが出力されます。
$ cd DeviceConnect-Android/dConnectDevicePlugin/dConnectDevicePluginSDK
$ ./gradlew generateJavadocForPlugin
> cd DeviceConnect-Android/dConnectDevicePlugin/dConnectDevicePluginSDK
> gradlew.bat generateJavadocForPlugin
gradleを実行したディレクトリにDevicePluginSDK-Javadocが作成され、Device Plugin SDKのJavadocが出力されます。
Device Connect Managerや各デバイスプラグインを開発したい人は、こちらのビルド手順書に従ってビルドしてください。