Scrcpy on Ivon's Blog

LinuxでAndroid Studioエミュレーターをスマホゲーム用に使う考え方（Playストア＋Nvidia GPUアクセラレーション＋AVD単独実行）

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Sat, 07 Jun 2025 15:00:00 +0800

Using AVD of Android Studio on Linux as a Android gaming emulator.

Ubuntu LinuxシステムでAndroid StudioのAVDエミュレーターを使ってゲームを遊び、さらに重たいIDEを一緒に起動せずAVDエミュレーターだけを起動する設定方法を共有します。

Android StudioはGoogleが提供するIDEで、Linux、Windows、macOSをサポートし、Androidアプリ開発に使われます。ライセンスはプロプライエタリソフトウェアです。

最大の特徴は、各バージョンのAndroidエミュレーター（Android Virtual Devices、以下AVD）を内蔵していることです。このエミュレーターでゲームは遊べるのでしょうか？理論上は可能です。Android Studioのエミュレーターはスマホ機種のエミュレート、内蔵GAPPS、GPUアクセラレーション、内蔵ARMトランスレーターlibndk、ウィンドウサイズの動的リサイズに対応しています。

例：AVDエミュレーターを使ってLinuxでGoogle Playのウマ娘ゲームをプレイ

では、なぜAndroid StudioのAVDを使うのでしょう？IvonはLinux Android Emulatorsを共有しました。その中でAndroid StudioのAVDは、Genymotion以外では、Linux上でNvidia GPUを正常に使ってAndroidスマホゲームを遊べる唯一のエミュレーターかもしれません。Google公式が提供している以上、公開前に多くのテストを経ているはずです。品質は信頼できるはずです。

LinuxでAndroidスマホゲームを実行したい場合、Waydroidが比較的よく推薦される方案で、Steam Deckで使っている人もいます。ただしWindows上のBluestacksエミュレーターに近い使用体験を求めるなら、AVDの方が近いです。

本来、Waydroidの方がより良い方案のはずでした。完全にオープンソースコミュニティで維持され、Waydroid（LXCコンテナ）はAVDエミュレーター（QEMU/KVM仮想マシン）より性能が良いです。AVDエミュレーターはいつも少しもたつきます。

実際にGeekbenchでベンチマークしたところ、同じIntel i5-10210U CPUで同じコア数を割り当てた場合、Waydroid（上）は確かにAVDエミュレーター（下）より性能が良く、Waydroidはほぼネイティブ速度でAndroidアプリを実行します。AVDには仮想化による性能損失があります。

しかしWaydroidの致命的な弱点は、IntelとAMD GPUしかサポートしていないことです。開発者によると、Nvidiaを一時的にサポートしていない理由は、NvidiaがオープンソースのAndroid側ドライバーを提供しておらず、Linux側のMesaドライバーにも問題があるためです。一方Googleは何らかのOpenGL ES変換の魔法を使い、Nvidiaドライバーを動かしています。

AVDエミュレーターの中では、LinuxホストのNvidia GPUが正常に表示されているのを確認できます。AVDエミュレーターはIntel、AMD、NvidiaのいずれでもOpenGL ESへ変換できます。

したがってNvidiaユーザーにとって、AVDはGPUアクセラレーション付きで実用可能な唯一のAndroidエミュレーター方案です。

1. 仮想化とグラフィックドライバーを確認
#

Android StudioはQEMU/KVMでエミュレーターを高速化するため、まずUbuntu PCで仮想化が有効か確認します。CPUが仮想化に対応しているか確認し、戻り値は0であってはいけません：

sudo grep -E -c '(vmx|svm)' /proc/cpuinfo

KVMカーネルモジュールが読み込まれているか確認します：

sudo lsmod | grep kvm

Nvidiaグラフィックカードを使っている場合は、Nvidiaクローズドソースドライバーをインストールすることを忘れないでください。

2. Android Studioをインストール
#

Android Studioはx86_64アーキテクチャのLinux PCのみ対応しています。ディスク容量64GB以上、RAM 8GB以上、CPU 4コア以上をおすすめします。

公式サイトからダウンロードします。Flatpak方式ではインストールしないでください。
tarファイルを展開し、任意のディレクトリに置きます。私は個人的に~/Applicationsに置いています
android-studio/bin/studioをダブルクリックしてAndroid Studioを起動し、初期化パッケージの完了を待ちます。
New Projectを押して適当なプロジェクトを作成します
左上のTools → Create Desktop Entryを押すと、Linuxデスクトップアイコンを作成できます

3. AVDエミュレーターを追加
#

左上 → Tools → Device Managerをクリック
画面左側にダウンロード済みのエミュレーターが表示されるはずです。執筆時点ではAndroid 16のイメージです
他のバージョンが必要な場合は＋をクリックし、Create New Virtual Deviceで追加します。たとえば私はPixel 9 Pro XLを選び、Android 16バージョンを設定し、Google Play内蔵イメージを選択しました。（注：この端末はパンチホール画面で、AVDエミュレーターもパンチホール画面を一緒にエミュレートします。完全な画面が欲しい場合は古い機種を選んでください。）
Additional Settingsを押してエミュレーター性能を調整します。少なくとも64GBのストレージ、さらに4GB以上のRAMと4つのCPUコアを割り当てます。ただしGoogle Playを含むイメージは全速で使えないため、設定ファイルを手動で変更する必要があります。
ダウンロード後、Show on diskをクリックし、設定ファイルconfig.iniを編集します
以下の内容を変更します（なければ自分で追加）

disk.dataPartition.size=64G # エミュレーター仮想ディスク容量
hw.audioInput=yes # 音声入力
hw.audioOutput=yes # 音声出力
hw.cpu.ncore=4 # エミュレーターのコア数。PC性能に応じて調整
hw.ramSize=6144 # エミュレーターRAM

PlayStore.enabled=true # Google Playを強制有効化
tag.display=Google Play
tag.id=google_apis_playstore

# エミュレーターにスマホ枠を表示したくない場合は以下3行を削除
skin.name=
skin.path=

その後起動し、Googleアカウントにログインして初期化を完了し、シャットダウンします。

4. IDEを起動せずAVDエミュレーターだけを起動
#

Android Studioの問題は重すぎることです。IDE実行時は非常にリソースを食います。IDEを開かず、AVDだけを単独実行できます。

Android Studioの依存パッケージは~/Android/に置かれます
エミュレーター一覧を表示します。例：Pixel_9_Pro_XL

~/Android/Sdk/emulator/emulator -list-avds

IDEを開かずAVDだけを起動したい場合は、このコマンドで起動します：

~/Android/Sdk/emulator/emulator -avd "模擬器機型"

GPUが2つある場合は、Nvidia PRIMEの方式で、エミュレーターのグラフィックアクセラレーションにNvidia GPUを指定できます。

これをLinuxデスクトップショートカットにして、Linuxアプリケーション一覧へ追加します

vim ~/.local/share/applications/emulator_pixel_9_pro_xl.desktop

以下のコマンドを入力します。Wayland下でAVDがおかしい場合は、Exec=の後ろに環境変数env WAYLAND_DISPLAY=を追加し、XWaylandで起動するようにします。

[Desktop Entry]
Categories=Development;IDE;
Exec="/home/user/Android/Sdk/emulator/emulator" -avd "Pixel_9_Pro_XL"
Icon=/home/user/Android/Sdk/skins/pixel_9_pro_xl/back.png
Name=Pixel 9 Pro Emulator
NoDisplay=false
Type=Application

これでLinuxデスクトップのショートカットをクリックしてAVDエミュレーターを起動できます。
AVDエミュレーター右上の三点をクリックして設定を開き、Show window frame around deviceをクリックすると枠が表示され、AVDエミュレーターウィンドウをリサイズできます。

5. QtScrcpyと組み合わせてキーマッピングを使う
#

主な接続手段としてScrcpyに切り替えます。QTScrcpyはキーマッピングに対応しており、キーボードでタッチ操作を制御できます。

AVDエミュレーター起動コマンドに-no-window -gpu hostパラメータを追加すると、エミュレーターのウィンドウを出さず、GPUアクセラレーションを維持できます。

~/Android/Sdk/emulator/emulator -avd "模擬器機型" -no-window -gpu host

次にADBで現在PC上のデバイスを一覧表示します

接続をクリック

6. 複数アプリを起動
#

複数のAVDを同時実行する必要はありません。リソースを食いすぎます。

Android 15の仮想デュアルディスプレイ機能を使えば十分です。

AVDエミュレーターの設定 → Displayをクリックし、画面を1つ追加します。

追加された画面で他のアプリを実行できます。ただし大型ゲームを動かす場合は、エミュレーターに割り当てたRAMが十分かどうかも考慮する必要があります。サブ画面は画面方向に追従して回転しないようです。

7. アプリがクラッシュする場合
#

AVDにはlibndkが内蔵されており、ARM変換の問題でクラッシュすることがあります。

できるだけx86_64アーキテクチャのAPKを探し、ARMトランスレーターのクラッシュによる可能性を減らしてください。

ゲームがエミュレーターを検出してクラッシュしている可能性もあります。AVDはあくまで開発用エミュレーターです。ゲームがエミュレーター疑いで遊ばせてくれないなら、まあどうしようもありません～

Play Integrity APIはハードウェア対応が必要なので、エミュレーター内で通過することは不可能です。

參考資料
#

ReDroidチュートリアル：DockerでAndroidシステムを動かし、x86 PCでARMスマホゲームを遊ぶ

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Thu, 15 Aug 2024 21:00:00 +0800

ReDroid (Remote anDroid) は自前で「クラウドスマホ」を構築する方案で、DockerでAndroidシステムコンテナを動かし、さらにScrcpyの画面ミラーリング機能でAndroidデスクトップへ接続します。

LinuxでReDroidを使ってFGOをプレイ

ReDroidもPC上でオープンソースソフトウェアを使ってAndroidアプリを動かすソリューションです。クラウドスマホはさておき、多くのAndroidスマホゲームエミュレーターはクローズドソースソフトウェアですからね。それに比べ、ReDroidはARMトランスレーター以外はオープンソースです。さらに素晴らしいことに、ReDroidはGPUアクセラレーション＋ARMからx86へのトランスレーターに対応しているため、大多数のスマホ3Dゲームを遊べます。

Linuxユーザーにとって、これはWaydroidとAndroid-x86仮想マシン以外に、Linux PCでAndroidアプリを高効率に動かす方法でもあります。さらにWaydroidよりクラウドスマホ用途に向いています。Self-hosting Cloud Phoneを参照してください

この記事では、x86アーキテクチャのLinux PCでReDroidを使い、ARMアーキテクチャのスマホゲームを遊ぶ方法を扱います。最良の使用体験を得るため、ReDroidイメージにARMトランスレーター＋Googleサービスフレームワークを追加します。

1. ReDroidシステム要件
#

任意のLinuxディストリビューションで使えるはずです。

この記事ではx86アーキテクチャのPCでReDroidを動かす例を示します。ARMアーキテクチャのPCについては、Oracle ARMアーキテクチャサーバーでのデプロイ成功例を報告したネットユーザーがおり、私もRaspberry Pi 5でReDroidを動かせることをテスト済みです。

PCがx86アーキテクチャの場合、実行できるのはx86アーキテクチャのAndroidアプリだけです。しかし多くのスマホゲームはARMアーキテクチャ版しかないため、ReDroidにはlibndkまたはlibhoudiniのARMトランスレーターを入れる必要があります。

スマホゲームを遊ぶなら、PCには少なくとも8GB以上のRAMをおすすめします。ARMをx86命令へ変換するとき、大量のRAMを消費することがあるためです。

GPUアクセラレーションについては、IntelやAMDのGPUなど、Linux Mesaがサポートするドライバーの使用をおすすめします。3Dアクセラレーションがそのまま使えます。Nvidiaはおすすめしません。

Androidバージョンについて、Redroid作者が公開しているredroid:11.0.0-latestとredroid:12.0.0-latestイメージにはGoogle開発のARMトランスレーターlibndkが内蔵されています。試したところAndroid 11だけが比較的安定しており、GAppsも使えたので、この記事ではAndroid 11のイメージを選びます。

2. ReDroid前提依存項目をインストール
#

ReDroidのGithubには主要Linuxディストリビューション向けのインストール説明があります。私はUbuntuシステムを例にします。

まずbinderカーネルモジュールを用意します。Ubuntu 24.04では以下のコマンドを実行し、必要なbinderカーネルモジュールをインストールします：

sudo apt install linux-modules-extra-`uname -r`

sudo modprobe binder_linux devices="binder,hwbinder,vndbinder"

上記カーネルモジュールを起動時自動読み込みに追加します

echo 'binder_linux options binder_linux devices="binder,hwbinder,vndbinder"' | sudo tee -a /etc/modules-load.d/redroid.conf

コンテナ実行用にDockerをインストールします
ADBツールをインストールします
最後にScrcpyをインストールします。

キーマッピングを統合したグラフィカルなScrcpy UIが欲しい場合は、QtScrcpyを入れてもよいです。Web版のws-scrcpyも試せます。

3. ReDroidイメージに事前にGAppsをインストール
#

ReDroid作者が公開しているイメージは素のAndroidで、GAppsはプリインストールされていません。Docker Hubで他人が事前にビルドしたReDroidイメージを探すこともできます。GApps内蔵のものなら自分でbuildする必要はありません。もちろん、リスクは自己責任です。

ここではayasa520のRemote-Android Scriptを使い、ReDroidイメージを自動取得してGAppsを入れます。Android 11のイメージのみ対応です。

このスクリプトはlibndk、libhoudini、Magisk、Widevine DRMなどのコンポーネントのインストールにも使えます。

Remote-Android Scriptリポジトリをクローンし、Python仮想環境を作成します

sudo apt install lzip python3 python3-venv python3-pip

git clone https://github.com/ayasa520/redroid-script.git

cd redroid-script

python3 -m venv venv

venv/bin/pip install -r requirements.txt

Android 11のイメージを取得し、GAppsをインストールします

venv/bin/python3 redroid.py -a 11.0.0 -g

これでGApps入りイメージredroid/redroid:11.0.0_gappsが得られます。

4. docker-composeでReDroidコンテナを起動
#

この手順はNvidiaグラフィックカードの場合のみ必要です。IntelとAMDグラフィックカードのユーザーは次の手順へ直接進んでください。ReDroidのNvidiaグラフィックカード対応は良くありません。可能なら内蔵GPUで動かすことをおすすめします。どうしてもNvidiaを使うなら、ReDroid用の仮想マシンを作成します。NvidiaクローズドソースドライバーではReDroidにGPUアクセラレーションを使わせられないため、QEMU仮想マシンを動かし、その中にReDroidを入れてvirtio-gpuでハードウェアアクセラレーションを実現する必要があります。ただしこれは準仮想化技術なので性能損失は大きいです。仮想マシンを作らず、PCに内蔵GPUもない場合、ReDroidはソフトウェアレンダリングになります。ソフトウェアレンダリングの性能を受け入れられるなら、仮想マシンをインストールする必要はありません。

ReDroid用仮想マシンを作成

QEMU ＋ Virt Managerをインストールし、Ubuntu 24.04をダウンロードして、64GBのUbuntu仮想マシンを作成します

qemu-img create -f qcow2 ubuntu.qcow2 64GB

qemu-system-x86_64 -boot d -cdrom "ubuntu-22.04.1-desktop-amd64.iso" -enable-kvm -smp 4 -device intel-hda -device hda-duplex  -device virtio-vga-gl  -net nic -net user,hostfwd=tcp::5555-:5555 -cpu host  -m 4096  -display sdl,gl=on -hda ubuntu.qcow2

仮想マシンへ起動し、その後Dockerをインストールします。

qemu-system-x86_64 -enable-kvm -smp 4 -device intel-hda -device hda-duplex  -device virtio-vga-gl  -net nic -net user,hostfwd=tcp::5555-:5555 -cpu host  -m 4096  -display sdl,gl=on -hda ubuntu.qcow2

Androidデータ保存用ディレクトリを作成し、docker-composeを追加します

mkdir ~/redroid

cd redroid

vim docker-compose.yml

以下の内容を入力します：

services:
  redroid:
    image: redroid/redroid:11.0.0_gapps # 先ほど作成したGApps入りReDroidイメージを使用
    stdin_open: true
    tty: true
    privileged: true
    ports:
      - 127.0.0.1:5555:5555 # ADBポート。セキュリティ強化のためローカルlocalhostポートのみリッスン
    volumes:
      - ./redroid-11-data:/data # データは現在ディレクトリに保存
    command:
      - androidboot.redroid_width=720 # スマホ解像度
      - androidboot.redroid_height=1280
      - androidboot.redroid_dpi=320
      - androidboot.redroid_fps=60
      - androidboot.redroid_gpu_mode=host # ホストGPUハードウェアアクセラレーションを有効化。hostはGPUアクセラレーション、guestはソフトウェアレンダリング
      - ro.product.cpu.abilist0=x86_64,arm64-v8a,x86,armeabi-v7a,armeabi # libndk関連設定
      - ro.product.cpu.abilist64=x86_64,arm64-v8a
      - ro.product.cpu.abilist32=x86,armeabi-v7a,armeabi
      - ro.dalvik.vm.isa.arm=x86
      - ro.dalvik.vm.isa.arm64=x86_64
      - ro.enable.native.bridge.exec=1
      - ro.dalvik.vm.native.bridge=libndk_translation.so
      - ro.ndk_translation.version=0.2.2

サービスを起動

sudo docker compose up -d

ADBでローカルのReDroidへ接続します。ローカルなのでIPはlocalhostです。ReDroidをリモートにデプロイしている場合は、リモートホストのIPに変更します。

adb connect localhost:5555

# 接続できない場合、以下のコマンドでコンテナ内部で何が起きているか確認します
sudo docker ps
sudo docker exec <容器ID> logcat
sudo docker logs <容器ID>

Scrcpyを実行し、Androidへ接続します：

scrcpy -s localhost:5555 --audio-codec=aac

これでAndroidデスクトップが見えます。
Google Playサービスが「デバイスは認証されていません」というエラーメッセージを出すことがあります。
以下のコマンドでAndroidデバイスIDを取得し、Googleサイトでデバイスを登録します。30分ほど待ってからRedroidコンテナを再起動すると、Google Playにログインできます。

adb -s localhost:5555 root

adb -s localhost:5555 shell 'sqlite3 /data/data/com.google.android.gsf/databases/gservices.db \
    "select * from main where name = \"android_id\";"'

ReDroidの3Dアクセラレーションが正常に動いているか確認するには、AIDA64をインストールし、PCのGPU型番を認識できるか見ます。
セキュリティを強化したい場合は、ReDroidのdocker-composeネットワーク設定をローカルlocalhostポートのみリッスンするようにしてください（ports: 127.0.0.1:5000:5000）。ReDroidを外部ネットワークからアクセス可能にする場合は、ファイアウォール設定に注意し、ADBの5000ポートを直接インターネットへ公開しないでください。重大なセキュリティリスクになります。

5. ReDroidにAPKをインストールする方法
#

現在、libndkをインストールしていても、Android 11のPlayストアはARMアーキテクチャのアプリをダウンロードさせてくれません。APKPureのようなアプリストアと組み合わせてアプリをインストールしてください。

コンテナ内部のブラウザでAPKをダウンロードする以外に、ADBでAPKをReDroidコンテナへインストールすることもできます。たとえばApkMirrorからLineのAPKをダウンロードし、ADBでインストールします：

adb -s localhost:5555 install "jp.naver.line.android.apk"

ScrcpyはAPKをウィンドウへドラッグしてインストールできます。

ADBのpullとpushコマンドでファイルを転送することもできます。

6. ReDroidを「起動・停止」する方法
#

ReDroidを停止したい場合、Scrcpyウィンドウを閉じた後、コンテナを停止します：

cd ~/redroid

sudo docker compose down

その後、このコマンドでReDroidを再び起動できます。ReDroidコンテナの/dataデータは~/redroid/redroid-11-dataディレクトリにあり、複数システムのファイルをバックアップするのに使えます。

cd ~/redroid

sudo docker compose up -d

adb connect localhost:5555

scrcpy -s localhost:5555 --audio-codec=aac

7. ReDroid多重起動の例
#

ReDroid Multiple Instancesを参照してください

付録
#

ReDroidイメージへGAppsを手動インストール

ReDroid作者によると、Googleサービスフレームワークはプロプライエタリソフトウェアなので内蔵できません。したがって自分でインストールする必要があります。1つ目の方法はReDroidイメージの再コンパイル、2つ目はOpenGAppsの手動インストールです。

1つ目の方法はおすすめしません。時間がかかるうえ、作者が提供するGAppsビルド手順には他のアプリが検出できない問題もあります。

ここでは2つ目の方法、手動インストールを使います。

OpenGappsからx86_64アーキテクチャのAndroid 11 GAppsをダウンロードし、最小構成のpico版を選びます。
展開すると、以下のディレクトリが見えます

open_gapps-x86_64-11.0-pico-20220503
├── Core
├── GApps
├── META-INF
├── Optional

展開したディレクトリopen_gapps-x86_64-11.0-pico-20220503の下にsystemディレクトリを追加します。
次に、CoreとGAppsディレクトリ内の.lzファイルをすべて展開し、中のAPKディレクトリを対応するインストール先に従ってsystemディレクトリへ置きます。たとえばGApps/googletts-x86_64/nodpi/app/下のGoogleTTSディレクトリは/system/appへ置きます。
配置後、system下のディレクトリ構造はこのようになるはずです：

system
├── app
│   ├── GoogleCalendarSyncAdapter
│   │   └── GoogleCalendarSyncAdapter.apk
│   ├── GoogleContactsSyncAdapter
│   │   └── GoogleContactsSyncAdapter.apk
│   ├── GoogleExtShared
│   │   └── GoogleExtShared.apk
│   └── GoogleTTS
│       └── GoogleTTS.apk
├── etc
│   ├── default-permissions
│   │   ├── default-permissions.xml
│   │   └── opengapps-permissions-q.xml
│   ├── permissions
│   │   ├── com.google.android.dialer.support.xml
│   │   ├── com.google.android.maps.xml
│   │   ├── com.google.android.media.effects.xml
│   │   ├── privapp-permissions-google.xml
│   │   └── split-permissions-google.xml
│   ├── preferred-apps
│   │   └── google.xml
│   └── sysconfig
│       ├── dialer_experience.xml
│       ├── google_build.xml
│       ├── google_exclusives_enable.xml
│       ├── google-hiddenapi-package-whitelist.xml
│       └── google.xml
├── framework
│   ├── com.google.android.dialer.support.jar
│   ├── com.google.android.maps.jar
│   └── com.google.android.media.effects.jar
├── priv-app
│   ├── AndroidAutoPrebuiltStub
│   │   └── AndroidAutoPrebuiltStub.apk
│   ├── AndroidMigratePrebuilt
│   │   └── AndroidMigratePrebuilt.apk
│   ├── CarrierSetup
│   │   └── CarrierSetup.apk
│   ├── ConfigUpdater
│   │   └── ConfigUpdater.apk
│   ├── GoogleBackupTransport
│   │   └── GoogleBackupTransport.apk
│   ├── GoogleExtServices
│   │   └── GoogleExtServices.apk
│   ├── GoogleFeedback
│   │   └── GoogleFeedback.apk
│   ├── GoogleOneTimeInitializer
│   │   └── GoogleOneTimeInitializer.apk
│   ├── GooglePackageInstaller
│   │   └── GooglePackageInstaller.apk
│   ├── GooglePartnerSetup
│   │   └── GooglePartnerSetup.apk
│   ├── GoogleRestore
│   │   └── GoogleRestore.apk
│   ├── GoogleServicesFramework
│   │   └── GoogleServicesFramework.apk
│   ├── Phonesky
│   │   └── Phonesky.apk
│   ├── PrebuiltGmsCore
│   │   └── PrebuiltGmsCore.apk
│   └── SetupWizard
│       └── SetupWizard.apk
└── product
    └── overlay
        └── PlayStoreOverlay.apk

以下のコマンドでroot権限を取得します：

adb connect localhost:5555
adb -s localhost:5555 root
adb -s localhost:5555 remount
adb -s localhost:5555 shell "rm -rf system/priv-app/PackageInstaller"

次にsystemディレクトリをReDroidシステムへpushし、権限を付与します：

adb -s localhost:5555 push system /
adb -s localhost:5555 shell "pm grant com.google.android.gms android.permission.ACCESS_COARSE_LOCATION"
adb -s localhost:5555 shell "pm grant com.google.android.gms android.permission.ACCESS_FINE_LOCATION"
adb -s localhost:5555 shell "pm grant com.google.android.setupwizard android.permission.READ_PHONE_STATE"
adb -s localhost:5555 shell "pm grant com.google.android.setupwizard android.permission.READ_CONTACTS"
adb reboot

ReDroidコンテナを再起動します：

cd ~/redroid
sudo docker compose down
sudo docker compose up -d

Scrcpyを起動

scrcpy -s localhost:5555 --audio-codec=raw

システム設定 → アプリを開き、右上からシステムアプリ表示を選択し、Google PlayサービスとPlayストアの権限をすべて有効にします。

libndkを手動抽出してAndroidイメージをビルド

libndkはGoogleが開発したプロプライエタリソフトウェアで、Android Studioのエミュレーターに含まれています。ReDroid作者の指示によると、新しいAndroidエミュレーターからlibndkを手動で抽出し、ReDroidの素のシステムへ入れることができます。

ここではAndroid 13を例にします。作者は必ず使えるとは保証していない点に注意してください。

Android Studioをインストールし、Android 13の仮想マシンを追加します
ADBで接続

adb devices
adb shell
su

libndkをパッケージ化

{ find /system -name arm* -type d; find /system -name *ndk_translation*; find /system/etc -name *arm*; } | tar -cf /sdcard/nb.tar -T -

libndk.soをパッケージ化

find system -type l | tar -cf /sdcard/so.tar -T -

ADBを終了し、上記ファイルをローカルへ転送します

exit
exit
adb pull /sdcard/nb.tar .
adb pull /sdcard/so.tar .

libndk.soをlibndkの圧縮ファイルへ追加します

tar -xvf so.tar
find system -type l | tar -rf libndk_translation.tar -T -

DOCKERFILEを追加し、以下の内容を入力します：

FROM redroid/redroid:13.0.0-latest

ADD libndk_translation.tar /

libndk入りAndroid 13イメージのビルドを開始します。その後、このイメージredroid:13.0.0-libndkをコンテナ実行に使えるようになります。

docker build . -t redroid:13.0.0-libndk

參考資料
#

LinuxにBliss OSをインストールする方法：GPUアクセラレーション対応Android-x86仮想マシンでスマホゲームを遊ぶ

infoivonblog.nkfjt@aleeas.com (Ivon Huang) — Thu, 11 Jul 2024 15:00:00 +0800

LinuxシステムでAndroidアプリを動かす方法について、IvonはLinux Android Emulatorsの記事で複数の方案に触れました。本記事ではAndroid-x86の分岐である「Bliss OS」を紹介します。

Bliss OSはAndroid-x86の改良版と言えるもので、物理機にも仮想マシンにもインストールでき、Intel第10世代以降のGPUなど多くの新しいハードウェアに対応しています。Androidバージョンの更新も比較的速いです。

Google Playストアを内蔵し、別途トランスレーターを入れなくても64ビットの3Dゲームを遊べます。これはかなり大きな進歩です。

この記事では、LinuxにBliss OSのQEMU/KVM仮想マシンをインストールし、virglrendererで仮想マシンのGPUアクセラレーションを行い、スマホゲームを遊べるようにする方法を扱います。

動画版のインストール手順はこちら：

1. なぜBliss OSを選ぶのか？
#

2. 仮想マシンのインストールに必要なソフトウェアとハードウェア
#

私のシステム仕様：

CPU：Intel i5-10210U
GPU：Intel® UHD Graphics 620
Android-x86バージョン：11.0
QEMUバージョン：8.1.1
virglrendererバージョン：0.10.4

CPUの仮想化が有効で、KVMカーネルモジュールが読み込まれていることを確認してください。

LinuxシステムにQEMU、Libvirt、Virt Managerパッケージをインストールしてください。Ubuntuはこの記事を参考にインストールします。Arch Linuxはこの記事を参考にしてください。

次に互換性のあるグラフィックカードを用意します。virglrendererは準仮想化GPU技術で、QEMU/KVM仮想マシンがGPUパススルーなしで3Dハードウェアアクセラレーションを得られます。

virglrendererにはIntelとAMDのグラフィックカードをおすすめします。Nvidiaクローズドソースドライバーのvirglrendererはあまり安定していません。

GPUパススルーをやる場合、NvidiaはAndroid側ドライバーに問題があるため、IntelまたはAMD GPUを使う必要があります。

Nvidiaグラフィックカードの場合、ハードウェアアクセラレーションを諦め、Bliss OSのNo HW Accelerationモードで起動することをおすすめします。

3. Bliss OSシステムのインストール開始、ディスク分割
#

Bliss OS公式サイトは各種バージョンのISOを提供しており、インストール方法はおおむね同じです。

Bliss OS 14（Android 11）とBliss OS 15（Android 12L）はIntel libhoudiniでARMアーキテクチャのAPKを変換します。それ以降のバージョンではGoogle libndkに切り替わっています。

ここではBliss OS 15を例にします。

公式サイトまたはSourceForgeからISOをダウンロードし、GApps内蔵版 (Bliss OS 15.9.x (x86_64-v2) with GApps) を選びます。その後、ファイル破損を防ぐためファイルの完全性を確認します。
Virt Managerを開き、新規仮想マシンを作成し、ISOを選択します。システムはAndroid-x86を選びます
8GB RAM、4コアCPUの割り当てをおすすめします。ARM命令変換が大量のRAMを消費することがあるため、RAMは多いほど良いです。
少なくとも64GBの仮想ディスクを割り当てます
インストール前に設定をカスタマイズする項目にチェックを入れます
チップセットタイプはQ35、ファームウェアはUEFI (OVMF_CODE.fd) を選択します
ディスクをVirtIOに設定します
CDROMをSATAに変更します
起動デバイスをすべてチェックし、CDROMを一番上に置きます
Spiceのリッスンタイプをなしに設定し、OpenGLにチェックを入れ、デバイスでIntelグラフィックカードを選択します
ビデオカードをVirtIOに設定し、3Dアクセラレーションにチェックを入れます。ここでの3DアクセラレーションはVirGLで実現しています。Linux virtio-gpu virglrenderer for QEMU/KVMを参照してください。
システムのインストール開始をクリックします
キーボードでBliss OS Installationを選択します
Enterを押し、Create/Modify Partitionを選択します
GPTパーティションテーブルを使用することを確認します
キーボードで操作します：左右キーでNewへ移動し、Enterを押し、+512Mを入力し、さらにef00を入力してパーティションタイプをEFIに変更します。パーティション名をefiに設定し、最初のパーティションをEFIパーティションにします。
キーボードでFree Spaceへ移動し、Enterを押してNewを選び、すべてEnterで進め、パーティション名にandroidを入力し、2つ目のパーティションをLinuxシステムパーティションにします。（アライメントの都合で3つのパーティションが出ることがありますが、気にしなくてよいです）
キーボードでWriteへ移動し、Enterで変更を書き込みます。その後Quitへ移動して終了します。
分割済みのディスクvda2を選択します
システムをExt4でフォーマットします
EFI/GRUBをインストールし、フォーマットします
インストール後、Virt Managerの強制シャットダウンボタンをクリックします。ハードウェア一覧からCDROMを削除します
以後の起動では最初の選択肢を選ぶと、デフォルトでvirglrendererアクセラレーションのシステムが読み込まれます。ハードウェアアクセラレーションなしの選択肢をテストする場合は、QEMUビデオカードをQXLに変更し、起動時にVM Options → VBox/VMWare - No HW Accelerationを選択して起動してください。

Bliss OSはGoogle Playストアを内蔵しており、デバイス認証なしで直接Googleアカウントにログインできます。

ARMトランスレーターはデフォルトで有効なので、手動インストールは不要です。

4. Bliss OSの画面解像度を変更する方法
#

起動メニューでVM Options → Debug QEMU/KVM VirGLを選び、Android shellに入ります
blikidコマンドでEFIディスクパーティションを確認します。通常は/dev/sda1です
EFIパーティションをマウントします

mount /dev/sda1 /mnt

android.cfgを編集します

cd /mnt/efi/boot

vi android.cfg

まずlinux $kd/kernelの行を見つけ、最後にvideo=1920*1080を追加します。次にset gfxmode=の行を見つけ、解像度を変更します。
再起動

umount /dev/sda1

reboot -f

別の解像度変更方法として、SecondScreenをインストールして強制調整する方法もあります。

解像度変更後にマウスが同期できない場合は、2本目のマウスを用意し、Virt ManagerのUSBリダイレクト機能でパススルーする必要があります。

Virt ManagerのウィンドウはBliss OS仮想マシンの解像度変化に反応できないようで、画面が依然としてぼやけて見えます。

5. Bliss OS使用テクニック
#

Bliss OSはデフォルトでBoringdroidのデスクトップモードを有効にしており、システム下部にタスクバーが常駐します。

全画面で実行したいアプリがある場合は、システム設定 → Boringdroid → Set full screen appで選択できます。

Bliss OSには「Set Orientation」アプリがプリインストールされており、画面を強制回転できます。ただしこれは古すぎるので、私はOHMAE Ryosuke’s Force Rotation Screenの方が使いやすいと思います。

スクリーンショットはプルダウンメニューから撮影します。画面録画については、virglrendererで録ると色がおかしくなるため、PC側のOBS Studioで仮想マシンウィンドウをキャプチャすることをおすすめします。

ネイティブAndroidのマルチウィンドウ対応はあまり良くありません。どうしても使うなら、開発者向けオプションで「自由形式ウィンドウ」を有効にできます。

Bliss OSはKernelSUとTermuxを内蔵しています。Root権限は全域で有効ではなく、個別アプリに対してマウントする必要があります。

仮想マシンのADB接続はReddit記事を参考にして無線接続しました。ADB ShellでRoot権限を有効にするには、KernelSUを開いて「com.android.shell」に権限を付与すればよいです。

6. 実際にBliss OSでゲームを遊ぶ
#

ゲームのインストールは、x86アーキテクチャをネイティブサポートするバージョンをおすすめします。Google Playが自動でフィルタしてくれるはずです。ARMアーキテクチャのAPKをインストールすると、システムは変換のために追加リソースを消費します。

ゲームがエミュレーターを検出しなければ起動するはずですが、一部のゲームでは動画再生に問題があります。おそらくvirglrendererのbugです。起動メニューのDebuggingメニューでhwcomposer.drm方式を使って起動してみてください。

ゲームでマウスクリックが反応しない場合は、システム設定 → Blissify → Force Mouse Click as touchで、マウスクリックイベントを強制的にタッチクリックへ変換できます。このオプションを有効にするとマウスホイールが無効になる点に注意してください。

Bliss OSは「ゲームモード」を内蔵しており、システム設定 → Blissify → Gaming Modeで有効化できます。ユーザーがゲームアプリを開くと通知が自動で無効化され、スクリーンショットに便利なフローティングボタンが表示されます。

一部のゲームはキーマッピングがないと操作できません。KernelSUを開いてXtMapperにRoot権限を付与できます。次にXtMapperを開き、サービスを有効化し、アプリを選択してキー割り当てを設定します。

また、QtScrcpyのキーマッピングも仮想マシンと組み合わせて使えます。

Bliss OSトランスレーターの実力をテストするため、以下のゲームはすべてARM-v8アーキテクチャのAPKでテストしました。Google Playがインストールさせてくれない場合は、自分でAPKを探してください。

《Fruit Ninja》、《Temple Run 2》は正常に動作します。

次は《原神》です。Waydroidでは動くので、理論上Bliss OSでもいけるはずですが… virglrendererがあまり安定せず、原神v4.1.0はシェーダーコンパイル時にクラッシュします。

もう一つの大型ゲーム《Tower of Fantasy》は、スクリプトなしで正常にゲームへ入れました。

Scrcpy on Ivon's Blog

LinuxでAndroid Studioエミュレーターをスマホゲーム用に使う考え方（Playストア＋Nvidia GPUアクセラレーション＋AVD単独実行）

1. 仮想化とグラフィックドライバーを確認 #

2. Android Studioをインストール #

3. AVDエミュレーターを追加 #

4. IDEを起動せずAVDエミュレーターだけを起動 #

5. QtScrcpyと組み合わせてキーマッピングを使う #

6. 複数アプリを起動 #

7. アプリがクラッシュする場合 #

參考資料 #

ReDroidチュートリアル：DockerでAndroidシステムを動かし、x86 PCでARMスマホゲームを遊ぶ

1. ReDroidシステム要件 #

2. ReDroid前提依存項目をインストール #

3. ReDroidイメージに事前にGAppsをインストール #

4. docker-composeでReDroidコンテナを起動 #

5. ReDroidにAPKをインストールする方法 #

6. ReDroidを「起動・停止」する方法 #

7. ReDroid多重起動の例 #

付録 #

參考資料 #

LinuxにBliss OSをインストールする方法：GPUアクセラレーション対応Android-x86仮想マシンでスマホゲームを遊ぶ

1. なぜBliss OSを選ぶのか？ #

2. 仮想マシンのインストールに必要なソフトウェアとハードウェア #

3. Bliss OSシステムのインストール開始、ディスク分割 #

4. Bliss OSの画面解像度を変更する方法 #

5. Bliss OS使用テクニック #

6. 実際にBliss OSでゲームを遊ぶ #

參考資料 #

1. 仮想化とグラフィックドライバーを確認
#

2. Android Studioをインストール
#

3. AVDエミュレーターを追加
#

4. IDEを起動せずAVDエミュレーターだけを起動
#

5. QtScrcpyと組み合わせてキーマッピングを使う
#

6. 複数アプリを起動
#

7. アプリがクラッシュする場合
#

參考資料
#

1. ReDroidシステム要件
#

2. ReDroid前提依存項目をインストール
#

3. ReDroidイメージに事前にGAppsをインストール
#

4. docker-composeでReDroidコンテナを起動
#

5. ReDroidにAPKをインストールする方法
#

6. ReDroidを「起動・停止」する方法
#

7. ReDroid多重起動の例
#

付録
#

參考資料
#

1. なぜBliss OSを選ぶのか？
#

2. 仮想マシンのインストールに必要なソフトウェアとハードウェア
#

3. Bliss OSシステムのインストール開始、ディスク分割
#

4. Bliss OSの画面解像度を変更する方法
#

5. Bliss OS使用テクニック
#

6. 実際にBliss OSでゲームを遊ぶ
#

參考資料
#