NS-USBLoader 安装与配置指南

NS-USBLoader 安装与配置指南

ns-usbloader Awoo Installer and GoldLeaf uploader of the NSPs (and other files), RCM payload injector, application for split/merge files. 项目地址: https://gitcode.com/gh_mirrors/ns/ns-usbloader

项目基础介绍与编程语言

项目名称: NS-USBLoader
主要编程语言: Java
作用: NS-USBLoader 是一个面向PC端的应用程序，它服务于Awoo Installer和其他兼容安装器（支持USB与网络传输）以及XorTroll的Goldleaf（仅USB）NSP安装。该工具不仅作为RCM（Recovery Console Mode）payload注入器，还能用于文件的分割与合并。适用于Windows、macOS（包括Intel和Apple Silicon）、及多种Linux环境（包括Raspberry Pi ARM架构）。

关键技术和框架

• JavaFX: 提供图形用户界面。
• libusb: 用于跨平台的USB设备通讯。
• OpenJFX: 在某些环境下用于GUI的支持。
• GNU General Public License v3.0: 开源许可协议。

准备工作与详细安装步骤

一、系统准备

对于所有平台：

确保你的系统已安装对应的JDK 11或更高版本。对于macOS，推荐使用JDK 19以避免已知的问题，特别是在苹果Silicon处理器上。

Windows:

1. 安装Java: 下载并安装最新版JDK。
2. 驱动安装: 运行NS-USBLoader时，可能需要手动下载并安装驱动。

macOS:

1. JDK安装: 确保安装了JDK 19，特别是如果你在使用苹果芯片。
2. libusb: 若你有Apple Silicon处理器，通过Homebrew安装libusb: brew install libusb。
3. 安全设置: 如果需要，调整“安全与隐私”设置以允许运行从互联网下载的.jar文件。

Linux:

1. JDK安装: 安装JDK 8u60或更高版本，并考虑添加JavaFX库如果UI显示需要。
2. udev规则: 编辑规则文件以允许非root用户访问NS设备 (/etc/udev/rules.d/99-NS.rules) 和 RCM设备 (/etc/udev/rules.d/99-NS-RCM.rules)。

二、项目下载与启动

1. 克隆仓库: 或者直接下载最新的release .jar文件。仓库地址: https://github.com/developersu/ns-usbloader

   git clone https://github.com/developersu/ns-usbloader.git
   

2. 运行NS-USBLoader: 使用命令行，导航到包含.jar文件的目录，并运行以下命令：

   java -jar NS-USBloader.jar
   

三、配置与使用

初次使用配置：

• 对于网络传输功能，检查"Gears"标签页中的网络设置，确保是否需要自定义服务器行为。
• 在首次使用之前，如果是用于Goldleaf，确认NS设备已正确设置了接收从USB或网络发送的NSP文件的方式。

实际操作：

• 游戏安装: 将NSP文件拖拽至应用或通过“Select NSP files”选择。
• RCM payload注入: 在“RCM”标签下选择payload文件并发送至Switch。
• 文件分割与合并: 利用“Folder with arrows and zeroes”标签完成操作。

记住，按照NS-USBLoader的界面指示进行操作，确保理解每个选项的作用，以便安全有效地使用此工具。

---

通过以上步骤，即使是新手也能够顺利安装并开始使用NS-USBLoader，享受自制软件安装和管理的乐趣。记得始终保持软件的更新，以便获取新功能和修复。

ns-usbloader Awoo Installer and GoldLeaf uploader of the NSPs (and other files), RCM payload injector, application for split/merge files. 项目地址: https://gitcode.com/gh_mirrors/ns/ns-usbloader