紹

AliOS Studio是一套基于vscode的開發(fā)環(huán)境，支持windows、linux、macOS。AliOS Studio有以下功能：

• 極佳開發(fā)體驗(yàn)、簡單操作界面
• 支持AliOS Things應(yīng)用開發(fā)
• 代碼補(bǔ)全、索引、提示等
• 編譯/下載/調(diào)試 AliOS Things
• 適配多種開發(fā)板
• 串口工具、TSL轉(zhuǎn)換工具等

安裝

下載并安裝 Visual Studio Code

訪問 https://code.visualstudio.com/ 下載并安裝vscode。

安裝 AliOS Studio 插件

打開vscode，按照下圖所示安裝AliOS Studio插件：

安裝 aos-cube

AliOS Studio 依賴 aos-cube，如果想要手動(dòng)安裝 aos-cube 的話，請參考 System environment setup，同時(shí)AliOS Studio也支持一鍵安裝aos-cube，如下圖所示：

使用AliOS Studio一鍵安裝功能首先需要安裝python2.7和pip。

AliOS Studio一鍵安裝的aos-cube是安裝在虛擬python環(huán)境里面的(virualenv)，在vscode的終端里面能夠正常使用aos-cube，其他終端無法正常使用aos-cube。

使用

AliOS-Studio 工具欄

AliOS Studio的主要功能都集中在vscode下方工具欄中，小圖標(biāo)從左至右功能分別是創(chuàng)建應(yīng)用工程 編譯 燒錄 串口工具 清除。

注： 當(dāng)用vscode打開了AliOS Things源碼或者應(yīng)用工程時(shí)，才會(huì)顯示全部的工具圖標(biāo)。

左側(cè)的helloworld@developerkit是編譯目標(biāo)，格式遵循應(yīng)用名字@目標(biāo)板名字的規(guī)則，點(diǎn)擊它可以依次選擇應(yīng)用和目標(biāo)板。

編譯 - Build

點(diǎn)擊編譯目標(biāo)選擇應(yīng)用和目標(biāo)板，點(diǎn)擊編譯圖標(biāo)進(jìn)行編譯：

燒錄 - Upload

1. 通過 USB Micro 線纜連接好開發(fā)板和電腦
2. 點(diǎn)擊下方工具欄閃電圖標(biāo)完成固件燒錄：

這里可以看到目前支持燒錄（upload）的開發(fā)板，如果想要自己添加開發(fā)板支持，請參考：

• https://github.com/alibaba/AliOS-Things/tree/master/build/site_scons
• 讓你的開發(fā)板支持AliOS Studio燒錄

串口監(jiān)控 - Monitor

1. 通過 USB Micro 線纜連接好開發(fā)板和電腦
2. 點(diǎn)擊下方工具欄插頭圖標(biāo)打開串口。第一次連接會(huì)提示填寫串口設(shè)備名和波特率，再次點(diǎn)擊可以看到串口輸出，同時(shí)也可以在這里輸入命令進(jìn)行交互。

這里如果打開串口出錯(cuò)，請注意你的用戶是否有串口訪問權(quán)限。

調(diào)試 - Debug

按F5或者點(diǎn)擊菜單欄Debug > Start Debugging進(jìn)入調(diào)試模式：

這里可以看到目前支持調(diào)試（debug）的開發(fā)板，如果想要自己添加開發(fā)板支持，請參考：

• https://github.com/alibaba/AliOS-Things/tree/master/build/site_scons。
• 讓你的開發(fā)板支持AliOS Studio燒錄

參考視頻：使用 AliOS Studio 開始 AliOS Things 調(diào)試。

設(shè)置優(yōu)化等級

使用調(diào)試功能，最好設(shè)置優(yōu)化等級為-Og或者-O0，否則會(huì)出現(xiàn)函數(shù)跳轉(zhuǎn)異常、單步調(diào)試異常、變量optimize-out等問題。設(shè)置優(yōu)化等級：

• AliOS Things 2.1版本以前：手動(dòng)更改build/aos_toolchain_arm-none-eabi.mk 中的COMPILER_SPECIFIC_OPTIMIZED_CFLAGS變量為-Og 或者 -O0。
• AliOS Things 2.1版本及以后：使用命令aos make BUILD_TYPE=debug即可。你也可以參考配置項(xiàng)：task.json中的說明，更改默認(rèn)的Build選項(xiàng)。

更多說明

AliOS Studio 命令列表

按 Ctrl-Shift-P 打開vscode的命令面板，輸入 alios-studio可以看到AliOS Studio支持的命令：

命令說明：

AliOS Studio 快捷鍵

默認(rèn)快捷鍵：

也可以在keybindings.json中自定義自己喜歡的按鍵組合：

[
 {
 "command": "alios-studio.build",
 "key": "shift+alt+b"
 },
 {
 "command": "alios-studio.clean",
 "key": "shift+alt+c"
 },
 {
 "command": "alios-studio.upload",
 "key": "shift+alt+u"
 }
]

配置文件說明

在AliOS Things源碼或者應(yīng)用工程中，都有.vscode/目錄，該目錄下面都有3個(gè)json文件，這些json文件分別配置不一樣的功能：

• launch.json - 設(shè)置調(diào)試參數(shù)
• settings.json - AliOS Studio配置選項(xiàng)
• tasks.json - 設(shè)置tasks參數(shù)（包括編譯、燒錄、串口監(jiān)控、清除等tasks）

AliOS-Things 2.1版本以后，新增加了一個(gè).TAGS.AOS.DB 文件，該文件是符號表數(shù)據(jù)庫。

launch.json

AliOS Studio依賴C/C++插件提供的調(diào)試能力，使用launch.json來配置調(diào)試參數(shù)，launch.json的詳細(xì)配置說明請參考：vscode-cpptools/launch.md。

每次更改編譯目標(biāo)(app@board)的時(shí)候，都會(huì)同步更新launch.json。

launch.json 中的關(guān)鍵配置項(xiàng)如下如所示：

{
 "version": "0.2.0",
 "configurations": [
 {
 ......
 "program": "${workspaceRoot}/out/helloworld@cy8ckit-149/binary/helloworld@cy8ckit-149.elf",
 "miDebuggerServerAddress": "localhost:4242",
 "setupCommands": [
 ......
 {
 "text": "target remote localhost:4242"
 }
 ......
 ],
 "osx": {
 "miDebuggerPath": "arm-none-eabi-gdb"
 },
 "linux": {
 "miDebuggerPath": "arm-none-eabi-gdb"
 },
 "windows": {
 "miDebuggerPath": "arm-none-eabi-gdb.exe"
 }
 }
 ]
}

配置項(xiàng)說明

settings.json

一般情況下無需更改settings.json的內(nèi)容，AliOS Studio會(huì)根據(jù)配置自動(dòng)更新。

{
 "aliosStudio.inner.yosBin": "aos",
 "aliosStudio.hardware.board": "developerkit",
 "aliosStudio.name": "helloworld",
 "aliosStudio.aosVersion": "2.1.0",
 "C_Cpp.default.browse.databaseFilename": "${workspaceRoot}/.vscode/.TAGS.AOS.DB"
}

該配置項(xiàng)為AliOS Things 2.1.0版本中的配置。

配置項(xiàng)說明

tasks.json

vscode 的 tasks.json 官方說明請參考https://code.visualstudio.com/Docs/editor/tasks。task的屬性請參考：https://code.visualstudio.com/Docs/editor/tasks#_custom-tasks。

當(dāng)然，你也可以在tasks.json中添加自己的任務(wù)，然后依次點(diǎn)擊vscode菜單欄的Terminal > Run Task... ，即可看到你配置的導(dǎo)出IAR工程的task：

更多的自定義task可以參考 附錄 > 添加自定義task。

其他功能

AliOS Things 3.0 應(yīng)用開發(fā)

AliOS Things 3.0版本于9月27日在云棲大會(huì)正式發(fā)布，在新版本中帶來了全新的應(yīng)用開發(fā)框架，幫助用戶快速構(gòu)建自己的應(yīng)用。使用戶可以更專注于自身應(yīng)用的開發(fā)。開發(fā)者可以在AliOS Studio中快速的創(chuàng)建應(yīng)用工程：

要求 AliOS Things >=3.0.0 和 aos-cube >=0.3.7。

鼠標(biāo)移到AliOS Things的API上會(huì)顯示API說明鏈接

為了方便開發(fā)者盡快熟悉AliOS Things API，當(dāng)鼠標(biāo)移到AliOS Things的API上就會(huì)顯示查看AliOSThings 官方API文檔：

轉(zhuǎn)換TSL json文件為C代碼文件

物的模型(TSL) 是阿里云IOT平臺很重要的一個(gè)概念，是一個(gè)數(shù)據(jù)模型，它是物理空間中的實(shí)體，如傳感器、車載裝置、樓宇、工廠等在云端的數(shù)字化表示。AliOS Studio 提供了一個(gè)高效的方法可以快速的把TSL json文件轉(zhuǎn)換為C代碼文件，右鍵json文件，然后選中Convert TSL json to C string 即可轉(zhuǎn)換：

附錄

添加自定義task

添加task - 導(dǎo)出IAR/MDK工程：

{
 "label": "alios-studio: Export IAR Project",
 "type": "shell",
 "command": "aos",
 "args": [
 "make",
 "IDE=iar"
 ],
 "presentation": {
 "focus": true
 }
}

添加task - 多線程編譯：

{
 "label": "alios-studio: Parallel Build",
 "type": "shell",
 "command": "aos",
 "args": [
 "make",
 "JOBS=8"
 ],
 "presentation": {
 "focus": true
 }
}

添加task - 編譯debug類型固件：

該固件配合調(diào)試功能。

{
 "label": "alios-studio: Build Debug",
 "type": "shell",
 "command": "aos",
 "args": [
 "make",
 "BUILD_TYPE=debug"
 ],
 "presentation": {
 "focus": true
 }
}

常見問題

Visual Studio Code is unable to watch for file changes in this large workspace

針對Linux系統(tǒng)，windows和mac不會(huì)出現(xiàn)這種情況。

該錯(cuò)誤在 linux系統(tǒng)上比較常見，主要是因?yàn)閘inux系統(tǒng)最大可監(jiān)聽文件數(shù)有限制。linux系統(tǒng)默認(rèn)系統(tǒng)可監(jiān)聽文件數(shù)為8192個(gè)，AliOS-Things的源碼比較大，文件數(shù)遠(yuǎn)遠(yuǎn)大于8192個(gè)，此時(shí)vscode無法監(jiān)聽所有的文件改動(dòng)，導(dǎo)致AliOS Studio 插件會(huì)工作不正常，報(bào)如下錯(cuò)誤：

解決辦法：

此時(shí)需要設(shè)置linux系統(tǒng)最大可監(jiān)聽文件數(shù)。

使用如下命令查看當(dāng)前可監(jiān)聽文件數(shù)：

cat /proc/sys/fs/inotify/max_user_watches

編輯文件：/etc/sysctl.conf，然后增加如下行：

fs.inotify.max_user_watches=524288

使用如下指令生效：

sudo sysctl -p

Arch Linux 用戶請參考此鏈接(https://github.com/guard/listen/wiki/Increasing-the-amount-of-inotify-watchers).

更多細(xì)節(jié)請參考："Visual Studio Code is unable to watch for file changes in this large workspace" (error ENOSPC)。

Workspace is too large to watch for file changes

和上面的問題一樣：Visual Studio Code is unable to watch for file changes in this large workspace

SyntaxError: .vscodelaunch.json: Unexpected token / in JSON at position 4378

請不要在 .vscode/tasks.json 或者 .vscode/launch.json中添加注釋。

調(diào)試模式，提示gdb is not signed

試試換個(gè)toolchain，或者刪除這個(gè)toolchain，讓aos-cube自己下載toolchain。

作者：麻紙君

本文為云棲社區(qū)內(nèi)容，未經(jīng)允許不得轉(zhuǎn)載。