终极指南：OnionOS系统完整安装与配置教程

【免费下载链接】OnionOS overhaul for Miyoo Mini and Mini+项目地址: https://gitcode.com/gh_mirrors/on/Onion

OnionOS是一款专为Miyoo Mini和Mini+掌机设计的开源操作系统，它为复古游戏爱好者带来了全新的体验。这个强大的系统不仅优化了模拟器性能，还提供了现代化的用户界面和丰富的自定义功能。无论是新手还是资深玩家，都能通过本指南快速掌握OnionOS的完整安装流程和高级配置技巧。

📋 核心概念：理解OnionOS系统架构

OnionOS基于模块化设计理念，将系统功能拆分为多个独立的组件，这种架构带来了极大的灵活性和可扩展性。系统主要由以下几个核心模块组成：

系统核心模块：

• 内核层：负责硬件驱动和基础系统服务
• UI框架：提供统一的用户界面和交互逻辑
• 模拟器引擎：支持100+不同平台的游戏模拟
• 包管理系统：实现应用的安装、更新和卸载

特色功能组件：

• GameSwitcher：快速游戏切换系统
• 包管理器：模块化应用管理工具
• 主题系统：可自定义的视觉界面
• 网络服务：内置多种网络连接功能

OnionOS简洁现代的启动界面

🚀 实践指南：从零开始安装OnionOS

准备工作：选择合适的存储介质

在开始安装前，需要准备一张高质量的microSD卡。建议选择SanDisk、Samsung或Kingston等知名品牌，容量至少16GB。避免使用设备自带的SD卡，因为它们通常性能较差。

格式化要求：| 参数 | 推荐值 | 说明 | |------|--------|------| | 文件系统 | FAT32 | 必须使用FAT32格式，不支持exFAT | | 分区方案 | MBR | 确保兼容性 | | 集群大小 | 32KB | 16KB可延长SD卡寿命 | | 工具选择 | Rufus（Windows）或磁盘工具（Mac） | 确保正确格式化 |

第一步：获取OnionOS安装文件

从项目仓库克隆最新版本：

git clone https://gitcode.com/gh_mirrors/on/Onion.git

或者直接下载预编译的安装包。解压后你会看到以下目录结构：

.tmp_update/ # 系统更新文件 BIOS/ # 模拟器BIOS文件 Media/ # 媒体资源 miyoo/ # Miyoo Mini配置文件 miyoo354/ # Miyoo Mini+配置文件 RetroArch/ # 核心模拟器 Themes/ # 系统主题

第二步：执行系统安装

将解压后的所有文件夹复制到SD卡根目录，然后插入Miyoo设备并开机。系统会自动检测安装文件并开始安装过程。

安装过程中的欢迎界面，展示系统新特性

安装过程中，系统会逐步介绍各项新功能：

1. GameSwitcher功能：轻松在最近游戏间切换
2. 网络服务：提供热点、SMB、SSH等多种连接方式
3. 电池管理：实时监控设备电量状态
4. 包管理器：模块化应用安装系统

GameSwitcher功能展示，方便快速切换游戏

第三步：配置基础系统

安装完成后，系统会自动重启。首次启动时，建议进行以下基础配置：

显示设置：

• 调整屏幕亮度和对比度
• 选择合适的色彩模式
• 配置休眠时间

控制配置：

• 自定义按键映射
• 设置快捷键组合
• 调整摇杆灵敏度

存储管理：

• 检查SD卡空间使用情况
• 配置游戏存档位置
• 设置自动备份选项

🎮 高级应用：充分利用OnionOS功能

模块化包管理系统

OnionOS的最大特色是其包管理系统，位于src/packageManager/目录下。通过这个系统，你可以选择性地安装需要的模拟器和应用程序：

安装步骤：

1. 进入主菜单的"包管理器"
2. 浏览可用的模拟器类别（FC、SFC、GB、GBA、PS等）
3. 按A键选择需要的项目
4. 按START键两次完成安装

支持平台：

• 经典主机：FC、SFC、MD、PS等
• 掌机平台：GB、GBC、GBA、NDS等
• 街机游戏：MAME、FB Alpha等
• 自制软件：PICO-8、TIC-80等

游戏ROM管理最佳实践

正确的ROM管理能极大提升游戏体验：

目录结构建议：

Roms/ ├── FC/ # 红白机游戏 ├── SFC/ # 超级任天堂游戏 ├── GB/ # Game Boy游戏 ├── GBA/ # GBA游戏 ├── PS/ # PlayStation游戏 ├── ARCADE/ # 街机游戏 └── PORTS/ # 移植游戏

文件命名规范：

• 使用英文名称，避免特殊字符
• 保持文件名简洁明了
• 同一系列游戏使用统一命名规则

网络功能配置指南

OnionOS内置了完整的网络服务套件，位于src/installUI/res/installSlide8.png展示的网络设置界面：

网络服务配置界面，提供多种连接选项

可用网络服务：

1. 热点模式：将设备作为WiFi热点
2. SMB共享：通过网络访问游戏文件
3. SSH连接：远程管理设备
4. FTP服务器：方便文件传输
5. Web文件服务器：通过浏览器管理文件

配置步骤：

1. 进入"Tweaks"菜单
2. 选择"Network"子菜单
3. 启用需要的网络服务
4. 配置IP地址和端口

电池管理与优化

OnionOS提供了详细的电池状态监控功能，相关代码位于src/batteryMonitorUI/目录：

电池状态显示：

• 实时电量百分比
• 充电状态指示
• 预估剩余使用时间
• 低电量警告系统

充电状态界面，显示电池充满状态

节能技巧：

• 调整屏幕亮度至合适水平
• 设置合理的自动休眠时间
• 关闭不必要的后台服务
• 定期校准电池电量

🔧 故障排除与维护

常见问题解决方案

游戏不显示？

• 按SELECT键选择"刷新所有游戏"
• 检查ROM文件格式是否正确
• 确认ROM文件放置在正确的文件夹中
• 确保BIOS文件完整

系统运行缓慢？

• 更换更高速的SD卡（建议Class 10以上）
• 清理不需要的游戏文件
• 关闭不必要的后台服务
• 定期重启设备

网络连接失败？

• 检查WiFi信号强度
• 确认网络服务已正确启用
• 重启网络相关服务
• 检查防火墙设置

系统升级与备份

升级流程：

1. 下载最新版本的OnionOS安装包
2. 解压并将文件夹复制到SD卡根目录
3. 选择覆盖现有文件
4. 插入SD卡并开机
5. 系统自动完成升级

数据备份策略：

• 游戏存档：定期备份Saves文件夹
• 系统设置：备份miyoo或miyoo354配置文件
• 游戏列表：备份Roms目录下的.list文件
• 主题配置：备份Themes文件夹

高级调试技巧

日志查看：

• 系统日志位于.tmp_update/logs/目录
• 使用SSH连接查看实时日志
• 日志级别可通过配置文件调整

性能监控：

• 监控CPU和内存使用情况
• 检查存储空间使用率
• 查看网络连接状态

🎨 个性化定制

主题系统深度定制

OnionOS支持丰富的主题定制功能，相关工具位于src/themeSwitcher/目录：

主题切换方法：

1. 下载喜欢的主题包
2. 将主题文件放入Themes目录
3. 在系统设置中选择主题
4. 重启设备应用更改

自定义主题创建：

• 参考现有主题文件结构
• 使用标准图片格式（PNG推荐）
• 遵循统一的命名规范
• 测试不同分辨率下的显示效果

按键映射优化

根据不同游戏类型优化按键配置：

动作游戏：

• 设置连发功能
• 调整按键灵敏度
• 配置组合快捷键

角色扮演游戏：

• 优化菜单导航按键
• 设置快速存档快捷键
• 调整对话跳过功能

模拟经营游戏：

• 配置快速操作组合
• 设置视角切换按键
• 优化建造菜单导航

📊 性能优化建议

存储优化技巧

1. 清理缓存文件：定期清理临时文件
2. 压缩游戏ROM：使用合适的压缩格式
3. 优化目录结构：减少深层目录嵌套
4. 使用高速SD卡：提升读写性能

电量管理策略

1. 屏幕亮度调整：根据环境光线调整
2. 自动休眠设置：合理设置休眠时间
3. 后台服务管理：关闭不必要的服务
4. CPU频率调节：平衡性能与功耗

网络优化配置

1. 连接优先级：设置首选网络类型
2. 传输优化：调整数据包大小
3. 缓存策略：优化网络数据缓存
4. 安全设置：配置合适的加密方式

🚀 开始你的复古游戏之旅

完成OnionOS系统安装和配置后，你的Miyoo设备将焕然一新。无论是经典的红白机游戏，还是复杂的PlayStation大作，都能获得流畅的游戏体验。系统提供的丰富功能和高度可定制性，让每位玩家都能打造属于自己的个性化游戏环境。

最后建议：

• 定期检查系统更新，获取最新功能
• 加入社区讨论，分享使用经验
• 备份重要数据，防止意外丢失
• 探索高级功能，充分发挥设备潜力

OnionOS不仅是一个操作系统，更是为复古游戏爱好者打造的完整解决方案。它完美结合了现代技术的便利性和经典游戏的魅力，让每一台Miyoo设备都能发挥最大潜力，带你重温那些美好的游戏时光。

【免费下载链接】OnionOS overhaul for Miyoo Mini and Mini+项目地址: https://gitcode.com/gh_mirrors/on/Onion