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

xusiwei1236發表於2020-10-01
dev

本文介紹如何在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++外掛。

img

相關文章