メインコンテンツまでスキップ

開発者向けスタートガイド

開発用に XREAL AURA をセットアップします。

前提条件​

開始前に次のものを準備してください。

  • XREAL AURA（グラス + Compute Puck）
  • 開発用パソコン（Windows、macOS、Linux）
  • Android Studio（最新安定版）のインストール
  • USB-C ケーブル（高品質でデータ通信対応）
  • Play ストアとサービス用の Google アカウント

手順1：Android Studio を設定する​

Android XR SDK のインストール​

  1. Android Studio を開きます。
  2. SDK Manager を開きます（Tools > SDK Manager）。
  3. SDK Platforms タブを選択します。
  4. Android 15（API 35）以降にチェックを入れます。
  5. SDK Tools タブを選択します。
  6. 次のものをインストールします。
    • Android SDK Build-Tools
    • Android Emulator
    • Android XR 拡張機能（利用可能な場合）

XR エミュレータープロファイルのインストール​

実機を使わずにテストする場合：

  1. Android Studio で Device Manager を開きます。
  2. 新しい仮想デバイスを作成します。
  3. XR デバイスプロファイルを選択します。
  4. Android XR システムイメージを選択します。
  5. XREAL のシミュレーション用に OST 設定を構成します。

手順2：デバイスで開発者モードを有効にする​

XREAL AURA で次の操作を行います。

  1. 設定を開きます（ランチャーを開く > 設定）。
  2. デバイス情報に進みます。
  3. ビルド番号を7回タップします。
  4. 「開発者モードが有効になりました」と表示されます。
  5. 設定に戻ります。
  6. 新しく表示された開発者向けオプションを開きます。
  7. USB デバッグを有効にします。

手順3：デバイスをパソコンに接続する​

  1. グラスは Compute Puck 右側のグラス用ポートに接続したままにします。
  2. パソコンから Compute Puck 左側の充電ポートに USB-C ケーブルを接続します。
important

グラス用ポートと充電ポートは、どちらも ADB デバッグの全機能に対応しています。充電ポートを使用すると、グラスで画面を見ながら有線デバッグを行えます。

手順4：最初のアプリをビルドして配置する​

新しいプロジェクトの作成​

  1. Android Studio で New Project を選択します
  2. XR Activity テンプレート（利用可能な場合）または Empty Activity を選択します
  3. 最小 SDK を API 35 に設定します
  4. プログラミング言語に Kotlin を選択します

XR 依存関係の設定​

build.gradle.kts ファイル内で設定します。

android {
    defaultConfig {
        minSdk = 35
        targetSdk = 35
    }
}

dependencies {
    // Add XR dependencies
    implementation("androidx.xr:xr-compose:1.0.0")
    // ... other dependencies
}

デバイスへの配置​

  1. デバイスのドロップダウンから接続したデバイスを選択します
  2. Run（緑色の再生ボタン）をクリックします
  3. ビルドとインストールの完了を待ちます
  4. グラスを装着してアプリの動作を確認します

次のステップ​

トラブルシューティング​

問題解決方法
デバイスが認識されないケーブルを確認し、別の USB ポートを試してください
状態に「Unauthorized」と表示されるデバイスの USB デバッグ確認画面で「許可」をタップしてください
ビルドに失敗するAndroid Studio と SDK プラットフォームツールを更新してください
起動時にアプリがクラッシュするlogcat でエラーの詳細とスタックトレースを確認してください
グラスの画面が表示されないADB セッションの終了後、グラスを接続し直してください

さらにサポートが必要な場合は、XREAL 開発者 Discordをご利用ください。