开发环境一键安装

开发环境介绍

本文所述的AliOS Things开发环境包含2部分：

• 在宿主机（即你正在使用的电脑）上运行的脚本，可以从gitee下载，详见下文的“下载一键安装工具”章节。目录结构如下所示：

dev_tool
├── dev_tool_linux.sh          # 一键安装脚本，Ubuntu版本
├── dev_tool_osx.sh            # 一键安装脚本，MacOS版本
├── dev_tool_win.bat           # 一键安装脚本，Win10版本
├── README.md                  # 说明文档
├── pic                        # 说明文档中使用的图片
├── aos_burn_tool              # aos烧录工具，目前仅支持haas100
└── utilities                  # 其它脚本和工具

• docker容器，由上述的一键安装脚本安装。容器安装并启动后，用户可以使用宿主机上的浏览器以HTTP方式连接容器，查看docker容器内的代码，也可以编辑、编译代码和烧录固件。安装好的docker容器，包含以下内容：

├──ubuntu 20.04               #容器系统
├──sshd                       #远程连接服务工具
├──aos-cube                   #AliOS Things的集成开发工具
├──dev_3.1.0_haas             #AliOS Things的dev_3.1.0_haas分支源代码
└──code-server                #网页版的Visual Studio Code

• 逻辑框图如下图所示。

• 演示视频

安装

• 下载一键安装工具

  • git代码下载

  git clone https://gitee.com/alios-things/dev_tool.git

  • http方式下载

  https://gitee.com/alios-things/dev_tool/repository/archive/master.zip

• 一键安装

进入dev_tool目录cd dev_tool，根据电脑的系统，执行相应的脚本：

# for MacOS
bash ./dev_tool_osx.sh -i

# for Ubuntu
bash ./dev_tool_linux.sh -i

# for Win10
.\dev_tool_win.bat -i

1. 安装docker软件及其依赖的工具。

2. 下载包含AliOS Things开发工具的docker镜像rtos:v0.1。

3. 使用rtos:v0.1创建一个docker容器，并下载AliOS Things的dev_3.1.0_haas分支源代码至容器中的/workspace/AliOS-Things目录。

4. 在docker容器中安装code-server及AliOS Studio，作为AliOS Things开发的Web IDE。

开发使用

• 登录code-server

一键安装成功后，将自动打开浏览器，进入到登录code-server页面。

密码获取方式

1. 成功登录网页后，系统已自动复制密码到剪切板，只需要在密码框中点击鼠标右键，然后在菜单中选择“粘贴”，点击“SUBMIT”，登录server。

2. 在执行“一键安装”脚本的终端窗口，搜索关键字password，如下图所示password:<password>，复制密码。

# for MacOS
bash ./dev_tool_osx.sh -p

# for Ubuntu
bash ./dev_tool_linux.sh -p

# for Win10
.\dev_tool_win.bat -p

• 配置和编译

使用预装在code-server上的AliOS Studio插件，选择app和board，然后点左下角的“√”号编译。

1. 点击左下角的框helloworld@developerkit，在随后的弹窗中选择apphelloworld_demo

2. 选择开发板型号haas100

3. 点击下面的“√”号，进行编译。

烧录固件

• 点击下方状态栏中的⚡️标志。

• 根据提示选择相应的串口，即可进行烧录。串口配置信息将保存在代码根目录下的.aos_config_burn文件中。若后续串口有变化，可删除该文件后，再烧录。

• 切回到原先的终端中可查看烧录的详细日志。如果日志中出现Please reboot the board manually.或者听到每秒钟1声beep，请按复位键手动复位开发板。

• 烧录成功后的提示信息如下图所示：

• 如果烧录过程中提示Communicated with host pc is failed. Please start flash programmer in host pc.，则需要使用下文所述的“再次打开docker”，该命令会在后台启动一个烧录监控程序；然后重新点击⚡️标志再烧录一次。

再次打开docker

安装成功后，docker容器将在后台运行。如果下次重新开机后，可使用-s参数，运行安装脚本，重新打开docker。

# for MacOS
bash ./dev_tool_osx.sh -s

# for Ubuntu
bash ./dev_tool_linux.sh -s

# for Win10
.\dev_tool_win.bat -s

SSH方式登录

对于不习惯使用Web IDE的开发人员，也可以通过ssh方式连接docker，进入容器内部查看代码，编译版本，烧录固件。

• 使用命令docker ps -a查看docker是否处于运行状态，如下图所示：

PORTS：端口映射状态，容器中22端口对应宿主机64028端口。

• 使用SSH方式连接

  • 方式1：命令行方式。ssh -p <port> root@127.0.0.1 ，其中port为宿主机端口号，如下图所示：

  • 方式2：VS Code+ssh remote插件方式。若已经在宿主机（即用户正在使用的电脑）上安装了VS Code和ssh remote插件，请在~/.ssh/config文件中，增加如下4行，配置完成后，可在VS Code中连接容器。

  Host code-server
  User root
  HostName 127.0.0.1
  Port 64028                         #请根据docker ps命令查找22对应的端口号填写

删除docker镜像

删除AliOS Things的docker镜像rtos:v0.1及其相应的容器，请执行如下命令：

# for MacOS
bash ./dev_tool_osx.sh -r

# for Ubuntu
bash ./dev_tool_linux.sh -r

# for Win10
.\dev_tool_win.bat -r

卸载docker工具

# for MacOS
bash ./dev_tool_osx.sh -u

# for Ubuntu
bash ./dev_tool_linux.sh -u

# for Win10
.\dev_tool_win.bat -u

注意：该命令将删除宿主机上所有docker镜像，请谨慎使用。