OnionUI系统升级指南：从原厂系统或其他版本升级详解

OnionUI系统升级指南：从原厂系统或其他版本升级详解

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

前言

OnionUI作为一款专为复古游戏掌机设计的定制系统，其升级过程需要特别注意数据迁移和兼容性问题。本文将详细介绍从原厂系统或其他版本升级到OnionUI 4.2版本的全过程，帮助用户顺利完成系统升级。

升级前的准备工作

在开始升级前，请务必注意以下关键事项：

1. 存档保护：虽然升级过程中大多数存档数据会自动保留，但某些模拟器的即时存档(save states)可能存在兼容性问题。强烈建议：

   • 对所有游戏进行游戏内存档(非即时存档)
   • 备份重要存档文件至电脑

2. OTA更新说明：对于支持Wi-Fi的机型，可以通过内置OTA应用进行无线升级。若OTA更新失败，仍需采用本文介绍的手动升级方式。

升级步骤详解

第一步：准备安装文件

Windows系统操作指南

1. 右键点击下载的Onion-v4.x.x.zip文件
2. 选择"全部解压缩"并指定解压路径
3. 将解压后的7个核心文件夹复制到SD卡根目录
4. 出现覆盖提示时选择"是"

macOS系统操作指南

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

Linux系统操作指南

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

(注意根据实际情况修改路径和文件名)

Chrome OS特别说明

由于系统限制，建议采用以下流程：

1. 备份ROM、BIOS、存档和主题等个人文件
2. 执行全新安装
3. 恢复备份文件(注意避免文件名冲突)

重要提示：若从v3.9或更早版本升级，建议先删除SD卡上的.tmp_update文件夹。

第二步：执行安装

1. 将准备好的SD卡插入设备并开机
2. 系统将自动开始安装过程
3. 安装完成后：
   • 标准机型：按A键关机
   • Plus机型：设备将自动重启

第三步：文件验证与整理

1. BIOS文件检查：确保所有BIOS文件位于BIOS目录下
2. ROM文件整理：按照模拟器要求将ROM放入对应子目录
3. 特殊目录说明：.tmp_update目录必须保留在SD卡上
4. 刷新游戏列表：开机后进入游戏菜单，按SELECT键刷新ROM列表

常见问题解答

Q：升级后我的游戏存档会丢失吗？ A：游戏内存档通常会保留，但即时存档可能存在兼容性问题，建议提前备份。

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

Q：升级失败怎么办？ A：建议重新下载安装包，检查SD卡健康状况，必要时尝试全新安装。

结语

通过本文详细的升级指南，即使是新手用户也能顺利完成OnionUI系统的升级过程。升级后您将体验到最新版本带来的性能优化和新功能。如果在升级过程中遇到任何问题，建议参考官方文档或社区讨论获取更多帮助。

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