1.3 安装

环境安装

• 下载 python 环境，推荐使用 Conda 配置环境，下载并安装最新的当前系统的 Miniforge 软件或 Miniconda 软件。

• Conda 下载地址：Miniforge3

• 安装好后启动 Miniforge Prompt，输入以下指令进行 conda 初始化

  conda init

• 安装好后启动 Miniforge Prompt 或者系统终端，输入下列命令创建新的 python 环境

  conda create -n agilesdk python=3.10

• 输入命令进入刚创建的环境

  conda activate agilesdk

  • 如果 conda 环境安装不便可使用 pip 创建和激活虚拟环境

    # 创建
    python3.10 -m venv agilesdk
    # Windows下激活环境
    .\agilesdk\Scripts\activate
    # Linux下激活环境
    source myenv/bin/activate

• 输入 cd 命令进入解压后目录，使用下方命令安装所需 python 包

  cd 包解压目录
  pip install -r requirements.txt

• 如果遇到安装错误，重复上述安装命令或切换网络后再试或者使用命令更换安装源再试：

  pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/

• 如果 pip 安装失败，可打开 requirements.txt，对每个包使用 conda 进行安装

  conda install package_name=<version>

IDE 安装

• 推荐使用 PyCharm 作为开发环境

• PyCharm 下载地址：https://www.jetbrains.com/zh-cn/pycharm/download/?section=windows

• 下载并安装好 PyCharm Community Edition 后，启动软件

• 新建 Python 项目，项目类型选择纯 Python

• 解释器类型选择基础 Conda，路径设置为之前创建的 agilesdk 环境

• 点击创建，即可开始编写代码

SDK 安装及测试

• 输入下述命令安装 python 版本的机器人 SDK，将 x.x.x 替换为当前 sdk 版本号

  pip install Agilebot.SDK.A-x.x.x-py3-none-any.whl

• 进入 example 示例文件夹，使用下述命令运行测试

  cd example
  python 示例程序名（示例：python arm/get_version.py）

• 运行示例时上位机必须连接到机器人网络中。