【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开发主要功能区别
功能OpenHarmonyHarmonyOS
支持的编程语言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安装
搭建开发环境流程
DevEco Studio支持Windows系统和macOS系统，在开发HarmonyOS应用/服务前，需要准备HarmonyOS应用/服务的开发环境。环境准备流程如下所示：
如上图所示，搭建HarmonyOS应用/服务开发的环境包括软件安装、配置开发环境和运行HelloWorld三个环节，详细的指导请参考：
步骤操作步骤操作指导说明
1软件安装Windows环境安装DevEco Studio。
macOS环境
2配置开发环境（可选）配置Gradle代理网络不能直接访问Internet，需要通过代理服务器才可以访问的情况下需要设置。如果无需代理即可访问Internet，可跳过该步骤。
3（可选）配置DevEco Studio代理
4（可选）配置NPM代理
5下载HarmonyOS SDK-
6运行HelloWorld创建一个新工程使用模拟器运行Demo工程，验证环境是否已经配置完成。
7运行应用
evEco Studio支持Windows和macOS系统，下面将针对两种操作系统的软件安装方式进行介绍。Windows环境
运行环境要求为保证DevEco Studio正常运行，建议电脑配置满足如下要求：
[*]操作系统：Windows10 64位
[*]内存：8GB及以上
[*]硬盘：100GB及以上
[*]分辨率：1280*800像素及以上
下载和安装DevEco Studio
[*]进入HUAWEI DevEco Studio产品页，点击下载列表后的按钮，下载DevEco Studio。
[*]下载完成后，双击下载的“deveco-studio-xxxx.exe”，进入DevEco Studio安装向导，在如下界面选择安装路径，默认安装于C:\Program Files路径下，也可以点击Browse...指定其他安装路径，然后点击Next。
[*]在如下安装选项界面勾选DevEco Studio后，点击Next，直至安装完成。
[*]安装完成后，点击Finish完成安装。
macOS环境
运行环境要求为保证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
下载HarmonyOS SDK在开发HarmonyOS应用/服务前，请提前下载HarmonyOS SDK及配套的工具链。DevEco Studio提供SDK Manager统一管理SDK及工具组件，包括如下组件包：
组件包名说明参考
NativeC/C++语言SDK包。《Native API参考》
eTSeTS（Extended TypeScript） SDK包。《基于TS扩展的声明式开发范式》
JSJS语言SDK包。《基于JS扩展的类Web开发范式》
JavaJava语言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本地模拟器工具包。
ToolchainsSDK工具链，HarmonyOS应用/服务开发必备工具集，包括编译、打包、签名、数据库管理等工具的集合。-
PreviewerHarmonyOS应用/服务预览器，在开发过程中可以动态预览Phone、TV、Wearable、LiteWearabl e等设备的应用/服务效果，支持JS、eTS和Java应用/服务预览。使用预览器查看应用/服务效果
下载HarmonyOS SDKHarmonyOS应用/服务支持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）。
配置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。
参考信息DevEco Studio开发环境依赖于网络环境，需要连接上网络才能确保工具的正常使用。一般来说，如果使用的是个人或家庭网络，是不需要设置代理信息的；只有部分企业网络受限的情况下，才需要设置代理信息。如果是首次使用DevEco Studio，配置向导界面出现Set up HTTP Proxy界面，如果您通过代理服务器上网，可以通过配置代理的方式来解决，包括配置DevEco Studio代理和NPM代理。
配置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代理。
配置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代理仅在网络受限的情况下，且开发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
DevEco Studio配置开发环境完成后，可以通过运行HelloWorld工程来验证环境设置是否正确。以Phone工程为例，在Phone的远程模拟器中运行该工程。创建一个新工程
[*]打开DevEco Studio，在欢迎页点击Create Project，创建一个新工程。
[*]根据工程创建向导，在HarmonyOS页签，选择“Empty Ability”模板，然后点击Next。关于工程模板的介绍和支持的设备类型，请参考工程模板和开发语言介绍。
[*]填写工程相关信息，保持默认值即可，点击Finish。关于各个参数的详细介绍，请参考创建一个新的工程。工程创建完成后，DevEco Studio会自动进行工程的同步，同步成功如下图所示。
使用模拟器运行HelloWorldDevEco 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应用开发快速入门。
页:
[1]