HarmonyOS 鸿蒙Next DevEco Studio历史版本常见问题

概述

Q1：如何获取DevEco Studio 2.0？（版本计划 + 获取方式）

答：在HarmonyOS官网下载DevEco Studio 2.0（Beta1）。DevEco Studio 2.0 Beta2版本已于2020年11月15日发布，DevEco Studio 2.0 Beta3版本已于2020年12月16日发布。

下载地址：https://developer.harmonyos.com/cn/develop/deveco-studio ，HarmonyOS官网也可获取API手册、指导文档、样例代码。

Q2：DevEco Studio 1.0 和 DevEco Studio 2.0 有什么差异?

答：DevEco Studio 1.0 是EMUI版，深度集成HUAWEI HiAI、互联互通、多媒体、安全服务等EMUI开放能力，可实现拖拽式调用，可以开发集成EMUI开放能力的Android应用。

DevEco Studio 2.0 是HarmonyOS版，可以开发HarmonyOS应用。

DevEco Studio 2.0 获取方式：https://developer.harmonyos.com/cn/develop/deveco-studio

Q3：接入HarmonyOS需要学习什么新技能？安卓转HarmonyOS麻烦吗？

答：HarmonyOS应用开发只需要Java、JavaScript、html、css基础开发功底即可。如果有应用开发的经验，HarmonyOS应用开发就更容易轻松上手。

Q4：现在有哪些HarmonyOS机型？我没有HarmonyOS真机，怎么办？

答：如果你手边无真机，推荐使用DevEco Studio 2.0内置的HarmonyOS预览器和远程模拟器，当前提供的模拟器参考下图

真机类型参考下图，如果有合作意愿， 可以单点联系，我们会提供尽可能的技术支持。

Q5：DevEco Studio 开源吗？

答：DevEco Studio是基于IntelliJ IDEA开源社区版开发，符合开源管控流程规范，在不久的将来也会开源。

Q6：IntelliJ 的插件，DevEco Studio可以用吗？

答：DevEco Studio是基于IntelliJ IDEA 2020.2.2开源社区版开发，适配该版本的插件即可在DevEco Studio上使用。

Q7：现在提供Windows版吗？

答：DevEco Studio 1.0 和2.0版 支持win10和mac。

DevEco Studio 1.0 获取方式：https://developer.huawei.com/consumer/cn/activity/501599028185303455

DevEco Studio 2.0 win10版 / mac版下载地址：https://developer.harmonyos.com/cn/develop/deveco-studio

Q8：现在提供Mac版吗？

答：Mac版本已于2020年11月15日发布，开发者可以直接下载使用 https://developer.harmonyos.com/cn/develop/deveco-studio#download

Q9：现在提供Linux版吗？

答：暂时没有Linux版本。

Q10：海外开发者如何开发HarmonyOS应用？

答：当前暂不支持海外官网下载，在不久的将来会开放下载。如果有合作意愿， 可以单点联系，我们会提供尽可能的技术支持。

Q11：DevEco Studio 2.0现支持C/C++语言的开发么？

答：Car设备支持C/C++代码编辑、调试、编译构建等功能。

Q12：如何获取技术支持？

答：欢迎到51cto社区-harmonyos专区讨论(https://harmonyos.51cto.com/ )，求助牛人。您也可以去提单到华为开发者工单系统(https://developer.huawei.com/consumer/cn/support/feedback/#/ )获取支持。

Q13：如何升级？

答：升级方式：1、DevEco Studio > Help > Check for Updates > Update and Restart；

2、进入 https://developer.harmonyos.com/cn/develop/deveco-studio#download 直接下载安装；

Q14：无法自动下载SDK和相关工具，如何解决？

答：检查是否成功连接Internet网络，如果所在网络被管控，不能直接访问外网，请参考配置DevEco Studio代理后进行重试。

Q15：Java SDK下载正常，但是JS SDK下载失败，如何解决？

答：JS SDK下载失败，可能存在以下原因：

1. 未安装Node.js，请根据下载和安装Node.js进行处理。
2. 您的网络受限，需要通过配置代理才能访问，请根据npm代理设置进行处理。

Q16：下载JS SDK时，JS依赖下载缓慢，如何解决？

答：对于国内用户，可以将npm仓库设置为华为公有云仓库。在命令行工具中执行如下命令，重新设置npm仓库地址后，再执行JS SDK的下载。

npm config set registry https://mirrors.huaweicloud.com/repository/npm/

Q17：Gradle插件下载失败，如何解决？

答：Gradle下载失败，可能存在如下两种原因：

1. 网络受限，请检查网络设置或者DevEco Studio代理设置。

2. 网络正常，但在IDE里下载较慢或中断失败，可能是因为Gradle服务器在境外，IDE下载能力比较普通，你可以直接将地址复制到浏览器或迅雷等下载增强工具里下载，具体方法如下：

   2.1 点击链接下载 Gradle插件（https://services.gradle.org/distributions/）

   

   说明：Gradle插件版本与HarmonyOS编译构建插件版本的配套关系请参见工程级build.gradle说明

   2.2 打开DevEco Studio，进入Files > Settings > Build, Execution, Deployment > Gradle页面，检查Gradle插件的本地路径。如果未设置，默认存储在user目录下的.gradle文件夹。

   2.3 打开“此电脑”，进入2.2中的Gradle目录，并进入wrapper > dists > gradle-6.3-all > xxxxxx（临时文件夹）目录，将2.1下载的“gradle-6.3-all.zip”拷贝到该目录下临时文件夹中。

   如果存在多个临时文件夹，建议每个文件夹都拷贝一份。

   2.4 等待工程同步完成，还有问题建议重启IDE再试试。

Q18：同时安装多个DevEco Studio版本，怎样做才保证各个版本不冲突？

答：可按照如下解决办法操作

1. 同时安装多个版本DevEco Studio，安装时请注意：

   • 安装新版本的时候不要勾选卸载已安装的版本
   • 选择一个新的安装路径，不要和之前安装的冲突，安装的时候不要勾选重建快捷方式，不然会将之前安装的版本覆盖了

2. 安装完成之后先不要打开新的DevEco Studio，修改新安装DevEco Studio的“idea.properties”里面的缓存路径，并保存文件。

“idea.properties”存放在DevEco Studio的安装目录（~：…/DevEco Studio/bin）下，这个文件可以自定义设置DevEco Studio的缓存路径，默认的缓存路径为“C:\Users{username}\AppData\Local\Huawei\DevEcoStudio2.1”和“C:\Users{username}\AppData\Roaming\Huawei\DevEcoStudio2.1”。

功能开发 Q1：如何查看“config.json”文件的所有字段说明？

答：“config.json”文件的各字段说明请查阅配置文件的元素。

Q2：怎么实现Ability可以被其他应用调用？

答：开发者需要在“config.json”文件中将“abilities”字段的“visible”标签设置为true。

Q3：权限声明在哪里进行添加？

答：开发者需要在“config.json”文件中的“reqPermissions”字段中声明所需要的权限，具体配置方法请参考申请权限。

Q4：使用数据库注解相关功能前有什么注意事项？

答：使用注解功能需在模块的“build.gradle”文件的“ohos”节点中增加如下配置项（不使用注解功能无须配置）：

1. compileOptions{

2. annotationEnabled true
   

3. }

Q5：使用`<image>`标签引入本地图片，但图片无法加载？

答：图片无法加载的可能情况有三种

1. 没有给图片设置宽度和高度，需要在对应的page目录下的css样式文件中设置图片的宽高。使用`<image>`标签的图片不会自动缩放，图片宽高超过组件的宽高会自动截取。
2. 图片引入路径错误。图片引入的路径必须是项目编译后的静态文件的路径。
3. 在导入图片或添加/删除页面后没有重新编译。

Q6：如何在后一个页面获取前一个页面传递过来的参数？

答：有三种方式可以获取前一个页面的参数。以如下场景为例：有两个页面“index”和“detail”，第二个页面“detail”需要获取从第一个页面“index”传递过来的参数。

1. 如果参数需要在页面中引用，可以直接在“detail.hml”中使用`{{参数名}}`的形式进行引用。
2. 如果需要对参数进行操作，在“detail.js”中，直接用this.参数名的形式使用。
3. 可以在“detail.js”的data域中定义一个同名参数进行接收，注意以这种方式接受的参数将覆盖已有的参数。

Q7：如何查询设备支持的硬件/软件功能？如何查询设备是否支持某个硬件/软件特性？

答：可参考如下操作

1. 应用通过调用IBundleManager接口类中的getSystemAvailableCapabilities方法，可以查询设备支持的硬件/软件功能列表。具体的功能定义可以通过ohos.utils.CapabilityConstants类查询。
2. 应用通过调用IBundleManager接口类中的hasSystemCapability方法，可以查询设备是否支持某个硬件/软件功能。具体的功能定义可以通过ohos.utils.CapabilityConstants类查询。

Q8：图片为什么显示不全？

答：父类容器大小不能小于子组件容器大小。

Q9：新建项目报错ERROR:Failed to open zip file 或 自动进行工程同步时出现 Gradle sync Failed: error in opening zip file 怎么解决？

答：可以到gradle的缓存目录：C:\Users\{Username}\.gradle\wrapper\dists 下将损坏的gradle删除，然后回到DevEco Studio点击 try again 或者重新打开工程。

Q10：在config.json文件中添加defPermissions自定义权限时，编辑器是否支持自动联想？

答：不支持

调测验证
Q1：编译工程提示"This device type does not match project profile."

答：出现这种情况是由于“config.json”中配置的设备类型与调试设备类型不匹配，需要在“module”标签下配置对“deviceType”的定义。具体请参考表7的“deviceType”。

Q2：安装HAP失败，并提示“INCONSISTENT_BUNDLE_VERSION”，如何解决？

答：系统中有重复应用，卸载系统中已有的包名相同的应用。

Q3：提示“signingConfig 'debug' can not be null or empty”，如何解决？

答：检查“entry”下的build.gradle是否配置了签名。如果配了依然报错，检查是否误配到了工程级的build.gradle当中。

Q4：安装HAP失败，并提示“STRING_LENGTH_ERROR”，如何解决？

答：可能原因有

1. 包信息超过最大长度。包信息中包含的各属性字符串长度需要同时满足以下条件，否则会报错。
   - bundleName的长度为7~127个字节。
   - vendor的长度为0~255个字节。
   - version.name的长度为0~127个字节。

同时安装两个不同module生成的hap时，包信息不一致。需要比对两个module的“config.json”文件中“app”标签配置内容是否一致。

Q5：没有配置签名运行应用到模拟器时报签名错误，提示 Invalid keystore format

答：可以尝试在用户目录下找到.DevEcoStudio2.0文件夹，进入里面的config目录，删除debug.p12签名文件，再次启动ide打包时会自动生成一个新的签名文件，应用将会运行起来。

Q6：如何获取手机的udid？

答：使用实体机开发，需要申请签名，申请签名时需提供机器的udid，模拟器不需要。

1. cmd打开命令行工具
2. 进入HarmonyOS的SDK目录
3. 再进入toolchains目录
4. hdc shell dumpsys DdmpDeviceMonitorService

模拟器
Q1：模拟器版本会持续更新升级吗？目前使用哪些操作系统？

答：模拟器的版本更新随DevEco Studio同步更新，当前支持Windows10 版本、Mac10.13/10.14/10.15/11.2.2。

Q2：DevEco Studio怎么调出快捷工具图标？

答：在主工具栏，勾选“View -> Appearance -> Toolbar”，将显示快捷工具图标

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20200924180516.30370612216728706829407833992452:50520602034825:2800:F381D0FB4CD26B46BF0B260421217D3CF3681F5814F2213E82FED3BFD6DC2DA1.png)

Q3：模拟器在登录时对浏览器有什么要求吗？

答：建议使用Chrome浏览器，请将Chrome设置为默认浏览器。

Q4：DevEco Studio工程存放文件的目录是否支持中文？

答：不支持，需要修改成全英文文件名目录。

Q5：使用模拟器时，SDK在哪下？

答：在创建工程前需要下载SDK，可在File->Settings->System Settings->HarmonyOS SDK路径下查看，如图：

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20201228145728.28973990423859297848567436387421:50520602034825:2800:5BF0936F940CC8A93A8C2D7F94FF8CBD6F9190B0806ECF8828429A7993B90160.png)

Q6：DevEco Studio在Tools > HVD Manager登录过程中一直卡住不动，该怎么办？

答：使用模拟器前需跳转至浏览器登陆页面，使用个人实名账号进行登陆操作，并点击“允许”按钮。若出现如图情况，可能由于以下原因，可尝试对应的解决方案：

1. 登录帐号未实名认证：浏览器会自动跳转到实名认证界面，请先完成实名认证（个人帐号建议使用银行卡认证，可以实时生效）；认证完成后，点击Cancel后重新登录。
2. 未点击“允许”按钮。解决办法：转至浏览器页面，查看是否已完成“允许”操作。
3. 可能由于cookie 跨域，被chrome浏览器 被禁止。解决办法：可检查chrome 浏览器 是否已设置cookie op.hicloud.com 为允许。

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20200924180645.07089066138758615246295469668939:50520602034825:2800:654B20412AB97CF213B2EF0627D7477841C018694A4A67A9196F59EB4945853F.png)

Q7：Virtual Device Manager内无任何设备可选？

答：可能由于下载的资源不完整，需要重新下载。请删掉C:\Users\用户名\.DevEcoStudio2.0\system下的 kits_caches 文件夹目录。重新refresh，触发下载。

Q8：创建一个HarmonyOS的HelloWorld HAP尝试运行后报错，Error while Deploying HAP

答：创建工程的device type与申请的模拟器设备不一致。请重新申请对应的模拟器。

Q9：模拟器已打开，工程编译过程中提示以下报错：

答：配套的SDK未下载好，可以在File->Settings->System Settings-HarmonyOS SDK重新下载。

Q10：模拟器屏幕显示 The device may be in standby or screen-off state, please touch or drag the screen to wake up your device.

答：网络问题引起的数据获取慢，不能显示真机图像，可以尝试滑动屏幕 或者更换设备继续使用。

Q11：屏幕显示 Network exception, please release and try again

答：网络不稳定，导致的数据流断连，请释放模拟器重新申请模拟器进行使用。

Q12：弹框显示 The number of devices used by your account has reached the upper limit

答：当用户设备未正常释放，占用超过两台，想继续使用，会有这个提示，需要点击“OK”去释放占用的机器，然后继续使用。

Q13：启动模拟器失败报错 ClassNotFound, NoClassDefFoundError，UnsatisfiedLinkError

答：这种问题属于未下载完整资源，

1. 请点击eventlog中的“download again”重新下载资源。
2. 若未解决，可关闭DevEco Studio，删掉C:\Users\用户名\.DevEcoStudio2.0\system下的 kits_caches 文件夹目录。重新触发下载。当日志打印“Download all resources successfully, please try to use again.” 则标志资源下载完成，即可正常使用。

Q14：正常使用模拟器，调试JAVA工程时能进入断点，为什么调试JS的不能进入断点。

答：请把调试的类型改为JS就行了

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20200924181019.06854787493533797223609002349754:50520602034825:2800:448358501593699309C6AC1B809D8A890D7404F48AEB2A534016E1047A458B83.png)

Q15：使用模拟器为什么还要进行实名认证？

答：根据《关于中国互联网领域实名制的法律要求》，互联网信息发布服务、电信服务、网络游戏、文化表演、电子商务、金融服务、快递、O2O 八大服务类型要求用户实名制。为避免通过华为模拟器进行恶意信息发布、电子商务诈骗等行为，使用模拟器的用户需进行实名认证。

Q16：登录模拟器，一直停留在IE界面不跳转

答：可能是当前IE版本不适配，请手动添加受信任站点，可参考如下方式操作

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20201014113526.27640743921942270741972042711196:50520602034825:2800:4405B1000466BEA04379D162C5A4424C4EB97E1362C18EDD17D0F4B0E53826FF.png)

Q17：使用模拟器需要通过浏览器登录授权，浏览器提示该网站“不安全”，或者“你的连接不是私密连接”信息

答：DevEco Studio云端服务平台使用的是业界知名CA结构ACTALIS颁发的商业证书，一般主流浏览器都会预置ACTALIS公司的根证书。如果出现上述问题现象，可以通过如下措施进行解决：

1. 检查浏览器是否安装了ACTALIS公司的根证书（不同浏览器查看证书方法不同，请自行查阅）。
   
   已安装：请根据2检查Actalis证书是否被禁用。
   
   未安装：请前往[https://www.actalis.it/area-download#](https://www.actalis.it/area-download#)下载和安装“Actalis Authentication Root CA”，安装完成后重启浏览器即可。

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20201019113655.36027058652381494889594684808621:50520602034825:2800:1F99BC9F9D10EF502B6215B1D8C517F6F5EB87B5FBB2417B095E6F38745A6ECF.png)

2. 打开命令行工具，执行certmgr.msc命令，打开证书管理界面。
3. 在受信任的根证书颁发机构 > 证书中，找到Actalis Authentication Root CA，点击鼠标右键选择“属性”。
4. 选择“启用此证书的所有目的(E)”，点击确定。然后重启浏览器即可。

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20201019113816.18076734741301707375039104057044:50520602034825:2800:102E0B02DD946C2069DA136C17BD0886ED64EB2BD3B776530F3F8041E9CB3A4C.png)

Q18：点击Tools > HVD Manager，提示“Invalid system username: Username cannot contain spaces.”

答：原因是您PC的用户名中，存在空格，模拟器不支持username有空格符号。请更换用户名后再使用模拟器。

Q19：Remote Device运行程序提示找不到设备

答：可能是端口被占用了，建议将端口改一下：在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，添加HDC端口变量。变量名为：HDC_SERVER_PORT，变量值设置为非5037的其它端口，如7305（参考下图），然后重启IDE，如果重启IDE还是无法发现设备，就重启电脑。

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/022/054/200/0220086000022054200.20210223163806.25735436656891216096829470899656:50520602034825:2800:009792FA68F743BC0043B5BE7A3804410264BDBED071981006FBDB1DF13C5287.png)

预览器
Q1：升级SDK过程中提示Preview升级失败

答：将预览器退出，点击窗口设置中的remove from sidebar，将预览器退出后再更新preview组件。

Q2：打开新工程，没有找到预览器的入口

答：预览器的入口在View->Tool Windows->Previewer。如果没有，可以选择JS UI框架的js、css、hml文件，或者选择Java UI框架的layout.xml/AbilitySlice.java/Ability.java文件，再访问该入口，即可查看预览。

Q3：预览器启动后没有显示出界面预览效果

答：可能是预览器组件没有更新导致，先检查SDK中是否已升级到最新的预览器组件，然后关闭掉所有打开的IDE窗口，只打开当前需要预览的工程，然后再次启动预览。

Q4：无法使用预览器

答：无法使用预览器，可能存在以下几种原因：

1. 工程未同步成功：如果工程同步失败，请根据错误提示修复相应问题，同步成功后可通过View>Tool Windows>Previewer打开预览器。
2. 未下载预览器资源：请在File > Settings > Appearance&Behavior > System Settings > HarmonyOS SDK界面中，选择SDK Tools页签，下载Previewer。
   
   ![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20201216110619.23295390351013411045615492953124:50520602034825:2800:AC2F994CDE119EF5FA49CED0B8FDDD347D3267C91423971DE40E3B8E0CB736B3.png)
   
3. 编辑器中当前打开的文件不支持预览，如果无法预览，您可以选择JS UI框架的js、css、hml文件，或者选择Java UI框架的layout.xml/AbilitySlice.java/Ability.java文件。
4. SDK未升级至最新版本，建议将Java SDK和JS SDK升级至最新版本。

Q5：使用Java预览器提示错误

答：打开Java预览器时，DevEco Studio出现报错，提示“Cannot run program‘null\code'“错误。原因为未安装Node.js软件，预览器功能依赖Node.js，请按照如下步骤进行处理：

1. 请根据[下载和安装Node.js](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/software_install-0000001053582415#ZH-CN_TOPIC_0000001057685607__section36231715192913)指导，安装Node.js软件。
2. 在DevEco Studio中关闭当前打开的工程，然后重启DevEco Studio。
3. 重启DevEco Studio后，重新打开工程，然后点击Previewer使用预览器。

应用编译
Q1：打开历史工程时同步错误：打开历史版本的DevEco Studio创建的工程，同步时提示“Unable to download the HarmonyOS SDK. package java not found!”错误信息。

答：该问题是由于当前版本的编译构建插件版本与SDK版本不匹配导致。如果SDK的版本为API Version4，则配套的编译构建插件必须为2.4.0.1版本。请根据如下指导进行处理。

打开工程及的build.gradle文件，修改buildscript闭包下的编译构建插件版本为2.4.0.1。

```groovy
dependencies {
    classpath 'com.huawei.ohos:hap:2.4.0.1'
}

修改完成后，点击Sync Now重新同步工程即可。

Q2：打开历史工程提示Gradle版本不匹配：打开历史版本的DevEco Studio创建的工程，DevEco Studio会提示开发者需要将编译构建插件升级为2.4.0.1，升级后同步错误，提示“Minimum supported Gradle version is Gradle 6.3. Current version is Gradle 5.4.1.”

答：该问题是由于编译构建插件版本与Gradle版本不匹配导致的问题，需要将Gradle版本更新为6.3版本。请根据如下的指导进行处理。

打开工程目录下的gradle > wrapper > gradle-wrapper.properties文件，将Gradle版本号修改为6.3，然后点击Try Again重新同步工程即可。

![](https://alliance-communityfile-drcn.dbankcdn.com/FileServer/getFile/cmtybbs/300/118/079/0890086000300118079.20201216111258.54337173050780060753850057295613:50520602034825:2800:D2DA89D3D2618C9E2DD854E0BCEE551DF52FFE88273C8F3