Linbox-WinEmu模拟器v1.0 安卓完整版

编辑点评：WinEmulator模拟器的升级版本

依托PRoot、Box64/86、Termux-X11等核心技术打造的一款Linbox-WinEmu模拟器，支持运行Windows应用程序和游戏，打破设备系统限制，支持自定义分辨率、多种输入模式、Wine兼容层配置及图形加速功能，无需修改Android系统，即可在移动设备上实现Linux与Windows应用运行。

Linbox-WinEmu使用教程

准备工作

在开始使用 Linbox-WinEmu 之前，请确保完成以下准备工作。首先，进入手机设置，开启开发者选项。在开发者选项中，找到并勾选「USB 调试」和「USB 安装」选项。随后，找到「后台进程限制」或「停止限制子进程」选项，勾选「不允许后台进程被限制」或类似的选项。这一步非常重要，可以避免应用在后台运行时出现报错 9（崩溃/闪退）的问题。

如果应用提示需要存储权限，请授予「管理所有文件」的权限，以便应用能够访问和修改文件系统。

创建第一个容器

首次启动应用后，您需要创建一个 Linux 容器。在应用主界面，双击容器管理（分为wine和fexwine两种）点击「新建容器」按钮

容器创建完成，选择您刚创建的容器作为当前使用的容器。

主要设置说明

Linbox-WinEmu 提供了丰富的设置选项，让您可以根据具体需求调整应用的运行行为。以下是各主要设置面板的详细说明。

常规设置

在常规设置面板中，您可以配置以下选项：

分辨率设置：进入「X11 显示设置」中的分辨率选项，可选择预设分辨率（800x600、1024x768、1280x720、1600x900、1920x1080）或自定义输入分辨率。分辨率越高，画面越精细，但对设备性能要求也越高。默认推荐 1280x720。

容器语言：设置容器启动时的 locale 环境变量（LANG），影响程序界面的语言显示。可选 zh_CN.utf8（简体中文）或 en_US.utf8（英文）。

共享文件夹：添加 Android 设备上的文件夹，使这些文件夹在 Linux 容器内可访问。默认已配置 Download 文件夹共享。点击添加按钮可选择更多文件夹，被共享的文件夹会在容器内挂载到指定路径。

Rootfs 切换：管理多个 Linux 容器，可以添加、删除、重命名容器，或在容器之间切换。当前正在运行的容器无法被删除。切换容器后需要重启应用生效。

X11 显示设置

X11 显示设置面板控制 X11 服务器的行为和显示效果：

触摸方式：应用提供三种触摸操作模式。虚拟触控板模式将屏幕下方区域作为触控板使用，单指移动控制光标，轻点模拟鼠标左键，一指按住加另一指轻点模拟右键，双指移动模拟滚轮。模拟触摸模式中单指点击即为鼠标操作，长按模拟右键。触摸屏模式则直接将屏幕作为触摸屏使用。

屏幕方向：控制 X11 显示的屏幕方向，可选跟随系统自动旋转、固定横屏、固定竖屏、反向横屏或反向竖屏。此设置不影响系统界面的方向。

显示缩放：通过滑块调整 X11 显示的缩放比例，范围从 30% 到 300%。当设备屏幕较大或分辨率较高时，可以适当降低缩放比例以显示更多内容；反之则可放大显示。

保持屏幕常亮：启用此选项后，在 X11 运行期间防止屏幕自动熄灭，适合长时间游戏或观看视频。

PRoot 参数设置

PRoot 参数设置面板允许高级用户调整容器运行参数：

PRoot 选项：可用的选项包括 -L（启用符号链接模拟）、--link2symlink（启用 link2symlink 功能，必要）、--kill-on-exit（退出时清理进程）、--sysvipc（启用 System V IPC 支持）和 --ashmem-memfd（使用 ashmem 内存文件描述符）。建议保持默认选项不变，除非您明确知道某个选项的作用。

启动后执行命令：在此处输入的命令会在容器启动后自动执行。常见的用途包括设置环境变量、启动特定服务或程序。例如，输入 cd /usr/local/games && wine game.exe 可在容器启动后自动运行游戏。

输入控制设置

输入控制系统允许您创建自定义的虚拟按键布局：

创建配置：在「输入控制」设置中，点击「添加配置」创建新的控制方案。为配置命名后，点击「编辑控件」进入编辑器界面。

添加控件：在编辑器中，点击空白区域可添加新的控件。可选的控件类型包括按钮（可绑定键盘按键或鼠标动作）、鼠标区域（拖动时光标跟随移动）、摇杆和滚轮。

绑定动作：选中控件后，点击「绑定」选项进入绑定模式。点击某个按钮或移动摇杆，应用将识别对应的输入信号，然后将其绑定到选中的控件上。例如，将游戏手柄的 A 按钮绑定到键盘的 Enter 键。

调整样式：可以为控件选择不同的图标、形状和颜色，设置控件的透明度。透明度越低，控件在游戏中越不明显，避免遮挡游戏画面。

导入导出：支持将控制配置导出为文件，方便备份或在其他设备上导入使用。

Linbox-WinEmu主要功能

PRoot 容器环境

应用内置 PRoot 技术，无需 root 权限即可在 Android 设备上运行完整的 Linux 容器。支持切换不同的 Linux 发行版 rootfs，兼容 Debian、Ubuntu、Arch Linux 等多种发行版。每个容器可以独立配置语言环境、共享文件夹和启动命令。

X11 显示服务

集成 Termux-X11 作为 X11 服务器，支持自定义分辨率（从 800x600 到 1920x1080 等多种预设，并支持自定义分辨率）。提供三种触摸操作模式：虚拟触控板模式适合精确光标控制；模拟触摸模式支持单指点击和长按右键；触摸屏模式则直接在屏幕上操作。

Wine 兼容层

支持多种 Wine 版本安装和管理，包括 wine-ge-custom、wine-tkg 等优化版本。内置 DXVK、DXVK-ASYNC、DXVK-GPLASYNC 等 DirectX 到 Vulkan 的转换层，以及 VKD3D（Direct3D 12 到 Vulkan）和 D8VK（Direct3D 8 到 Vulkan）支持，显著提升 Windows 游戏的图形性能。

Box64/86 模拟器

内置 Box64 和 Box86 模拟器，使 ARM64/Android 设备能够运行 x86_64 和 x86 架构的 Linux 和 Windows 程序。通过动态翻译技术，在移动设备上实现更广泛的软件兼容性。

输入控制系统

功能完善的虚拟输入控制系统，支持创建和管理多个控制配置文件。每个配置文件可以包含虚拟按键、虚拟摇杆、鼠标区域等控件元素。支持导入导出配置，方便用户分享和备份。

开发者指南

构建项目

要构建 Linbox-WinEmu，请确保您的开发环境满足以下要求：Android Studio 最新版、Android SDK 35、JDK 11 或更高版本。首先克隆项目仓库，然后使用 Android Studio 打开项目目录。等待 Gradle 同步完成后，点击运行按钮即可在已连接的设备或模拟器上运行应用。

目录结构

项目的源代码主要位于 app/src/main/java/org/github/ewt45/winemulator/ 目录下。其中 emu/ 子目录包含 PRoot 容器管理、X11 服务和音频服务等核心功能实现；ui/ 子目录包含 Compose UI 界面代码，setting/ 子目录包含各设置面板的实现；inputcontrols/ 子目录包含虚拟输入控制系统的实现；viewmodel/ 子目录包含 MVVM 架构中的 ViewModel 层代码。

添加新的 rootfs 支持

如需添加对新的 Linux 发行版的支持，需要在 assets/ 目录中放置对应的 rootfs 镜像文件，并在代码中注册相应的发行版信息。具体步骤可参考现有的 Alpine rootfs 配置。

常见问题

应用启动后立即崩溃（报错 9）

这个问题通常是由于 Android 系统限制了后台进程导致的。解决方法如下：进入手机设置，打开「开发者选项」，找到「后台进程限制」或「停止限制子进程」相关选项，选择「不允许后台进程被限制」或「无限制」。部分手机品牌可能将此项放在「电池管理」或「应用后台管理」设置中。

无法安装 rootfs 或安装后无法启动

首先检查设备存储空间是否充足，每个 rootfs 至少需要 2-4GB 空间。其次，确保已授予应用「管理所有文件」权限。如果网络不稳定，建议使用 VPN 或在网络条件较好的环境下重试。

音频无法正常工作

检查容器内 PulseAudio 服务是否正常运行。在终端输入 pulseaudio --check 检查服务状态。如果音频断续，可以尝试在 PRoot 启动命令中添加 -pa 参数或手动启动 PulseAudio。

触摸操作不灵敏或光标漂移

在 X11 显示设置中尝试切换触摸模式。虚拟触控板模式适合需要精确控制的场景。如果使用模拟触摸模式，适当调整光标速度设置。

容器内无法访问共享文件夹

检查共享文件夹路径是否正确，确认 Android 端对应文件夹存在且应用已获得访问权限。在终端中使用 ls /storage/emulated/0/ 命令检查共享目录是否正确挂载。