Skip to content

Releases: Gsjsjzhznsz/Air-Minecraft-iOS-Launcher

Air 5.1.0 —— 从 0 到 220+ 次提交

Choose a tag to compare

@Gsjsjzhznsz Gsjsjzhznsz released this 19 Sep 14:10

Air 5.1.0 —— 从 0 到 220+ 次提交

本 Fork 自 2026 年 9 月初分叉以来,累计 220+ 次提交,后端(渲染/崩溃/输入/启动链)与前端(UI/主题/背景/本地化)双线并进。本版是第一个正式发行版。

📜 项目历史

这个项目的成长经历本身值得一记:

  • 两个对话的接力:本 Fork 的开发最初由 2 个 AI 对话接力完成——第一个对话打下了渲染桥接、启动链与崩溃修复的基线,第二个对话接力完成了系统化验证、UI 重设计与发行准备。
  • 30+ 个提交的恢复:仓库历史曾经历过一次重置,最早期那个对话在极其有限的线索下恢复并重建了 30+ 个提交的工作(渲染、JIT、兼容层基线),项目才得以延续至今。
  • 撤包与重新提交:恢复完成后,第一个发行包曾因构建问题整体撤下、修复后重新提交——这段"撤包又重提"的插曲让"CI 全绿才发版"成为了本项目的铁律,5.1.0 的发行包正出自一次全绿的 CI 构建。

✨ 新增功能

  • 启动时自动检查更新:启动器启动时自动检测新版本;发现新版时以应用内卡片通知提示(点击"查看"直达发布页),已是最新或检测失败时完全静默。可在设置中关闭。
  • Zink(Mesa 25.0.7)渲染器:完整 OSMesa 桥接——GL → zink → Vulkan → MoltenVK → Metal,支持 26.3 + 光影(Iris/Sodium)所需的全套 GL 4.x 扩展。
  • FSR1 画质/帧率管线:单遍 EASU 上采样,五档预设;渲染器侧升采样,MC 以低分辨率渲染、放大后呈现,帧率与画质自由取舍。zink、MobileGlues、MobileGL 三条路径全部支持。
  • MobileGL 渲染后端:设置 > 视频 > 「MobileGL 渲染后端」单一选项(Vulkan 默认 / GLES / Mithril / 关闭),不占用渲染器列表。Vulkan 档走 DirectVulkan 直呈(无逐帧 CPU 回读),是实测最流畅的路径。
  • LTW 渲染器:OpenGL Core 3.3 → ES 3 转译层,支持 Sodium + Iris。
  • 键盘自动弹出:游戏内输入框光标闪烁时键盘正常自动弹出。
  • 帧率解锁:26.x AFK/闲置限帧与 dynamic_fps 类模组的 30fps 钉死均已根治;后台过渡期合法降帧省电,回前台即恢复。
  • 新拟态 UI 全面覆盖:深浅双主题、毛玻璃卡片、自定义图片/视频背景、可自定义强调色/文字色/卡片色——主界面、设置页与所有子级面板(账户、下载、Mod 管理、文件列表等)全部统一新拟物设计语言。
  • 服务器快速加入:配置文件中填入服务器地址,启动后自动加入(FCL 风格,按版本自动选择 --server/--quickPlayMultiplayer)。
  • 下载中心:MC 本体/模组/光影/资源包/整合包下载任务集中管理,带进度与徽标。
  • 应用内语言切换:跟随系统 / 简体中文 / English,即时生效。

🔓 恢复的功能

  • 第三方登录完整恢复(LittleSkin / 自定义 authlib-injector 服务器):FCL 风格卡片式登录表单、多角色账户支持、皮肤与正版服务器验证全部可用。登录组件随包内置,不再依赖在线下载;令牌过期的账户仍可选中启动(提示重新登录即可恢复完整功能)。本项目 2025 年的早期版本曾支持第三方认证账户,本版将其完整带回。
  • 背景照片/视频:自定义启动器背景全面恢复,卡片毛玻璃透出、侧栏半透明,未设置时维持纯色新拟态。
  • 窗口模式:iPadOS 26 多任务/窗口化支持恢复。
  • 更新检测指向本仓库:应用内检查更新与发布页链接不再指向上游。

🛡️ 稳定性与兼容性

本开发周期完成了大量崩溃根治与兼容性工作:Minecraft 26.3 全线支持(SDL3 通路、LWJGL 3.4.1/3.4.3 兼容层、JNA 降级替换)、OpenAL 崩溃修复、多轮装机实测反馈的渲染与帧率问题闭环、正版账号登录提示体验改进(自动消失的应用内通知,不再有需要手动处理的系统弹窗)、设置项四种语言(en / zh-Hans / zh-CN / zh-Hant)键集完全对齐。每个修复都配有可复跑的验证脚本(仓库 scripts/ 目录,任务级校验器)。

📱 装机验证锚点

功能 日志锚点
MobileGL FSR [MGLFSR] Task119 FSR1 upscale engaged (MobileGL)
MobileGL 后端 [Amethyst] Task120: MobileGL backend override active(仅渲染器为"自动"时)
第三方登录 [JavaLauncher] Adding authlib-injector arguments for third party account
自动更新 发现新版时应用内卡片通知(无弹窗)

⚠️ 已知事项

  • 26.3 整合包在 zink 路径下仍有 ~10ms 级呈现常数(分相位计时可见);追求最高流畅度请在设置中选择 MobileGL Vulkan 后端。
  • 1.20.1 画面变糊若出现,优先检查模组自带设置(sodium-extra「Mac 下降低分辨率」,启动器 FAQ 有自助指引)。
  • MoltenVK 维持 1.4.2(上游 1.2.9 是 iPhone X/A11 渲染异常的回退,M4 设备无影响)。
  • 显式选择的渲染器永远优先于 MobileGL 后端选项(后者仅对"自动"渲染器生效)。

安装方式

  • TrollStore 用户:下载 .tipa 文件,通过分享菜单用 TrollStore 打开
  • AltStore/SideStore 用户:下载 .ipa 文件,按标准流程导入安装

完整提交历史0 → 220+ 次提交

v1.0.0 - LWJGL 3.4.1 兼容版

Pre-release

Choose a tag to compare

@Gsjsjzhznsz Gsjsjzhznsz released this 28 Aug 17:07

更新内容

LWJGL 3.4.1 兼容性更新

  • 更新 LWJGL 至 3.4.1 兼容层,支持 Sodium 0.9+ 等要求 LWJGL 3.4.1 的模组
  • 保留 3.3.x 基础模块 jar + 新增 lwjgl-callback-descriptor.jar (3.4.1)
  • 源码覆盖层兼容 3.3.x 和 3.4.1 两种 Callback API
  • 修复 Version.java/VersionImpl.java 编译错误

iOS 26+ TXM JIT 修复

  • 修复提前开启 JIT 权限时启动游戏崩溃的问题
  • 当 JIT 已启用但设备需要 debug JIT mapping 时,通过 stikjit:// URL 重新请求带脚本的 JIT
  • 使用应用生命周期通知(WillResignActive/BecomeActive)正确等待 StikJit 处理完毕
  • 30 秒超时保护,防止 StikJit 未安装时卡死

中文本地化

  • 完整中文界面翻译(1955 行)

其他修复

  • 修复 Makefile TAB 缩进被转为空格导致构建失败
  • 修复 APIUtil 中已移除的 wrapBufferByte() 调用

安装方式

  • TrollStore 用户:下载 .tipa 文件,通过分享菜单用 TrollStore 打开
  • AltStore/SideStore 用户:下载 .ipa 文件,按标准流程导入安装

基于 herbrine8403/Amethyst-iOS-MyRemastered fork