OnionUI/Onion 4.2 安装指南：从固件检查到系统部署

OnionUI/Onion 4.2 安装指南：从固件检查到系统部署

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

作为一款专为复古掌机设计的定制系统，OnionUI/Onion 4.2 版本为用户带来了更流畅的操作体验和更丰富的功能。本文将详细介绍从固件检查到系统安装的全过程，帮助您顺利完成系统部署。

固件检查：系统稳定运行的基础

固件是设备底层的操作系统核心，而Onion则是运行在SD卡上的前端界面。在安装前，请务必确认您的设备固件版本符合要求，否则可能导致设备无法正常工作甚至损坏。

固件检查步骤

1. 进入设备设置菜单
2. 选择"设备信息"或"关于设备"
3. 查看"版本"或"固件版本"信息

各设备型号要求

Miyoo Mini (MM) 设备

• 最低要求版本：20220419****
• 特别注意：2022年12月生产的设备可能存在"Boya事件"问题固件（版本20221216和20221224），需要应用社区补丁

Miyoo Mini+ (MMP) 设备

• 最低要求版本：20230505****
• 特别注意：Onion V4.2是首个支持MMP硬件的版本

系统文件下载与准备

下载最新版本

Onion 4.2版本针对不同设备进行了优化，请确保下载正确的安装包。安装包通常命名为Onion-v4.x.x.zip或Onion-v4.x.x-snapshot-[tag].zip。

文件结构说明

安装包包含以下主要目录：

• BIOS：系统核心文件
• Icons：界面图标资源
• Themes：系统主题文件
• Roms：游戏ROM存放位置（需用户自行添加）
• Saves：游戏存档目录

安装与升级流程

全新安装步骤

1. 准备一张高质量的SD卡（建议使用品牌产品）
2. 将SD卡格式化为FAT32文件系统
3. 解压Onion安装包到SD卡根目录
4. 插入SD卡到设备并启动

升级现有系统

1. 备份Roms和Saves目录
2. 删除SD卡上除上述两个目录外的所有内容
3. 复制新版本文件到SD卡
4. 重新插入SD卡启动设备

常见问题排查

若安装过程中遇到问题，可尝试以下解决方案：

1. 重新复制安装文件（可跳过BIOS、Icons和Themes目录）
2. 格式化SD卡后重新安装（记得备份重要数据）
3. 检查固件版本是否符合要求

系统优化建议

成功安装后，您可以：

1. 根据个人喜好更换主题
2. 添加游戏ROM到相应目录
3. 调整系统设置以获得最佳性能
4. 定期备份存档文件

通过以上步骤，您应该能够顺利完成OnionUI/Onion 4.2系统的安装。这个轻量级但功能强大的系统将为您的复古游戏体验带来质的提升。如果在安装过程中遇到任何问题，建议参考官方文档或社区讨论获取更多帮助。

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