OnionUI/Onion系统升级指南：从原厂系统或旧版本升级详解

OnionUI/Onion系统升级指南：从原厂系统或旧版本升级详解

Onion OS overhaul for Miyoo Mini and Mini+ 项目地址: https://gitcode.com/gh_mirrors/on/Onion

前言

OnionUI/Onion作为专为Miyoo Mini系列掌机设计的操作系统，其升级过程需要特别注意数据迁移和系统兼容性问题。本文将详细介绍从原厂系统或旧版Onion系统升级到最新版本的全过程，帮助用户顺利完成系统更新。

升级前的注意事项

1. 数据备份：虽然升级过程会保留游戏存档、ROM和BIOS文件，但强烈建议在升级前备份重要数据
2. 存档类型：某些模拟器的即时存档(save states)在升级后可能不兼容，务必在升级前创建游戏内存档(in-game saves)
3. OTA更新：Miyoo Mini+支持通过Wi-Fi进行OTA更新，若更新失败可转为手动更新

升级步骤详解

第一步：准备升级文件

Windows系统操作指南

1. 右键点击Onion-v4.x.x.zip文件，选择"全部解压缩"功能
2. 将解压后的7个文件夹复制到SD卡根目录
3. 出现覆盖提示时选择"是"

Mac系统操作指南

1. 双击.zip文件自动解压（解压后文件与原压缩包同目录）
2. 确保显示隐藏文件（快捷键Command+Shift+.）
3. 将7个文件夹复制到SD卡根目录
4. 出现文件夹合并提示选择"合并"，文件替换提示选择"替换"

Linux系统操作指南

1. 使用unzip命令解压文件：

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

2. 复制文件到SD卡（注意修改挂载路径）：

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

Chrome OS系统操作指南

1. 备份个人文件（ROMs、BIOS、Saves和Themes目录）
2. 执行全新安装（clean install）
3. 恢复备份文件（注意避免文件名冲突）

特殊注意事项

1. 如果从v3.9或更早版本升级，建议先删除.tmp_update文件夹
2. 升级过程中请确保设备电量充足
3. 使用质量可靠的SD卡进行操作

第二步：启动设备完成安装

1. 将SD卡插入设备后开机，系统将自动开始安装
2. 安装完成后：
   • Miyoo Mini：按A键关机
   • Miyoo Mini+：设备将自动重启

第三步：验证文件结构

1. 检查BIOS文件是否位于BIOS文件夹
2. 确认ROM文件已放入Roms目录下对应的子文件夹
3. 重要提示：.tmp_update文件夹必须保留在SD卡中
4. 开机后，在游戏主菜单按SELECT键刷新ROM列表

常见问题解答

Q：升级后我的游戏存档会丢失吗？ A：游戏内存档会保留，但某些模拟器的即时存档可能不兼容

Q：为什么需要保留.tmp_update文件夹？ A：该文件夹包含系统运行所需的临时文件，删除可能导致功能异常

Q：升级失败怎么办？ A：建议重新下载升级包，格式化SD卡后执行全新安装

总结

OnionUI/Onion系统的升级过程相对简单，但需要注意文件迁移的细节问题。遵循本指南的步骤操作，可以确保升级过程顺利完成。升级后您将体验到最新的系统功能和性能优化，为游戏体验带来显著提升。

Onion OS overhaul for Miyoo Mini and Mini+ 项目地址: https://gitcode.com/gh_mirrors/on/Onion