JoyShockMapper安装与配置指南

1. 项目基础介绍

JoyShockMapper 是一个开源项目，旨在让PC玩家能够使用 Sony PlayStation DualSense、DualShock 4、Nintendo Switch JoyCons 以及 Pro 控制器来玩游戏，并利用这些设备的 3-axis gyroscope（陀螺仪）特性，提供更好的游戏体验。该项目主要使用 C++ 编程语言。

2. 项目使用的关键技术和框架

• JoyShockLibrary: 用于读取 DualShock 4、DualSense、JoyCons 和 Pro 控制器输入的库。
• SDL2: 用于控制器支持。
• CMake: 用于构建项目，生成适用于不同平台的编译文件。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 操作系统: JoyShockMapper 主要在 Windows 上开发，但也支持 Linux。请确保你的系统是 Windows 或兼容的 Linux 发行版。
• 依赖项: 根据操作系统不同，需要安装相应的依赖项。

对于 Windows 用户

• 安装 Visual Studio，并确保安装了 C++ 工具和桌面开发工作负载。
• 安装 SDL2 库。

对于 Linux 用户

• 安装以下依赖项的开发包：gtk+3、libappindicator3、libevdev。
• 由于 GCC 的一个 bug，建议使用 Clang 编译器。

安装步骤

Windows 用户

1. 克隆或下载项目到本地目录。
2. 创建一个名为 build 的文件夹，并进入该文件夹。
3. 根据你的系统架构（32位或64位），使用以下命令生成 Visual Studio 解决方案：

   cmake .. -G "Visual Studio 16 2019" -A Win32
   

   或

   cmake .. -G "Visual Studio 16 2019" -A x64
   

4. 使用 Visual Studio 打开生成的 .sln 文件，并构建项目。
5. 构建完成后，运行生成的 JoyShockMapper.exe。

Linux 用户

1. 克隆或下载项目到本地目录。
2. 创建一个名为 build 的文件夹，并进入该文件夹。
3. 使用以下命令生成编译文件：

   cmake .. -DCMAKE_CXX_COMPILER=clang++
   

4. 构建项目：

   cmake --build .
   

5. 运行生成的可执行文件。

注意事项

• 在 Linux 上，可能需要更改 /dev/uinput 和 /dev/hidraw[0-n] 文件的权限，或者添加相应的 udev 规则。
• 确保将用户添加到输入组，并根据需要重启计算机。

按照以上步骤，你应该能够成功安装并运行 JoyShockMapper。享受游戏吧！