安装

前提条件

Java

• Java ≥ 11（推荐使用最新 LTS 版本）
• Maven 命令行工具

Python

• Python ≥ 3.10

安装 SDK

Java

第一步：将 SDK 安装到本地 Maven 仓库

cd idmp-java-sdk
mvn install -DskipTests

第二步：在项目 pom.xml 中添加依赖

<dependency>
  <groupId>com.taosdata</groupId>
  <artifactId>idmp-sdk</artifactId>
  <version>{SDK_VERSION}</version>
</dependency>

将 {SDK_VERSION} 替换为实际版本号，例如 1.0.13.0。

Python

进入 idmp-python-sdk 目录后，使用 pip 安装：

cd idmp-python-sdk
pip install .

提示

建议在虚拟环境中安装，避免与其他项目的依赖冲突：

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install .

验证安装

安装完成后，运行以下命令验证 SDK 是否可以正常加载：

Java

在项目中添加如下代码，能正常编译即表示安装成功：

import org.openapitools.client.ApiClient;
// 如果编译通过，说明 SDK 安装正确

Python

python -c "import idmp_sdk; print('SDK 安装成功')"

企业私有仓库

如果您的开发环境无法访问公网，需要将 SDK 托管到私有仓库：

Java

将 JAR 包上传到您的私有 Maven 仓库（如 Nexus、Artifactory），然后在 pom.xml 中配置私有仓库地址：

<repositories>
  <repository>
    <id>private-repo</id>
    <url>https://your-maven-repo/repository/maven-releases/</url>
  </repository>
</repositories>

Python

将 SDK 源码上传到私有 PyPI 服务器，然后指定索引地址安装：

pip install idmp-sdk --index-url https://your-pypi-server/simple/