Cuttlefish on Mac: Apple Silicon上でAndroidの仮想デバイスフレームワークをネイティブに実行
Cuttlefish on Mac: Android's Virtual Device Framework on Apple Silicon (engineering.fb.com)
要約
MetaのReality Labsは、Androidの仮想デバイスフレームワークであるCuttlefishを、Apple Silicon搭載のMac上でネイティブに実行できるようにしました。これにより、Linuxのみでしか動作しなかったCuttlefishをMac開発者も利用できるようになり、開発・テストの効率が向上しました。この成果は、QEMUのvhost-user、Hypervisor.framework、ネイティブディスプレイ、ビルド・署名パスの改善を通じて実現され、コミュニティに公開されています。
全文翻訳
Cuttlefish on Mac: Apple Silicon上でAndroidの仮想デバイスフレームワークをネイティブに実行
MetaのReality LabsがCuttlefishとそのQEMUバックエンドをmacOSとApple Siliconに移植した方法。
MetaのReality Labsは、AIグラスなどの製品を開発しています。エミュレータは、限られた物理ハードウェアに依存することなく、開発とテストをスケーリングするための方法を提供します。
電話以外のAndroidデバイス向けのソフトウェアをテストすることは、仮想デバイスが物理製品のソフトウェア動作をどれだけ正確に再現するかに依存します。Goldfishのような軽量エミュレータは一部の機能を提供しますが、実際のデバイスとの違いが開発の後半までバグを隠してしまう可能性があります。この忠実性の欠如は、デバイスエミュレーションへの信頼を損ない、限られた物理ハードウェアへの依存度を高めます。
Cuttlefishは、Android Open Source Project(AOSP)の仮想デバイスフレームワークであり、仮想ハードウェアに対してAndroidソフトウェアをテストするために使用されます。これは、実際のハードウェアと同じシステムイメージを起動し、仮想ハードウェアに対して現実的なソフトウェアスタックを実行します。これにより、Cuttlefishは軽量エミュレータよりも物理デバイスの動作をより正確に追跡できます。
残念ながら、CuttlefishはLinuxでのみサポートされており、当社のアプリケーションおよびライブラリ開発者はApple Silicon搭載のMacで作業しています。このため、GoldfishとCuttlefishを並行してサポートする必要がありました。
単一のCuttlefishベースのプラットフォームに統合できれば、すべての開発者に同じ高忠実度仮想デバイスのメリットを提供できると確信していました。課題は、CuttlefishをmacOS上でネイティブに実行できるようにスタックを移植することでした。
フラグメンテーションの影響
デュアルエミュレータプラットフォームの維持は、重い運用上の負担を課しました。コンピューティングリソースを消費し、開発者に混乱をもたらし、エミュレータチームの速度を低下させました。すべてのツールが2つの別々のプラットフォームをサポートする必要があり、インフラストラクチャとエンジニアリング能力はそれらの間で分割されました。さらに、開発者は作業方法に基づいてエミュレータターゲットを選択する必要がありました。Goldfishはどこでも動作しましたが忠実度は低く、CuttlefishはLinuxが必要でした。
[画像]
AOSPはこの正確な分割を反映しています。Goldfishはアプリケーション開発者を対象とし、CuttlefishはAndroidプラットフォーム開発者を対象としています。その分割を維持する限り、フラグメンテーションの影響を受けることになります。
スタックとmacOSのギャップ
Cuttlefishはオーケストレーションレイヤーであり、実際にゲストOSを実行するコンポーネントは仮想マシンモニター(VMM)です。Linuxでは、Cuttlefishは通常crosvmを使用しますが、以前は代替VMMとしてQEMUのサポートも含まれていました。その統合は時間の経過とともに非アクティブになっていました。macOSでのネイティブApple Siliconサポートを有効にするために、QEMUサポートを復活させました。
Cuttlefishの多くの仮想デバイスはvhost-userバックエンドを使用しており、これらはソケット経由でQEMUにvirtioデバイスを提供する別個のプロセスです。アーキテクチャはクリーンですが、その大部分はLinuxを強く想定して書かれていました。それらの想定のうち3つがmacOSで破綻します。vhost-userの仕組みはLinuxに限定されており、ビルドまたは実行できません。Appleハイパーバイザーは、QEMUが予期しないリソース制限を課します。最後に、ネイティブディスプレイ、ビルド、署名パスが存在しませんでした。私たちはこれら3つすべてに取り組みました。
[画像]
Cuttlefish on Macスタック。CuttlefishはQEMUをバックエンドとする仮想デバイスをオーケストレーションします。ハイライトされたオレンジ色のブロックはMac固有の作業です。vhost-userへのmacOSサポートの追加、QEMUのHVFバックエンドでのメモリ領域追跡スロットの増加、ネイティブCocoaディスプレイおよびコード署名パスの使用。
Linuxを超えたvhost-userのポータビリティ
構造的に最も重要な変更は、QEMUのvhost-userパスで行われました。フロントエンド、libvhost-user、およびvhost-user-blkなどのコントリビュートバックエンドはすべてLinuxに限定されていました。これらのビルド制限を緩和し、vhost-userフロントエンドとライブラリがmacOSでもLinuxでもビルドできるようにしました。これにより、Cuttlefishのデバイスバックエンドは、Linux上と同じようにMac上のQEMUにハンドオフできるようになります。これがなければ、Cuttlefishを使用する価値がある高忠実度デバイスモデルはLinux以外では利用できません。
Hypervisor.framework内での動作
Apple Siliconでは、QEMUはKVMではなくHVF(Hypervisor.framework)を通じてアクセラレーションを行います。QEMUのHVFバックエンドは、より大きなCuttlefish構成に必要なメモリ領域を十分に追跡していませんでした。追跡スロット数を増やし、それらの構成が正しく実行できるようにしました。
使用可能なネイティブディスプレイ
ローカルアプリケーション開発には、開発者が仮想デバイスを直接表示および操作できるインタラクティブなディスプレイが必要です。WebRTCインターフェースへの依存を回避し、直接的な操作を可能にするために、QEMUのネイティブCocoaディスプレイに移行しました。変更点は以下の通りです。
- BGRAピクセルフォーマットサポート: Apple Silicon上で視覚的なアーティファクトを排除するための正確なディスプレイレンダリングを可能にします。
- マウス操作をタッチ入力として変換: ポインターアクションをタッチ入力に変換し、タッチスクリーンデバイスを操作できるようにします。
- カスタムジオメトリオプション: ディスプレイ構成のためにgraphic_console_initに-gフラグを追加します。
また、gfxstream/rutabaga構成のRust側のグラフィックスABIに一致するために必要な、不安定なRutabaga構造体も有効にしました。
Apple Siliconでのビルドと署名
最後に、ビルドとパッケージングの作業がありました。初期のDarwinビルドサポート、macOS用のarm64向けQEMUのビルド、ツールチェーンの修正です。macOSビルドは、コード署名と公証サポートに加えて、JITエンタイトルメントも必要としました。Cuttlefish側では、macOSホストサポートを追加し、フレームワークのオーケストレーションがLinuxホストを想定するのではなく、Mac上でビルドおよび実行できるようにしました。
メリット
プラットフォームを統合することで、メンテナンス要件を削減し、インフラストラクチャのニーズを減らし、冗長なツールを排除し、忠実度を向上させ、開発者がCI全体で使用されているものと全く同じCuttlefish仮想デバイスを実行できるようにしました。
[画像]
単一プラットフォームは、共有スタックで機能をサポートすることも容易にしました。これには以下が含まれます。
- Bluetoothペアリングと接続。
- Wi-Fi。
- セルラー。
- 3Dグラフィックス。
- オーバー・ザ・エア(OTA)アップデートテストにより、仮想デバイスに対してOTAアップデートフローを実行します。
- Fastboot。
- スナップショット機能により、CIおよび開発フローでデバイスの状態を保存および復元します。
Reality Labsのエンジニアをサポートするだけでなく、この同一の仮想デバイスは外部開発者とも共有され、エコシステムを構築しています。この連携により、サードパーティチームがOS自体の開発および検証に使用しているものと全く同じCuttlefishベースのプラットフォームでテストすることが保証されます。
AIエージェントがAndroid開発でますます重要な役割を果たす中、検証実行とランタイム動作はコード生成と同様に不可欠です。仮想デバイスは、エンジニアと自動化されたエージェントの両方が分離された環境内で同時に動作できるようにし、アプリケーション実行と迅速なイテレーションを促進します。状態のリセットとテスト実行の繰り返しを即座に可能にすることで、チームは共有物理ハードウェアへの依存を排除し、ワークフローの中断を防ぎます。最終的に、高忠実度エミュレーションは、これらの継続的なフィードバックループが迅速かつ有意義であることを保証します。
コミュニティへの貢献
Reality Labs内での開発のためにこれを構築しましたが、macOSサポートは当社の製品以外でも役立ちます。私たちは、他の開発者が当社の作業を可能にしたQEMUとAOSPの基盤の上に構築できるように、この作業をコミュニティと共有しています。
作業は2つの部分で配布しています。
- qemu-wearables: 当社のコミットを含むMetaがメンテナンスするQEMUのフォーク。
- cuttlefish-wearables: パッチファイルのセットで、Android/AOSPにパッチを適用するための指示が含まれています。
これらのリポジトリには、当社のQEMUの変更とCuttlefishパッチシリーズ、およびビルドとパッチ適用手順が含まれています。
また、これらの変更をQEMUとAOSPにアップストリームで貢献する方法も検討しています。それまでの間、開発者は当社のフォークとパッチセットを使用できます。
謝辞
このプロジェクトは、QEMUおよびCuttlefish/AOSPコミュニティによって築かれた基盤に依存しています。特に、macOS統合を直接可能にした Stefano Garzarellaによる vsock-userの実装に感謝します。
また、MetaのOlya ArkhangelskaiaとTom Careには、CuttlefishをmacOSに移植した基盤的な作業、およびJeffrey EffendyにはネイティブMac開発者エクスペリエンスの改善とそれに続く製品化作業に特別な感謝を捧げます。