【HarmonyO 应用开发环境搭建】鸿蒙应用开发工具DevecoStudio...S

鸣涧

【HarmonyOS 应用开发环境搭建】鸿蒙应用开发工具DevEcoStudio安装


DevEco Studio版本简介






HUAWEI DevEco Studio是基于IntelliJ IDEA Community开源版本打造，面向终端全场景多设备的一站式集成开发环境（IDE），同时支持OpenHarmony和HarmonyOS应用/服务（Application/Service）开发。为开发者提供一站式的分布式应用/服务开发平台，支持分布式多端开发、分布式多端调测、多端模拟仿真，提供全方位的质量与安全保障。

OpenHarmony和HarmonyOS应用/服务均使用DevEco Studio进行开发，但在部分功能（如编程语言、模拟器、签名等）的使用上会存在差别，具体请参考表1。为了避免开发者在使用DevEco Studio的过程中混淆OpenHarmony和HarmonyOS的相关功能，我们将DevEco Studio使用指南分为《HUAWEI DevEco Studio For HarmonyOS使用指南》和《HUAWEI DevEco Studio For OpenHarmony使用指南》，请在查阅过程中注意区分。

DevEco Studio在支撑OpenHarmony和HarmonyOS应用/服务开发的主要功能区别如下表所示：

表1 OpenHarmony和HarmonyOS开发主要功能区别[td]

功能	OpenHarmony	HarmonyOS
支持的编程语言	JavaScript、eTS和C/C++	Java、JavaScript、eTS和C/C++
支持的设备类型	搭载OpenHarmony系统的开发板，如RK3568、Hi3516DV300等	华为提供的终端设备，如Phone、Tablet、TV、Wearable、Lite Wearable、Smart Vision和Router
工程结构	采用Hvigor编译构建体系，其配置文件为build-profile.json5、package.json	API 4-7：采用Gradle编译构建体系，其配置文件为build.gradle API 8：采用Hvigor编译构建体系，其配置文件为build-profile.json5、package.json
模拟器	暂不支持	支持Local Emulator和Remote Emulator，包括Phone、Tablet、TV等设备
远程真机	暂不支持	支持Phone、Tablet、TV等设备
编译构建	使用Hvigor编译构建工具	API 4-7：使用Gradle编译构建工具 API 8：使用Hvigor编译构建工具
签名	使用SDK包中携带的签名工具进行签名	应用通过AppGallery Connect申请签名文件；服务通过HUAWEI Ability Gallery申请签名文件
调试	支持单设备、单语言调试	支持跨语言、跨设备的分布式调试
性能分析	支持CPU、内存分析	支持CPU、内存、网络活动、能耗分析
发布	暂不支持	应用支持发布到AppGallery Connect，服务支持发布到HUAWEI Ability Gallery

HarmonyOS 应用开发环境搭建--DevEcoStudio安装


搭建开发环境流程






[color=rgba(0, 0, 0, 0.9)]DevEco Studio支持Windows系统和macOS系统，在开发HarmonyOS应用/服务前，需要准备HarmonyOS应用/服务的开发环境。环境准备流程如下所示：
[color=rgba(0, 0, 0, 0.9)]

如上图所示，搭建HarmonyOS应用/服务开发的环境包括软件安装、配置开发环境和运行HelloWorld三个环节，详细的指导请参考：

[td]

步骤	操作步骤	操作指导	说明
1	软件安装	Windows环境	安装DevEco Studio。
		macOS环境
2	配置开发环境	（可选）配置Gradle代理	网络不能直接访问Internet，需要通过代理服务器才可以访问的情况下需要设置。 如果无需代理即可访问Internet，可跳过该步骤。
3		（可选）配置DevEco Studio代理
4		（可选）配置NPM代理
5		下载HarmonyOS SDK	-
6	运行HelloWorld	创建一个新工程	使用模拟器运行Demo工程，验证环境是否已经配置完成。
7		运行应用

[color=rgba(0, 0, 0, 0.9)]evEco Studio支持Windows和macOS系统，下面将针对两种操作系统的软件安装方式进行介绍。

[color=rgba(0, 0, 0, 0.9)]Windows环境
[color=rgba(0, 0, 0, 0.9)]运行环境要求

为保证DevEco Studio正常运行，建议电脑配置满足如下要求：

• 操作系统：Windows10 64位
• 内存：8GB及以上
• 硬盘：100GB及以上
• 分辨率：1280*800像素及以上
  

[color=rgba(0, 0, 0, 0.9)]下载和安装DevEco Studio

• 进入HUAWEI DevEco Studio产品页，点击下载列表后的 按钮，下载DevEco Studio。
• 下载完成后，双击下载的“deveco-studio-xxxx.exe”，进入DevEco Studio安装向导，在如下界面选择安装路径，默认安装于C:\Program Files路径下，也可以点击Browse...指定其他安装路径，然后点击Next。

  

• 在如下安装选项界面勾选DevEco Studio后，点击Next，直至安装完成。

  

• 安装完成后，点击Finish完成安装。

  

  
  

[color=rgba(0, 0, 0, 0.9)]macOS环境
[color=rgba(0, 0, 0, 0.9)]运行环境要求

为保证DevEco Studio正常运行，建议电脑配置满足如下要求：

• 操作系统：macOS 10.14/10.15/11.2.2
• 内存：8GB及以上
• 硬盘：100GB及以上
• 分辨率：1280*800像素及以上
  

下载和安装DevEco Studio

• 进入HUAWEI DevEco Studio产品页，点击下载列表后的 按钮，下载DevEco Studio。
• 下载完成后，双击下载的“deveco-studio-xxxx.dmg”软件包。
• 在安装界面中，将“DevEco-Studio.app”拖拽到“Applications”中，等待安装完成。

  

• 安装完成后，接下来请根据配置开发环境，检查和配置开发环境。
  

配置开发环境

• 
  

更新时间: 2022-07-07 16:32
[color=rgba(0, 0, 0, 0.9)]下载HarmonyOS SDK

在开发HarmonyOS应用/服务前，请提前下载HarmonyOS SDK及配套的工具链。DevEco Studio提供SDK Manager统一管理SDK及工具组件，包括如下组件包：

[td]

组件包名	说明	参考
Native	C/C++语言SDK包。	《Native API参考》
eTS	eTS（Extended TypeScript） SDK包。	《基于TS扩展的声明式开发范式》
JS	JS语言SDK包。	《基于JS扩展的类Web开发范式》
Java	Java语言SDK包。	《Java API参考》
System-image-phone	本地模拟器Phone设备镜像文件，仅支持API Version 6。	使用Local Emulator运行应用/服务
System-image-tv	本地模拟器TV设备镜像文件，仅支持API Version 6。
System-image-wearable	本地模拟器Wearable设备镜像文件，仅支持API Version 6。
EmulatorX86	本地模拟器工具包。
Toolchains	SDK工具链，HarmonyOS应用/服务开发必备工具集，包括编译、打包、签名、数据库管理等工具的集合。	-
Previewer	HarmonyOS应用/服务预览器，在开发过程中可以动态预览Phone、TV、Wearable、LiteWearabl e等设备的应用/服务效果，支持JS、eTS和Java应用/服务预览。	使用预览器查看应用/服务效果

[color=rgba(0, 0, 0, 0.9)]下载HarmonyOS SDK

HarmonyOS应用/服务支持API Version 4至8，第一次使用DevEco Studio，工具的配置向导会引导您下载HarmonyOS SDK及工具链。配置向导默认下载 API Version 8的SDK及工具链，如需下载API Version 4至7，可在工程配置完成后，进入HarmonyOS SDK界面手动下载。

• 运行已安装的DevEco Studio，首次使用，请选择Do not import settings，点击OK。
• 进入DevEco Studio操作向导页面，设置npm registry，DevEco Studio已预置对应的仓，直接点击Start using DevEco Studio进入下一步。
  
  说明
  

  如果配置向导界面出现的是设置Set up HTTP Proxy界面，说明网络受限，请根据参考信息配置DevEco Studio代理和NPM代理后，再下载SDK。

  
  
  
  
  
  

  

• 设置Node.js信息，可以指定本地已安装的Node.js（版本要求为v14.19.1及以上，且低于v15.0.0）；如果本地没有合适的版本，可以选择Download按钮，然后在线下载Node.js。本示例以下载Node.js为例，选择下载源和存储路径后，点击Next进入下一步。

  

  等待Node.js安装完成。安装完成后，点击Finish完成Node.js安装。

  

• 在SDK Componets Setup界面，设置OpenHarmony SDK和HarmonyOS SDK存储路径，点击Next进入下一步。
  
  说明
  

  OpenHarmony SDK和HarmonyOS SDK不能设置为同一个路径，且路径中不能包含中文字符。

  
  
  
  
  
  

  

• 在弹出的SDK下载信息页面，点击Next，并在弹出的License Agreement窗口，阅读Licnese协议，需同意License协议后（需同时接受OpenHarmony SDK和HarmonyOS SDK的License协议），点击Next开始下载SDK。
  
  说明
  

  下载SDK过程中，如果出现下载JS SDK失败，提示“Install js dependencies failed.”，请根据JS SDK安装失败处理指导进行处理。

  
  
  
  
  
  

  

• 等待SDK下载完成后，点击Finish，完成HarmonyOS SDK的下载，界面会进入到DevEco Studio欢迎页。
  

默认下载API Version 8的SDK及工具链，如需下载其它版本SDK，请在HarmonyOS SDK界面手动下载，进入方法如下：

• 在DevEco Studio欢迎页，点击Configure（或 图标） > Settings > HarmonyOS SDK进入SDK Manager界面（macOS系统为Configure > Preferences > HarmonyOS SDK）。
• 在DevEco Studio打开工程的情况下，点击Tools > SDK Manager界面进入；或者点击Files > Settings > HarmonyOS SDK进入（macOS系统为DevEco Studio > Preferences > HarmonyOS SDK）。
  

[color=rgba(0, 0, 0, 0.9)]配置HDC工具环境变量

HDC是为开发者提供HarmonyOS应用/服务的调试工具，为方便使用HDC工具，请为HDC工具及其端口号设置环境变量。

• Windows环境变量设置方法：
  
  • 在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，添加HDC端口变量名为：HDC_SERVER_PORT，变量值设置为7035。

    

  • 在path变量中，添加HDC工具路径，HDC工具路径为：HarmonyOS SDK安装目录/toolchains/{版本号}。
    

  环境变量配置完成后，关闭并重启DevEco Studio。

• macOS环境变量设置方法：
  
  • 打开终端工具，执行以下命令，打开.bash_profile文件。
    
    • vi ./.bash_profile
      
  • 点击字母“i”，进入Insert模式。
  • 输入以下内容，在PATH路径下添加HDC工具路径（HarmonyOS SDK安装目录/toolchains/{版本号}）和添加HDC_SERVER_PORT端口信息。
    
    • export PATH=$PATH:/Users/admin/Library/HarmonyOS/Sdk/toolchains/{版本号}
    • export CLASSPATH
    • HDC_SERVER_PORT=7035
    • launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORT
    • export HDC_SERVER_PORT
      
  • 编辑完成后，点击“Esc”键，退出编辑模式，然后输入“:wq”，点击“Enter”按钮保存。
  • 执行以下命令，使配置的环境变量生效。
    
    • source .bash_profile
      
  • 环境变量配置完成后，关闭并重启DevEco Studio。
    
  
  

[color=rgba(0, 0, 0, 0.9)]参考信息

DevEco Studio开发环境依赖于网络环境，需要连接上网络才能确保工具的正常使用。

一般来说，如果使用的是个人或家庭网络，是不需要设置代理信息的；只有部分企业网络受限的情况下，才需要设置代理信息。

如果是首次使用DevEco Studio，配置向导界面出现Set up HTTP Proxy界面，如果您通过代理服务器上网，可以通过配置代理的方式来解决，包括配置DevEco Studio代理和NPM代理。

[color=rgba(0, 0, 0, 0.9)]配置DevEco Studio代理

• 启动DevEco Studio，配置向导进入Set up HTTP Proxy界面，勾选Manual proxy configuration，设置DevEco Studio的HTTP Proxy。
  
  说明
  

  如果非首次设置向导进入HTTP Proxy，可以通过如下方式进入HTTP Proxy配置界面：

  
  
  • 在欢迎页点击Configure（或 图标） > Settings > Appearance & Behavior > System Settings > HTTP Proxy进入HTTP Proxy设置界面（macOS为Configure > Preferences > Appearance & Behavior > System Settings > HTTP Proxy）。
  • 在打开了工程的情况下，可以点击File > Settings > Appearance & Behavior > System Settings > HTTP Proxy进入HTTP Proxy设置界面（macOS为DevEco Studio > Preferences > Appearance & Behavior > System Settings > HTTP Proxy）
    
  
  
  
  
  
  
  • HTTP配置项，设置代理服务器信息。如果不清楚代理服务器信息，可以咨询你们的网络管理人员。
    
    • Host name：代理服务器主机名或IP地址。
    • Port number：代理服务器对应的端口号。
    • No proxy for：不需要通过代理服务器访问的URL或者IP地址（地址之间用英文逗号分隔）。
      
  • Proxy authentication配置项，如果代理服务器需要通过认证鉴权才能访问，则需要设置。否则，请跳过该配置项。
    
    • Login：访问代理服务器的用户名。
    • Password：访问代理服务器的密码。
    • Remember：勾选，记住密码。
      
    
    

  

• 配置完成后，点击Check connection，输入网络地址（如：https://developer.harmonyos.com），检查网络连通性。提示“Connection successful”表示代理设置成功。
• 点击Next: Configure npm继续设置NPM代理信息，请参考配置NPM代理。
  

[color=rgba(0, 0, 0, 0.9)]配置NPM代理通过DevEco Studio的设置向导设置NPM代理信息，代理信息将写入用户“users/用户名/”目录下的.npmrc文件。

说明

该向导只有第一次安装DevEco Studio才会出现。如果未出现该向导，可以直接在“users/用户名/”目录下的.npmrc文件中，添加代理配置信息。

• npm registry：设置npm仓的地址信息，建议勾选。
• HTTP proxy：代理服务器信息，默认会与DevEco Studio的HTTP proxy设置项保持一致。
• Enable Https Proxy：同步设置HTTPS Proxy配置信息，建议勾选。
  

然后点击Start using DevEco Studio继续下一步操作。

如果代理服务器需要认证（需要用户名和密码），请先根据如下指导配置代理服务器的用户名和密码信息，然后再下载HarmonyOS SDK；否则，请跳过该操作，参考下载HarmonyOS SDK进行操作即可。

• 进入用户的users目录，打开.npmrc文件。如果该目录下没有.npmrc文件，请新建一个。
• 修改npm代理信息，在proxy和https-proxy中，增加user和password字段，具体取值请以实际代理信息为准。示例如下所示：
  
  • proxy=http://user:password@proxy.server.com:80
  • https-proxy=http://user:password@proxy.server.com:80
    
  
  
  说明
  

  如果password中存在特殊字符，如@、#、*等符号，可能导致配置不生效，建议将特殊字符替换为ASCII码，并在ASCII码前加百分号%。常用符号替换为ASCII码对照表如下：

  • !：%21
  • @：%40
  • #：%23
  • ￥：%24
  • &：%26
  • *：%2A
    
  
  
  
  
  
• 代理设置完成后，打开命令行工具，执行如下命令进行验证网络是否正常。
  
  • npm info express
    

  执行结果如下图所示，则说明代理设置成功。

  

• 网络设置完成后，然后再下载HarmonyOS SDK。
  

配置Gradle代理

[color=rgba(0, 0, 0, 0.9)]仅在网络受限的情况下，且开发HarmonyOS SDK 4至7版本应用/服务时，需要配置Gradle的代理。

• 打开“此电脑”，在文件夹地址栏中输入%userprofile%（macOS请点击前往 > 个人），进入个人用户文件夹。

  

• 创建一个文件夹，命名为.gradle。如果已有.gradle文件夹，请跳过此操作。
  
  说明
  

  macOS系统创建.gradle文件夹前，请将系统设置为“显示隐藏文件”。

  
  
  
  
• 进入.gradle文件夹，新建一个文本文档，命名为gradle，并修改后缀为.properties。
• 打开gradle.properties文件，添加如下脚本，然后保存。其中代理服务器、端口、用户名、密码和不使用代理的域名，请根据实际代理情况进行修改。其中不使用代理的“nonProxyHosts”的配置间隔符是 “|”。
  
  • systemProp.http.proxyHost=proxy.server.com
  • systemProp.http.proxyPort=8080
  • systemProp.http.nonProxyHosts=*.company.com|10.*|100.*
  • systemProp.http.proxyUser=userId
  • systemProp.http.proxyPassword=password
  • systemProp.https.proxyHost=proxy.server.com
  • systemProp.https.proxyPort=8080
  • systemProp.https.nonProxyHosts=*.company.com|10.*|100.*
  • systemProp.https.proxyUser=userId
  • systemProp.https.proxyPassword=password
    
  
  
  

创建和运行Hello World

• 
  

更新时间: 2022-07-06 18:24
[color=rgba(0, 0, 0, 0.9)]

DevEco Studio配置开发环境完成后，可以通过运行HelloWorld工程来验证环境设置是否正确。以Phone工程为例，在Phone的远程模拟器中运行该工程。

创建一个新工程

• 打开DevEco Studio，在欢迎页点击Create Project，创建一个新工程。
• 根据工程创建向导，在HarmonyOS页签，选择“Empty Ability”模板，然后点击Next。关于工程模板的介绍和支持的设备类型，请参考工程模板和开发语言介绍。

  

• 填写工程相关信息，保持默认值即可，点击Finish。关于各个参数的详细介绍，请参考创建一个新的工程。

  

  工程创建完成后，DevEco Studio会自动进行工程的同步，同步成功如下图所示。

  

  
  

使用模拟器运行HelloWorld

DevEco Studio提供远程模拟器和本地模拟器，本示例以远程模拟器为例进行说明。关于本地模拟器的使用请参考使用Local Emulator运行应用/服务。

DevEco Studio提供模拟器供开发者运行和调试HarmonyOS应用/服务。

• 在DevEco Studio菜单栏，点击Tools > Device Manager。
• 在Remote Emulator页签中点击Sign In，在浏览器中弹出华为开发者联盟帐号登录界面，请输入已实名认证的华为开发者联盟帐号的用户名和密码进行登录（查看远程模拟器登录常见问题）。
  
  说明
  

  推荐使用最新版本Chrome浏览器，如果使用Safari、360等其他浏览器，要取消阻止跨站跟踪和阻止所有Cookie功能。

  
  
  
  
  
  
• 登录后，请点击界面的允许按钮进行授权。

  

• 在设备列表中，选择Phone设备P50，并点击 按钮，运行模拟器。

  

• 点击DevEco Studio工具栏中的 按钮运行工程，或使用默认快捷键Shift+F10（macOS为Control+R）运行工程。

  

• DevEco Studio会启动应用/服务的编译构建，完成后应用/服务即可运行在模拟器上。

  

  
  

已成功运行了第一个HarmonyOS应用/服务，接下来，可以通过一个简单的DEMO工程示例，来详细了解HarmonyOS应用/服务的开发过程，具体请参见HarmonyOS应用开发快速入门。