# Waydroid运行器
**Repository Path**: zhonghongsoftware/waydroid
## Basic Information
- **Project Name**: Waydroid运行器
- **Description**: 基于Gfdgd_xi的waydroid运行器开源项目二次开发
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-01-06
- **Last Updated**: 2024-01-06
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
Waydroid 运行器 1.2.0.1
## 介绍
Waydroid运行器是可以通过GUI形式半自动配置Waydroid的工具，使用户使用Waydroid更为方便。Waydroid本身存在很多因AOSP未考虑PC用户而产生的问题(如没有自带Houdini,默认英语,默认非小窗模式)而使用户使用起来非常难受,本运行器支持以GUI形式自动化安装以及配置Waydroid，并会创建快捷控制的快捷方式，可以用于玩游戏/刷视频/Android开发等。
### 本版本是梦希操作系统项目对梦希操作系统的适配版
若您对本项目有疑问/需要一些帮助，可以进Q群:872491938，我们会尽其所能帮助(偶尔吹水也可以)
## 配置要求
仅限启用 Wayland 的 x86-64 的 Linux，ARM64的在安装Magisk时可能需要重新制作data.img(教程有时间放出来) 显卡仅限Intel & AMD(独立显卡需要启动桌面环境时使用独立显卡,否则无法使用),只有英伟达显卡(连Intel核心显卡都没有的)当前无法使用本项目，建议使用xDroid/UEngine作为替代。
**支持的系统（效果很好）**:Ubuntu 20.04 或更高、Deepin v23 Wayland(最新内测版最好)、Debian 11+(且安装了支持Wayland协议的桌面环境)、Linux MINT(KDE环境)
**支持但效果不好**：YOYO OS以及上述系统的 X11 环境
**支持但效果不好/很差，需要额外调教**：Deepin20.9、UOS家庭版、LingmoOS,Linux Mint(Cinnamon环境)……
**不支持的系统**：UOS 专业版、UOS 教育版、UOS 学生版
支持很好的桌面环境：DDE(deepin v23最新内测),GNOME 42及以上,KDE Plasma 5.27.4及以上(如果低于5.27,使用Wayland的bug估计不少),UnityX 7.7,Xfce 4.20
支持很差的桌面环境：DDE20(deepin 20.9及以下,包括UOS家庭版，但不包括专业版、教育版、学生版),CutefishDE及其二改桌面环境,Budgie(等新版本支持Wayland)
（更多系统测试中）
***Deepin20/UOS 建议用 UEngine，虽然这个老掉牙了***
***Waydroid 和 UEngine、Anbox 无法共存，可以输入以下命令卸载 UEngine***
```bash
sudo apt purge uengine
sudo apt autopurge
```
## 安装&使用教程
下载安装本软件,然后按照提示执行或使用功能即可
如果 `waydroid-android-image-gapps` 这个包下载慢，可以到这里手动下载 deb 包：https://github.com/gfdgd-xi/waydroid-android-image-gapps/releases/
### LingmoOS 如何调教以便能运行 Waydroid？
***此方法有危险性，可能导致系统崩溃***
安装源里其他的内核或者安装以下链接的内核并重启切换后用 Waydroid 运行器自带的 Waydroid 安装程序安装即可
内核链接：https://gfdgdxi.lanzoue.com/b01r54ple 密码:35j0
### Deepin20/UOS 家庭版如何调教以便能运行 Waydroid？
***此方法有危险性，可能导致系统崩溃***
目前 Waydroid 运行器自带的 Waydroid 安装程序（国内源）可以自动处理，但你依旧可以手动处理：
### 升级系统 lxc 版本
在这里下载 lxc 包并升级：
https://gfdgdxi.lanzoue.com/b01r5slyh
密码:1zre
### 安装 Waydroid
使用运行器自带的安装程序即可，但如果要安装原版的 Waydroid，则需要自行编译 `python-gbinder`，方法如下：
```bash
sudo apt update
sudo apt install dpkg-dev git fakeroot
# 编译 libglibutil
git clone https://github.com/waydroid/libglibutil
cd libglibutil
sudo apt build-dep .
dpkg-buildpackage -b
cd ..
sudo apt install ./*.deb
# 编译 libgbinder
git clone https://github.com/waydroid/libgbinder
cd libgbinder
sudo apt build-dep .
dpkg-buildpackage -b
cd ..
sudo apt install ./*.deb
# 编译 python-gbinder
git clone https://github.com/waydroid/gbinder-python
cd gbinder-python
sudo apt build-dep .
sudo dpkg-buildpackage -b
cd ..
sudo apt install ./*.deb
```
## 当前系统的内核不支持运行 Waydroid 怎么办（如 Kail Linux）？
**理论上不会出现此问题:Waydroid文档说明只要内核版本>=4.4即可**
**相反,很多时候跑不了Waydroid是因为LXC库太老/桌面太老或者跟Cinnamon一样不支持Wayland**
可以自行寻找或编译支持的内核，或直接安装下面测试无问题的内核：
https://gfdgdxi.lanzoue.com/b01r54ple 密码:35j0
## 安装 UEngine For Ubuntu 后无法正常启动 Waydroid 怎么办？
需要输入以下命令卸载 UEngine For Ubuntu（核心原因是 lxc 版本过老）
```bash
sudo apt-mark unhold lxc lxc-templates liblxc1 liblxc-common lxc-utils
sudo apt purge uengine uengine-android-image uengine-modules-dkms
sudo apt update
sudo apt install lxc
```
## 效果演示
### Deepin20（X11）
需要使用 Sway/Weston 以及升级 lxc（运行器可以自动配置）
### UOS 家庭版
需要使用 Sway/Weston 以及升级 lxc（运行器可以自动配置）
### Deepin23
#### X11
需要使用 Sway/Weston（运行器可以自动配置）
#### Wayland
无需特殊操作
### Kail Linux（X11）
需要使用 Sway/Weston（运行器可以自动配置）以及更换内核（需手动设置）
### YOYO OS（X11）
需要使用 Sway/Weston（运行器可以自动配置）
### LingmoOS
需要使用 Sway/Weston（运行器可以自动配置）
### Ubuntu
#### 20.04
需要使用 Sway/Weston（运行器可以自动配置）
#### 22.04
无需特殊操作
### Openkylin
#### X11
需要使用 Sway/Weston（运行器可以自动配置）且需要升级系统 lxc 版本（需手动设置）
#### Wayland
需要升级系统 lxc 版本（需手动设置）
### UbuntuKylin
需要使用 Sway/Weston（运行器可以自动配置）
## 源码安装教程
```bash
git clone https://gitee.com/gfdgd-xi/waydroid-runner
cd waydroid-runner
make install -j4
```
## 参与贡献
@Telegram HuskyDG 巨佬贡献的 `Magisk` 安装到 `/system` 分区的方案和他的 `Magisk-Delta`
@casualsuek 的 `Waydroid-Script` 代码
@Quackdoc 的 Waydroid-Choose-gpu.sh
## ©2023~Now gfdgd xi、Bail、LFRon