下载与安装

前置准备

在安装 Java SDK 前，请确保运行环境已正确配置，更多环境配置相关信息请参见 AUBO SDK 运行要求。

SDK 开发包

SDK 开发包的下载链接：Index of /sdk (aubo-robotics.cn)。

此链接中的 SDK 开发包中有 C++ 头文件、C++ SDK 库文件，可用于 C++ SDK 二次开发。

pyaubo_sdk 库文件

如需使用 Python SDK，则需要下载和安装 pyaubo_sdk 库文件。

下载和安装

方法1：在 pypi 官网下载 pyaubo_sdk包
- 打开 pypi 网址：PyPI · The Python Package Index
- 输入并搜索 pyaubo-sdk
- 下载 pyaubo-sdk
- 单击 Download files，在 Built Distributions 栏找到对应版本的 .whl，单击即可下载。
- 下载完成后，切换到 .whl 文件所在的目录，通过 pip 命令安装。例如，安装适配 Windows 系统 64 位 python 版本 3.11 的 pyaubo_sdk 库，输入如下所示的命令。
```
  pip install pyaubo_sdk-0.22.2-cp311-cp311-win_amd64.whl
```
- 安装成功后，如下图所示。
方法2：通过 pip 命令来下载和安装
- 安装命令
```
  pip install pyaubo_sdk
```
- 安装指定版本
```
  pip install pyaubo_sdk==x.x.x
```
  例如，下载和安装版本 0.22.2
```
  pip install pyaubo_sdk==0.22.2
```
方法3：通过 PyCharm 来下载和安装
1. 依次单击“File -> Settings”
2. 在 Python Interpreter 页面下，点击 + 标志
3. 搜索 pyaubo-sdk，选择版本，点击 Install Package

卸载

方法1：通过 pip 命令来卸载

pip uninstall pyaubo_sdk

方法2：通过 PyCharm 来卸载

File -> Settings
在 Python Interpreter 界面中，选中 pyaubo-sdk，点击 — 标志来进行卸载，卸载完成后，点击 OK

Java SDK 开发包

Java SDK 安装分为本地安装及远程依赖安装两种安装方式。

本地安装

SDK 获取

Java SDK 下载地址：请从官方镜像站 aubo sdk (aubo-robotics.cn) 获取最新的 aubo_sdk-x.x.x.jar 文件。
当前版本：aubo_sdk-0.26.0-rc.6.jar。

SDK 安装

在 JAR 包所在目录下，打开命令行终端。

运行以下命令：

::: tip 说明：

需要将 aubo_sdk-0.26.0-rc.6.jar 替换为对应 SDK 版本。

:::

mvn install:install-file -Dfile=aubo_sdk-0.26.0-rc.6.jar -DgroupId=cn.aubo_robotics -DartifactId=aubo_sdk -Dversion=0.26.0-rc.6 -Dpackaging=jar

当出现 BUILD SUCCESS 即代表安装成功。

远程依赖安装

Maven 远程依赖集成

添加依赖

在项目配置文件 pom.xml 中添加如下依赖：

::: tip 说明：

需要将 <version>0.26.0-rc.6</version> 替换为目标 SDK 版本。

:::

::: details 单击查看依赖：

<!-- 项目依赖配置：引入AUBO机械臂Java SDK -->
<dependencies>
  <!-- aubo sdk 核心依赖 -->
  <dependency>
      <groupId>cn.aubo_robotics</groupId>
      <artifactId>aubo_sdk</artifactId>
      <version>0.26.0-rc.6</version>
  </dependency>
</dependencies>

<!-- aubo nexus repository：AUBO官方Maven仓库，用于在线下载SDK -->
<repositories>
    <repository>
      <id>cn.aubo_robotics</id>
      <url>http://nexus.aubo-robotics.cn/repository/maven-public/</url>
      <snapshots>
        <enabled>true</enabled>
        <updatePolicy>always</updatePolicy>
      </snapshots>
    </repository>
</repositories>

<!-- 分发管理配置：用于将项目发布到AUBO仓库 -->
<distributionManagement>
    <snapshotRepository>
      <id>maven-snapshots</id>
      <url>http://nexus.aubo-robotics.cn/repository/maven-snapshots/</url>
    </snapshotRepository>
    <repository>
      <id>maven-public</id>
      <url>http://nexus.aubo-robotics.cn/repository/maven-public/</url>
    </repository>
</distributionManagement>

:::

IDE 刷新与同步

在 Idea 中单击【Reload All Maven Projects】。
当 External Libraries 中出现 aubo_sdk-0.26.0-rc.6.jar 即代表安装成功。

Android 工程仓库配置

本模块演示如何用 Android Studio 为 Android 工程导入并验证 AUBO Java SDK。

::: tip 说明：

Android 项目中推荐通过 Gradle + Nexus Maven 的方式接入 SDK，方便同步 SDK 以及其相关依赖，便于统一版本管理。

:::

添加依赖

在 Android 工程的 settings.gradle.kts 中配置 pluginManagement 和 dependencyResolutionManagement。

::: tip 说明

如果项目中已经存在相关仓库配置，只需要合并 AUBO 私有仓库部分即可，避免重复配置。

:::

::: details 单击查看依赖：

pluginManagement {
    repositories {
        maven {
            url = uri("http://nexus.aubo-robotics.cn/repository/maven-public/")
            isAllowInsecureProtocol = true
        }

        maven { setUrl("https://maven.aliyun.com/nexus/content/groups/public/") }
        maven { setUrl("https://maven.aliyun.com/nexus/content/repositories/jcenter") }
        maven { setUrl("https://maven.aliyun.com/nexus/content/repositories/google") }
        maven { setUrl("https://maven.aliyun.com/nexus/content/repositories/gradle-plugin") }
        maven { setUrl("https://jitpack.io") }
        gradlePluginPortal()
        google()
        mavenCentral()
        jcenter()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven {
            url = uri("http://nexus.aubo-robotics.cn/repository/maven-public/")
            isAllowInsecureProtocol = true

            content {
                includeGroup("cn.aubo_robotics")
            }

            metadataSources {
                mavenPom()
                artifact()
            }
        }

        maven { setUrl("https://maven.aliyun.com/nexus/content/groups/public/") }
        maven { setUrl("https://maven.aliyun.com/nexus/content/repositories/jcenter") }
        maven { setUrl("https://maven.aliyun.com/nexus/content/repositories/google") }
        maven { setUrl("https://maven.aliyun.com/nexus/content/repositories/gradle-plugin") }
        maven { setUrl("https://jitpack.io") }
        google()
        mavenCentral()
    }
}

include(":app")

:::

java_sdk_uninstall

在 App 文件夹下的 build.gradle.kts 中添加 AUBO SDK 依赖。

dependencies {
    //AUBO SDK
    implementation("cn.aubo_robotics:aubo_sdk:0.26.0-rc.6")
}

java_sdk_uninstall

AndroidManifest 权限配置
- 必备权限：SDK 需要与机器人控制器建立网络通信，务必在 AndroidManifest.xml 中添加以下 2 项网络权限，否则会出现连接失败、网络请求异常等问题：
```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```
- 可选权限：如果项目需要识别当前 Wi-Fi 网络环境（如自动扫描机器人控制器所在局域网、校验 Wi-Fi 连接状态），可补充添加以下权限：
```
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
```
Android 9 及以上明文流量说明

::: tip 说明
- 通过 HTTP / WebSocket 明文协议连接机器人时，需配置此节。
- 如果项目当前网络策略已经满足要求，可忽略本节。
:::

Android 9.0 及以上系统为了提升安全性，默认限制了应用的明文网络流量。若直接连接，可能导致机器人连接失败或请求被拦截。

在项目的 AndroidManifest.xml 文件中，为 <application> 节点添加明文访问支持。
```
<application
    android:usesCleartextTraffic="true"
    ... >
</application>
```

Gradle 同步校验

在 Android Studio 依次单击“File > Sync Project / Gradle Sync”

当出现BUILD SUCCESSFUL 即代表依赖下载成功。
当 External Libraries 中出现 aubo_sdk-0.26.0-rc.6.jar 即代表安装成功。

下载与安装

下载与安装

前置准备

SDK 开发包

pyaubo_sdk 库文件

下载和安装

卸载

Java SDK 开发包

本地安装

SDK 获取

SDK 安装

远程依赖安装

Maven 远程依赖集成

添加依赖

IDE 刷新与同步

Android 工程仓库配置

添加依赖

Gradle 同步校验

results matching ""

No results matching ""