本页概述了在所有支持的平台上运行 Tuanjie 所需的最低系统要求。
本节列出了在各支持平台上运行 Tuanjie 编辑器的最低系统要求。请注意，实际的性能和渲染效果可能因项目复杂度而有所差异。
| 最低系统要求 | Windows | macOS | Linux |
|---|---|---|---|
| 操作系统版本 | Windows 7（SP1 及以上）、Windows 10 和 Windows 11，仅支持 64 位版本 | macOS Mojave 10.14 及以上（Intel 处理器） macOS Big Sur 11.0 及以上（Apple Silicon 处理器） |
Ubuntu 20.04 或 Ubuntu 18.04 |
| CPU | 基于 x64 架构，支持 SSE2 指令集 | 基于 x64 架构并支持 SSE2 指令集（Intel 处理器） Apple M1 或更高版本（Apple Silicon 架构） |
基于 x64 架构，支持 SSE2 指令集 |
| 图形 API | 支持 DirectX 10、11 或 12 的显卡 | 支持 Metal 的 Intel 或 AMD 显卡 | 支持 OpenGL 3.2 或 Vulkan 的 Nvidia 或 AMD 显卡 |
| 其他要求 | 安装硬件厂商官方提供的驱动程序 | 使用 Apple 官方支持的驱动程序（Intel） Apple Silicon 架构设备需安装 Rosetta 2 以兼容运行 Editor 的 Intel 或原生版本 |
建议使用 Gnome 桌面环境并基于 X11 窗口系统运行，需搭配 Nvidia 官方专有驱动或 AMD Mesa 驱动。其他环境（如发行版、窗口合成器、内核版本等）需满足兼容性要求 |
| 对于所有操作系统，工作站或笔记本电脑机型均支持 Tuanjie Editor，无需仿真、容器或兼容性层即可运行。 | |||
在 macOS 上，Tuanjie 编辑器的辅助窗口仅支持最大化，不支持进入全屏模式。
在 Apple Silicon 芯片设备上运行的 Tuanjie 编辑器存在以下限制：
在 Linux 系统下运行的 Tuanjie 编辑器存在以下限制：
Pipe error ! 错误信息，需在当前终端会话中手动提升可打开文件数限制。例如，可在终端中输入 ulimit -n 4096 后再启动编辑器。详见 Linux 编辑器问题排查指南 页面。本节列出了构建并运行 Tuanjie Player 的最低系统要求。实际的性能表现和渲染质量可能会因项目的复杂程度而有所不同。
| 操作系统 | Android | ChromeOS | iOS/iPadOS | tvOS | OpenHarmony |
|---|---|---|---|---|---|
| 版本要求 | 5.1（API 22）及以上 定制版 Android 需完整包含所有支持的 Google 标准 API。 |
稳定版本通道的 R89 及以上（Android API 28+） | iOS 12 及以上 | tvOS 12 及以上 | 3.2（API 9）及以上 |
| CPU | 支持 Neon 指令集的 ARMv7（32 位和 64 位）或 ARM64 | ARMv7、ARM64、x86 和 x86_64 | Apple A7 芯片及以上 | Apple A8 芯片及以上 | ARMv7、ARM64 和 x86_64 |
| 图形 API | OpenGL ES 2.0+、3.0+，Vulkan 注：OpenGL ES 2.0 已被弃用 |
OpenGL ES 2.0+、3.0+，Vulkan 注：OpenGL ES 2.0 已被弃用 |
Metal | Metal | OpenGL ES 2.0+、3.0+，Vulkan 注：OpenGL ES 2.0 已被弃用 |
| 其他要求 | - 内存不低于 1GB - 硬件需符合或超出 Google Android 兼容性定义文档（版本 9.0）的以下设备类型： 1. 手持设备（第 2.2 节） 2. 电视设备（第 2.3 节） 3. 平板设备（第 2.6 节） - 必须运行原生 Android 系统，除 ChromeOS 版本外，不支持容器或模拟器中的 Android - 开发环境需安装 Android SDK（12/API 31）、NDK（r23b）和 OpenJDK（11），通过 Tuanjie Hub 默认安装 |
- 支持 2019 年后发布的 ChromeOS 设备，包括 Chromebook、Chromebase、Chromebox 及平板，且处于 自动更新有效期 内 - 仅通过 WiFi 或以太网使用 Android Debug Bridge (adb) 进行脚本调试和性能分析 |
- 开发与调试请参考 Apple 官方关于 XCode 支持 的文档 - App Store 提交请遵循 Apple 的提交指南，使用指定版本 Xcode |
Apple TV 第四代及以上设备 | - 必须运行原生 OpenHarmony 操作系统 - 开发环境需安装 OpenHarmony SDK（4.0/API 10），通过 Tuanjie Hub 默认安装 |
| 操作系统 | Windows | 通用 Windows 平台（UWP） | macOS | Linux |
|---|---|---|---|---|
| 操作系统版本 | Windows 7（SP1+）、Windows 10 和 Windows 11 | Windows 10 及以上，支持 Xbox One、Xbox Series X|S、HoloLens | Mojave 10.14 及以上 | Ubuntu 20.04、Ubuntu 18.04、CentOS 7 |
| CPU | x86 或 x64 架构（支持 SSE2 指令集） | x86、x64 架构（支持 SSE2 指令集）、ARM、ARM64 | Apple Silicon，或支持 SSE2 指令集的 x64 架构 | x64 架构（支持 SSE2 指令集） |
| 图形 API | 支持 DirectX 10、11 或 12 的显卡 | 支持 DirectX 10、11 或 12 的显卡 | 支持 Metal 的 Intel 或 AMD GPU | 支持 OpenGL 3.2+ 或 Vulkan 的 GPU |
| 其他要求 | - 使用硬件厂商官方支持的驱动程序 - 开发环境需安装 Visual Studio 2015 及以上（含 C++ 工具组件），以及 Windows 10 SDK，以支持 IL2CPP 脚本后端 |
- 使用硬件厂商官方支持的驱动程序 - 开发环境要求 Windows 10（64 位）及以上，Visual Studio 2015 或更新版本（需含 C++ 工具组件）及 Windows 10 SDK |
- Apple 官方支持驱动程序 - 开发环境需安装 Xcode；如使用 IL2CPP 脚本后端并部署至 Apple Silicon，则需 macOS Catalina 10.15.4 及以上，以及 Xcode 12.2 或更高版本 |
- 使用 X11 窗口系统运行的 Gnome 桌面环境 - 使用 Nvidia 官方闭源驱动或 AMD Mesa 开源驱动的 Nvidia/AMD 显卡 - 支持的内核、合成器及用户环境需满足特定发行版要求 |
| 通用说明 | 所有桌面操作系统均支持在工作站、笔记本电脑或平板电脑形态设备上原生运行 Tuanjie Player，无需仿真器、容器或兼容性层。 | |||
| 操作系统 | Windows | macOS | Linux |
|---|---|---|---|
| 操作系统版本 | 支持 Windows 7（SP1+）、Windows 10 和 Windows 11，需在工作站或机架式设备上运行，无需仿真或兼容性层。 | 支持 Mojave 10.14 及以上版本，需在工作站或机架式设备上运行，无需仿真或兼容性层。 | 支持 Ubuntu 20.04、Ubuntu 18.04 以及 CentOS 7，需在工作站或机架式设备上运行，无需仿真或兼容性层。 |
| CPU | x86 或 x64 架构，支持 SSE2 指令集。 | x64 架构，支持 SSE2 指令集。 | x64 架构，支持 SSE2 指令集。 |
| GPU | 无需显式 GPU 支持。 | — | — |
| 其他要求 | 使用硬件厂商官方支持的驱动程序。 | — | — |
| 运行平台的操作系统 | Windows、macOS 和 Linux |
|---|---|
| 硬件 | 工作站或笔记本电脑设备。 |
| 其他要求 | 支持以下条件的现代浏览器（如 Chrome、Firefox、Safari、基于 Chromium 的 Edge）： - 支持 WebGL 2.0 - 符合 HTML5 标准 - 64 位架构 - 支持 WebAssembly 注意：WebGL 1.0 已不再推荐使用。 |
| 运行平台的操作系统 | Android、iOS、Windows 和 macOS |
|---|---|
| CPU | - 移动端：ARMv7 或 ARM64 - 桌面端：x64 架构 |
| RAM | - 移动端：≥ 1GB - 桌面端：≥ 4GB（推荐） |
| 图形 API | 支持 WebGL 2.0 |
| 其他要求 | - 安装微信客户端或抖音客户端（推荐最新版本） - 支持 WebAssembly - 64 位架构 - 支持 Unity 小游戏宿主运行环境 |
Tuanjie 目前已适配多种嵌入式平台，包括 HMI Android、Embedded Linux 和 QNX，广泛覆盖多种主流芯片架构与操作环境。
以下为各平台的推荐系统配置：
| 操作系统 | HMI Android | Embedded Linux | QNX |
|---|---|---|---|
| RAM | ≥ 1GB | ≥ 1GB | ≥ 1GB |
| CPU | ARMv7（支持 Neon，32 位或 64 位）或 ARM64 | 双核 x86、x64、ARM 或 ARM64 | 双核 x64 或 ARM64 |
| 图形 API | 支持 OpenGL ES 2.0 及以上版本，推荐 OpenGL ES 3.0+ 或 Vulkan | 支持 OpenGL ES 3.0 或 Vulkan 1.1 | 支持 OpenGL ES 3.0 或 Vulkan 1.1 |
HMI Android 的系统要求与Android Mobile一致.
对于任何支持 Windows 7 的 Tuanjie Editor 或 Player，请注意，Microsoft 为 Windows 7 提供的支持于 2020 年 1 月 14 日之后到期。