azahar-emu/azahar
GitHub: azahar-emu/azahar
一个基于 Citra 的开源任天堂 3DS 模拟器，旨在成为原版 Citra 下架后的统一继承项目。
Stars: 6755 | Forks: 439
Azahar 是一个基于 Citra 的开源 3DS 模拟器项目。
它由 PabloMK7 的 Citra 分支和 Lime3DS 项目合并而成，这两个项目都是在 Citra 被下架后不久出现的。
该项目的目标是成为未来开发的既定平台。
# 安装
### Windows
Azahar 提供安装程序和 zip 压缩包两种形式。
从 [Releases](https://github.com/azahar-emu/azahar/releases) 页面下载您首选格式的最新版本。
如果您不确定是使用 MSVC 还是 MSYS2，请使用 MSYS2。
### MacOS
要下载适用于所有 Mac 的构建版本，您可以在 [Releases](https://github.com/azahar-emu/azahar/releases) 页面下载 `macos-universal` 构建。
或者，如果您希望下载专门针对您的 Mac 的构建，可以选择：
- `macos-arm64`，适用于 Apple Silicon Mac
- `macos-x86_64`，适用于 Intel Mac
### Android
Android 上有两种 Azahar 变体可用，即 Vanilla 版和 Google Play 版。
从技术上讲，Vanilla 版更胜一筹，因为它使用了一种更快的替代文件管理方法，但该方法不允许在 Google Play 商店中使用。
对于大多数用户，我们目前建议通过 Google Play 商店下载 Azahar Android 版，以便于访问：
或者，您可以使用 Obtainium 安装该应用，以使用 Vanilla 变体：
1. 从[这里](https://github.com/ImranR98/Obtainium/releases)下载并安装 Obtainium（使用名为 `app-release.apk` 的文件）
2. 打开 Obtainium 并点击“Add App”
3. 在“App Source URL”部分输入 `https://github.com/azahar-emu/azahar`
4. 点击“Add”
5. 点击“Install”，并选择首选变体
如果您愿意，也可以直接从 [Releases](https://github.com/azahar-emu/azahar/releases) 页面安装最新的 APK。
请记住，通过 APK 安装时您将无法收到自动更新。
### Linux
在 Linux 上使用 Azahar 的推荐格式是 Flathub 上提供的 Flatpak：
Azahar 也在 [Releases](https://github.com/azahar-emu/azahar/releases) 页面上以 AppImage 格式提供。
有两种 AppImage 变体可用，即 `azahar.AppImage` 和 `azahar-wayland.AppImage`。
如果您不确定使用哪种变体，我们建议使用默认的 `azahar.AppImage`。这是因为 Wayland 生态系统中的上游问题可能会在运行模拟器时引发问题（例如 [#1162](https://github.com/azahar-emu/azahar/issues/1162)）。
除非您明确需要原生 Wayland 支持（例如您正在运行没有 Xwayland 的系统），否则建议使用非 Wayland 变体。
Azahar 的 Flatpak 构建也默认禁用了原生 Wayland 支持。如果您需要原生 Wayland 支持，可以使用 [Flatseal](https://flathub.org/en/apps/com.github.tchx84.Flatseal) 启用它。
# 构建说明
请参阅此代码库的 [wiki](https://github.com/azahar-emu/azahar/wiki/Building-From-Source) 以获取构建说明
# 如何贡献？
### Pull requests
如果您想要实现更改并具备相应的技术能力，我们将很乐意接受您的贡献。
如果您要贡献新功能，强烈建议您先提出一个 Feature Request issue，在编写任何代码之前讨论该添加内容。这是为了确保您的时间不会浪费在开发被认为不适合该项目的功能上。
创建 pull request 后，请不要重复将 `master` 合并到您的分支中。维护者会在适当的时候为您更新分支。
### 语言翻译
此外，我们正在 [Transifex](https://app.transifex.com/azahar/azahar) 上接受语言翻译。如果您了解我们 Transifex 页面上列出的非英语语言，请随时做出贡献。
### 兼容性报告
即使您不想贡献代码或翻译，您也可以通过向我们的兼容性列表报告游戏兼容性数据来帮助该项目。
为此，只需阅读 https://github.com/azahar-emu/compatibility-list/blob/master/CONTRIBUTING.md 并按照说明操作。
贡献兼容性数据有助于更准确地反映模拟器当前的能力，因此如果您能在完成游戏后通过报告流程进行反馈，我们将不胜感激。
# 最低要求
以下是运行 Azahar 的最低要求：
### Desktop
```
Operating System: Windows 10 (64-bit), MacOS 13.4 (Ventura), or modern 64-bit Linux
CPU: x86-64/ARM64 CPU (Windows for ARM not supported).
Single core performance higher than 1,800 on Passmark.
SSE4.2 required on x86_64.
GPU: OpenGL 4.3 or Vulkan 1.1 support
Memory: 2GB of RAM. 4GB is recommended
```
### Android
```
Operating System: Android 10.0+ (64-bit)
CPU: Snapdragon 835 SoC or better
GPU: OpenGL ES 3.2 or Vulkan 1.1 support
Memory: 2GB of RAM. 4GB is recommended
```
# 下一步是什么？
我们以 GitHub 里程碑的形式分享即将发布的版本的公开路线图。
您可以在 https://github.com/azahar-emu/azahar/milestones 找到这些信息。
# 加入讨论
我们有一个社区 Discord 服务器，您可以在那里讨论项目、了解最新公告或协调模拟器开发。
加入链接：https://discord.gg/4ZjMpAp3M6
或者，您可以使用 Obtainium 安装该应用，以使用 Vanilla 变体：
1. 从[这里](https://github.com/ImranR98/Obtainium/releases)下载并安装 Obtainium（使用名为 `app-release.apk` 的文件）
2. 打开 Obtainium 并点击“Add App”
3. 在“App Source URL”部分输入 `https://github.com/azahar-emu/azahar`
4. 点击“Add”
5. 点击“Install”，并选择首选变体
如果您愿意，也可以直接从 [Releases](https://github.com/azahar-emu/azahar/releases) 页面安装最新的 APK。
请记住，通过 APK 安装时您将无法收到自动更新。
### Linux
在 Linux 上使用 Azahar 的推荐格式是 Flathub 上提供的 Flatpak：
Azahar 也在 [Releases](https://github.com/azahar-emu/azahar/releases) 页面上以 AppImage 格式提供。
有两种 AppImage 变体可用，即 `azahar.AppImage` 和 `azahar-wayland.AppImage`。
如果您不确定使用哪种变体，我们建议使用默认的 `azahar.AppImage`。这是因为 Wayland 生态系统中的上游问题可能会在运行模拟器时引发问题（例如 [#1162](https://github.com/azahar-emu/azahar/issues/1162)）。
除非您明确需要原生 Wayland 支持（例如您正在运行没有 Xwayland 的系统），否则建议使用非 Wayland 变体。
Azahar 的 Flatpak 构建也默认禁用了原生 Wayland 支持。如果您需要原生 Wayland 支持，可以使用 [Flatseal](https://flathub.org/en/apps/com.github.tchx84.Flatseal) 启用它。
# 构建说明
请参阅此代码库的 [wiki](https://github.com/azahar-emu/azahar/wiki/Building-From-Source) 以获取构建说明
# 如何贡献？
### Pull requests
如果您想要实现更改并具备相应的技术能力，我们将很乐意接受您的贡献。
如果您要贡献新功能，强烈建议您先提出一个 Feature Request issue，在编写任何代码之前讨论该添加内容。这是为了确保您的时间不会浪费在开发被认为不适合该项目的功能上。
创建 pull request 后，请不要重复将 `master` 合并到您的分支中。维护者会在适当的时候为您更新分支。
### 语言翻译
此外，我们正在 [Transifex](https://app.transifex.com/azahar/azahar) 上接受语言翻译。如果您了解我们 Transifex 页面上列出的非英语语言，请随时做出贡献。
### 兼容性报告
即使您不想贡献代码或翻译，您也可以通过向我们的兼容性列表报告游戏兼容性数据来帮助该项目。
为此，只需阅读 https://github.com/azahar-emu/compatibility-list/blob/master/CONTRIBUTING.md 并按照说明操作。
贡献兼容性数据有助于更准确地反映模拟器当前的能力，因此如果您能在完成游戏后通过报告流程进行反馈，我们将不胜感激。
# 最低要求
以下是运行 Azahar 的最低要求：
### Desktop
```
Operating System: Windows 10 (64-bit), MacOS 13.4 (Ventura), or modern 64-bit Linux
CPU: x86-64/ARM64 CPU (Windows for ARM not supported).
Single core performance higher than 1,800 on Passmark.
SSE4.2 required on x86_64.
GPU: OpenGL 4.3 or Vulkan 1.1 support
Memory: 2GB of RAM. 4GB is recommended
```
### Android
```
Operating System: Android 10.0+ (64-bit)
CPU: Snapdragon 835 SoC or better
GPU: OpenGL ES 3.2 or Vulkan 1.1 support
Memory: 2GB of RAM. 4GB is recommended
```
# 下一步是什么？
我们以 GitHub 里程碑的形式分享即将发布的版本的公开路线图。
您可以在 https://github.com/azahar-emu/azahar/milestones 找到这些信息。
# 加入讨论
我们有一个社区 Discord 服务器，您可以在那里讨论项目、了解最新公告或协调模拟器开发。
加入链接：https://discord.gg/4ZjMpAp3M6标签：3DS模拟器, Android模拟器, Azahar, Bash脚本, C++, Citra, Citra分支, Flathub, JIT编译, Lime3DS, Linux模拟器, macOS模拟器, OpenGL, Vulkan, Windows模拟器, 主机模拟, 云资产清单, 任天堂3DS, 开源模拟器, 怀旧游戏, 掌机游戏, 数据擦除, 本地多人游戏, 游戏存档, 游戏机模拟, 游戏模拟器, 谷歌商店, 软件移植, 逆向工程