インストール - WayDroidのソースを表示

== 概要 ==
Waydroidは、Ubuntuのような通常のGNU/Linuxシステム上で完全なAndroidシステムを起動するコンテナベースのアプローチである。<br>
Linuxの名前空間（user、pid、uts、net、mount、ipc）を使用して、コンテナ内で完全なAndroidシステムを実行して、GNU/Linuxベースのプラットフォーム上でAndroidアプリケーションを提供する。<br>
<br>
コンテナ内のAndroidは、必要なハードウェアに直接アクセスできる。<br>
また、Androidランタイム環境は、LineageOSをベースにカスタマイズされた最小限のAndroidシステムイメージとともに出荷される。<br>
2024年4月現在、使用されているイメージはAndroid 11に基づいている。<br>
<br>
WayDroidは、Debian(Mobian)、UBPorts等の<u>Wayland環境のみ</u>動作することに注意すること。<br>
<br>
Waydroidの詳細を知りたい場合は、[https://docs.waydro.id 公式ドキュメント]を参照すること。<br>
<br><br>

== 依存関係のライブラリのインストール ==
WayDroidを動作させるため、依存関係のライブラリをインストールする。<br>
<br>
==== Debian 11 bullseye / Mobian 11 bullseye ====
 sudo apt install curl ca-certificates python3 lxc 
 # または
 sudo apt install curl ca-certificates python3 \
                  apparmor arch-test bridge-utils busybox-static debootstrap distro-info mmdebstrap uidmap uuid-runtime \
                  fakechroot libdistro-info-perl libfakechroot liblxc1 libpam-cgfs lxc lxc-templates lxcfs
<br>
==== Manjaro ====
 sudo pip install pyclip
 # または
 sudo pamac build python-pyclip
<br>
次に、/boot/boot.txtファイルを以下のように編集する。
 sudo vi /boot/boot.txt
<br>
 # /boot/boot.txtファイル
 
 # 編集前
 setenv bootargs loglevel=4 console=tty0 console=${console} earlycon=uart,mmio32,0x01c28000 consoleblank=0 boot=PARTUUID=${uuid_boot} root=PARTUUID=${uuid_root} rw rootwait quiet audit=0 bootsplash.bootfile=bootsplash-themes/manjaro/bootsplash
 
 # 編集後
 setenv bootargs loglevel=4 console=tty0 console=${console} earlycon=uart,mmio32,0x01c28000 consoleblank=0 boot=PARTUUID=${uuid_boot} root=PARTUUID=${uuid_root} rw rootwait quiet audit=0 bootsplash.bootfile=bootsplash-themes/manjaro/bootsplash psi=1
<br>
設定を適用するため、U-bootをアップデートする。<br>
 sudo pp-uboot-mkscr
<br><br>

== WayDroidのリポジトリの登録 ==
==== Debian / Mobian ====
WayDroidのリポジトリを登録する。<br>
もし、Linuxディストリビューションの検出に失敗した場合は、<code>-s <ディストリビューション名></code>オプションを付加する。<br>
現在サポートされている値は、以下の通りである。<br>
* <code>bookworm</code>
* <code>bullseye</code>
* <code>sid</code>
* <code>mantic</code>
* <code>focal</code>
* <code>jammy</code>
* <code>kinetic</code>
* <code>lunar</code>
* <code>noble</code>
* <code>trixie</code>
 curl https://repo.waydro.id | sudo bash
 または
 curl https://repo.waydro.id | sudo bash -s <ディストリビューション名>
<br>
パッケージ管理システムを更新する。<br> 
 sudo apt update
<br><br>

== WayDroidのインストール ==
==== Debian ====
Waydroidをインストールする。<br>
 sudo apt install waydroid
<br>
次に、WayDroidの初期化プロセスを開始する。<br>
 sudo waydroid init
<br>
WayDroidコンテナデーモンを起動する。<br>
 sudo systemctl start waydroid-container
<br>
==== Mobian ====
WayDroidをインストールする。<br>
 sudo apt update
 sudo apt install waydroid
<br>
次に、WayDroidの初期化プロセスを開始する。<br>
 sudo waydroid init
<br>
WayDroidコンテナデーモンを起動する。<br>
 sudo start waydroid
<br>
==== Manjaro ====
WayDroidをインストールする。<br>
 sudo pacman -S waydroid waydroid-image
 sudo pkexec setup-waydroid
<br>
この時、/var/lib/waydroid/waydroid_base.propファイルの内容の一部に誤りがあるため、修正する。<br>
 sudo vi /var/lib/waydroid/waydroid_base.prop
<br>
 # /var/lib/waydroid/waydroid_base.propファイル
 
 # 編集前
 ...略
 ro.product.waydroid.model=Pine64 PinePhone (1.2)^@
 ro.product.waydroid.name=^@
 
 # 編集後
 ...略
 ro.product.waydroid.model=Pine64 PinePhone (1.2)
 ro.product.waydroid.name=
<br>
次に、WayDroidの初期化プロセスを開始する。<br>
Waydroidを起動する時、自動的に最新のAndroidイメージがダウンロードされる。<br>
 sudo waydroid init
<br>
WayDroidコンテナデーモンを起動する。<br>
 sudo systemctl start waydroid-container
 # または
 sudo start waydroid
<br>
WayDroidコンテナデーモンを自動起動する場合、以下のコマンドを実行する。<br>
 sudo systemctl enable waydroid-container
<br>
WayDroidコンテナデーモンを起動した後、WayDroidセッションをアクティブにする。<br>
 waydroid session start
<br>
WayDroidセッションと対話するためのコマンドを、以降のセクションに記載する。<br>
<br><br>

== 手動でのWayDroidの起動 ==
<code>systemctl</code>コマンドを使用せずにWayDroidを起動するには、以下の手順を行う必要がある。<br>
<br>
# まず、WayDroidコンテナを起動する。
#: <code>sudo waydroid container start</code>
# 次に、ターミナルを起動して、WayDroidセッションを開始する。<br>この時、"Android with user 0 is ready"と表示された後、アプリケーションメニューからWayDroidを起動する。
#: <code>waydroid session start</code>
<br><br>

== ネットワークの設定 ==
必要な場合は、WayDroidのセッションを開始する前に、ファイアウォールにおいて以下のようなルールを許可する。<br>
<br>
以下の例では、ufwを使用している。<br>
 # DNSトラフィックを許可する場合
 ufw allow 67
 ufw allow 53
 
 # パケット転送を許可する場合
 ufw default allow FORWARD
<br><br>

== WayDroidをフルスクリーンモードで起動する ==
まず、WayDroidを起動する。
 # Debian 11 bullseye
 sudo waydroid container start
 
 # Mobian 11 bullseye
 sudo start waydroid
<br>
WayDroidの起動中に、以下のコマンドを実行する。<br>
 waydroid show-full-ui
<br><br>

== マルチウィンドウモードでWayDroidを起動する ==
WayDroidのセッションが実行されている間に、プロパティを設定する必要がある。<br>
 waydroid prop set persist.waydroid.multi_windows true
<br>
次に、WayDroidコンテナデーモンを再起動する。<br>
Androidのソフトウェアを起動する準備が整い、マルチウインドウモードで起動できるようになる。<br>
 sudo systemctl restart waydroid-container
<br><br>

== Androidソフトウェアのインストール ==
Androidソフトウェアをインストールする。<br>
 waydroid app install <APKファイルのパス>
<br>
Web上に存在するAPKファイルは、ARM /AArch64のみサポートしている傾向が多いため、x86 64のPCでは動作しない。<br>
その場合、[https://f-droid.org F-Droidをインストール]してアプリケーションを取得することを推奨する。<br>
<br>
または、[https://opengapps.org GAppsイメージ]をインストールした場合は、Playストアを使用することができる。<br>
<br><br>

== Androidソフトウェアの実行 ==
インストールしたAndroidソフトウェア名を確認する。<br>
 waydroid app list
<br>
インストールしたAndroidソフトウェアを実行する。<br>
 waydroid app launch <Androidソフトウェア名>
<br>
また、アプリケーションメニューからアプリケーションを起動することもできる。<br>
<br>
その他、Androidパッケージ名（com.xxx.yyy）が既に分かっている場合は、コマンドラインを実行して起動することもできる。<br>
 waydroid app launch <Androidパッケージ名  例: com.xxx.yyy>
<br><br>

== WayDroidのアンインストール ==
まず、WayDroidのセッションとコンテナを停止する。<br>
 waydroid session stop
 sudo waydroid container stop
<br>
次に、WayDroidをアンインストールする。<br>
 sudo apt purge waydroid
<br>
Linuxを再起動する。<br>
 sudo systemctl reboot
<br>
再起動後、以下のディレクトリを削除する。<br>
 sudo rm -rf /var/lib/waydroid /home/.waydroid ~/waydroid
<br>
再インストールする場合は、再度、WayDroidをインストールして初期化プロセスを開始する。<br>
 sudo apt install waydroid
 sudo waydroid init
<br><br>

== エラー ==
まず、WayDroidが最新であることを確認する。<br>
 waydroid upgrade
<br>
WayDroidコンテナデーモンを停止して、不要なファイルを削除する。<br>
 sudo systemctl stop waydroid-container
 
 sudo rm -rf ~/waydroid ~/.share/waydroid ~/.local/share/waydroid "~/.local/share/applications/*aydroid*"
 sudo rm -rf /var/lib/waydroid /home/.waydroid
<br>
WayDroidを再初期化して、WayDroidコンテナデーモンを開始する。<br>
 sudo waydroid init -f
 sudo systemctl start waydroid-container 
<br>
より詳細なことを知りたい場合は、[https://github.com/waydroid/waydroid/issues 公式WebサイトのWaiDroid Issue Tracker]を参照すること。<br>
<br><br>

__FORCETOC__
[[カテゴリ:PinePhone]]