目录

模拟器真机预览器调试差异常见问题

Q:根据官方文档给出的示例如何拉起浏览器应用,使用预览器查看Demo效果,控制台报错日志信息Error message:is not callable. 使用模拟器进行调试,也无法拉起浏览器应用。当前无真机设备。调试过程中,模拟器、真机、预览器具有哪些差异?

A:编译方式和环境配置对比:

显示效果对比:

调试能力对比:

官方文档模拟器与真机的差异清楚的描述了模拟器对各种Kit的支持情况,开发者在无真机或者模拟器不具备支持能力的情况时可以使用云调试。

Q:使用模拟器进行HarmonyOS NEXT系统调试都支持哪些设备类型?

A:模拟器已支持的系统类型有:Windows(X86)和macOS(ARM),已支持的设备类型为:手机(包括折叠屏)、平板、Wearable、2in1。具体可参考每版本的发布指南:支持的设备类型。

Q:预览器支持哪些组件?NavDestination组件支持使用预览器吗?

A:NavDestination组件支持使用预览器。支持使用预览器的ArkTS组件详见官方指南。

Q:引用了HSP的模块是否支持预览?

A:预览不支持引用HSP。引用了HSP的模块不支持预览,需要直接在HSP内预览或模拟HSP。官方文档中已给出说明,详见查看ArkTS/JS预览效果。

Q:手机模拟器里面能否使用浏览器之类的搜索功能,或者通过应用市场之类的安装应用?

A:手机模拟器不支持浏览器和应用市场,若场景需要可以使用真机或者云调试。

Q:点击了预览器中的Inspector后,就看不到界面的预览效果了,会出现这样的一个提示:add preview by decorating components。

A:Inspector双向预览支持ets文件与预览器界面的双向预览。@Entry装饰器装饰的组件支持Inspector,@Preview不支持。使用双向预览功能时确保组件被@Entry修饰。

Q:模拟器里无钱包服务App,导致依赖了钱包拉活SDK的应用,在模拟器里运行会发生异常。具体报错如下:

LastFatalMessage:[default] [LoadJSPandaFile:108] resolveBufferCallback get hsp buffer failed, hsp path:/data/storage/el1/bundle/com.huawei.hmos.walletkit/walletKit/walletKit/ets/modules.abc, errorMsg:hap path error: /data/storage/el1/bundle/com.huawei.hmos.walletkit/walletKit/walletKit.hsp

A:该报错是因为Kit在模拟器不支持,可以参考:Kit能力差异。当前walletkit不支持在模拟器上使用,建议使用真机进行调试。如遇到因Kit能力不支持导致的应用闪退问题,可以使用动态引入Kit的方式规避此异常问题。

Q:模拟器能安装apk或卓易通吗?

A:模拟器主要是提供给用户做HarmonyOS NEXT应用调试,不支持安装apk或卓易通。

Q:DevEco Studio的预览器有深色模式吗?

A:预览器暂不支持深色模式,请使用模拟器或真机进行测试。

Q:模拟器是否支持开启root权限?

A:模拟器暂不支持root。

Q:模拟器可以使用WiFi吗?

A:模拟器暂不支持通过连接WiFi访问互联网,模拟器上网实际走的是以太网,跟电脑共享同一网络。是否连接WiFi并不影响互联网连接。

Q:华为轻量穿戴应用使用模拟器运行时提示页面.js超过48kb,怎么解决这个限制?

A:由于设备上空间小,当前文件有大小限制,且这种限制不支持开发者自己修改,建议控制文件大小在限制的范围之内。

Q:接入高德SDK,发现无法在模拟器上运行,是不支持在模拟器上运行吗?

A:目前高德SDK不支持在模拟器上定位,请使用真机或者云调试。目前HarmonyOS 5及以上应用/元服务仅支持单机调试场景。单机调试:申请单台设备进行调试,用于调试应用在指定机型上的表现。

Q:使用SafetyDetect进行设备安全检测,为什么调用checkSysIntegrity在真机(未root)运行正常,在模拟器中报错?

A:该报错是因为SafetyDetect属于Device Security Kit(设备安全服务)而模拟器不支持该Kit,可以参考:Kit能力差异-安全。建议使用真机进行调试以规避该报错。

Q:预览器是否支持根据module.json5的orientation配置自动切换横竖屏?

A:预览器不支持页面自动旋转,预览器页面上提供了orientation按钮,可以点击该按钮切换设备的横竖屏状态。

Q:使用API20模拟器加载ArkWeb组件时页面出现倒转?

A:参考模拟器使用环境要求,图形倒转是GPU显示驱动版本过低导致的,需要GPU支持OpenGL版本4.1及以上,AMD的GPU显示驱动版本不能低于24.1.1。

Q:应用编译通过且能生成HAP/APP包,但使用模拟器调试时提示设备rpcid.json文件中不包含部分系统能力属性(如SystemCapability.Multimedia.Media.AVTranscoder、SystemCapability.Communication.Bluetooth.Core等),如何处理?

A:该报错是模拟器的系统能力集不完整导致的,与应用编译是否通过无关。编译通过仅说明代码和SDK API编译通过,但推到模拟器调试时,IDE会检查设备rpcid.json中声明的SystemCapability,发现模拟器不具备应用或依赖库要求的能力时就会拒绝运行。常见不支持的能力包括多媒体转码、蓝牙、WiFi P2P、分布式设备管理、分布式KV、DRM、企业设备管理等。建议排查项目及依赖中是否直接或间接引入了相关Kit或三方库,如需调试这些能力请使用真机或云调试,具体差异可参考模拟器与真机的差异。

Q:在模拟器中实例化AgentController时应用崩溃,如何处理?

A:Agent Framework Kit暂不支持模拟器,在模拟器中实例化AgentController会导致应用崩溃。建议使用真机进行调试,或在使用前判断当前运行环境,通过条件编译规避模拟器场景。

Q:无真机设备时如何调试应用?

A:可使用模拟器或云调试进行调试。模拟器使用方式详见应用/元服务调试,云调试使用方式详见云调试。

Q:没有真机和模拟器时,能否仅使用预览器完成开发?

A:预览器可以承担纯UI界面的开发与调试,但对涉及网络请求、系统能力、Native代码的项目,仅靠预览器开发存在以下限制:

  1. 网络请求验证结果不可信:预览器走宿主机网络栈,网络安全配置只在真机生效,预览器中网络请求成功不代表真机成功。
  2. 大量组件与API无法预览:Video组件不支持实时渲染,Richtext、Web、XComponent组件受限,Ability、MultiMedia等模块API无法预览。
  3. 错误难以发现和定位:超时、断网重试、错误码处理等异常路径无法触发,预览器不支持C++调试、Attach调试、跨Ability调试、Hot Reload、多进程和worker/taskpool调试。
  4. 运行环境存在差异:预览器简化图形渲染,不执行完整编译安装流程,权限弹窗、系统资源调度行为均与真机不同。预览器仅用于纯UI阶段,涉及相机、定位、传感器、推送等系统能力的功能验证、Native C++调试、上架前最终测试,必须使用真机或模拟器。可参考使用预览器调试应用。

Q:是否有以具体商用机型命名的模拟器?

A:没有以具体商用机型命名的模拟器。模拟器是按设备形态/品类提供的,而非按具体商用机型命名。若需适配小折叠机型等折叠形态,可使用Foldable折叠屏模拟器进行折叠/展开场景的功能与布局测试,但需注意模拟器与真机在屏幕具体参数上存在差异,最终适配效果仍建议以真机验证为准。具体支持的设备类型可参考支持的设备类型。