Sudachi快速上手教程：Windows/Linux/macOS/Android多平台安装指南

Sudachi是一款支持Android、Linux、macOS和Windows多平台的Nintendo Switch模拟器（Emulator，模拟器），采用C++开发。本指南将帮助你在不同操作系统上快速搭建Sudachi运行环境，涵盖从源码编译到基础配置的完整流程。

准备工作：了解系统要求

Sudachi对硬件和软件环境有一定要求，不同平台需满足以下条件：

• 通用要求：64位操作系统、支持Vulkan® 1.3的显卡（GPU，图形处理器）、至少4GB内存（RAM，随机存取存储器）
• 开发工具：Git（版本控制工具）、CMake（跨平台构建工具）、对应平台的C++编译器（如GCC、Clang或MSVC）

Android平台安装步骤

环境配置

1. 安装Android Studio（推荐版本：Iguana）及Java Development Kit
2. 下载并配置Vulkan® SDK 1.3.280.0
3. Windows用户需额外安装Visual Studio 2022并勾选"Desktop development with C++"工作负载

编译安装

# 克隆项目源码
cd 你的工作目录
git clone --recursive https://gitcode.com/GitHub_Trending/suda/sudachi

# 开始编译
cd sudachi/src/android
gradlew build  # Windows系统使用gradlew.bat

编译完成后，可在src/android/app/build/outputs/apk目录找到APK安装包，通过USB调试或文件传输安装到Android设备。详细构建指南可参考Building for Android。

Linux平台安装步骤

安装依赖包

在Debian/Ubuntu系统中执行以下命令安装开发依赖：

sudo apt install autoconf cmake g++-11 gcc-11 git glslang-tools libasound2 libboost-context-dev libglu1-mesa-dev libhidapi-dev libpulse-dev libtool libudev-dev libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-xinerama0 libxcb-xkb1 libxext-dev libxkbcommon-x11-0 mesa-common-dev nasm ninja-build qtbase5-dev qtbase5-private-dev qtwebengine5-dev qtmultimedia5-dev libmbedtls-dev catch2 libfmt-dev liblz4-dev nlohmann-json3-dev libzstd-dev libssl-dev libavfilter-dev libavcodec-dev libswscale-dev libunistring-dev libaom-dev libdav1d-dev autoconf automake build-essential cmake git-core libass-dev libfreetype6-dev libgnutls28-dev libmp3lame-dev libsdl2-dev libtool libva-dev libvdpau-dev libvorbis-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev meson ninja-build pkg-config texinfo wget yasm zlib1g-dev nasm libx264-dev libx265-dev libnuma-dev libvpx-dev libfdk-aac-dev libopus-dev libsvtav1-dev libsvtav1enc-dev libsvtav1dec-dev libdav1d-dev

编译安装

# 克隆项目源码
cd 你的工作目录
git clone --recursive https://gitcode.com/GitHub_Trending/suda/sudachi

# 创建构建目录并配置
mkdir build && cd build
cmake .. -DSUDACHI_USE_BUNDLED_VCPKG=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS="-march=x86-64-v2" -GNinja

# 开始编译
cmake --build . --config Release

编译完成后，可在build/bin目录找到可执行文件。详细构建指南可参考Building for Linux。

Windows平台安装步骤

环境配置

1. 安装Visual Studio 2022（勾选"Desktop development with C++"工作负载）
2. 安装Git、CMake和Vulkan® SDK
3. 确保系统已安装Qt5开发环境

编译安装

Windows平台的官方构建文档尚未完成，可参考以下临时步骤：

# 克隆项目源码
git clone --recursive https://gitcode.com/GitHub_Trending/suda/sudachi

# 使用CMake生成Visual Studio项目
cmake -S . -B build -G "Visual Studio 17 2022" -DCMAKE_BUILD_TYPE=Release

# 用Visual Studio打开build/Sudachi.sln并编译

注意：Windows平台的详细构建指南正在完善中，临时参考官方文档链接。

macOS平台安装说明

目前Sudachi的macOS平台构建文档尚未提供。基于项目结构，推测编译步骤与Linux类似，但需替换为macOS对应的依赖包管理器（如Homebrew）和开发工具链。建议关注项目更新或加入社区获取最新信息。

快速启动与基础配置

获取可执行文件

除源码编译外，你也可以直接下载官方预编译版本：

• 所有发布版本
• 最新稳定版

首次运行设置

1. 启动Sudachi后，在设置界面指定Nintendo Switch固件（Firmware，固件）和游戏ROM（Read-Only Memory，只读存储器）目录
2. 根据硬件配置调整图形和性能选项，建议开启Vulkan渲染以获得最佳体验
3. 连接控制器（支持键盘映射和手柄适配）

常见问题解决

编译失败

• 依赖缺失：确保已安装所有必要的开发包，可参考各平台的依赖列表
• 子模块未同步：克隆时添加--recursive参数，或执行git submodule update --init --recursive

运行时错误

• Vulkan初始化失败：检查显卡驱动是否支持Vulkan 1.3，更新显卡驱动
• 游戏无法加载：确认ROM文件完整性，目前兼容性列表尚未发布，可尝试不同游戏版本

项目资源与支持

• 项目源码：GitHub_Trending/suda/sudachi
• 构建文档：
  • Android：documentation/building/ANDROID.md
  • Linux：documentation/building/LINUX.md
• 社区支持：通过项目issue跟踪页面提交问题报告（目前贡献功能已关闭，请勿提交PR）

提示：Sudachi是开源项目，永远不会通过付费墙限制使用。如果需要支持开发者，可通过官方渠道进行捐赠。

通过以上步骤，你已成功在目标平台安装Sudachi模拟器。随着项目迭代，更多功能和兼容性改进将逐步推出，建议定期更新源码或关注官方发布。