v1.3.3.2

English: 1.3.3.2 release notes

内置版本 Mindustry v8 Build 160.5

概要

Caution

强烈建议使用Mindustry Ark v1.2.0.1 - v1.3.3.1 的平板用户进行更新

这个问题从 1.2.0.1 起就存在，而这一版本引入了启动器界面。表现为：从启动器进入游戏而不是直接启动游戏时，键盘操作不起作用。

---

修复

问题	说明
游戏里实体键盘没反应	先显示启动器界面时，游戏画面从来没有拿到键盘焦点；而系统只把按键事件投递给持有焦点的组件。触摸不受影响

---

下载

文件	说明
MindustryArk-v1.3.3.2-unsigned.hap	应用本体。未签名 —— 装之前自己签一次
MindustryArk-v1.3.3.2-payload.zip	载荷包。只有要从源码构建才需要，玩的话不用

---

安装

未签名的 HAP 无法直接安装

用安装工具安装（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

想自己用 DevEco Studio 签名的话，步骤见 README。

Warning

不要用「小白调试助手」这类工具去打开应用的「游戏模式」。
以「游戏模式」启动应用，会把应用锁在 60 帧

---

支持设备与限制

设备	自签名安装	应用商店（计划中）
平板	可用	Mindustry Ark上架海外应用商店 Ark Launcher上架国内应用商店
手机	部分可用	Ark Launcher(纯管理工具，无法启动游戏) 上架国内应用商店
PC · 2in1	未测试	Mindustry Ark上架海外应用商店 Ark Launcher上架国内应用商店

• 本应用声明的最低兼容版本是 鸿蒙6.1.1（API 24）。低于此版本的设备无法安装本应用。
• 自DevEco Studio 26 起，手机debug安装也可获取缺失的ACL权限。理论上，API24的手机也可自签名安装本应用。
• Ark Launcher是去除内置游戏的分支lite版本，属于游戏管理工具，而非游戏。Ark Launcher不在GitHub Release发布。有需要的可以去lite分支自行构建。
• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

截至2026.10.5，本应用尚未上架鸿蒙应用商店，目前只有 GitHub 分发。

Full Changelog: v1.3.3.1...v1.3.3.2

v1.3.3.1

English: 1.3.3.1 release notes

内置版本 Mindustry v8 Build 160.5

概要 - 1.3.3 存储更新发布

1.3版本的核心任务是完善游戏存档管理，以及存储相关的内容。同时，1.3.3.1版本也修复了大量旧版本的隐形bug。

前言

Mindustry原生缺少对多存档的管理功能，而且游戏存档存储在应用内部不方便玩家操作。

而现在，你可以自由管理存档数据，选择数据存储位置。

总而言之，Mindustry Ark v1.3.3主要补上了这些Mindustry原生缺失的功能：

1. 跨版本多存档管理
2. 多版本数据隔离系统
3. 应用数据存储位置切换
4. 游戏语言跟随系统
5. 游戏内的界面缩放与自动异形屏避让（实验性，界面缩放默认值改为150%）

(这些功能只是启动器的附加功能，未对游戏本体源码进行任何更改。)

---

新增

项目	说明
存储位置（沙箱 / 外置）	游戏数据可以放在应用沙箱里，也可以放在 Download/Mindustry Ark/ 下 —— 用文件管理器看得见、能自己备份
切换存储位置时，数据会跟着迁移	整套数据搬过去；全部复制成功才会删掉旧的那份，中途失败的话旧的原样留着
深色模式	跟随系统，也可以手动指定
游戏内显示	启动器把适合本机的「UI 内边距」与「界面缩放比例」写进游戏自己的那份设置；这两项在游戏内的设置界面里仍然可以随时改
自动异形屏适配（实验性）	按本机挖孔算出适合的值并写进游戏设置。默认关闭
游戏语言跟随系统	游戏内的界面语言跟随系统语言；也可以在启动器里指定
左滑删除游戏版本	在首页左滑某个版本即可删掉，有二次确认
存档整批复制 / 移动	一次勾选一批存档，复制或移动到另一个版本

---

变动

项目	说明
设置页分组	「语言」「存储」「显示」分开，不再是一长条
存储位置开关	拨完就直接搬，不再弹确认窗。搬的过程中开关置灰
窄屏不再分左右栏	手机上列表与详情上下排

---

修复

逐条（17 项）

问题	说明
删掉一个存档后它还留在屏幕上	要离开这一页才消失
一批列表项显示旧数字	复用同一行时，行里的数量没有跟着换
对话框的「取消」按钮小一档	与它旁边的按钮不是一个字号
固定宽度框里的文字会随系统字体变大	盒子没有变，字先溢出去了
游戏语言开关没有作用	它读到的国家码被截断，永远匹配不上
「数据没有搬过来」这条提示从不出现	判据算错了，那块提示等于不存在
迁移搬走的是整个沙箱，不是游戏数据	会把不相干的东西一起搬过去
游戏设置的探测读不到界面缩放	那一项一直显示成默认值
导入/导出时的提示画不出来	拷贝是在界面线程上同步做完的，那句话来不及显示
注入的 JVM 选项从来没有到过 JVM	那条自测通道被另一个写入者每次启动清掉（不影响正常游戏）
两处栈上越界读	用 snprintf 的返回值当作已写入的长度
迁移时会漏掉一棵子树	判据在外部目录上会误报「没有」，于是那棵被静默跳过
回收 / 归档失败时看不到提示	那条消息显示在回收站那一屏，而这个动作是在存档页做的 —— 失败时玩家正看着的那一屏上什么都没有
上一次的提示一直留着	它从不被清掉 ⇒ 一次成功的删除之后，屏幕上留着的是上一条错误
返回键关不掉「导入到哪一份数据」	框开着时返回键会穿过去关下面那一层
设置页那行隔离说明会用旧分组	刚导入或删掉一个游戏版本之后，那句话说的还是上一次的分组，要等下一次刷新才对
两个选择框每次重绘都去读盘	导入目标框与复制/移动目标框里的数目说明在重绘时现算 ⇒ 每帧多次目录扫描

---

下载

文件	说明
MindustryArk-v1.3.3.1-unsigned.hap	应用本体。 未签名，需要先自行签名一次
MindustryArk-v1.3.3.1-payload.zip	载荷包。只有要从源码自行构建才需要，玩游戏不必下载

---

安装

未签名的 HAP 无法直接安装

用安装工具安装（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

想自己用 DevEco Studio 签名的话，步骤见 README。

Warning

不要用「小白调试助手」这类工具去打开应用的「游戏模式」。
以「游戏模式」启动应用，会把应用锁在 60 帧

---

支持设备与限制

设备	自签名安装	应用商店（计划中）
平板	可用	Mindustry Ark上架海外应用商店 Ark Launcher上架国内应用商店
手机	部分可用	Ark Launcher(纯管理工具，无法启动游戏) 上架国内应用商店
PC · 2in1	未测试	Mindustry Ark上架海外应用商店 Ark Launcher上架国内应用商店

• 本应用声明的最低兼容版本是 鸿蒙6.1.1（API 24）。低于此版本的设备无法安装本应用。
• 自DevEco Studio 26 起，手机debug安装也可获取缺失的ACL权限。理论上，API24的手机也可自签名安装本应用。
• Ark Launcher是去除内置游戏的分支lite版本，属于游戏管理工具，而非游戏。Ark Launcher不在GitHub Release发布。有需要的可以去lite分支自行构建。
• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

截至2026.10.5，本应用尚未上架鸿蒙应用商店，目前只有 GitHub 分发。

Full Changelog: v1.3.2.1...v1.3.3.1

v1.3.2.1

English: 1.3.2.1 release notes

概要

内置版本 Mindustry v8 Build 160.5（补充说明，与下面的功能无关）

⚠️ 上一版 1.3.1.1 目前标记为预发布版本。 下面把那一版的内容一并写全，从 1.3.0.1 直接升上来的读者不必再去翻另一页。

新增整包导入 / 导出：把一整套游戏数据打成一个 zip 带走或带回来。启动器的界面也在这一轮重做 —— 加了进场动效、适配异形屏，底部导航栏换成系统的悬浮材质样式。

---

新增

项目	说明
整包导出	把某个版本的一整套游戏数据（存档、模组、蓝图、设置）打成一个 zip，便于备份或换设备
整包导入	选一个 zip 导入。导入前会自动把现有数据备份一份
导入可选多处	一次勾选多个目标再确认；带「全选 / 全不选」。同一份数据只写一次
一键清空垃圾站	垃圾站里可以一次全清掉，有二次确认；归档的会单独点出来
导出与备份的位置	都在 Mindustry Ark/ 文件夹下，用文件管理器能找到；文件名带版本与时间
启动器进场动效	启动器的界面切换有了过渡
异形屏适配	启动器界面会避开挖孔与曲面边缘，可在「设置」里调整
底部导航栏	换成系统的悬浮材质底栏（沉浸光感）

---

变动

项目	说明
导入的交互	原来是「点一行就立刻导入」，现在是先勾选、再确认。同一个目标只写一次
存档的动作按钮	原来的一排按钮改为「删除 / 复制 / 移动」三个
应用名不再硬编码	「关于」卡片、诊断报告标题等处改为读取应用资源
诊断报告	标题下方不再多出一条分隔线
没有运行时的包	包里没有运行时，启动器会说明原因并让「启动游戏」不可用 —— 不再出现「点了没反应」的按钮

---

修复

问题	说明
「关于」看不到版本号	那一行一直在，但喂给它的值永远是空串，所以只显示应用名。现在点开就查一次
删多个同名存档时进不了垃圾站	同一批删除共用同一个毫秒戳，同名存档撞同一个目录名，第二个被拒。现在撞名自动加序号
垃圾站的列表滚不动	列表内容的实际高度等于视口，一点可滚动的余量都没有 —— 看起来只是「列表就这么长」
「按版本」把内部标记当版本号念	孤儿的标签写成「没有版本读它（b160.5）」，与内置那份的 160.5 看起来是两条一样的记录。现在写明那是内部标记
两个 C 函数从未被声明	setenv 与 pthread_getname_np 一直靠 C99 已废弃的隐式声明编译通过 —— AArch64 上恰好能跑对，属于巧合而非保证。已补上声明，生成的机器码不变
SDL3 的类型声明与实际调用不符	声明 3 个参数、调用传 5 个。此前一直被增量编译缓存掩盖：换一份干净克隆、或清一次缓存，构建就会失败。现已一致
「内置游戏」那一行缺守卫	在包里没有内置游戏时，那一行仍然显示

---

下载

文件	说明
MindustryArk-v1.3.2.1-unsigned.hap	应用本体。 未签名，需要先自行签名一次
MindustryArk-v1.3.2.1-payload.zip	载荷包。只有要从源码自行构建才需要，玩游戏不必下载

---

安装

未签名的 HAP 无法直接安装

方法一：用安装工具（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

方法二：用 DevEco Studio 自行签名

1. 用 DevEco Studio 打开本项目
2. File → Project Structure → Signing Configs → Automatically generate signature
3. bash deploy.sh

更详细的安装说明见 README。

Warning

不要用「小白调试助手」这类工具去打开应用的「游戏模式」。
以「游戏模式」启动应用，会把应用锁在 60 帧

---

支持设备与限制

按设备

设备	自签名安装	应用商店
平板	可用	计划上架海外应用商店
手机	部分可用（见下）	不提供
PC · 2in1	未测试	计划上架海外应用商店

按系统版本

• 本应用声明的最低版本是 6.1.1（API 24），该下限未实测。
• API 26（鸿蒙7，DevEco Studio 26）起：调试安装会自动申请受支持的 ACL 权限 ⇒ 手机自签名可用。
• 鸿蒙 5 / 6：没有这个机制，能否自签名安装请以实机结果为准。

其他

• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

截至2026.10.3，本应用尚未上架任何应用商店，目前只有 GitHub 分发。

Full Changelog: v1.3.1.1...v1.3.2.1

v1.3.1.1

English: 1.3.1.1 release notes

概要

内置版本 Mindustry v8 Build 160.5（补充说明，与下面的功能无关）

本版本新增整包导入 / 导出：把一整套游戏数据打成一个 zip 带走或带回来。
启动器的界面也在这一版重做 —— 加了进场动效、适配异形屏，底部导航栏换成系统的悬浮材质样式。

---

新增

项目	说明
整包导出	把某个版本的一整套游戏数据（存档、模组、蓝图、设置）打成一个 zip，便于备份或换设备
整包导入	选一个 zip 导入。⚠️ 导入前会自动把现有数据备份一份
导出与备份的位置	都放在 Mindustry Ark/ 文件夹下，用文件管理器能找到；文件名带版本与时间
启动器进场动效	启动器的界面切换有了过渡
异形屏适配	启动器界面会避开挖孔与曲面边缘，可在「设置」里调整
底部导航栏	换成系统的悬浮材质底栏（沉浸光感）

---

变动

项目	说明
存档的动作按钮	原来的一排按钮改为「删除 / 复制 / 移动」三个
应用名不再硬编码	「关于」卡片、诊断报告标题等处改为读取应用资源，而不是写死
诊断报告	标题下方不再多出一条分隔线
不带游戏运行时的包	若包里没有运行时，启动器会说明原因并让「启动游戏」不可用 —— 不再出现「点了没反应」的按钮

---

修复

问题	说明
「内置游戏」那一行缺守卫	在包里没有内置游戏时，那一行仍然显示
两个 C 函数从未被声明	setenv 与 pthread_getname_np 一直靠 C99 已废弃的隐式声明编译通过 —— AArch64 上恰好能跑对，属于巧合而非保证。现已补上声明，生成的机器码不变
SDL3 的类型声明与实际调用不符	声明写 3 个参数、调用传 5 个。此前一直被增量编译缓存掩盖：换一份干净克隆、或清一次编译缓存，构建就会失败。现已一致
格式声明缺少导入	同上那个文件里 UIAbility / abilityAccessCtrl / intl 三个名字从未有定义

---

下载

文件	说明
MindustryArk-v1.3.1.1-unsigned.hap	应用本体。 未签名，需要先自行签名一次
MindustryArk-v1.3.1.1-payload.zip	载荷包。只有要从源码自行构建才需要，玩游戏不必下载

---

安装

未签名的 HAP 无法直接安装

方法一：用安装工具（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

方法二：用 DevEco Studio 自行签名

1. 用 DevEco Studio 打开本项目
2. File → Project Structure → Signing Configs → Automatically generate signature
3. bash deploy.sh

更详细的安装说明见 README。

---

支持设备与限制

按设备

设备	自签名安装	应用商店
平板	可用	计划上架海外应用商店
手机	部分可用（见下）	不提供
PC · 2in1	未测试	计划上架海外应用商店

按系统版本

• 本应用声明的最低版本是 6.1.1（API 24），该下限未实测。
• API 26（鸿蒙7，DevEco Studio 26）起：调试安装会自动申请受支持的 ACL 权限 ⇒ 手机自签名可用。
• 鸿蒙 5 / 6：没有这个机制，能否自签名安装请以实机结果为准。

其他

• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

截至2026.10.3，本应用尚未上架任何应用商店，目前只有 GitHub 分发。

Full Changelog: v1.3.0.1...v1.3.1.1

v1.3.0.1

English: 1.3.0.1 release notes

概要

内置版本 Mindustry v8 Build 160.5（补充说明，与下面的功能无关）

从本版本起，每个游戏版本可以各用一套游戏数据，并新增了存档管理界面。

在此之前，所有游戏版本共用同一批存档：换一个 jar，看到的是同一份进度，装不下两套配置。
现在可以在启动器里选择隔离粒度，把不同版本的数据分开；存档页则能列出所有版本的存档、
查看元数据，并跨版本复制或搬移。

Caution

隔离默认是【关闭】的。 关闭时所有版本仍然共用同一批存档，与之前版本完全一致。
开启后每个版本各一份 —— 也就是说，从这一刻起，你换哪个游戏版本就会决定你看到哪些存档。
打开时可以选择把现有数据复制过去，或从空开始。

⚠️ 存档从 高版本 → 低版本 仍可能出现兼容性问题 —— 那讲的是存档格式，与隔离无关。

---

新增

项目	说明
版本隔离	每个游戏版本各用一套游戏数据（存档、模组、蓝图、研究进度）。四档粒度：不隔离 / 大版本 / 构建号 / 小版本
存档管理	新增「存档」页：列出所有版本的存档并按「共用同一份数据」分组，可查看元数据（写入时的版本 / 地图 / 时长 / 模组清单）
复制 / 移动存档	把存档在版本之间搬，或复制到多个目标。可多选。⚠️ 同版本再复制一份只对手动存档开放
垃圾站	删除不是抹掉 —— 搬进垃圾站，保留 3 / 7 / 30 天，或归档（永不自动清理）。随时可放回
多选删除	在存档列表里长按进入多选，一次删多个。删除前有确认框，会列出选中的存档与它们各自的来源
启动模式	设置里可选「先显示启动器」或「直接进游戏」

---

变动

项目	说明
存档的可见性	开启隔离后，一个存档只对读取同一份数据的版本可见。默认（不隔离）不变
同版本的 jar 与内置游戏合并	版本号与内置那一致的 jar 共用内置那一份数据，不再各占一份。⚠️ 现有数据不会被覆盖
存档页的列表	「按存档」现在列出所有版本的存档；不含存档的目录也照样列出（它是「还没放东西」的去处）
版本名显示	版本号在前、文件名在后，例如 v8 Build 160.5（内置游戏, Mindustry160.5.jar）

---

修复

问题	说明
换版本后存档「全都看不见」	隔离开着、而当前版本那一档还是空的时候，界面上只说「请把隔离关掉或重新打开一次」，没有可点的出口。现在就地给出复制按钮
存档列表滚不动	只能看到头两三组，后面的看不到。列表本身一直没有可滚动的余量
「按版本」左侧列表竖直居中	版本少时会停在屏幕中间，应当贴顶
手机比例下首页没铺满	内容宽度被一个固定值卡住，右边空出一条，看起来既没占满也没居中
「关于」窗缺一行	「上游」那一行的标签缺失，而它的样式接到了上一行，导致上一行的字号/颜色不是代码里写的那样
点击已选中的存档无法取消	选中之后详情栏再也关不掉
多选时出现两个「删除」	一个是删勾选的一批、一个是删详情里那一个，标签相同无法分辨。多选态下后者不再显示
取消最后一项会退出多选	退出应当只由「取消」按钮负责

---

下载

文件	说明
MindustryArk-v1.3.0.1-unsigned.hap	应用本体。 未签名，需要先自行签名一次
MindustryArk-v1.3.0.1-payload.zip	载荷包。只有要从源码自行构建才需要，玩游戏不必下载

---

安装

未签名的 HAP 无法直接安装

方法一：用安装工具（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

方法二：用 DevEco Studio 自行签名

1. 用 DevEco Studio 打开本项目
2. File → Project Structure → Signing Configs → Automatically generate signature
3. bash deploy.sh

更详细的安装说明见 README。

---

支持设备与限制

按设备

设备	自签名安装	应用商店
平板	可用	计划上架海外应用商店
手机	部分可用（见下）	不提供
PC · 2in1	未测试	计划上架海外应用商店

按系统版本

• 本应用声明的最低版本是 6.1.1（API 24），该下限未实测。
• API 26（鸿蒙7，DevEco Studio 26）起：调试安装会自动申请受支持的 ACL 权限 ⇒ 手机自签名可用。
• 鸿蒙 5 / 6：没有这个机制，能否自签名安装请以实机结果为准。

其他

• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

截至2026.10.3，本应用尚未上架任何应用商店，目前只有 GitHub 分发。

Full Changelog: v1.2.0.1...v1.3.0.1

v1.2.0.1

English: 1.2.0.1 release notes

概要

内置版本 Mindustry v8 Build 160.5

从本版本起，你可以自选加载的Mindustry游戏版本。

启动器会显示一个游戏列表：内置游戏，以及你放进文件夹(Download/Mindustry Ark/games)里的任意多个 jar。
列表里每一项都标出该文件自带的版本号（例如 v8 Build 160.5），可以自行选择版本。

其他版本的jar请从官方Release下载。最低支持版本未测试。

⚠️注意：游戏存档不会因版本选择而变化，存档从 高版本->低版本 可能出现兼容性问题⚠️

---

新增

项目	说明
自选游戏版本	可以同时放多个游戏 jar，在启动器里挑一个使用。在此之前只能用随包的那一份
显示每个 jar 的版本	版本号是从文件本身读出来的，不必靠文件名分辨
启动器界面	新增一屏用来管理游戏版本。默认每次启动先显示它
下拉刷新	在列表上往下拉即可重新扫描文件夹
启动模式	设置里可选「先显示启动器」或「直接进游戏」
启动失败时的说明	上一次没启动成功时，启动器会说明原因，并给出绕过这次判断的入口

---

变动

项目	说明
应用图标	换回原先那张
默认启动行为	从「直接进游戏」改为「先显示启动器界面」。可在设置里改回
「仍然尝试启动」	从常驻按钮改为只在启动失败时以弹窗出现

---

修复

问题	说明
选了不能玩的文件之后打不开	若选中的文件不能玩（例如误把模组当成游戏），以前每次打开都会立刻退出，而且没有任何界面可以把它改回来。现在会回到启动器界面并说明原因
全新安装的第一次启动说找不到文件夹	第一次打开会说读不到游戏文件夹，需要重启一次才好。现在第一次就正常

---

下载

文件	说明
MindustryArk-v1.2.0.1-unsigned.hap	应用本体。 未签名，需要先自行签名一次
MindustryArk-v1.2.0.1-payload.zip	载荷包。只有要从源码自行构建才需要，玩游戏不必下载

---

安装

未签名的 HAP 无法直接安装

方法一：用安装工具（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

方法二：用 DevEco Studio 自行签名

1. 用 DevEco Studio 打开本项目
2. File → Project Structure → Signing Configs → Automatically generate signature
3. bash deploy.sh

更详细的安装说明见 README。

---

支持设备与限制

按设备

设备	自签名安装	应用商店
平板	可用	计划上架海外应用商店
手机	部分可用（见下）	不提供
PC · 2in1	未测试	计划上架海外应用商店

按系统版本

• 本应用声明的最低版本是 6.1.1（API 24），该下限未实测。
• API 26（鸿蒙7，DevEco Studio 26）起：调试安装会自动申请受支持的 ACL 权限 ⇒ 手机自签名可用。
• 鸿蒙 5 / 6：没有这个机制，能否自签名安装请以实机结果为准。

其他

• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

截至2026.10.2，本应用尚未上架任何应用商店，目前只有 GitHub 分发。

Full Changelog: v1.1.0.1...v1.2.0.1

v1.1.0.1 - Mindustry v8 Build 160.5

English: 1.1.0.1 release notes

概要

内嵌的游戏本体升级到上游 Mindustry v8 Build 160.5。

从本版本起，随包发布的游戏本体是未经修改的上游原版 —— 与官方发布的那份文件逐字节相同。启动器需要的适配代码已独立成一份补丁，在游戏之前加载。

---

变动

项目	说明
内嵌游戏	160.4 → 160.5
游戏本体	改为上游原版，未做任何修改
适配代码	从游戏本体中移出，独立成一份补丁

本版本没有本项目自身的功能性改动 —— 下面「修复」里全部是上游 160.5 的内容。

---

修复

以下是上游 160.5 修的问题（不是本项目修的），挑的是玩家能感觉到的部分；完整列表见
上游发布页。

问题	说明
命中框极大的实体导致线程卡死	表现为卡顿或无响应
地图描述不换行	长描述挤成一行
逻辑处理器	超过 Long.MAX_VALUE 的十六进制 / 二进制数值无法解析；重启后图形与文本缓冲不清空；界面的形状文字标记无法选中
产出被增益时生产方块跟不上	输出速度不够
靶机	附近有大型命中框的靶机时无法降落
数据补丁	液体容量为 0 的方块不再显示液体条；图像现在会做边缘透明扩散与抗锯齿，和原版精灵图一致
服务器 / 模组	隐藏 UI 时某些弹窗仍然显示；模组浏览器现在会优先显示标题与当前游戏版本匹配的模组版本

---

下载

文件	说明
MindustryArk-v1.1.0.1-unsigned.hap	应用本体。 未签名，需要先自行签名一次
MindustryArk-v1.1.0.1-payload.zip	载荷包。只有要从源码自行构建才需要，玩游戏不必下载

---

安装

未签名的 HAP 无法直接安装

方法一：用安装工具（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

方法二：用 DevEco Studio 自行签名

1. 用 DevEco Studio 打开本项目
2. File → Project Structure → Signing Configs → Automatically generate signature
3. bash deploy.sh

更详细的安装说明见 README。

---

支持设备与限制

按设备

设备	自签名安装	应用商店
平板	可用	ACL 已获批；商店上架尚未完成
手机	部分可用（见下）	不提供
PC · 2in1	未测试	未测试

• 手机为什么没有应用商店版本：可执行内存权限（ACL，ALLOW_WRITABLE_CODE_MEMORY）只向平板与 PC / 2in1 开放。而 Java 的 JIT 需要该项能力。
• 手机为什么是「部分可用」：取决于系统版本，见下。符合版本的手机上，自签名安装和平板一样。

按系统版本

• 本应用声明的最低版本是 6.1.1（API 24），该下限未实测。
• API 26（鸿蒙 7）起：调试安装会自动申请受支持的 ACL 权限 ⇒ 手机自签名可用。
• 鸿蒙 5 / 6：没有这个机制，能否自签名安装请以实机结果为准。

其他

• 没有成就，也没有创意工坊 —— 两者都是 Steam 平台的功能，Mindustry 本身不含。
• 仅支持 arm64-v8a 真机，模拟器不可用（x86_64 无法运行本包）。
• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

本应用尚未上架任何应用商店，目前只有 GitHub 分发。计划上架海外应用商店；国内因版号限制无法上架。

上架版本只面向鸿蒙平板与 PC/2in1，不包含手机 —— 原因见上面「支持设备与限制」。

GitHub 这一侧的分发方式不变。

Full Changelog: v1.0.0.2...v1.1.0.1

v1.0.0.2 (RC 2) - Mindustry v8 Build 160.4

English: 1.0.0.2 (RC 2) release notes

概要

这是 1.0.0 正式版之前的第二个候选版本。已完整支持所有 Mindustry 原生功能。

ALLOW_WRITABLE_CODE_MEMORY 这项权限已获批，本版本是第一个可以提交应用商店的版本，已提交 AppTest。

---

新增

项目	说明
悬浮球 · 导出诊断	悬浮球菜单新增「导出诊断」，一键把运行日志导出到 Download/com.haohandc.mindustryark/diagnostics/，方便反馈问题
崩溃报告自动导出	应用崩溃后，下次启动会自动把崩溃报告写到同一个 diagnostics/ 文件夹

---

变动

项目	说明
应用图标	换为手绘图标
仓库首页	仓库首页改为中文，英文版在 README.en.md

---

修复

问题	说明
开着「坚盾守护模式」时点开即退，且不给任何提示	该模式会禁止应用申请可执行内存，Java 虚拟机因此无法创建。此前表现为无声退出 —— 没有提示、没有日志、屏幕上什么都不说。现在会说明原因，并给出关闭路径：设置 → 隐私和安全 → 坚盾守护模式

---

下载

文件	说明
MindustryArk-v1.0.0.2-unsigned.hap	应用本体。 未签名，需要先自行签名一次
MindustryArk-v1.0.0.2-payload.zip	载荷包。只有要从源码自行构建才需要，玩游戏不必下载

---

安装

未签名的 HAP 无法直接安装

方法一：用安装工具（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

方法二：用 DevEco Studio 自行签名

1. 用 DevEco Studio 打开本项目
2. File → Project Structure → Signing Configs → Automatically generate signature
3. bash deploy.sh

更详细的安装说明见 README。

---

支持设备与限制

按设备

设备	自签名安装	应用商店
平板	可用	可用（待 AppTest 通过）
手机	部分可用（见下）	不提供
PC · 2in1	未测试	未测试

• 手机为什么没有应用商店版本：可执行内存权限（ACL，ALLOW_WRITABLE_CODE_MEMORY）只向平板与 PC / 2in1 开放。而 Java 的 JIT 需要该项能力。
• 手机为什么是「部分可用」：取决于系统版本，见下。符合版本的手机上，自签名安装和平板一样。

按系统版本

• 本应用声明的最低版本是 6.1.1（API 24），该下限未实测。
• API 26（鸿蒙 7）起：调试安装会自动申请受支持的 ACL 权限 ⇒ 手机自签名可用。
• 鸿蒙 5 / 6：没有这个机制，能否自签名安装请以实机结果为准。

其他

• 没有成就，也没有创意工坊 —— 两者都是 Steam 平台的功能，Mindustry 本身不含。
• 仅支持 arm64-v8a 真机，模拟器不可用（x86_64 无法运行本包）。
• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

本应用尚未上架任何应用商店，目前只有 GitHub 分发。计划上架海外应用商店；国内因版号限制无法上架。

已提交 AppTest；上架版本只面向鸿蒙平板与 PC/2in1，不包含手机 —— 原因见上面「支持设备与限制」。

GitHub 这一侧的分发方式不变。

---

Full Changelog: v1.0.0.1...v1.0.0.2

v1.0.0.1 (RC 1) - Mindustry v8 Build 160.4

English: 1.0.0.1 (RC 1) release notes

概要

这是 1.0.0 正式版之前的第一个候选版本。该版本功能补齐了所有 Mindustry 原生支持的功能。且该版本已冻结，之后只修阻断性问题，所有新增功能需等待正式版本发布。

---

新增

项目	说明
多人联机	局域网联机、搜索公网服务器、在本机开服
模组加载	支持 .jar / .zip 格式的模组。放入 Download/Mindustry Ark/（真实路径 Download/com.haohandc.mindustryark/），需在游戏内选中导入
悬浮球 · 关于	悬浮球菜单新增「关于」，可查看版本号与仓库地址

---

变动

项目	说明
文件夹权限	不再申请「下载」文件夹权限，改用应用自己创建的指定文件夹。详见「新增 · 模组加载」

---

修复

问题	说明
模组导入入口过多	现在只有游戏自带的「导入模组」按钮。悬浮球菜单里的「导入模组」已移除（该入口未在已发布版本中出现过），应用也不再自动扫描文件夹
悬浮球菜单点击区域过小	每个选项原来只有约 19vp 高，且挨得很近；已放大并加上分隔

---

下载

文件	说明
MindustryArk-v1.0.0.1-unsigned.hap	应用本体。 未签名，需要先自行签名一次
MindustryArk-v1.0.0.1-payload.zip	载荷包。只有要从源码自行构建才需要，玩游戏不必下载

---

安装

未签名的 HAP 无法直接安装

方法一：用安装工具（不需要开发环境，推荐）

工具	说明
小白调试助手	免费的跨平台鸿蒙调试工具，签名 + 安装一步完成
HoKit	一键重签名、设备投屏、性能监控、文件管理

方法二：用 DevEco Studio 自行签名

1. 用 DevEco Studio 打开本项目
2. File → Project Structure → Signing Configs → Automatically generate signature
3. bash deploy.sh

更详细的安装说明见 README。

---

支持设备与限制

按设备

设备	自签名安装	应用商店
平板	可用	ACL 批准后可用
手机	部分可用（见下）	不提供
PC · 2in1	未测试	未测试

• 手机为什么没有应用商店版本：可执行内存权限（ACL，ALLOW_WRITABLE_CODE_MEMORY）只向平板与 PC / 2in1 开放。而 Java 的 JIT 需要该项能力。
• 手机为什么是「部分可用」：取决于系统版本，见下。符合版本的手机上，自签名安装和平板一样。

按系统版本

• 本应用声明的最低版本是 6.1.1（API 24），该下限未实测。
• API 26（鸿蒙 7）起：调试安装会自动申请受支持的 ACL 权限 ⇒ 手机自签名可用。
• 鸿蒙 5 / 6：没有这个机制，能否自签名安装请以实机结果为准。

其他

• 没有成就，也没有创意工坊 —— 两者都是 Steam 平台的功能，Mindustry 本身不含。
• 仅支持 arm64-v8a 真机，模拟器不可用（x86_64 无法运行本包）。
• 完整清单见 docs/LIMITATIONS.md。

---

关于上架应用商店

本应用尚未上架任何应用商店，目前只有 GitHub 分发。未来计划上架海外应用商店；国内因版号限制无法上架。

正在申请 ohos.permission.kernel.ALLOW_WRITABLE_CODE_MEMORY 这项受限权限（ACL）。批准后会先提交 AppTest，RC 版本和后续上架版本只面向鸿蒙平板与 PC/2in1，不包含手机 —— 原因见上面「支持设备与限制」。

该权限是平板端 JIT 的必需项：没有它，Java 运行时无法启动。批准后 GitHub 这一侧的分发方式不变。

---

Full Changelog: v0.2.0-beta.1...v1.0.0.1

v0.2.0-beta.1 — Mindustry v8 Build 160.4 (unofficial HarmonyOS port)

⚠️ 上个版本（v0.1.0-beta.1）可以直接升级安装

⚠️ 非官方项目 —— 与 Mindustry 及 Anuken 无隶属关系，以 GPL-3.0 分发。
内嵌游戏版本 Mindustry v8 Build 160.4（与本项目的版本号是两套体系）。

这一版新增

⌨️ 屏幕软键盘	点进游戏里的输入框会自动弹出，打字、退格、ESC 关闭都正常。在此之前完全打不了字
🎈 悬浮球	可拖动、松手吸附最近的四条边、3 秒后自动半隐藏（只露外侧 2/5），点击把它叫回来。它承载的第一项功能是切换模式
🖥️ PC / 触屏模式切换	游戏自带的开关只换输入层、不换 UI；这个会真正切到移动端或桌面端 UI。⚠️ 重启应用后生效
🖼️ 沉浸模式	隐藏状态栏与导航条，游戏铺满全屏。系统手势未被抑制，随时能回桌面
🎨 新应用图标	蓝底 + Arc 炮塔，取代了模板占位图
📛 改名 Mindustry Ark	⚠️ 下载的文件名仍是无空格的 MindustryArk-v…（构建规则不允许空格）
🐛 触摸修复	触屏点进存档列表后，条目不再「高亮卡住、要点两次」

下载哪个文件

文件	说明
MindustryArk-v0.2.0-beta.1-unsigned.hap	应用本体。 未签名，需自签一次
MindustryArk-v0.2.0-beta.1-payload.zip	载荷包。只有要从源码构建才需要

⚠️ 未签名的 HAP 装不上（HarmonyOS 要求先签名）。
安装方法、已知限制、从源码构建 见 README。

已验证

HUAWEI MatePad Pro 12.2" 2025 平板 + HUAWEI Mate 80 Pro 手机（HarmonyOS 7 / API 26）：
主菜单与渲染 ✅｜音频（OHAudio）✅｜触屏（含双指捏合缩放）✅｜
软键盘 ✅（接系统输入法，中文可打）｜实体键盘（ESC 不当返回，中文亦可）✅｜
鼠标 ✅｜悬浮球 ✅｜沉浸模式 ✅｜键盘不再遮挡输入框 ✅｜存档导入导出 ✅｜正常退出 ✅

---

⚠️ Installs of v0.1.0-beta.1 upgrade in place.

⚠️ Unofficial — not affiliated with the Mindustry project or Anuken; distributed
under GPL-3.0. Embedded game version Mindustry v8 Build 160.4 (a separate
versioning scheme from this project's).

What is new

⌨️ On-screen keyboard	Appears when you tap a text field in the game; typing, backspace and ESC all work. Text entry did not work at all before this
🎈 Floating ball	Draggable, snaps to the nearest edge, half-hides after three seconds (leaving the outer 2/5), comes back on tap. Its first function is switching mode
🖥️ PC / touch mode switch	Mindustry's own toggle swaps the input handler but leaves the mobile UI; this one switches both. ⚠️ Takes effect on restart
🖼️ Immersive mode	Hides the status and navigation bars. System gestures are left alone, so you can always leave the app
🎨 New app icon	A blue plate with the Arc turret, replacing the template placeholder
📛 Renamed Mindustry Ark	⚠️ The downloaded filename keeps the unspaced form — the build rule forbids spaces
🐛 Touch fix	Save-list entries no longer stay highlighted and need a second tap

Which file to download

File	What it is
MindustryArk-v0.2.0-beta.1-unsigned.hap	The app. Unsigned — sign it once yourself
MindustryArk-v0.2.0-beta.1-payload.zip	Build inputs. Only needed to build from source

⚠️ An unsigned HAP will not install (HarmonyOS requires a signature).
Installing, known limitations and building from source are in the
README.

Verified

HUAWEI MatePad Pro 12.2" 2025 tablet + HUAWEI Mate 80 Pro phone (HarmonyOS 7 / API 26):
menu and rendering ✅ · audio (OHAudio) ✅ · touch incl. two-finger pinch zoom ✅ ·
on-screen keyboard ✅ (system input method, Chinese works) ·
physical keyboard, ESC not treated as Back, Chinese too ✅ · mouse ✅ ·
floating ball ✅ · immersive mode ✅ · keyboard no longer covers the field ✅ ·
save import/export ✅ · clean exit ✅

Full Changelog: v0.1.0-beta.1...v0.2.0-beta.1