从源码编译到游戏上机Awoo Installer 完整实操手册【免费下载链接】Awoo-InstallerA No-Bullshit NSP, NSZ, XCI, and XCZ Installer for Nintendo Switch项目地址: https://gitcode.com/gh_mirrors/aw/Awoo-InstallerAwoo Installer 是一款运行在 Switch 自制系统上的开源游戏安装器负责把 NSP、NSZ、XCI、XCZ 四种格式含分割版文件安装进主机安装前逐块校验 NCA 头部签名并支持 SD 卡、USB、局域网/网络三种传输通道以及签名补丁的一键管理。下文按部署 → 传文件 → 安装 → 校验的动线走一遍完整流程。先快速对齐这个工具负责什么把自制系统装 Switch 游戏这件事拆开看核心就一步让游戏文件以主机认得出的方式进入系统。Awoo Installer 专门做这一步内核基于 Adubbz Tinfoil图形界面来自 XorTroll 的 Plutonium 框架作者在 README 里的定位很直白——就是装软件不夹带别的活。它覆盖的能力清单安装 NSP、NSZ、XCI、XCZ 及分割版 NSP/XCI 文件三种文件进入方式SD 卡、USB、局域网/网络直链或 Google 网盘安装前对每个 NCA 文件做头部签名校验异常文件先拦下签名补丁的安装、更新、卸载自动适配 HOS 版本图形化菜单内置 12 种语言含简体中文。 先让它跑起来从源码到 .nro手头没有现成 .nro 的话从源码编译是最干净的路径需要 DevkitPro 编译环境git clone https://gitcode.com/gh_mirrors/aw/Awoo-Installer cd Awoo-Installer make编译产物上机分三步把生成的 Awoo-Installer.nro 复制到 SD 卡的switch/Awoo-Installer/目录工具的配置文件config.json也保存在这里SD 卡插回 Switch从 hbmenu 里启动 Awoo Installer如果你是在 Applet 模式下启动比如从相册直接跳入工具会提示该模式可能不稳定。⚠ 实操注意——界面出现异常时推荐的回退路径是退回主界面按住 R 键打开任意游戏进入 hbmenu再从完整内存模式启动 Awoo Installer。文件进 Switch 的三条路怎么挑主菜单提供三个入口通过 SD 卡安装、通过局域网或网络安装、通过 USB 安装。选哪条取决于文件现在在哪、以及你要装多少通道文件入口电脑端搭配典型用途USB数据线直连NS-USBloader批量、大文件、追求速度网络Wi-Fi 传输浏览器或 NS-USBloader免拔卡、单个补装SD 卡拷入 SD 卡读卡器新手、第一次跑通流程实操上我倾向第一次就走 SD 卡步骤最少、可排除的变量最少跑通一次心里就有底了日常补装切到网络省掉频繁拔插一次要塞几十个文件时再考虑 USB。3.1 SD 卡路径把 NSP/NSZ/XCI/XCZ 文件拷进 SD 卡任意目录分割版文件保持原样不用先合并启动 Awoo Installer选择通过 SD 卡安装浏览到文件所在目录按 A 勾选单个文件Y 可整目录全选然后按 开始安装选择安装位置SD 卡或内部存储装完后工具会询问是否删除 SD 卡上的源文件空间紧张就删想留备份就选否。3.2 网络路径前提是 Switch 与电脑处于同一 Wi-Fi且飞行模式已关闭。选择通过局域网或网络安装屏幕会显示 Switch 的 IP 地址电脑浏览器直接输入这个 IP就能在网页里选择文件上传也可以用 NS-USBloader 这类工具在 Tinfoil 模式下把文件直接推到 Switch手里有直链时选网络链接输入 URL是 Google Drive 分享链接则选Google 网盘填写文件 ID由 Switch 自行下载。备注网络安装不限制文件扩展名。如果你用的传输工具只认特定后缀改一下扩展名往往就能通过。3.3 USB 路径电脑装好 NS-USBloader用支持数据传输的 USB-C 线连接 Switch 与电脑选择通过 USB 安装等待连接建立电脑端选择文件可多选批量发送Switch 接收后会列出文件清单确认文件后按 安装等进度条走完即可。USB 通道在不同平台上的行为有差异。连接失败时先确认数据线是否支持数据传输再换一个 USB 口仍不行就切回网络通道它永远是好用的备选。安装执行装到哪、装完怎么办三条通道的文件汇入工具后后半段流程是共用的安装位置选择无论单文件还是多文件工具都会询问装入SD 卡还是内部存储按容量和用途选安装进度页显示当前文件与进度条中途不要退出清理询问SD 卡安装完成后会问是否从 SD 卡中删除安装文件。这个询问受设置里的安装后询问文件删除控制见下文失败兜底若提示安装失败已写入的部分内容可以在系统设置里清除不占死空间。起飞前两道检查NCA 验证与签名补丁能装上只是前半段能启动才算完成。工具内置两道检查建议都保留。NCA 签名验证。安装前工具会校验每个 NCA 文件的头部签名发现异常会弹出检测到无效 NCA 签名并要求确认。两类文件会始终触发这个提示整合型 XCI、含 DLC 解锁器的文件——属正常现象。但文件来源不明时看到警告先停手核实来源再决定是否继续。该验证可在设置中关闭不过工具自己也提示只有在确认文件绝对可靠时才这么做。签名补丁管理。运行自制系统内容依赖签名补丁系统升级后补丁可能失效——表现就是游戏装得上却打不开。主菜单选管理签名补丁可安装、更新、卸载。工具会自动检测当前 HOS 版本并匹配补丁更新前先备份 Hekate 的 patch.ini不使用 Hekate 时备份失败的警告可忽略装完提示重启主机即生效。系统升级后游戏打不开第一时间就到这里更新补丁。⚙️ 设置页值得翻的开关设置里多数条目保持默认即可下面几个建议过一遍安装时启用增强模式安装期间对 CPU 超频并缩短等待时间。SD 卡读写够快可以开老旧卡建议保持关闭忽略游戏最低固件版本要求想装高于当前系统固件的游戏时开启会影响兼容性谨慎使用安装后询问文件删除关闭后装完不再询问适合明确不想保留源文件的人自动检查 Awoo Installer 更新建议保持开启让工具自己跟进新版本。另外两项语言条目内置 12 种语言含简中、繁中随时可切签名补丁源链接 (URL)条目只在你想换补丁来源时才需要动。出状况时四种常见情形现象先查什么备选动作安装中断存储空间是否充足、文件是否完整换一条安装通道重试装完游戏打不开签名补丁是否为当前 HOS 版本确认 Atmosphere 是否最新版网络传输失败是否同一网络、飞行模式是否关闭大文件改用 USB 或 SD 卡USB 没反应换支持数据传输的原装线、换 USB 口重启双方设备仍不行走网络通道开始第一次安装到这里你已经具备了完整跑一遍的能力部署工具 → 按场景选通道送文件 → 选安装位置 → 装后验证能否启动。下一步把 SD 卡插回 Switch从通过 SD 卡安装完成第一次实操。自制系统相关操作动的是系统环境动手前把重要存档备份好只安装你拥有合法权利的游戏文件补丁与游戏文件来源认准可核实的渠道尊重开发者的劳动成果。【免费下载链接】Awoo-InstallerA No-Bullshit NSP, NSZ, XCI, and XCZ Installer for Nintendo Switch项目地址: https://gitcode.com/gh_mirrors/aw/Awoo-Installer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从源码编译到游戏上机：Awoo Installer 完整实操手册
从源码编译到游戏上机Awoo Installer 完整实操手册【免费下载链接】Awoo-InstallerA No-Bullshit NSP, NSZ, XCI, and XCZ Installer for Nintendo Switch项目地址: https://gitcode.com/gh_mirrors/aw/Awoo-InstallerAwoo Installer 是一款运行在 Switch 自制系统上的开源游戏安装器负责把 NSP、NSZ、XCI、XCZ 四种格式含分割版文件安装进主机安装前逐块校验 NCA 头部签名并支持 SD 卡、USB、局域网/网络三种传输通道以及签名补丁的一键管理。下文按部署 → 传文件 → 安装 → 校验的动线走一遍完整流程。先快速对齐这个工具负责什么把自制系统装 Switch 游戏这件事拆开看核心就一步让游戏文件以主机认得出的方式进入系统。Awoo Installer 专门做这一步内核基于 Adubbz Tinfoil图形界面来自 XorTroll 的 Plutonium 框架作者在 README 里的定位很直白——就是装软件不夹带别的活。它覆盖的能力清单安装 NSP、NSZ、XCI、XCZ 及分割版 NSP/XCI 文件三种文件进入方式SD 卡、USB、局域网/网络直链或 Google 网盘安装前对每个 NCA 文件做头部签名校验异常文件先拦下签名补丁的安装、更新、卸载自动适配 HOS 版本图形化菜单内置 12 种语言含简体中文。 先让它跑起来从源码到 .nro手头没有现成 .nro 的话从源码编译是最干净的路径需要 DevkitPro 编译环境git clone https://gitcode.com/gh_mirrors/aw/Awoo-Installer cd Awoo-Installer make编译产物上机分三步把生成的 Awoo-Installer.nro 复制到 SD 卡的switch/Awoo-Installer/目录工具的配置文件config.json也保存在这里SD 卡插回 Switch从 hbmenu 里启动 Awoo Installer如果你是在 Applet 模式下启动比如从相册直接跳入工具会提示该模式可能不稳定。⚠ 实操注意——界面出现异常时推荐的回退路径是退回主界面按住 R 键打开任意游戏进入 hbmenu再从完整内存模式启动 Awoo Installer。文件进 Switch 的三条路怎么挑主菜单提供三个入口通过 SD 卡安装、通过局域网或网络安装、通过 USB 安装。选哪条取决于文件现在在哪、以及你要装多少通道文件入口电脑端搭配典型用途USB数据线直连NS-USBloader批量、大文件、追求速度网络Wi-Fi 传输浏览器或 NS-USBloader免拔卡、单个补装SD 卡拷入 SD 卡读卡器新手、第一次跑通流程实操上我倾向第一次就走 SD 卡步骤最少、可排除的变量最少跑通一次心里就有底了日常补装切到网络省掉频繁拔插一次要塞几十个文件时再考虑 USB。3.1 SD 卡路径把 NSP/NSZ/XCI/XCZ 文件拷进 SD 卡任意目录分割版文件保持原样不用先合并启动 Awoo Installer选择通过 SD 卡安装浏览到文件所在目录按 A 勾选单个文件Y 可整目录全选然后按 开始安装选择安装位置SD 卡或内部存储装完后工具会询问是否删除 SD 卡上的源文件空间紧张就删想留备份就选否。3.2 网络路径前提是 Switch 与电脑处于同一 Wi-Fi且飞行模式已关闭。选择通过局域网或网络安装屏幕会显示 Switch 的 IP 地址电脑浏览器直接输入这个 IP就能在网页里选择文件上传也可以用 NS-USBloader 这类工具在 Tinfoil 模式下把文件直接推到 Switch手里有直链时选网络链接输入 URL是 Google Drive 分享链接则选Google 网盘填写文件 ID由 Switch 自行下载。备注网络安装不限制文件扩展名。如果你用的传输工具只认特定后缀改一下扩展名往往就能通过。3.3 USB 路径电脑装好 NS-USBloader用支持数据传输的 USB-C 线连接 Switch 与电脑选择通过 USB 安装等待连接建立电脑端选择文件可多选批量发送Switch 接收后会列出文件清单确认文件后按 安装等进度条走完即可。USB 通道在不同平台上的行为有差异。连接失败时先确认数据线是否支持数据传输再换一个 USB 口仍不行就切回网络通道它永远是好用的备选。安装执行装到哪、装完怎么办三条通道的文件汇入工具后后半段流程是共用的安装位置选择无论单文件还是多文件工具都会询问装入SD 卡还是内部存储按容量和用途选安装进度页显示当前文件与进度条中途不要退出清理询问SD 卡安装完成后会问是否从 SD 卡中删除安装文件。这个询问受设置里的安装后询问文件删除控制见下文失败兜底若提示安装失败已写入的部分内容可以在系统设置里清除不占死空间。起飞前两道检查NCA 验证与签名补丁能装上只是前半段能启动才算完成。工具内置两道检查建议都保留。NCA 签名验证。安装前工具会校验每个 NCA 文件的头部签名发现异常会弹出检测到无效 NCA 签名并要求确认。两类文件会始终触发这个提示整合型 XCI、含 DLC 解锁器的文件——属正常现象。但文件来源不明时看到警告先停手核实来源再决定是否继续。该验证可在设置中关闭不过工具自己也提示只有在确认文件绝对可靠时才这么做。签名补丁管理。运行自制系统内容依赖签名补丁系统升级后补丁可能失效——表现就是游戏装得上却打不开。主菜单选管理签名补丁可安装、更新、卸载。工具会自动检测当前 HOS 版本并匹配补丁更新前先备份 Hekate 的 patch.ini不使用 Hekate 时备份失败的警告可忽略装完提示重启主机即生效。系统升级后游戏打不开第一时间就到这里更新补丁。⚙️ 设置页值得翻的开关设置里多数条目保持默认即可下面几个建议过一遍安装时启用增强模式安装期间对 CPU 超频并缩短等待时间。SD 卡读写够快可以开老旧卡建议保持关闭忽略游戏最低固件版本要求想装高于当前系统固件的游戏时开启会影响兼容性谨慎使用安装后询问文件删除关闭后装完不再询问适合明确不想保留源文件的人自动检查 Awoo Installer 更新建议保持开启让工具自己跟进新版本。另外两项语言条目内置 12 种语言含简中、繁中随时可切签名补丁源链接 (URL)条目只在你想换补丁来源时才需要动。出状况时四种常见情形现象先查什么备选动作安装中断存储空间是否充足、文件是否完整换一条安装通道重试装完游戏打不开签名补丁是否为当前 HOS 版本确认 Atmosphere 是否最新版网络传输失败是否同一网络、飞行模式是否关闭大文件改用 USB 或 SD 卡USB 没反应换支持数据传输的原装线、换 USB 口重启双方设备仍不行走网络通道开始第一次安装到这里你已经具备了完整跑一遍的能力部署工具 → 按场景选通道送文件 → 选安装位置 → 装后验证能否启动。下一步把 SD 卡插回 Switch从通过 SD 卡安装完成第一次实操。自制系统相关操作动的是系统环境动手前把重要存档备份好只安装你拥有合法权利的游戏文件补丁与游戏文件来源认准可核实的渠道尊重开发者的劳动成果。【免费下载链接】Awoo-InstallerA No-Bullshit NSP, NSZ, XCI, and XCZ Installer for Nintendo Switch项目地址: https://gitcode.com/gh_mirrors/aw/Awoo-Installer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考