安装与环境

系统要求

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`

安装 SDK 后，请根据设备类型完成连接和网络配置，详见设备发现与连接。

安装

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

安装 Python SDK

从 PyPI 安装 wuji-sdk：

pip install wuji-sdk

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

python -c "import wuji_sdk"

安装 C SDK

从 GitHub Releases 下载目标平台的 tarball。每个包包含 lib/libwuji_sdk_c.so、include/wuji_sdk.h 和许可证文件。下面的命令以 Linux x86_64 为例。将 <TAG> 替换为 Release 标签，并按目标平台修改 SDK 的值：

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 的头文件和动态库：

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 参考。

验证安装

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

Python
C

python -c "from wuji_sdk import SdkManager"

test -f "${SDK}/include/wuji_sdk.h" && test -f "${SDK}/lib/libwuji_sdk_c.so" && echo "C SDK is ready"

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

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`	检查设备是否响应

概览

硬件

软件

更多

系统要求

安装

安装 Python SDK

安装 C SDK

验证安装

接口清单

​系统要求

​安装

​安装 Python SDK

​安装 C SDK

​验证安装

​接口清单

系统要求

安装

安装 Python SDK

安装 C SDK

验证安装

接口清单