如何安全升级Onion系统？三大核心模块保障数据安全与顺利更新

准备阶段：升级前的关键决策与准备工作

明确升级路径：选择适合你的更新方式

根据设备型号和当前系统版本，选择最佳升级路径：

• Miyoo Mini+用户：优先使用OTA更新（类似手机自动升级），通过系统设置中的"系统更新"功能直接完成
• Miyoo Mini用户：需采用手动升级方式，需要准备电脑和SD卡读卡器
• 旧版本用户（v3.9及更早）：必须先执行清理操作，删除SD卡根目录下的.tmp_update文件夹

准备升级文件：获取正确的系统包

1. 访问项目仓库获取最新版本压缩包（仓库地址：https://gitcode.com/gh_mirrors/on/Onion）
2. 验证文件完整性：确保下载的ZIP文件大小与官方提供的校验值一致
3. 解压文件：根据你的操作系统选择对应方法

硬件准备清单：确保升级环境安全

• ✅ 质量可靠的SD卡（建议容量≥16GB，速度等级Class 10）
• ✅ 读卡器或支持OTG功能的设备
• ✅ 电脑（Windows/macOS/Linux均可）
• ✅ 设备电量≥50%（避免升级中断）

图1：Onion系统启动界面，升级成功后将显示此画面

风险规避：数据安全与兼容性保障

规避存档风险：两种备份策略对比

策略一：完整备份法（推荐新手用户）

• 复制SD卡中以下文件夹到电脑：/Roms、/BIOS、/Saves、/Themes
• 优点：操作简单，适合所有用户
• 缺点：占用空间较大，耗时较长

策略二：精准备份法（推荐进阶用户）

• 仅备份游戏内存档文件：通常位于/Saves目录或模拟器特定文件夹
• 注意：即时存档（.state文件）可能不兼容新版本，建议在游戏内创建常规存档
• 优点：节省空间，针对性强
• 缺点：需要了解不同模拟器的存档位置

硬件兼容性检查：避免升级失败

⚠️ 重要提示：确保你的设备型号在支持列表中：

• Miyoo Mini（所有版本）
• Miyoo Mini+（所有版本）
• 不支持Miyoo Pocket或其他非Mini系列设备

版本适配对照表：选择正确的升级包

设备型号	支持的升级方式	最低系统要求	推荐升级版本
Miyoo Mini	手动升级	v3.0+	最新稳定版
Miyoo Mini+	OTA/手动升级	v4.0+	最新稳定版

多场景操作：不同系统平台的升级步骤

Windows系统操作指南

解压升级文件 目的：将压缩包内容提取到本地文件夹

右键点击Onion-v4.x.x.zip文件 → 选择"全部解压缩" → 指定解压路径

复制文件到SD卡 目的：将系统文件部署到SD卡

1. 打开解压后的文件夹
2. 全选7个系统文件夹
3. 复制到SD卡根目录
4. 出现覆盖提示时选择"是"（Windows会保留原有文件）

macOS系统操作指南

显示隐藏文件 目的：确保所有系统文件（包括隐藏文件）都能被复制

按下Command+Shift+.组合键显示隐藏文件

文件复制操作 目的：正确合并系统文件夹

1. 双击ZIP文件自动解压
2. 将解压后的7个文件夹拖到SD卡图标
3. 出现提示时选择"合并"（保留原有文件）和"替换"（更新系统文件）

Linux系统操作指南

解压命令 目的：在终端中解压升级包

unzip Onion-v4.2.0.zip -d Onion-v4.2.0

原理注释：-d参数指定解压目录，避免文件散落在当前文件夹

复制文件命令 目的：将系统文件复制到SD卡

cp -rf Onion-v4.2.0/* /run/media/mmcblk0p1

原理注释：-r参数表示递归复制子目录，-f参数强制覆盖现有文件

图2：Onion系统安装引导界面，升级过程中会显示类似的引导画面

验证与排障：确保系统正常运行

系统安装过程监控

1. 将SD卡插入设备并开机，系统会自动启动安装程序
2. 观察屏幕显示：
   • Miyoo Mini：安装完成后需按A键关机
   • Miyoo Mini+：安装完成后会自动重启
3. 首次启动时间较长（约2-3分钟），请耐心等待

关键文件结构验证

✅ 必查项目：

• BIOS文件是否位于/BIOS文件夹
• ROM文件是否在/Roms对应子目录中
• .tmp_update文件夹是否存在于SD卡根目录 技术背景：.tmp_update文件夹包含系统更新所需的临时文件和脚本，删除会导致更新失败或功能异常

常见问题现场解决

问题一：升级后ROM列表不显示 解决步骤：

1. 在游戏主菜单按SELECT键刷新列表
2. 检查ROM文件是否放在正确的模拟器子目录
3. 确认ROM文件名没有特殊字符或中文

问题二：存档无法加载 解决步骤： ⚠️ 注意：这通常是由于即时存档不兼容导致

1. 删除旧的.state文件
2. 使用游戏内存档功能重新创建存档
3. 检查模拟器设置是否正确

问题三：系统启动卡在Logo界面 解决步骤：

1. 取出SD卡重新插入
2. 长按电源键10秒强制关机后重试
3. 如仍无法启动，需格式化SD卡后重新安装系统

电量与系统状态检查

图3：系统电量满格状态指示，升级前请确保电量充足

阶段检查清单：

• ✅ 系统能够正常启动到主界面
• ✅ 所有模拟器能够正常打开
• ✅ 游戏存档可以正常加载
• ✅ 系统设置能够保存
• ✅ 电池电量显示正常

通过以上步骤，你已经成功完成Onion系统的升级。新系统将为你带来更流畅的操作体验和更多实用功能。如果遇到其他问题，请查阅项目文档或社区支持资源。