> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装与环境

## 系统要求

Python SDK 支持 Python 3.10 及更高版本。C SDK 提供 Linux x86\_64、Linux aarch64 和 Android aarch64 平台的预编译包。请根据目标平台选择对应的 C SDK tarball。

| 平台 | C SDK 包 |
| - | - |
| Linux x86\_64（gnu） | `wuji-sdk-c-<version>-x86_64-linux-gnu.tar.gz` |
| Linux aarch64（gnu） | `wuji-sdk-c-<version>-aarch64-linux-gnu.tar.gz` |
| Android aarch64 | `wuji-sdk-c-<version>-aarch64-android.tar.gz` |

<Info>
  安装 SDK 后，请根据设备类型完成连接和网络配置，详见[设备发现与连接](/docs/wuji-sdk/device-connection/)。
</Info>

## 安装

根据项目使用的语言选择对应的 SDK。Python 和 C SDK 可以单独安装，不要求同时安装。

### 安装 Python SDK

从 PyPI 安装 `wuji-sdk`：

```bash theme={null}
pip install wuji-sdk
```

安装完成后，使用以下命令确认 Python 包可导入：

```bash theme={null}
python -c "import wuji_sdk"
```

### 安装 C SDK

从 [GitHub Releases](https://github.com/wuji-technology/wuji-sdk/releases) 下载目标平台的 tarball。每个包包含 `lib/libwuji_sdk_c.so`、`include/wuji_sdk.h` 和许可证文件。

下面的命令以 Linux x86\_64 为例。将 `<TAG>` 替换为 Release 标签，并按目标平台修改 `SDK` 的值：

```bash theme={null}
TAG="<TAG>"
VER="${TAG#v}"
SDK="wuji-sdk-c-${VER}-x86_64-linux-gnu"
curl -L "https://github.com/wuji-technology/wuji-sdk/releases/download/${TAG}/${SDK}.tar.gz" | tar xz
```

`${SDK}` 表示解压后的 tarball 根目录。CMake 工程通过以下参数指向 SDK 的头文件和动态库：

```bash theme={null}
cmake -S examples/c/wuji_glove -B build \
  -DWUJI_SDK_INCLUDE_DIR="${SDK}/include" \
  -DWUJI_SDK_LIB="${SDK}/lib/libwuji_sdk_c.so"
cmake --build build
```

完整的 C SDK 下载、编译和示例说明见 [C SDK 参考](/docs/wuji-sdk/c-sdk-reference/)。

## 验证安装

选择已安装的 SDK，运行对应命令完成验证：

<Tabs>
  <Tab title="Python">
    ```bash theme={null}
    python -c "from wuji_sdk import SdkManager"
    ```
  </Tab>

  <Tab title="C">
    ```bash theme={null}
    test -f "${SDK}/include/wuji_sdk.h" && test -f "${SDK}/lib/libwuji_sdk_c.so" && echo "C SDK is ready"
    ```
  </Tab>
</Tabs>

安装 Wuji CLI 后，可以使用以下命令检查设备发现状态：

```bash theme={null}
wuji devices
wuji ping
```

## 接口清单

| 类别 | 接口或文件 | 用途 |
| - | - | - |
| Python 包 | `wuji_sdk` | 导入 Python SDK |
| Python 管理器 | `SdkManager` | 创建 SDK 管理器实例 |
| C 头文件 | `include/wuji_sdk.h` | 提供 C API 声明 |
| C 动态库 | `lib/libwuji_sdk_c.so` | 提供 C API 实现 |
| CMake 参数 | `WUJI_SDK_INCLUDE_DIR` | 指定 C 头文件目录 |
| CMake 参数 | `WUJI_SDK_LIB` | 指定 C 动态库路径 |
| 设备发现命令 | `wuji devices` | 列出已发现的设备 |
| 设备连通性命令 | `wuji ping` | 检查设备是否响应 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.