<p width=100px align="center"><img src="runner.svg"></p>
<h1 align="center">UEngine 运行器 2.1.2</h1>
<hr>
<a href='https://gitee.com/gfdgd-xi/uengine-runner/stargazers'><img src='https://gitee.com/gfdgd-xi/uengine-runner/badge/star.svg?theme=dark' alt='star'></img></a>
<a href='https://gitee.com/gfdgd-xi/uengine-runner/members'><img src='https://gitee.com/gfdgd-xi/uengine-runner/badge/fork.svg?theme=dark' alt='fork'></img></a>
## 介绍
虽然通过Deepin/UOS应用商店已经能够安装部分安卓应用，但对于安卓应用爱好者来说，不能自由地安装任意APK软件包实在是不尽如人意。本软件可以实现在Deepin/UOS上安装任意APK软件包，并能将其启动图标发送到系统桌面或启动器中，方便用户快速启动它。
支持系统：Deepin（amd64）、UOS（amd64/arm64）、Debian（amd64，≥debian 10）、Ubuntu（amd64，≥Ubuntu 20.04）
Debian 10、Debian 11、Ubuntu 20.04 需要从 http://dtk.gfdgdxi.top/ 下载 dtk（版本≥5.5）并安装才能通过运行器的安装程序正确安装 UEngine
## 程序相关网站
作者个人站：https://www.gfdgdxi.top
查询 APK 运行情况：https://gfdgd-xi.github.io/uengine-runner-info/
星火应用商店：https://spark-app.store/
星火社区：https://www.deepinos.org
Deepin 官网：https://www.deepin.org
Deepin 论坛：https://bbs.deepin.org
## 在 Deepin 23 Alpha2/Beta 安装 UEngine 运行器？
> 例如：https://gitee.com/gfdgd-xi/uengine-runner/issues/I6MBBC
需要从以下链接补充依赖：
https://gfdgdxi.lanzoue.com/b01qiu22f
密码:dihl
或者从星火应用商店下载安装，星火应用商店的源里已经补齐 UEngine 运行器在 Deepin 23 Alpha2/Beta 缺少的依赖
然后输入：
```bash
python3 -m pip install pillow
```
## 上架到的应用商店
> 可以从下列应用商店获取 UEngine 运行器
### Deepin/UOS 应用商店
### 星火应用商店
## 安装前必读
+ **UEngine 安装时会自动把要安装的 apk 删除**，如果这个 apk 文件非常重要请**拷贝一个备份版并安装这个备份版或者在程序设置里面选择“备份APK包然后在安装后自动拷贝原先目录”选项**
## 如何升级至最新版本
### 一、使用星火应用商店更新到最新版本
**1、打开星火应用商店并打开到对应的界面，点击“升级”**
**2、然后安装**
**3、结束**
### 二、通过源更新（需要添加星火应用商店源）
输入以下命令即可：
```bash
sudo apt update
sudo apt upgrade
```
### 三、使用程序自带的更新程序更新
**1、打开 UEngine 运行器然后点击“关于”=>“检查更新”，点击“更新（更新过程中会关闭这个应用的所有进程）”**
**2、输入密码进行更新**
**3、提示更新完毕即可**
### 更新内容
#### V2.1.2（2023年08月14日）
**※1、修复 https://gitee.com/gfdgd-xi/uengine-runner/issues/I6ZRZX**
**※2、修复添加应用图标时activity名称错误的问题**
**※3、修复 UEngine 运行器在 23 运行时提示缺失 PIL.Image 库的问题**
#### V2.1.1（2023年07月06日）
**※1、修复在 Ubuntu/Debian 安装 UEngine 时提示“该脚本不支持 deepin”的问题；**
**※2、修复 UEngine 在 debian12 安装无法正常开启 UEngine 的问题；**
**※3、修复在 UEngine 程序菜单检查到 UEngine 不存在但是无法安装的问题；**
**※4、修复了 https://gitee.com/gfdgd-xi/uengine-runner/issues/I6B6C8 的问题；**
**※5、优化了 postinst 和 postrm 脚本；**
6、添加 zenity 依赖；
7、屏蔽在更新程序过程中杀死程序中输出的错误；
8、修改下载 dtk 的网址。
#### V2.1.0（2023年05月13日）
**※1、修复源地址（迁出 Gitlink）；**
**※2、优化 UEngine 安装器，可以在 Debian/Ubuntu 使用（Debian11/Debian10/Ubuntu20.04 需要安装 dtk（≥5.5），dtk 可以从 https://gitee.com/gfdgd-xi/dtk-sources-for-uos-apt/releases 获取）；**
**※3、UEngine 安装器不再强制安装 5.17.3 内核以运行 UEngine 运行环境，只要当前使用内核支持 binder 模块即可继续（安装前会进行检测，如果用 2.0.0/2.0.1 安装了 5.17.3 内核也可以继续使用该内核）；**
**※4、修复 uengine-loading-ubuntu 的问题（参考 #I6CKHB:Ubuntu 22.04 LTS安装运行器并按提示安装UEngine后UEngine服务持续崩溃无法使用 ）以及 binder 模块调用问题。**
#### V2.0.1（2023年04月29日，劳动节版）
**※1、新增移除在 Ubuntu 上安装的 UEngine 及其附属脚本的功能**
**※2、优化 Ubuntu 安装器启用和安装逻辑，不允许在 UOS/Deepin 安装移植的 Ubuntu UEngine**
**※3、Ubuntu 安装器不允许在非 X86 架构上使用**
**※4、在升级/安装运行器的 deb 时会自动移除安装错误的 UEngine 生成的脚本**
**※5、Ubuntu 安装器进行环境监测**
**※6、修复应用商店换源问题（由@Bail修复）**
7、修改作者信息
8、更新使用帮助
9、关于窗口修复系统失败错误的问题并新增安装包构建时间
10、移除赞赏功能
11、微型应用商店适配了更新关闭进程（由@Bail实现）
#### V2.0.0（2023年01月22日，新春版）
**※1、内置微型应用商店，支持评论、评分功能；**
**※2、修复 UEngine 安装器在 Wayland 下无法正常运行的问题；**
**※3、更新 UEngine 安装器安装的 UEngine 版本；**
**※4、修复 UEngine 安装器安装后的 UEngine 无法正常安装 APK 的问题（包括从运行器和 deb 包安装）；**
**※5、UEngine 安装器支持安装使用 SuperSU Root 的镜像；**
**※6、UEngine 安装器安装后的 UEngine 支持开机后自动加载运行环境，无需人手动打开终端运行；**
**※7、放开原先程序内的程序安装量查询功能，并新增打开量查询功能（在程序的关于窗口里打开）；**
**※8、程序更新时不需要关闭所有 Python3 程序，只会关闭自己；**
**※9、新增彩蛋（只在2023年1月22日生效）；**
**※10、修复 UEngine 打包器在部分系统无法打开的问题；**
**※11、新增程序公告功能；**
**※12、修复了程序更新功能从高版本降级到低版本的问题；**
**※13、不强制依赖 Deepin 终端；**
**※14、新增 UEngine 打包器（高级版）；**
15、更改程序论坛网址；
16、新增程序评分功能；
17、修复 UEngine 打包器在打包时无法正确禁用所有选项；
18、UEngine 打包器打包的 deb 不再指定 `deepin-elf-verify` 依赖版本；
19、“更多帮助”功能支持访问云端的帮助内容；
20、更换程序接口；
21、优化菜单栏分类，菜单栏新增图标；
22、程序关于可以查看程序使用的开源协议；
23、修复在 Ubuntu 下安装后启动器没有图标的问题。
#### V1.8.3（2022年12月18日）
**※1、修复安装/打包程序时出现找不到图标的问题；**
**※2、修复部分无法正确获取程序中文名和 Activity 的问题；**
**※3、修复在运行器内打开打包器不会自动填充打包器 APK 路径；**
**※4、问题反馈新增论坛反馈入口。**
#### V1.8.2（2022年11月28日）
**※1、重新恢复 uengine-installer For Ubuntu**
**※2、修复 postrm 的问题**
**※3、修复“添加UEngine应用快捷方式出现问题”的问题**
**※4、修复打包器无参数问题**
**※5、打包器默认勾选“使用 uengine-dc 前缀”**
6、修复Python主版本号判断时潜在的问题（By Bail）
7、新增部分资源入口
#### V1.8.1-1（2022年09月03日）
**※1、修复缺失依赖 python3-matplotlib 导致程序无法开启的问题**
**※2、移除在 Ubuntu 上用于安装 UEngine 的安装工具**
**※3、解决了未输入密码自动回车的 bug**
#### V1.8.1（2022年08月30日）
**※1、修复在 APK 详细信息中图标可能过大导致无法正常使用的问题**
**※2、修复 APK 路径带空格无法正常安装的问题**
3、修复打包器打包的 APK 带下划线“_”无法正常打包的问题
4、修复打包器下方命令返回过多空白行的问题
5、修复程序生成的默认图标任然是旧版图标的问题
#### V1.8.0（2022年07月27日）
**※1、程序界面大部分由 Tkinter 转 PyQt5**
**※2、添加了自动/手动配置 UEngine 窗口大小文件（自动需要在设置里手动开启，配置窗口的配置文件需要 Root）**
**※3、增加了安装/卸载失败后的提示**
**※4、补回谢明名单**
**※5、支持免密安装/卸载 APK**
6、pip 更换华为源，提升下载速度
7、新增主题功能
8、支持在安装 APK 后手动指定分类（手动指定需要在设置里手动开启）
#### V1.7.0（2022年07月08日，暑假开始）
**※1、新增暗黑主题**
**※2、优化 deepin-terminal 在其它发行版显示奇奇怪怪的问题**
**※3、修复 UEngine 安装脚本在安装时不让用户选择，直接默认 N 无法安装的问题**
4、新增设置 UEngine 代理的功能
5、将执行命令和打包器的返回输出从命令结束后显示输出内容改为实时显示内容
#### V1.6.2（2022年06月21日，中考假期+即将期末考试）
**※1、优化了 UEngine 运行器的英语翻译**
**※2、新增加了可以打开或关闭第三方应用安装的功能（使用此功能后在UEngine里可以使用默认的APK安装程序安装应用，此操作需要使用程序的Adb补丁）**
**※3、新增加了 UEngine 的 Ubuntu 安装程序**
**※4、双包合一，只保留了UOS打包标准，可以从旧标准无缝升级（推荐使用本程序的升级程序进行升级）**
5、修复了本程序在 Ubuntu 上安装和卸载报错而无法继续的问题
6、优化帮助/关于窗口在高分辨率电脑上显示不全的问题
#### V1.6.1（2022年05月21日，521）
**※1、修复了打包 deb 包在 APK 的包名有大写时无法启动的问题**
**※2、提供新版本的 UEngine Root 镜像**
**※3、更新了 UEngine Root 的下载地址**
**※4、修复了本程序的“UEngine 键盘映射”无法启动的问题**
5、把构建 UEngine Root 镜像修改为多线程下载（wget=>aria2）
6、提供了 UEngine 运行器的 API（可以从项目地址中获取）
7、补上遗漏的项目参与者“星空露光”，新加参与者
#### V1.6.0（开学版，开学前一天完成）
**※1、更换了新的图标已完成（感谢[@星空露光](https://gitee.com/Cynorkyle)）**
**※2、支持程序的评分和查看分数详情的功能**
**※3、修复了在安装奇奇怪怪的安装包（如格式、标识不正确的）时的快捷方式图标为空以及快捷方式文本的变化**
**※4、添加更新功能，可以自行升级到最新版本**
**※5、新增程序帮助**
6、新填彩蛋（在“关于”=>“关于”显示的窗口双击“关于”开启）
7、修复了“UEngine 打包器”前缀选项勾选设置不生效的问题
8、修复了“UEngine 打包器” 打包的安装包版本号带 V 无法打包的情况
#### V1.5.3（2021-12-12，DDUC11版）：
##### 更新内容
**※1、修复了在 UOS 家庭版安装 apk 文件安装包信息为 None 的问题**
**※2、“添加/删除 UEngine 图标”窗口的写入按钮在目录** `~/.local/share/icons/hicolor/256x256/apps`**不存在时点击无反应，参考报错1.5.3-1**
**※3、修复了“UEngine APK 应用打包器”打包的deb包的.desktop文件的** `Icon`**和** `Exec`**字段有误的问题以及使用“使用前缀‘uengine-dc’”前缀的问题**
4、“UEngine APK 应用打包器”支持打包完后自动删除临时目录
5、“UEngine APK 应用打包器”以及“添加/删除 UEngine 图标”支持在运行出现错误时显示报错
##### 报错：
*1.5.3-1*
```bash
Exception in Tkinter callback
Traceback (most recent call last):
File "/usr/lib/python3.7/tkinter/__init__.py", line 1705, in __call__
return self.func(*args)
File "/home/gfdgd_xi/Desktop/uengine-runner/main.py", line 865, in SaveDesktopLink
shutil.copy(programPath + "/defult.png", iconSavePath)
File "/usr/lib/python3.7/shutil.py", line 245, in copy
copyfile(src, dst, follow_symlinks=follow_symlinks)
File "/usr/lib/python3.7/shutil.py", line 121, in copyfile
with open(dst, 'wb') as fdst:
FileNotFoundError: [Errno 2] No such file or directory: '/home/gfdgd_xi/.local/share/icons/hicolor/256x256/apps/com.miHoYo.cloudgames.ys.png'
```
##### 截图
#### V1.5.2（2021-11-28）：
**※1、支持安装和构建带 Root 的 UEngine 的镜像**
2、更新了反馈链接
#### V1.5.1（2021-10-05，国庆节版）：
**※1、精简用户界面，合并安装和卸载输入框和浏览按钮等**
**※2、修复安装以其的程序图标无法点击进入的问题（deepin 社区版不存在此问题）**
**※3、支持在程序本体反馈问题**
4、修复了菜单栏的部分显示问题
5、支持显示 apk 的部分信息
6、支持删除 UEngine 程序运行检查以及重新安装 UEngine 的功能
7、自带有跳过家庭版必须有指定包名才能运行程序限制的脚本
8、补回依赖包“adb”
#### V1.5.0（2021-09-21，中秋节版）：
**没有什么实质性的功能，只是开始有多语言支持**
**※1、部分窗口支持英语**
2、修复在英语状态下启动器图标名称异常的问题
#### V1.4.3（2021-09-11，开学第一版）：
**※1、支持打包器打包的包名带前缀“uengine-dc”**
**※2、修复了两种情况可能导致程序卡住/出错无法继续运行的情况（配置文件夹不齐全和获取版本信息卡住两种情况）**
**※3、修改了 UEngine 打包器打包的应用包名可能有大写的情况**
4、支持一键使用 Scrcpy 连接 UEngine（①先安装 adb 破解补丁；②请确保是使用snap安装的 Scrcpy【目前只支持 snap 安装的 Scrcpy 进行连接】）
5、支持右键打包 apk
#### V1.4.2（2021-08-30，快开学了）：
**※1、添加adb破解补丁（用于可以让adb连接UEngine）并支持adb的部分操作;**
2、菜单栏的项目添加以及外观优化;
3、修复键盘映射无法添加新映射的问题并修改键盘映射启动方式;
4、把 uengine 改为 UEngine;
5、修改 pkexec 获取密码时显示的图标和文本;
6、添加了 UEngine 系统设置的快捷方式;
#### V1.4.1（2021-08-26）：
**※1、初步支持键盘映射**
2、修复新版包在发送uengine列表快捷方式时会提示找不到文件
#### V1.4.0（2021-08-19）：
**※1、添加新版打包方式（deepin打包方式）;**
**※2、支持测试运行/创建/删除uengine图标;**
**※3、支持提取安装的apk;**
**※4、支持打包deb包;**
5、修改菜单栏布局;
6、支持打开uengine数据目录和用户数据目录;
7、程序信息保存到json,非直接写入程序本体;
8、更多命令操作;
#### V1.3.2（2021-08-16）：
**※1、支持uengine数据重置;**
**※2、支持修改uengine网络桥接的启动状态;**
**※3、支持右键安装/卸载;**
**※4、支持启用或禁用uengine;**
**※5、修复打包问题，不会出现“dpkg:警告:卸载spark-uengine-runner时，目录/opt/apps/uengine-runner非空，因而不会删除该目录”的错误;**
#### V1.3.1（2021-08-12）：
**※1、修复打包问题，防止部分用户安装出错的问题;**
**※2、修复了程序无法提取图标时可以提取默认图标使用;**
#### V1.3.0（2021-08-08）：
**※1、修改了界面布局;**
**※2、修复大多数新安装普通用户的路图标及启动菜单文件路径不存在导致安装APK报错的bugs;**
3、删除少量冗余代码，调整代码顺序;
4、支持提取 apk 图标。
#### V1.2.3（2021-08-02）：
1、调整部分控件名称；
2、调整界面布局及界面风格；
#### V1.2.2（2021-07-11）：
1、对程序错误的显示更加人性化；
2、对 icon 的获取方式进行了升级；
3、增加了注释、删除部分冗余代码。
#### V1.2.1（2021-07-02）：
**※1、进行了安装方式的修改（不使用 adb），修复原无法安装和卸载的问题；**
2、进行了部分优化；
3、进行了功能缩水；
4、修复 deb 打包错误。
#### V1.2.0（2021-06-06）：
1、支持安装自动添加快捷方式、卸载删除快捷方式；
2、支持使用包名或 APK 文件卸载程序；
3、支持查看安装的所有包名；
4、进行了部分优化
#### V1.1.0（2021-05-30）：
1、修改了因编写时出现的中、英文混用的情况
2、支持一键连接默认 IP
3、修复在不连接设备直接选择 apk 安装时会卡住的问题
4、修复在把“uengine 程序菜单”发送到桌面或启动器如果询问覆盖时点击取消会卡住的问题
5、修改了程序界面为白色调，不和标题栏冲突矛盾
#### V1.0.0（2021-05-29）：
### 源码安装教程
按下 `<kbd>`Ctrl`</kbd>`+`<kbd>`Alt`</kbd>`+`<kbd>`T`</kbd>` 打开终端，按以下内容操作：
1. 安装所需依赖
```bash
sudo apt install make
```
2. 下载本程序
```bash
git clone https://gitee.com/gfdgd-xi/uengine-runner.git
```
3. 运行本程序
```bash
cd uengine-runner
make run
```
如果你想要安装到系统，只需要输入：
```bash
make install
```
即可
### 使用说明
1、需要你有使用 root 权限的能力；
2、需要安装 UEngine 才能使用，UOS建议在商店安装一个安卓应用，让系统自动安装 UEngine 及相关的依赖包；
3、提取 apk 图标的 apk 路径以“安装 apk”那栏为准;
4、如果报错是有关产生 .deksotp 文件有关，一般可以打开程序列表运行。如果想要连接其他手机，请使用 1.2.0 以前的版本，可以使用 adb 连接。
### 故障排除
提 issue 最好，当然有些问题自己无法解决，请大佬 push 一下
如果出现故障，尝试终端运行，如果是可以自行解决的问题，就**自行解决**，如果可以就**提 issues 并提供解决方案**，不行就**提 isscue 并提供程序和终端报错以及程序版本**
### 已知问题
<p align="center"><img src='https://bbs.deepin.org/assets/image/raccoon/[sad].gif'></p>
部分 app 无法读取出图片，已知：
| 程序 | 下载链接 |
| :--------------------: | :------------------------------------: |
| Firefox For Android | https://www.firefox.com.cn/download/ |
| 网易云音乐 For Android | https://music.163.com/#/download |
| 抖音 | https://www.wandoujia.com/apps/7461948 |
| 360 手机浏览器 | https://mse.360.cn/ |
| E-Go | http://www.xiaojump.com/ |
| 其他待测试…… | 其他待测试…… |
**注意：提取不出图标不代表未安装成功！**
### 贡献
<p align="center"><img src='https://bbs.deepin.org/assets/image/raccoon/blush.gif'></p>
非常欢迎大家的贡献
贡献的开发者列表：
| 开发者 | 邮箱 |
| :--------------------------: | :----------------------------: |
| gfdgd xi | 3025613752@qq.com |
| actionchen | 917981399@qq.com |
| 柚子 | https://gitee.com/Limexb |
| 星空露光 | https://gitee.com/Cynorkyle |
| 为什么您不喜欢熊出没和阿布呢 | https://weibo.com/u/7755040136 |
### 相关项目
| 项目名称 | 项目地址 |
| :----------------: | :--------------------------------------------: |
| uengine-installer | https://gitee.com/Maicss/uengine-installer |
| UEngine APK 打包器 | https://gitee.com/gfdgd-xi/uengine-apk-builder |
| Root UEngine | https://gitee.com/Limexb/root-uengine |
### UEngine 运行器的部分技术介绍
可见：https://www.52pojie.cn/thread-1672077-1-1.html
### 附测试生成图标无问题列表：
**至于能不能用就不测试了，这暂时不是重点**
**现在新加了评分功能，就看大家的评分了！**
| 程序 | 下载链接 |
| :-----------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------: |
| QQ 全家桶（完整版、极速版、Android Pad 版） | https://im.qq.com |
| TIM | https://office.qq.com/download.html |
| 微信 | https://weixin.qq.com |
| 百度翻译 | https://fanyi.baidu.com/appdownload/download.html |
| 百度网盘 | https://pan.baidu.com |
| 腾讯课堂 | https://ke.qq.com/download/app.html |
| 抖音极速版 | https://www.douyin.com/downloadpage/app |
| 豌豆荚 | https://www.wandoujia.com/ |
| 小猿口算 | http://kousuan.yuanfudao.com/ |
| Hyperbowl | 忘了/无 |
| bilibili | https://d.bilibili.com/download_app.html?bsource=app_bili |
| 蓝奏云 | https://up.woozooo.com/lanzouh5.apk |
| QQ 音乐（完整版、Android Pad 版、TV 版、车载版） | https://y.qq.com/download/index.html |
| 360 手机卫士（完整版、极速版） | https://shouji.360.cn/v6/index.html |
| 360 清理大师（稳定版、尝鲜版） | http://shouji.360.cn/360cleandroid/ |
| 360 手机助手 | http://sj.360.cn/index.html |
| WPS Office For Android | https://www.wps.cn/ |
| 钉钉 for android | https://page.dingtalk.com/wow/dingtalk/act/download?spm=a3140.8196062.0.0.6f4c5c3dWBhYUM |
### 更多软件
[](https://gitee.com/gfdgd-xi/deep-wine-runner)
[](https://gitee.com/gfdgd-xi/uengine-runner)
[](https://gitee.com/gfdgd-xi/deepin-community-live-cd)
[](https://gitee.com/gfdgd-xi/apt-packages-websize-program)
[](https://gitee.com/gfdgd-xi/simple-remote-desktop-accessor)
[](https://gitee.com/spark-community-works-collections/spark-store-console)
[](https://gitee.com/spark-community-works-collections/spark-webapp-runtime-runner)
[](https://gitee.com/gfdgd-xi/timer)
## ©2021-Now gfdgd xi
马建仓 AI 助手
