ALVR 编译 windwos && android [Streamer &Client]

说明：因为在实际操作中发现，在真机上直接编译会影响环境变量和其他项目的编译，因此这里使用docker的编译，也更为稳妥。

ALVR下载源码地址：ALVR download

1 ALVR windows编译 [Streamer Building]

1.1 环境安装

参照官方文档：https://github.com/alvr-org/ALVR/wiki/Building-From-Source，

@1 rust环境安装：

下载并安装https://static.rust-lang.org/rustup/dist/i686-pc-windows-gnu/rustup-init.exe

@2 在windows平台上还需要另外安装 chocolatey，具体参考：https://chocolatey.org/install

1.2 编译windows版本streaming

关于--gpl选项的说明：
如果想在 ALVR Streamer 中下载、构建和捆绑 FFmpeg，需使用 --gpl 标志。
注意：这仅适用于软件编码，只能以 GPLv2.0 许可的方式重新分发最终包。

编译流程具体如下：

#移动到项目的根目录，然后运行此命令
$cargo xtask prepare-deps --platform windows --gpl
#接下来是流媒体的正确构建。运行以下命令
$cargo xtask build-streamer --release --gpl
#可以在中找到生成的包build/alvr_streamer_windows
$cd build/alvr_streamer_windows;ls

2 ALVR android端 [Client Building]

2.1 构建docker

构建基础docker操作如下：

$docker pull ubuntu:20.04
$docker images
REPOSITORY                                          TAG       IMAGE ID       CREATED        SIZE
ubuntu                                              20.04     [image id]     2 weeks ago    77.8MB
#运行docker，设置共享目录，使用image构建container
$docker run -it -v /data/IrisOpenSource/ALVR:/root/ALVR --name alvr_build_docker [image id] /bin/bash
#退出后再次进入docker时需执行
$docker start [container id]
$docker exec -it [container id] /bin/bash

然后进入到docker中操作即可。

2.2 apt install安装软件

update /etc/apt/source.list，添加内容：

deb http://apt.llvm.org/bullseye/ llvm-toolchain-bullseye-14 main
deb-src http://apt.llvm.org/bullseye/ llvm-toolchain-bullseye-14 main

安装如下软件：

$sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 15CF4D18AF4F7421
$sudo apt update
$sudo apt-get install -y vim tree apt-file android-sdk-platform-tools-common $sdkmanager openjdk-11-jdk
$sudo apt-get install -y build-essential pkg-config libclang-dev libssl-dev libasound2-dev libjack-dev libgtk-3-dev libvulkan-dev libunwind-dev
$sudo apt-get install -y yasm nasm curl libx264-dev libx265-dev libxcb-render0-dev libxcb-shape0-dev
$sudo apt-get install -y libxcb-xfixes0-dev libspeechd-dev libxkbcommon-dev libdrm-dev libva-dev libvulkan-dev
$sudo apt-file update
#install clang14 step process (order,step by step)
# LLVM
$sudo apt-get -y install libllvm-14-ocaml-dev libllvm14 llvm-14 llvm-14-dev llvm-14-doc llvm-14-examples llvm-14-runtime
# Clang and co
$sudo apt-get -y install clang-14 clang-tools-14 clang-14-doc libclang-common-14-dev libclang-14-dev libclang1-14 clang-format-14 python3-clang-14 clangd-14 clang-tidy-14
# libfuzzer
$sudo apt-get -y install libfuzzer-14-dev
# lldb
$sudo apt-get -y install lldb-14
# lld (linker)
$sudo apt-get -y install lld-14
# libc++
$sudo apt-get -y install libc++-14-dev libc++abi-14-dev
# OpenMP
$sudo apt-get -y install libomp-14-dev
# libclc
$sudo apt-get -y install libclc-14-dev
# libunwind
$sudo apt-get -y install libunwind-14-dev
# mlir
$sudo apt-get -y install libmlir-14-dev mlir-14-tools

之后安装rust运行环境，使用官网https://www.rust-lang.org/tools/install编译，具体如下：
#curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
验证rustc和cargo，使用--verison命令验证即可，较为简单，这里忽略。

2.3 设置环境变量

参照官方文档：https://github.com/alvr-org/ALVR/wiki/Building-From-Source，设置环境变量
编辑/root/.bashrc，添加如下内容：

export PATH=$PATH:/root/Android/Sdk/tools/bin:/root/Android/Sdk/platform-tools
export ANDROID_HOME=/root/Android/Sdk/
export ANDROID_NDK_HOME=/root/Android/Sdk/ndk/25.1.8937393/
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64/
source "$HOME/.cargo/env"

2.4 编译

编译流程如下所示：

#工程清理，保持编译环境干净
$cargo clean
#开始编译前，需要收集一些额外的资源来准备构建。这里存在很多下载失败的情况，有时需多次执行该命令。移动到项目根目录，运行以下命令：
$cargo xtask prepare-deps --platform android
#在构建客户端之前，Android 必须让我们同意许可证，否则构建客户端将停止并失败。要接受协议，一路y即可
$sdkmanager --licenses
#接下来是客户端apk的正确构建。运行以下命令：
$cargo xtask build-client --release
#构建的 APK 将位于 build/alvr_client_quest 中,查看后可根据需要拷贝到其他文件夹下
$cd ~/ALVR/build/alvr_client_android;ls
#进入到out目录，即生成apk的文件夹
$cd ~/ALVR/target/release/apk;ls