¶ 1.SDK编译教程
¶ 概述
本指南旨在帮助开发者快速搭建 Arcs 开发环境，主要内容包括：
- 在 Ubuntu/Windows 系统上配置 Arcs 开发环境
- 获取 Arcs SDK 开发套件
- 完成示例项目的编译与烧录流程
- 查看设备运行日志
¶ 一、环境搭建
选择你正在使用的操作系统。
- 提供两种 Windows 下的开发环境搭建方式：
- Windows + WSL2 （推荐，安装步骤比虚拟机更少）
- Windows + 虚拟机
- 系统要求：
- Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11
- 需保证 C 盘至少有 20GB 的存储空间
1.安装 Ubuntu 环境
推荐使用微软官方维护的 Ubuntu 发行版（建议 Ubuntu 20.04 或更高版本）。
管理员权限打开 powershell ：
win + R -> 输入 powershell -> Ctrl + Shift + 回车
执行以下命令，跟随指引安装 Ubuntu 发布版本。
wsl --install Ubuntu-24.04
2.设置用户名
需要注意，用户名不要数字开头
3.设置WSL的root权限密码
请记住输入的root密码
4.启动wsl
管理员权限的 powershell 的复制粘贴不好用，因此重新开启一个powershell窗口
打开 powershell ：
win + R -> 输入 powershell -> 回车
执行命令wsl，启动 WSL
5.后续搭建步骤与 Ubuntu 原生环境相同
通常，为了保证软件源的时效性，推荐你在进入下一步之前先执行以下命令
sudo apt update
sudo apt upgrade
5.1. 安装必要依赖包
执行以下命令安装基础依赖：
sudo apt install -y \
vim \
openssh-client \
git \
git-lfs \
wget \
cmake \
curl \
tar \
zlib1g-dev \
bzip2 \
unzip \
python3
5.2. 获取 SDK
执行以下命令克隆仓库
git clone https://cloud.listenai.com/CSKG836746/arcs-sdk/public/arcs_mini.git
请注意：
SDK 请不要克隆到挂载的 windows 硬盘的路径(如：/nmt/d/)，会导致编译速度较慢。
推荐克隆到 WSL 系统内的路径（如：/home/workspace/)
可通过命令mkdir -p ~/workspace && cd ~/workspace快速进入文件夹
如果执行命令后要求输入账户以及密码，请根据文档《LSCloud使用帮助》创建仓库访问令牌
登录账号为您的聆思账户，登录密码为访问令牌
5.3. 编译工具链
克隆结束后，执行以下命令获取编译工具链：
cd arcs_mini && source ./arcs-sdk/env.sh
¶
至此，Arcs开发环境搭建完成。
1.下载 Ubuntu 镜像
下载链接：Ubuntu 官网(本文使用的版本为 24.04.3 LTS)
2.在虚拟机安装镜像
下载链接：VMware 官网 (本文使用的版本为17.6.4)
3.开发环境搭建
虚拟机环境下推荐安装 open-vm-tools 工具，之后可以复制命令到虚拟机环境进行环境配置，通过以下命令安装：
sudo apt install -y open-vm-tools
在这之后，可以重启 VMware，就可以愉快地粘贴命令。
4.后续搭建步骤与 Ubuntu 原生环境相同
通常，为了保证软件源的时效性，推荐你在进入下一步之前先执行以下命令
sudo apt update
sudo apt upgrade
4.1. 安装必要依赖包
执行以下命令安装基础依赖：
sudo apt install -y \
vim \
openssh-client \
git \
git-lfs \
wget \
cmake \
curl \
tar \
zlib1g-dev \
bzip2 \
unzip \
python3
4.2. 获取 SDK
执行以下命令克隆仓库
git clone https://cloud.listenai.com/CSKG836746/arcs-sdk/public/arcs_mini.git
如果执行命令后要求输入账户以及密码，请根据文档《LSCloud使用帮助》创建仓库访问令牌
登录账号为您的聆思账户，登录密码为访问令牌
4.3. 编译工具链
克隆结束后，执行以下命令获取编译工具链：
source ./arcs-sdk/env.sh && printf '\nsource %s/arcs-sdk/env.sh >/dev/null\n' "$PWD" >>~/.bashrc
¶
至此，Arcs开发环境搭建完成。
¶ 操作系统版本要求
支持 Ubuntu 18.04 LTS 及更新的版本。
通常，为了保证软件源的时效性，推荐你在进入下一步之前先执行以下命令
sudo apt update
sudo apt upgrade
¶ 1. 安装必要依赖包
执行以下命令安装基础依赖：
sudo apt install -y \
vim \
openssh-client \
git \
git-lfs \
wget \
cmake \
curl \
tar \
zlib1g-dev \
bzip2 \
unzip \
python3
¶ 2. 获取 SDK
执行以下命令克隆仓库
git clone https://cloud.listenai.com/CSKG836746/arcs-sdk/public/arcs_mini.git
如果执行命令后要求输入账户以及密码，请根据文档《LSCloud使用帮助》创建仓库访问令牌
登录账号为您的聆思账户，登录密码为访问令牌
¶ 3. 编译工具链
克隆结束后，执行以下命令获取编译工具链：
source ./arcs-sdk/env.sh && printf '\nsource %s/arcs-sdk/env.sh >/dev/null\n' "$PWD" >>~/.bashrc
¶
至此，Arcs开发环境搭建完成。
¶ 1. 获取SDK
执行以下命令克隆仓库
git clone https://cloud.listenai.com/CSKG836746/arcs-sdk/public/arcs_mini.git
如果执行命令后要求输入账户以及密码，请根据文档《LSCloud使用帮助》创建仓库访问令牌
登录账号为您的聆思账户，登录密码为访问令牌
¶ 2. 安装 Docker Desktop
官方下载链接： https://docs.docker.com/desktop/setup/install/mac-install/
¶ 3. 编译构建环境
下载 Dockerfile：点击下载
将 Dcokerfile 保存至 arcs-mini 项目根文件夹，然后执行构建命令：
docker build -t arcs-builder --platform=linux/amd64 .
¶ 4.项目编译
执行命令：
docker run --rm -it --init -w $PWD -v $PWD:$PWD arcs-builder ./build.sh -S ./apps/arcs-mini
由于通过 Docker Desktop 转译，全量编译会较慢，请耐心等待。
¶ 二、项目编译
注意，目前仅支持在 linux 环境下进行编译。
Windows 系统用户请先进入 WSL 环境（在终端执行命令wsl） 或 进入 VMware 虚拟机环境中。
Mac 系统用户通过 Docker Desktop 进行转译
执行构建脚本脚本,在 arcs_mini 项目根目录执行以下命令：
./build.sh -S ./apps/arcs-mini -C
构建成功页面
可以在build文件夹找到编译好的业务固件arcs-mini.hex
¶ 三、烧录
- 参考文档 《烧录工具安装教程》安装 ADB 工具与 cskburn desktop 工具
- 参考文档 《固件烧录教程(ADB工具)》将
arcs-mini.hex拖入 cskburn desktop 后选择 ADB 设备进行烧录即可。
