sohzm/winedroid
系统工具一个实验性的 Android 兼容层,无需启动 Android 系统即可在 Linux、macOS 和浏览器中运行 APK。
项目简介
WineDroid 是面向 Linux、macOS 和浏览器的实验性 Android 兼容层,思路类似 Wine:不启动 Android 系统,直接运行 Android APK。它执行 DEX 字节码、实现部分 Android 框架行为,并用 Skia 渲染应用界面。桌面构建带有 Cranelift JIT,WebAssembly 构建则用解释器复用同一套运行时和渲染器。
项目仍处于非常早期的开发阶段,部分应用和工作流可以运行,但预期会缺少 API、遇到无法启动的应用。公开的 AppDB 记录了兼容性、截图和已知问题,并按 Gold/Silver/Bronze 评级,目前样例多为天气、计算器一类简单应用。
本地运行
需要较新的稳定版 Rust 工具链和本机 C/C++ 构建工具。macOS 上用 Xcode Command Line Tools;Linux 上还需安装 pkg-config 以及 FreeType、Fontconfig 开发包,并在 X11 或 Wayland 会话下运行。
git clone https://github.com/sohzm/winedroid.git
cd winedroid
cargo build --release --locked --bin winedroid
./target/release/winedroid /path/to/app.apk
应用数据默认存放在 ~/.winedroid/default,可通过 WINEDROID_PREFIX 指定其他目录。包管理、显示设置和性能分析见使用文档。只想试用的话,可以直接打开托管好的浏览器演示,选择或拖入 APK,无需本地构建。
浏览器运行
在 PATH 中有 Emscripten 的 emcc 并安装 Python 3 后,构建 WebAssembly 版本并在本地提供页面:
rustup target add wasm32-unknown-emscripten
scripts/build_web.sh
python3 -m http.server 4173 --directory web
打开 http://localhost:4173 后加载 APK。刷新页面会丢失应用数据;浏览器构建不支持 Android 原生 .so 库和 Cranelift JIT。
限制与行为
默认采用尽力而为的执行方式:调用到明确未支持的底层原语时,运行时打印 FIXME,并按返回类型替换为 void、数值零或 null。替换后的输出不能证明兼容性,缺少的对象也可能导致后续失败。设置 WINEDROID_STRICT=1 可在遇到缺失支持时停止,WINEDROID_MISSING_PRIMITIVE_LOG 可保存缺失原语报告。--trace(或 WINEDROID_TRACE)可开启启动、界面、交互、自动化和缺失调用等跟踪。
兼容性高度依赖具体应用:大量 Android API 尚未实现,浏览器构建还会失去原生库支持。代码采用 GPLv3 only 许可,第三方组件声明单独维护。
HotRepo 点评
HotRepo 记录到 winedroid 在 2026-11-21 首次进入新项目榜时累计 100 Star、4 Fork,增长窗口从前一晚开始。这只是项目刚出现时的一条早期快照,不足以说明持续热度,也与一个刚公开的实验性运行时相符。对读者更有价值的信号是项目对自身范围的说明:桌面 JIT 与浏览器解释器共用 Rust 运行时,并配有逐应用兼容性报告,便于在投入构建前判断当前可用程度。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- reveny/Android-Compatibility-Layer在 Wayland Linux 上直接运行 APK 的早期兼容层,面向想避开完整 Android 容器的桌面游戏玩家与折腾用户。
- wukongdaily/boxadb一个网页版 ADB 助手,在局域网内为电视盒子 / Android TV 提供装 APK、终端、遥控、截图和重启功能。
- unixzii/Champagne无需虚拟机,把 Snow Leopard 应用当作普通桌面窗口运行在 macOS 和 Windows 上。
- Leviidev/Husk让 iPhone 通过原生翻译层或 QEMU 模拟运行 Android 应用与游戏的工具。
- hoangsvit/google-ai通过 Android、ADB 与 Frida 在 Google Play 中检查 Google AI Pro 优惠的 Windows/macOS 终端工具。