**Show HN:** ARM64 Android 開発キット

AADK Full Scaffold（完全スキャフォールド）

Android DevKit スタイルのワークフロー向けに、GUI ファーストでマルチサービス gRPC を採用した scaffolding です。
GTK UI と CLI は薄いクライアントで、実際の処理はすべてサービス（crates）内にあります。

JobService

対応ホスト

x86_64

アーキテクチャ概要

GTK4 UI + CLI  →  gRPC サービス（ビジネスロジックなし）
└─ JobService   – ジョブレコードを保持し、履歴再生とライブイベントストリームを提供
    ├─ Toolchain/Build/Targets/Observe services はジョブを生成し JobService に送信
    ├─ ObserveService  – 実行履歴＋出力インベントリ（バンドル／アーティファクト）を保存し、ダッシュボード用サマリーポインタを保持
    ├─ ProjectService  – プロジェクトメタデータとテンプレートスキャフォールドの真実源
    └─ WorkflowService – マルチステップパイプラインを調整し、可観測性のためにランレコードを upsert

ソースマップ（主要エントリポイント）

crates/aadk-core/src/main.rs

crates/aadk-workflow/src/main.rs

crates/aadk-toolchain/src/main.rs

crates/aadk-project/src/main.rs

crates/aadk-build/src/main.rs

crates/aadk-targets/src/main.rs

crates/aadk-observe/src/main.rs

crates/aadk-ui/src/main.rs

crates/aadk-cli/src/main.rs

Proto 契約:

proto/aadk/v1

crates/aadk-proto

scripts/dev/run-all.sh

AGENTS.md

AGENTS.md

ランタイムトポロジー

デフォルトアドレス（環境変数で上書き可）：

AADK_JOB_ADDR

AADK_TOOLCHAIN_ADDR

AADK_PROJECT_ADDR

AADK_BUILD_ADDR

AADK_TARGETS_ADDR

AADK_OBSERVE_ADDR

AADK_WORKFLOW_ADDR

データと状態の保存場所

Jobs                     ~/.local/share/aadk/state/jobs.json
UI config                ~/.local/share/aadk/state/ui-config.json
CLI config               ~/.local/share/aadk/state/cli-config.json
Toolchains               ~/.local/share/aadk/state/toolchains.json
Toolchain downloads      ~/.local/share/aadk/downloads
Toolchain installs       ~/.local/share/aadk/toolchains
Projects                 ~/.local/share/aadk/state/projects.json
Project metadata         <project>/.aadk/project.json
Builds                   ~/.local/share/aadk/state/builds.json
Observe runs             ~/.local/share/aadk/state/observe.json
Observe bundles          ~/.local/share/aadk/bundles
UI/CLI log exports       ~/.local/share/aadk/state/*-job-export-*.json

サードパーティのインベントリは必要に応じてダウンロードされます。
レポジトリ自体は第三者ツールチェーンをバンドルしておらず、サービスが要求時にダウンロードまたは実行します。

Android SDK/NDK カスタムアーカイブ

https://github.com/HomuHomu833/android-sdk-custom/releases/download/36.0.0/android-sdk-aarch64-linux-musl.tar.xz

https://github.com/HomuHomu833/android-sdk-custom/releases/download/35.0.2/android-sdk-aarch64-linux-musl.tar.xz

https://github.com/HomuHomu833/android-sdk-custom/releases/download/36.0.0/android-sdk-aarch64_be-linux-musl.tar.xz

（完全リストは省略。詳細は元文書参照）

Windows ARM64 NDK アーカイブの解凍には 7‑zip が必要です。
現在、Darwin SDK/NDK アーティファクトはカスタムカタログに公開されていません。

MIT ライセンスで配布されていますが、再配布を検討する場合は上流の Android SDK/NDK の利用規約をご確認ください。

Cuttlefish ホストツール

• デフォルトでは Debian/Ubuntu 用

  android-cuttlefish

  apt リポジトリを使用：
  

  https://us-apt.pkg.dev/projects/android-cuttlefish-artifacts

  。
  他ディストリビューションは

  AADK_CUTTLEFISH_INSTALL_CMD

  で上書き可能。
• Cuttlefish イメージは

  ci.android.com / android-ci.googleusercontent.com

  から取得。
• Gradle は

  gradlew

  またはシステムの Gradle を使用。

• adb/platform-tools

  は Android SDK 又は Cuttlefish ホストツールから入手。

クイックスタート（Debian 13 aarch64）

1. システム依存パッケージ

   sudo apt update
   sudo apt install -y build-essential pkg-config libgtk-4-dev protobuf-compiler git curl xz-utils zstd
   

2. Rust ツールチェーン（必要に応じて）

   curl https://sh.rustup.rs -sSf | sh
   source "$HOME/.cargo/env"
   rustup default stable
   

3. ビルド
   

   cargo build --workspace

4. すべてのサービスを起動
   Terminal A

   AADK_JOB_ADDR=127.0.0.1:60051 ./scripts/dev/run-all.sh
   

   （任意で環境変数によりアドレスを上書き可）

5. GUI を起動
   Terminal B

   GTK_A11Y=none cargo run -p aadk-ui
   

6. CLI での確認（任意）

   cargo run -p aadk-cli -- toolchain list-providers
   cargo run -p aadk-cli -- toolchain list-sets
   cargo run -p aadk-cli -- targets list
   cargo run -p aadk-cli -- observe list-runs
   cargo run -p aadk-cli -- observe export-support
   cargo run -p aadk-cli -- project use-active-defaults <project_id>
   

リリースビルド（Linux aarch64）

cargo build --release --workspace
ls -1 target/release/aadk-*

GitHub Release 用のパッケージング（任意）:

VERSION=0.1.0
OUT=dist/aadk-${VERSION}-linux-aarch64
mkdir -p "${OUT}"
cp target/release/aadk-{core,workflow,toolchain,project,build,targets,observe,ui,cli} "${OUT}/"
cp scripts/dev/run-all.sh README.md LICENSE "${OUT}/"
tar -C dist -czf "aadk-${VERSION}-linux-aarch64.tar.gz" "aadk-${VERSION}-linux-aarch64"
sha256sum "aadk-${VERSION}-linux-aarch64.tar.gz" > "aadk-${VERSION}-linux-aarch64.tar.gz.sha256"

docs/release.md

scripts/release/build.sh

今日実装済みの機能

aadk-core

StreamRunEvents

aadk-toolchain

AADK_TOOLCHAIN_CATALOG

aadk-project

AADK_PROJECT_TEMPLATES

GetProject

aadk-build

ProjectService

ObserveService

aadk-targets

aadk-observe

run_id

correlation_id

aadk-workflow

workflow.pipeline

run_id

aadk-ui

job_id

correlation_id

aadk-cli

--job-id

--correlation-id

--run-id

拡張の推奨順序

1. ワークフロー入力用ピッカー（テンプレート、ツールチェーンセット、ターゲット）を追加し、UI 設定に最後使用したフィールドを保存。
2. 証拠ダッシュボードを拡張し、ランフィルタとアウトプットへのショートカット（開く／エクスポート）を実装。
3. CLI ヘルパーで

   StreamRunEvents

   をワークフロー実行後に tail できるようにする。

開発メモ

• gRPC は簡易化のため TCP loopback を使用；Unix ドメインソケットは次回実装予定。
• UI はバックグラウンド Tokio ランタイムを用いて GTK メインスレッドを応答性保持。
• ジョブワークフローは JobService で進捗メトリクスを公開；

  aadk-core

  を起動すると UI ストリームが確認できる。

なぜ AADK（ARM64 ギャップ）なのか

Android Studio の公式スタックは ARM64 ホストをサポートしていないため、ARM64‑ファーストの Android 開発ツールを提供することに焦点を当てています。
主なギャップの根拠：

• Android Studio Linux docs：「Linux マシンで ARM ベース CPU は非対応」＆「x86_64 が必要」。
  https://developer.android.com/studio/platform/install
• Google Issue Tracker: “Android Studio is not available on Windows Arm.”
  https://issuetracker.google.com/issues/351408627
• Google Issue Tracker: “Emulator is not available on Windows/Linux arm64。”
  https://issuetracker.google.com/issues/386749845

コミュニティ ARM64 ツール参照：

android-tools

android-sdk-tools

Cuttlefish ターゲットプロバイダー

TargetService

provider=cuttlefish

1. 利用可能なら

   cvd status

   で実行状態と adb serial を検知。
2. 必要に応じて

   adb connect

   を送信。
3. ADB（device/offline）または Cuttlefish（running/stopped/error）の状態を報告。
4. ADB ステータス、API レベル、ビルド/ブランチ/パス、および生のステータス出力で詳細付与。

前提条件（Android Cuttlefish ドキュメント参照）:

• KVM 仮想化が必要 –

  /dev/kvm

  を確認。
• ユーザーは

  kvm

  ,

  cvdnetwork

  ,

  render

  グループに属すること。
• ホストツールとイメージは同一ビルド ID である必要。

デフォルト設定（上書き不可）:

aosp-android-latest-release

main-16k-with-phones

aosp_cf_arm64_only_phone-userdebug

aosp_cf_x86_64_only_phone-userdebug

aosp_cf_riscv64_phone-userdebug

aosp_cf_arm64 / aosp_cf_x86_64

GPU 加速:

• Android 11+ のゲストはホストがサポートしていれば GPU アクセラレーションを利用；そうでなければ SwiftShader が使用される。
• 必要条件: EGL ドライバで

  GL_KHR_surfaceless_context

  、OpenGL ES、Vulkan をサポート。
• 環境変数

  AADK_CUTTLEFISH_GPU_MODE=gfxstream

  （OpenGL+Vulkan パススルー）または

  drm_virgl

  （OpenGL だけ）で

  --gpu_mode=…

  を指定。

WebRTC ストリーミング:

• --start_webrtc=true

  で起動（TargetService が自動設定）。
• デフォルト Web UI は https://localhost:8443。環境変数

  AADK_CUTTLEFISH_WEBRTC_URL

  で上書き可。
• リモートアクセスには TCP 8443 と TCP/UDP 15550‑15599 のファイアウォール許可が必要。

REST/CLI コントロール:

https://localhost:1443

AADK_CUTTLEFISH_ENV_URL

/devices/DEVICE_ID/services

/devices/DEVICE_ID/services/SERVICE_NAME

POST /devices/DEVICE_ID/services/SERVICE_NAME/METHOD_NAME

cvd env ls

cvd env type SERVICE_NAME REQUEST_TYPE

cvd env call SERVICE_NAME METHOD_NAME '{…}'

利用可能サービス:

GnssGrpcProxy

OpenwrtControlService

WmediumdService

CasimirControlService

Wi‑Fi:

• Cuttlefish は Wmediumd でワイヤレスメディアをシミュレート。
• Android 14+ は

  WmediumdService

  （REST/CLI 経由）、Android 13 以下は

  wmediumd_control

  を使用。
• OpenWRT AP: デフォルトデバイス ID は

  cvd-1

  、WAN IP は

  192.168.94.2

  または

  192.168.96.2

  （起動オプション無し時）。
• アクセス方法:

  ssh root@OPENWRT_WAN_IP_ADDRESS

  、または https://localhost:1443/devices/DEVICE_ID/openwrt。

Bluetooth:

• Web UI コマンドコンソールから Rootcanal を制御。
• コマンド例：

  list

  ,

  add DEVICE_TYPE [ARGS]

  ,

  del DEVICE_INDEX

  ,

  add_phy PHY_TYPE

  ,

  del_phy PHY_INDEX

  ,

  add_device_to_phy DEVICE_INDEX PHY_INDEX

  ,

  del_device_from_phy DEVICE_INDEX PHY_INDEX

  ,

  add_remote HOSTNAME PORT PHY_TYPE

  。
• デバイスタイプ: beacon, scripted_beacon, keyboard, loopback, sniffer。

環境変数設定例

AADK_CUTTLEFISH_ENABLE=0
AADK_CVD_BIN=/path/to/cvd
AADK_LAUNCH_CVD_BIN=/path/to/launch_cvd
AADK_STOP_CVD_BIN=/path/to/stop_cvd
AADK_CUTTLEFISH_ADB_SERIAL=127.0.0.1:6520
AADK_CUTTLEFISH_CONNECT=0
AADK_CUTTLEFISH_WEBRTC_URL=https://localhost:8443
AADK_CUTTLEFISH_ENV_URL=https://localhost:1443
AADK_CUTTLEFISH_PAGE_SIZE_CHECK=0
AADK_CUTTLEFISH_KVM_CHECK=0
AADK_CUTTLEFISH_GPU_MODE=gfxstream|drm_virgl
AADK_CUTTLEFISH_HOME=/path (or _16K/_4K)
AADK_CUTTLEFISH_IMAGES_DIR=/path (or _16K/_4K)
AADK_CUTTLEFISH_HOST_DIR=/path (or _16K/_4K)
AADK_CUTTLEFISH_START_CMD="…"
AADK_CUTTLEFISH_START_ARGS="…"
AADK_CUTTLEFISH_STOP_CMD="…"
AADK_CUTTLEFISH_INSTALL_CMD="…"   # 非Debian 系統必須
AADK_CUTTLEFISH_INSTALL_HOST=0
AADK_CUTTLEFISH_INSTALL_IMAGES=0
AADK_CUTTLEFISH_ADD_GROUPS=0
AADK_CUTTLEFISH_BRANCH=<branch> (or _16K/_4K)
AADK_CUTTLEFISH_TARGET=<target> (or _16K/_4K)
AADK_CUTTLEFISH_BUILD_ID=<id>
AADK_ADB_PATH or ANDROID_SDK_ROOT

Cuttlefish ビルド固定

ビルド ID を指定してイメージを固定する例：

AADK_CUTTLEFISH_BRANCH=aosp-android-latest-release \
AADK_CUTTLEFISH_TARGET=aosp_cf_arm64_only_phone-userdebug \
AADK_CUTTLEFISH_BUILD_ID=12345678 \
./scripts/dev/run-all.sh

GTK UI もブランチ／ターゲット／ビルド ID フィールドと「Build ID を解決」ボタンを備えているため、インストール前に確認できます。

補足事項

• UI と CLI は

  include_offline=true

  を渡すので、停止中の Cuttlefish も表示されます。
• 開始／停止／ステータスは UI（Targets → Start/Stop/Status）と CLI (

  cvd start/stop/status

  ) で操作可能です。
• Cuttlefish のインストールは

  ci.android.com

  から公開アーティファクトを使用します。