开发环境介绍

本文所述的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，根据电脑的系统，执行相应的脚本：

MacOS: bash ./dev_tool_osx.sh -i

Ubuntu: bash ./dev_tool_linux.sh -i

Win10: .\dev_tool_win.bat -i

安装脚本将完成以下工作，整个安装过程大概需要5~30分钟，取决于系统配置和网速，安装过程中，需要用户输入密码：

• 安装docker软件及其依赖的工具
• 下载包含AliOS Things开发工具的docker镜像rtos:v0.1
• 使用rtos:v0.1创建一个docker容器，并下载AliOS Things的dev_3.1.0_haas分支源代码至容器中的/workspace/AliOS-Things目录
• 在docker容器中安装code-server及AliOS Studio，作为AliOS Things开发的Web IDE

若安装失败，可再次执行该命令重新安装。

Win系统注意事项：

• 如果从Docker官网下载Docker安装文件很慢，可使用命令.\dev_tool_win.bat -m 代替.\dev_tool_win.bat -i。该命令将从阿里云镜像站点下载安装文件并安装。使用此命令可能会下载到非最新版本的镜像。
• 一些额外的人工操作，请根据下图提示选择

出现提示Installing Docker Desktop，请确保选择Enable Hyper-V Windows Feature和Install required Windows components for WSL2，然后点击“OK”按钮开始安装docker。

安装完成以后，点击“Close and Restart”按钮，重启电脑。重启电脑完成之后，需要再次输入“一键安装”的命令，继续安装。

出现提示类似Python 3.9.1(64-bit) Setup的python安装页面，请确保选择Add Python 3.9 to PATH，然后点击“Install Now”按钮开始安装python。

MacOS系统注意事项：

• Installing Cask docker阶段，会停顿较长时间，请耐心等待
• 如果从Docker官网下载Docker安装文件很慢，可使用命令bash ./dev_tool_osx.sh -m代替bash ./dev_tool_osx.sh -i。该命令从阿里云镜像站点下载安装文件并安装。使用此命令可能会下载到非最新版本的镜像。
• 一些额外的人工操作，请根据下图提示选择

出现提示 “Docker”是从互联网下载的App。您确定要打开它吗？，请点击 “打开”按钮

出现提示 "Docker Desktop needs privileged access"，请点击“OK”按钮

出现提示“Docker”正在尝试安装新帮助程序工具，请输入密码，并点击“安装帮助程序”按钮

出现提示 “Docker”想要访问“桌面”文件夹中的文件 类似的弹窗，请点击“好”按钮

若直接弹出docker软件的页面，表示用户第一次安装docker，用户只需最小化即可

• 一键安装视频演示：

  • MacOS版本

  

  • Ubuntu版本

  

  • win版本

  

开发使用

登录code-server

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

​

密码获取方式

• 成功登录网页后，系统已自动复制密码到剪切板，只需要在密码框中点击鼠标右键，然后在菜单中选择“粘贴”，点击“SUBMIT”，登录server
• 在执行“一键安装”脚本的终端窗口，搜索关键字password，如下图所示password:<password>，复制密码

​ 建议用户尽快修改密码。修改密码方式如下：

​ MacOS: bash ./dev_tool_osx.sh -p

​ Ubuntu: bash ./dev_tool_linux.sh -p

​ Win10: .\dev_tool_win.bat -p

配置和编译

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

• 点击左下角的框helloworld@developerkit，在随后的弹窗中选择app helloworld_demo

• 选择开发板型号haas100

  

• 点击下面的“√”号，进行编译

• 编译成功后，在out/helloworld_demo@haas100/binary目录下可以看到生成的elf文件和bin文件

烧录固件

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

• 根据提示选择相应的串口，即可进行烧录。串口配置信息将保存在代码根目录下的.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。

MacOS: bash ./dev_tool_osx.sh -s

Ubuntu: bash ./dev_tool_linux.sh -s

Win10: .\dev_tool_win.bat -s

SSH连接

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

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

  STATUS：运行状态,UP正常启动状态，其他状态表示容器运转不正常，参考“再次打开docker”章节中所述的方法重新打开

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

• 使用SSH方式连接：

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

  

  • 方式2：vscode+ssh remote插件，若已经在宿主机（即用户正在使用的电脑）上安装了vscode和ssh remote插件，请修改~/.ssh/config文件中，增加如下4行，配置完成后，通过ssh code-server登录容器。

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

删除docker镜像

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

MacOS: bash ./dev_tool_osx.sh -r

Ubuntu: bash ./dev_tool_linux.sh -r

Win10: .\dev_tool_win.bat -r

卸载docker工具

MacOS: bash ./dev_tool_osx.sh -u

Ubuntu: bash ./dev_tool_linux.sh -u

Win10: .\dev_tool_win.bat -u

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