# 支持的操作系统

控制器软件可在以下系统上运行：

* Windows 7 x64 或更新版本
* 使用 Intel CPU 的 MacOS，运行 Sonoma（14）或更高版本
* 使用 Apple Silicon CPU 的 MacOS，运行 Sonoma（14）或更高版本
* 使用 x64 CPU 的 Linux，运行带有 Glibc 2.35 或更高版本的 Linux 发行版（例如 Ubuntu 22.04 或更高版本）
* 使用 aarch64 CPU 的 Linux（例如树莓派 3+），运行带有 Glibc 2.39 或更高版本的 Linux 发行版（例如 Ubuntu 24.04 或更高版本）
* 运行 iOS 17.6 或更高版本的 Apple iPad
* 运行 Android 11 或更高版本的 Android 设备，支持 ARM 32 位和 64 位处理器（ARMv7a 和 ARMv8a）以及 x86\_64
* 其他系统可能可以通过 Python 包运行，详见 [Python 包](/docs/stable/zh/kong-zhi-qi/where-to-get.md#python-package) 了解更多详情。

## 操作系统特定说明

### MacOS

你可能会看到错误“Apple 无法验证“Carvera Controller Community”是否不包含可能会损害你的 Mac 或危及你的隐私的恶意软件。”，因为我们目前尚未对 MacOS 发布版本进行签名。

你可以通过打开“系统设置”，然后在侧边栏中点击“隐私与安全性”来解决此问题。滚动到底部并点击“仍要打开”。这样做一次后，应用就可以正常打开。

<figure><img src="/files/410b2081002ce7725b5114265be6c4cd1a59502a" alt=""><figcaption></figcaption></figure>

### Android

在 Controller 中使用文件浏览器时，应用会引导你进入 Android 的权限页面，你需要在那里授予应用对 Android 设备文件的完全访问权限。没有这个权限，你将看不到任何文件。

请注意，我们用于图形渲染的某个库中存在一个已知 bug，这可能会导致应用启动后屏幕保持黑屏。在上游库修复之前，我们已经实现了一个临时解决方案来尽量避免这种情况发生。如果你仍然遇到此问题，请返回主屏幕再回到应用。若你遇到此问题，请通过以下方式反馈： [GitHub issue](https://github.com/Carvera-Community/Carvera_Controller/issues/new) ，以便我们共同改进适用于你设备的临时解决方案。

### Linux

为了支持 Linux，我们构建了一个 AppImage，它是一个自包含的二进制文件，包含运行应用程序所需的所有依赖。

要使用它，首先将其设为可执行（`chmod +x carveracontroller-community-<version>-<arch>.appimage`).

然后你就可以运行它了。

如果你想要一个快捷方式，可以考虑使用 [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher).

#### Arch Linux

为了让 Carvera 控制器通过 USB 连接到 ArchLinux 上的机器，必须创建一条 udev 规则，在设备连接时为用户授予 USB 设备权限。

1. 添加一个新的 udev 文件：

```
sudo vim /etc/udev/rules.d/99-carverausb.rules
```

2. 添加以下内容：

```
# Carvera USB 串口设备
SUBSYSTEM=="tty", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE="0666"

# 可选的 Jog Pendant USB 设备
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="10ce", ATTRS{idProduct}=="eb93", MODE="0666"
```

3. 保存并关闭文件后，重新加载规则：

```
sudo udevadm control --reload-rules
sudo udevadm trigger
```

### iOS

由于 Apple App Store 审核和开发者可用性原因，Carvera Community Controller 的 iOS 版本可能会比其他发布版本滞后。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://carvera-community.gitbook.io/docs/stable/zh/kong-zhi-qi/supported-os.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.