Harmony OS 開發避坑指南——DevEco Device Tool 安裝配置

本文介紹如何在Windows主機上安裝DevEco Device Tool工具。

坑點總結：

1. 國內部網絡環境下，安裝npm包可能會失敗，推薦使用淘寶源；
2. serialport這個npm包安裝的過程當中須要編譯源碼，須要先安裝windows-build-tools再安裝這個包纔會成功；

準備環境

本節介紹下載、編譯鴻蒙源碼須要的軟硬件環境。

硬件環境

其中，Linux主機用於源碼下載和編譯，Windows主機用於燒寫程序到單板以及源碼編輯。

軟件環境

硬件	說明
Linux主機	推薦實際物理機器，Ubuntu16.04及以上64位系統，Shell使用bash，安裝有samba、vim等經常使用軟件，須要作適當適配以支持linux文件共享，（Samba配置須要注意，除了修改配置文件，還須要使用 smbpasswd 命令建立密碼）；使用虛擬機也能夠，但須要配置正確虛擬網絡，這裏不作詳細介紹。
Windows主機	Windows XP/Windows7/Windows10 系統
USB轉UART芯片驅動	對單板進行燒錄和調試須要安裝串口驅動程序，AI Camera和DIY IPC套件附贈的USB串口線內置PL2302芯片，須要安裝USB轉UART驅動，下載連接： http://www.hihope.org/download 頁面，USB-to-Serial Comm Port.exe 文件。WiFi IoT主控芯片上集成的是CH340G芯片，能夠選擇聯網自動安裝驅動程序。
遠程終端	推薦MobaXterm（PuTTY、SecureCRT等其餘遠程終端也能夠），用於在Windows主機上登陸Linux主機，進行源碼下載、編譯等工做

DevEco Device Tool以Visual Studio Code插件方式提供，安裝分爲以下幾步：

1. 安裝Visual Studio Code
2. 安裝Node.js
3. 安裝JDK
4. 安裝hpm和其餘npm包
5. 安裝DevEco Device Tool插件
6. 安裝C/C++插件

其中，下載nodejs、和JDK包可能較慢，安裝hpm包

安裝VSCode

DevEco Device Tool（簡稱DevEco插件）是一個Visual Studio Code（簡稱VSCode）的插件，須要先安裝VSCode；

VSCode下載頁面：https://code.visualstudio.com/Download，例如選擇 System Installer 64 bit 下載

安裝過程當中，請勾選「添加到PATH（重啓後生效）」，其餘按照默認選項進行便可；

安裝Node.js

DevEco插件的燒錄功能依賴nodejs和相關插件，須要先安裝nodejs和相關插件；

Node.js下載頁面：https://nodejs.org/en/download/ 例如選擇 64 bit Windows Installer (.msi) 下載

安裝完成後，設置環境變量 NODE_PATH 爲 C:\Users\%USERNAME%\AppData\Roaming\npm\node_modules 其中%USERNAME%爲實際用戶名；

Node.js 安裝過程當中提示，「Tools for Native Modules」 界面的複選框能夠不用勾選（勾選該選項後須要從npm官網下載安裝vs編譯工具包和Python，耗時較長，後續安裝serial插件以前，使用國內鏡像單獨安裝速度較快）；

安裝JDK

說明 須要安裝JDK 1.8，若是已安裝JDK，打開命令行工具，輸入java -version命令，檢查版本號是否1.8版本。

請自行下載並安裝JDK，版本要求爲：1.8版本。

Windows平臺的OpenJDK能夠在JetBrains下載：https://bintray.com/jetbrains/intellij-jbr/jbrsdk8-windows-x64

解壓後，配置 JAVA_HOME ，CLASSPATH，PATH 便可；

安裝hpm和其餘npm包

1. 使用國內鏡像源，加速模塊下載速度：npm config set registry https://registry.npm.taobao.org

2. 安裝hpm 鴻蒙組件管理器：npm install -g @ohos/hpm-cli

3. 安裝Windows編譯工具包，serialport 包須要編譯本地模塊，必須先安裝此包才能安裝 serialport 包：

   npm install -g windows-build-tools

4. 安裝 tftp 包，用於啓動tftp服務器，經過網絡方式向單板燒錄映像：

   npm install -g tftp

5. 安裝 serialport 包，用於經過串口燒寫映像：npm install -g serialport npm install -g @serialport/parser-readline

npm config set registry https://registry.npm.taobao.org
npm install -g @ohos/hpm-cli
npm install -g windows-build-tools
npm install -g tftp
npm install -g serialport
npm install -g @serialport/parser-readline

下載DevEco插件

1. 登陸HarmonysOS設備開發門戶，點擊右上角註冊按鈕，註冊開發者賬號，註冊指導參考註冊華爲賬號。若是已有華爲開發者賬號，請直接點擊登陸按鈕。

2. 進入HUAWEI DevEco Device Tool產品頁，下載DevEco Device Tool安裝包。

3. 打開Visual Studio Code軟件。

4. 採用從本地磁盤安裝方式，安裝DevEco Device Tool。

   安裝成功後，界面以下圖所示。

安裝C/C++插件

HarmonysOS設備開發採用C/C++語言，Visual Studio Code工具對C/C++語言的支持插件很是豐富，能夠安裝「C/C++」插件來實現C/C++代碼智能提示、代碼高亮、格式化等功能，幫助您更高效、便利的開發更規範和優美的代碼。

在Visual Studio Code的插件市場，輸入「C/C++」，而後點擊「Install」。

若是在線安裝失敗，可點擊右下角彈框的「Go to Download Page」，下載離線插件（選擇「cpptools-win32.vsix」版本，Windows下，64位和32位系統均爲同一個安裝包）。而後再參考安裝DevEco Device Tool插件的方式，離線安裝C/C++插件。