インストール
ゴール
このページでは二つのゴールをめざします。
- Meta Quest 2 / Pro に Zen Mirror をインストールする。
- Ubuntu 22.04 / Arch Linux に私たちのデスクトップ環境 Zen をインストールする。
注意
ZwinやZenは全てベータ版です。環境によってはうまく動かない可能性があります。
今後の開発でこれらのクオリティを上げていき、ロードマップに従って新しい機能を追加していく予定です。
パッケージのインストール
Ubuntu 22.04
$ sudo apt-get update
$ sudo apt-get install adb clang cmake git libcairo2-dev \
libcglm-dev libdrm-dev libegl-mesa0 libgbm-dev \
libgles-dev libglm-dev libglu1-mesa-dev libjpeg-dev \
librsvg2-dev libwayland-dev libwlroots-dev meson pkg-config \
wayland-protocols
私たちのデスクトップ環境で動作するアプリケーションをインストールしておくのも良いかもしれません。Zenウォークスルーを完了するためには、westonに含まれるターミナルが必要なので、インストールを特に強く推奨します。
# Optional
$ sudo apt-get install weston
$ sudo apt-get install google-chrome-stable
# apt-get でうまくインストールができない場合は、以下のURLからもChromeをインストールできます。
# https://www.google.com/chrome/?platform=linux
# ChromeではなくChromiumでも構いません。
Arch Linux
任意のAURヘルパーを用いてください。このページでは、 yay による例を示します。
$ yay -Syu
$ yay -S --needed \
git sudo clang make cmake meson ninja python python-pip curl unzip pkgconf \
wayland wayland-protocols wlroots0.15 glm glew librsvg ttf-ubuntu-font-family
私たちのデスクトップ環境で動作するアプリケーションをインストールしておくのも良いかもしれません。
# Optional
$ yay -S --needed weston google-chrome nautilus
ビルドスクリプトの準備
$ git clone https://github.com/zwin-project/zen-release-manager.git
$ cd zen-release-manager
$ pip3 install -r requirements.txt
$ ./zen-release configure ./release/latest.yaml
今後は zen-release-manager ディレクトリの中で作業します。
Meta Quest の開発者モードを有効にする
詳しくはMeta Quest Developer Centerをご覧ください。
Zen Mirror をインストールする
APK ファイルをダウンロードします。
$ ./zen-release download zen-mirror
Meta Quest が認識されるかを確認します。
$ adb devices
List of devices attached
1WMHH815K10424 device # OK
以下のような出力の場合は Meta Quest 側でUSBデバッグを許可する必要があります。
List of devices attached
1WMHH815K10424 unauthorized # NG
APK ファイルをインストールします。
$ adb install ./build/zen-mirror/zen-mirror.apk
「提供元不明のアプリケーション」一覧に Zen Mirror が表示されていれば完了です。
Zen をビルド・インストールする
Arch Linux をお使いの場合、事前に以下のコマンドを実行して下さい。
$ export PKG_CONFIG_PATH="/usr/lib/wlroots0.15/pkgconfig:/usr/local/lib/pkgconfig:/usr/local/lib64/pkgconfig:${PKG_CONFIG_PATH}"
プロトコルのビルドとインストールをします。
$ ./zen-release build protocol
$ sudo ./zen-release install protocol
依存ライブラリのビルドとインストールをします。このステップは10分以上かかるかもしれません。
$ ./zen-release build deps
$ sudo ./zen-release install deps
Zenのビルドとインストールをします。
$ ./zen-release build desktop
$ sudo ./zen-release install desktop
デフォルトの設定ファイルを作成する
適切な場所におすすめの設定ファイルを生成します。設定で詳細をご覧ください。
$ ./zen-release generate-config