全部产品

开发环境一键安装

使用开发环境一键安装方式,可以在MacOS、Ubuntu或者Win10电脑上简单快速安装开发环境aos-cube及相关的工具。安装过程比《Linux环境安装》、《Windows环境安装》、《Mac环境安装》简单,建议初学者采用本文所述的一键安装方式。

开发环境介绍

本文所述的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
  • 逻辑框图如下图所示。

overview
  • 演示视频

code_server_demo

安装

进入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
安装脚本将完成以下工作,整个安装过程大概需要5~30分钟,取决于系统配置和网速,安装过程中,需要用户输入密码
  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。

若安装失败,可再次执行该命令重新安装
更详细的说明和注意事项,可以参考上文所述的开发环境里面的“README.md”文档。

开发使用

  • 登录code-server

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

login

密码获取方式

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

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

url
​ 建议用户尽快修改密码。修改密码方式如下:
# 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_demoapp

  2. 选择开发板型号haas100board

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

烧录固件

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

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

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

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

  • 如果烧录过程中提示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是否处于运行状态,如下图所示:

STATUS:运行状态,UP正常启动状态,其他状态表示容器运转不正常,参考“再次打开docker”章节中所述的方法重新打开。
PORTS:端口映射状态,容器中22端口对应宿主机64028端口。docker_ps
  • 使用SSH方式连接

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

    • 方式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镜像,请谨慎使用。