← 返回文档中心
MD 使用文档

安卓版功能迁移与验证对照

安卓版功能迁移与验证对照

功能迁移与验证对照

2026-09-05。这里的“已接入”表示存在实现与调用链,不等于真机运行已通过。未以占位页面替换主要功能。

| 模块 | Android 实现 | 验证/边界 | | --- | --- | --- | | 首页与布局 | 模块排序/隐藏、壁纸、日历、资讯、账号/实例选择、启动统计、快速进入世界/服务器 | 首页手机截图检查通过;在线资讯与快速进入游戏未端到端验证 | | 实例 | 创建、复制、删除、独立目录、启动预设、内存/JVM参数、模组目录 | 创建/复制/内容保留单测通过;带实例的手机页面渲染通过 | | 账号与皮肤 | 离线账号、微软 OAuth PKCE、回环回调、令牌刷新、Android Keystore、皮肤管理/图片处理 | 离线账号调用及页面通过;微软真实账号/皮肤上传、真实 Keystore 尚待设备测试 | | 游戏下载 | Mojang 清单、原版安装、Fabric/Quilt/Forge/NeoForge、Java 自动匹配 | 代码已接入;完整下载、安装器 JNI 执行及每种加载器组合未实机验证 | | 下载队列 | 多线程、分段、重试、取消、下载源与镜像、校验、进度 | 本地 HTTP 流读取与错误校验拒绝测试通过;后台被杀后自动恢复未实现 | | 内容中心 | Modrinth 搜索/详情/依赖、模组、服务端插件、光影、材质、整合包导入、更新/启停 | 本地内容导入与 ZIP 路径穿越拒绝测试通过;远程项目安装和整合包逐个兼容性待验 | | 多人游戏 | 地址管理、收藏、快速启动、服务器信息 | 添加服务器和有数据的页面测试通过;真实联网进服未验证 | | 本地开服 | 原版/Paper/Fabric/自定义 JAR,独立 JNI Java 进程、stdin 控制台、资源/日志、配置、备份、自动化 | UI 与实现已迁移,服务器实际运行和控制台命令待真机验证;最多三个后台 JVM;断电/系统杀进程后调度不保证 | | 工具箱 | 崩溃诊断、兼容性检查、快照/恢复、清理、分段下载 | 快照恢复和本地文件测试通过;内存优化仅回收本应用可回收内存,不清理系统/其他应用 | | 音乐 | 歌单/导入、进度、暂停/继续、顺序/循环/随机;Android MediaPlayer | 页面渲染通过;实际音频解码、音频焦点及系统媒体通知控制仍需完善验证 | | 设置 | 九语言、主题、文字缩放、壁纸/颜色/透明度、目录、Java、下载源、插件、更新 | 设置读写单测与截图检查通过;Android 专属说明目前中文 | | 文件操作 | 系统选择器导入;私有目录浏览/新建;系统 CreateDocument 导出文件 | 已实现;设备文件提供方授权流程尚未真机测试 | | Java | 内置 FCL Android OpenJDK 8/17/21/25,ABI选择、解包、独立进程 JNI 调用 | 包内资源及构建通过;Java -version 设备测试已编写但未运行成功,不声称实际 JVM 已启动 | | 图形与输入 | GL4ES/NG-GL4ES、补丁版 LWJGL、Cacio AWT、OpenAL、Surface、触屏/常用键鼠 | 接入代码与 JNI 桥,未验证首帧/声音/帧率/具体模组兼容;不是已证实可玩的完整引擎集成 | | 自定义 Java | 扫描和指定本应用安装过的 Android Java 目录 | 不支持导入任意 Windows/Linux桌面 JDK;任意外部 Android JRE 压缩包导入未实现 | | 启动器扩展插件 | DEX 类加载器、插件清单/启停/权限入口 | 桌面纯 JVM JAR 不能直接运行;需带 classes.dex 和 Android 兼容 API。未经过真实插件验证,权限声明不是进程沙箱,只装可信插件 | | 自动更新 | 识别 APK,拒绝以桌面更新强制阻断 Android,交给系统安装器确认 | 版本判定单测通过;服务端须发布 Android 更新元数据,真实下载安装未验证 |

与桌面功能不等价之处

没有删除本地开服、加载器、扩展插件等困难模块来缩小功能范围,但这些模块的 Android 兼容工作尚未全部验证完成。 桌面窗口透明改为应用内容透明,桌面系统路径改为 Android 私有目录,系统全局内存操作被平台限制。 开服/音乐页暂用可左右滚动的宽布局;其余主要页面已调整为竖屏布局,复杂弹窗与极小屏仍需继续检查。

发布前必须补齐的验收

  1. ARM64 真机上执行内置 Java 8/17/21/25,并验证 JNI 动态链接、日志与 stdin。
  2. 至少旧版 Java 8 游戏、1.20.1、Java 21 游戏和 Java 25 游戏各跑通首帧、世界加载、保存退出。
  3. 分别验证 Fabric/Quilt/Forge/NeoForge、模组/光影、正版登录、联网及皮肤。
  4. 本地开服启动/停止/命令/重启/备份,前后台切换和系统任务限制。
  5. Android 8–15+、ARM64/x86_64、不同 GPU 与 16 KB 页大小设备兼容;当前未作兼容保证。
  6. 完善外部 Android JRE 导入、媒体焦点/通知控制、进程被杀后的任务恢复以及 Android 专属多语言。