AUBO 开发者

简体中文

English

简体中文

English

主题

下载与安装 ​

前置准备 ​

在安装 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”

      pyaubo_sdk_install_1

    2. 在 Python Interpreter 页面下，点击 + 标志

      pyaubo_sdk_install_2

    3. 搜索 pyaubo-sdk，选择版本，点击 Install Package

      pyaubo_sdk_install_3

卸载 ​

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

pip uninstall pyaubo_sdk

方法2：通过 PyCharm 来卸载

  1. File -> Settings

    pyaubo_sdk_install_1

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

    pyaubo_sdk_uninstall

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。

    java_sdk_uninstall

SDK 安装 ​

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

  2. 运行以下命令：

    说明：

    需要将 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

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

    java_sdk_uninstall

远程依赖安装 ​

Maven 远程依赖集成 ​

添加依赖 ​

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

说明：

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

单击查看依赖：
java
<!-- 项目依赖配置：引入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 刷新与同步 ​

  1. 在 Idea 中单击【Reload All Maven Projects】。

    java_sdk_uninstall

  2. 当 External Libraries 中出现 aubo_sdk-0.26.0-rc.6.jar 即代表安装成功。

    java_sdk_uninstall

Android 工程仓库配置 ​

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

说明：

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

添加依赖 ​

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

    说明

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

    单击查看依赖：
    java
    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

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

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

  3. AndroidManifest 权限配置

    • 必备权限：SDK 需要与机器人控制器建立网络通信，务必在 AndroidManifest.xml 中添加以下 2 项网络权限，否则会出现连接失败、网络请求异常等问题：

      <uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
      java_sdk_uninstall

    • 可选权限：如果项目需要识别当前 Wi-Fi 网络环境（如自动扫描机器人控制器所在局域网、校验 Wi-Fi 连接状态），可补充添加以下权限：

      <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
      java_sdk_uninstall

  4. Android 9 及以上明文流量说明

    说明

    • 通过 HTTP / WebSocket 明文协议连接机器人时，需配置此节。

    • 如果项目当前网络策略已经满足要求，可忽略本节。

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

    在项目的 AndroidManifest.xml 文件中，为 <application> 节点添加明文访问支持。

    <application
    android:usesCleartextTraffic="true"
    ... >
</application>
    java_sdk_uninstall
Gradle 同步校验 ​

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

    java_sdk_uninstall

    当出现BUILD SUCCESSFUL 即代表依赖下载成功。

    java_sdk_uninstall

  2. 当 External Libraries 中出现 aubo_sdk-0.26.0-rc.6.jar 即代表安装成功。

    java_sdk_uninstall