OnionUI 4.1 安装与升级完全指南

OnionUI 4.1 安装与升级完全指南

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

OnionUI 是一款专为复古游戏掌机设计的定制化前端界面系统，它基于开源框架构建，提供了美观的用户界面和强大的功能扩展。本文将详细介绍如何为你的设备安装或升级到 OnionUI 4.1 版本。

系统要求检查

在开始安装前，首先需要确认设备的固件版本是否符合要求：

1. 进入设备设置菜单，选择"设备信息"，查看"版本"号
2. 确认固件版本至少为 202204******（2022年4月版本）
3. 对于2022年12月购买的设备（固件版本20221216或20221224），建议先应用社区固件补丁

技术说明：固件是设备底层的操作系统，而OnionUI是运行在固件之上的前端界面系统。两者关系类似于Android系统与第三方启动器的关系。

准备工作

SD卡选择与准备

1. 选择优质SD卡：建议使用知名品牌的SD卡，原厂附带的SD卡性能较差，可能导致体验不佳或数据损坏
2. 格式化要求：
   • 必须格式化为FAT32文件系统
   • 在Mac上显示为"MS-DOS(FAT)"
   • 对于32GB以上的大容量卡，需要使用特殊工具进行格式化

下载安装包

获取最新版OnionUI 4.1安装包，解压后将包含以下6个关键文件夹：

• .tmp_update（隐藏文件夹）
• BIOS
• miyoo
• Media
• RetroArch
• Themes

全新安装步骤

第一步：基础安装

1. 将解压后的6个文件夹完整复制到SD卡根目录
2. 确保显示隐藏文件（Mac用户按Command+Shift+.）
3. 插入SD卡并启动设备，系统将自动开始安装
4. 安装完成后按A键或等待10秒，设备将自动关机

第二步：添加游戏资源

1. BIOS文件：将所需的BIOS文件放入BIOS文件夹
2. 游戏ROM：按照要求放入Roms目录下的相应子文件夹
3. 注意事项：
   • 切勿删除.tmp_update文件夹
   • 安装完成后按SELECT键刷新游戏列表
   • Mac用户建议运行清理工具处理系统索引文件

升级安装指南

升级前准备

1. 建议先对重要游戏存档进行备份
2. 某些模拟器的即时存档可能不兼容新版本，建议使用游戏内存档

升级步骤

1. 将安装包的6个文件夹复制到SD卡根目录，覆盖现有文件
2. 从v3.9或更早版本升级时，建议先删除旧的.tmp_update文件夹
3. 启动设备自动开始升级
4. 升级完成后验证：
   • BIOS和ROM文件位置是否正确
   • 游戏列表是否需要刷新

常见问题解决

1. 安装失败：尝试重新复制安装文件，可跳过部分文件夹
2. 持续问题：考虑重新格式化SD卡（记得备份重要文件夹）
3. 固件问题：确保使用兼容的固件版本

技术提示

1. 文件系统兼容性：FAT32虽然老旧，但在嵌入式设备中兼容性最佳
2. 隐藏文件处理：不同操作系统处理隐藏文件的方式不同，安装时需特别注意
3. 升级机制：OnionUI采用增量更新设计，用户配置和存档会自动保留

通过以上步骤，你应该能顺利完成OnionUI 4.1的安装或升级。这个版本带来了更流畅的界面体验和更完善的支持，是复古游戏爱好者的理想选择。

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