Awoo Installer超简单使用指南：3步掌握NSP/XCI安装工具

欢迎使用Awoo Installer——这款专为Nintendo Switch设计的安装工具，让你轻松搞定NSP、NSZ、XCI和XCZ文件的安装！无论是通过SD卡、局域网还是USB连接，只需简单几步，你就能快速上手这款"安装神器"。本文将带你从目录结构到高级配置，全方位掌握Awoo Installer的使用方法。

3步定位关键目录：轻松了解项目结构

1. 识别核心目录功能

Awoo Installer的目录结构清晰明了，主要分为以下几个部分：

目录名称	功能描述	重要文件
include/	头文件存放区	各类安装功能的声明文件，如install.hpp、nsp.hpp
source/	源代码文件夹	实现安装逻辑的cpp文件，如main.cpp、install.cpp
romfs/	资源文件目录	图片、音频等界面资源，如background.jpg、awoo.wav
include/util/	工具函数库	配置文件解析、网络连接等辅助功能

2. 寻找启动相关文件

项目的核心入口文件是source/main.cpp，它包含了程序的启动逻辑。编译后的可执行文件会在Nintendo Switch上运行，而开发环境中则通过Makefile进行构建。

3. 定位资源存储位置

所有图形界面所需的图片、图标和音频文件都存放在romfs/目录下：

• 背景图片：romfs/images/background.jpg
• 图标资源：romfs/images/icons/
• 音频文件：romfs/audio/

⚠️ 注意：修改资源文件后需要重新编译项目才能生效哦！

跨系统启动指南：Windows/macOS/Linux全支持

1. 准备工作：获取项目代码

首先，你需要将项目代码克隆到本地：

git clone https://gitcode.com/gh_mirrors/aw/Awoo-Installer
cd Awoo-Installer

2. 不同系统的编译方法

Windows系统

# 安装依赖（需提前配置好开发环境）
make dependencies
# 编译项目
make

macOS系统

# 安装必要的开发工具
brew install devkitpro
# 编译项目
make

Linux系统

# 安装编译依赖
sudo apt-get install devkitpro-pkgbuild-helpers
# 编译项目
make

3. 部署到Nintendo Switch

编译完成后，将生成的NRO文件复制到Switch的SD卡中：

sdmc:/switch/Awoo-Installer/Awoo-Installer.nro

在Switch上通过Homebrew菜单启动Awoo Installer即可开始使用！

配置文件全解析：打造个性化安装体验

1. 识别配置文件位置

Awoo Installer的配置文件位于：

sdmc:/switch/Awoo-Installer/config.json

如果是首次运行，程序会自动创建默认配置文件。

2. 关键配置项详解

配置文件中包含多个可自定义的选项：

• languageSetting：界面语言设置（0为系统默认，1为英语，2为中文等）
• overClock：是否启用超频模式加速安装
• validateNCAs：是否验证NCA文件签名
• deletePrompt：安装后是否提示删除源文件
• gayMode：是否启用特殊界面模式（试试就知道！）

示例配置片段：

{
  "languageSetting": 2,
  "overClock": true,
  "validateNCAs": true,
  "deletePrompt": true
}

3. 新手常见配置错误排查

找不到配置文件？试试这些方法：

• 确保Awoo Installer已至少运行过一次
• 检查SD卡目录结构是否正确
• 手动创建配置文件目录：mkdir -p sdmc:/switch/Awoo-Installer

⚠️ 注意：修改配置文件后需要重启Awoo Installer才能生效！

超实用安装教程：3种方式任你选

1. 通过SD卡安装游戏

1. 将NSP/NSZ/XCI/XCZ文件复制到SD卡
2. 在主菜单选择"Install from SD card"
3. 浏览并选择要安装的文件
4. 选择安装目标位置（SD卡或内部存储）
5. 等待安装完成

2. 局域网/互联网安装

1. 在主菜单选择"Install over LAN or internet"
2. 选择安装来源：URL或Google Drive
3. 输入文件地址或Google Drive文件ID
4. 确认安装目标位置
5. 等待下载并安装完成

3. USB连接安装

1. 在主菜单选择"Install over USB"
2. 使用USB线将Switch连接到电脑
3. 在电脑上打开NS-USBloader等工具
4. 选择要安装的文件并发送
5. 在Switch上确认安装

找不到安装选项？检查一下你的Awoo Installer版本是否为最新版！

进阶使用建议：解锁更多实用功能

1. 管理签名补丁

Awoo Installer提供了便捷的签名补丁管理功能：

• 在主菜单选择"Manage signature patches"
• 可一键安装、更新或卸载签名补丁
• 支持自定义签名补丁来源URL

2. 个性化设置选项

在"Settings"菜单中，你可以：

• 调整界面语言（支持多语言，包括中文）
• 启用"boost mode"加速安装
• 配置自动更新检查
• 管理NCA签名验证

3. 官方文档查询路径

虽然本文已经涵盖了大部分使用场景，但如果你想深入了解更多高级功能，可以查阅项目中的文档文件。官方文档会提供最新的功能说明和使用技巧。

现在，你已经掌握了Awoo Installer的基本使用方法和高级配置技巧！无论是通过SD卡本地安装，还是通过网络远程安装，Awoo Installer都能满足你的需求。立即开始体验这款强大的Nintendo Switch安装工具吧！

提示：定期更新Awoo Installer可以获得最新功能和安全修复哦！