ITPub博客

鸿蒙生态伙伴SDK专区是面向SDK提供商伙伴及开发者打造的SDK一站式供给平台，汇聚了行业主流SDK，推动热门优质的SDK与应用开发者高效连接，提升应用开发过程中的SDK获取和集成效率，帮助开发者构建高品质鸿蒙应用。为帮助广大SDK提供商伙伴更高效、顺畅地完成上架，我们梳理了过往伙伴们在实践中频繁遇到的问题，并整理为FAQ，助力伙伴提前预见可能遇到的常见障碍，提前规避、精准准备，从而更快速、更优质

1.问题描述：如何申请打开相机权限和相册权限？解决方案：受限权限需要在应用市场申请权限，权限申请流程繁琐。在开发测试阶段建议使用不需要权限的替代方案，常见情况如保存图片到相册可以使用安全控件SaveButton或弹窗授权showAssetsCreationDialog进行保存，相册管理可以使用photoAccessHelper进行相册图片选择等。2.问题描述：升级6后，IDE的文件浏览，图库不显示

1.问题描述：消息推送未接收到可以缓存多久？解决方案："Push Kit接收方无法收到消息分两种情况：1、如果接收端的设备离线，导致消息重新发送到接收端设备，则应用消息最多可以在Push Kit服务器侧缓存15天，该缓存时间可以在pushOptions中由ttl参数定义。2、如果接收端设备在线，但是应用不在前台，导致推送后台消息时无法推送至应用，则该消息会缓存至端侧，最多可缓存7天。&q

1.问题描述：如何批量推送push消息？解决方案：自行维护一个用户账号与PushToken的关系表，在用户登录的时候绑定获取的PushToken，用户退出的时候解除PushToken绑定。服务端根据用户关系表，确定接收用户的PushToken进行批量推送。此时post请求体中只需包含用户PushToken，即可实现精准推送指定用户。2.问题描述：播放长语音通知扩展消息，后发现应用通知角标未发生变化

1.问题描述：创建系统地理围栏后处于围栏中，围栏不回调处于围栏中的回调。解决方案：GeofenceTransitionEvent中GEOFENCE_TRANSITION_EVENT_DWELL事件需要设备在地理围栏范围内，且持续徘徊超过10秒方可触发。2.问题描述：系统地理围栏在应用退后台或者关闭后还会生效吗？解决方案：在HarmonyOS系统中使用地理围栏功能，并不强制要求应用处于前台运行。当应

1.问题描述：在尝试推送公告类（即MARKETING）消息时，push侧响应“消息数量超限”，但这是该应用24小时内首 次推送该类消息。解决方案："1.失效token会占用推送额度；2.token由开发者服务端进行存储管理，需要伙伴服务端对失效token进行清理。可在推送后，定期清理未推送成功的token，再对有效token和新上报的token进行推送。"2.问题描述：推送通知

1.问题描述：应用进入开屏广告，此时上划进入后台，是否可以控制应用暂停，等回到应用界面后再继续播放？解决方案：应用进入开屏广告，此时上划进入后台，是否可以控制应用暂停，等回到应用界面后再继续播放？ "当前广告组件支持在播放广告时，切回后台自动暂停。2.问题描述：开屏广告点击后跳转广告对应应用，需要自己处理还是由系统处理？解决方案：系统自动处理的，不需要自己跳转。3.问题描述接入广告有什么

1.问题描述：退出登录之后需要手动清空页面栈和storage吗？解决方案：当点击退出登录或Token过期跳转至登录页时都需要显式清空路由栈，HarmonyOS路由栈（通过NavDestination组件管理）默认不会自动清空历史页面，即使调用logout接口跳转到登录页，原栈中的页面实例（如多个首页）依然存在。不清空路由栈，可能会导致以下问题：内存泄漏：未销毁的页面可能持续占用资源。接口重复调用：

1.问题描述：开发调试阶段经常需要在沙箱路径下构造测试文件，然后使用fs进行文件操作，有什么方法可快速在沙箱路径下构造文件吗？解决方案：开发者可以手动在\resource路径下创建resfile目录，支持创建多层子目录，子目录名称可以自定义，文件夹内可以自由放置各类资源文件。目录中的资源文件会被直接打包进应用，不经过编译，也不会分配资源ID。应用安装后，resfile资源会被解压到应用沙箱路径，通

1.问题描述：创建系统地理围栏后处于围栏中，围栏不回调处于围栏中的回调。解决方案：GeofenceTransitionEvent中GEOFENCE_TRANSITION_EVENT_DWELL事件需要设备在地理围栏范围内，且持续徘徊超过10秒方可触发。2.问题描述：系统地理围栏在应用退后台或者关闭后还会生效吗？解决方案：在HarmonyOS系统中使用地理围栏功能，并不强制要求应用处于前台运行。当应

1.问题描述：如何实现自定义音量调节？解决方案：设置系统音量应用无法直接调节系统音量，系统提供了ArkTS组件AVVolumePanel音量面板，应用可以创建该组件，让用户通过界面操作来调节音量。设置应用音量1.管理应用音量的接口由AudioVolumeManager提供，在使用之前，需要使用getVolumeManager()获取AudioVolumeManager实例，示例代码如下：

1.问题描述：请问有没有C接口（NDK）直接读取CPU型号、主板UUID、硬盘序列号、网卡MAC等信息（比如udev）？或者有没有可靠的设备唯一ID接口可供调用？解决方案：常见设备的标识有OAID、ODID、AAID、UDID等，定义和用途如下：OAID（开放匿名设备标识符）一种非永 久性设备标识符，基于OAID，可在保护用户个人数据隐私安全的前提下，媒体App、广告平台、三方监测平台等开发者，可

1.问题描述：断点太多是否会使DevEco Studio运行卡顿？如何处理？解决方案：断点太多会影响DevEco Studio运行，可以通过断点管理删除不必要的断点。2.问题描述：为什么图片使用imagePacker.packToFile压缩完之后，反而变大了？解决方案：可以参考图片压缩API的质量参数quality与图片原始大小、压缩后大小的关系，quality是图片质量参数，并非是指按百分比压

1.问题描述：卡片里的Iamge无法显示网络图片。解决方案：通过FormExtensionAbility在元服务卡片上加载网络图片有以下两种方案： 方案一：先下载网络图片到本地，参考元服务卡片上加载本地图片示例代码在EntryFormAbility的onAddForm生命周期回调中实现本地文件的刷新。刷新后，在卡片页面通过backgroundImage属性展示EntryFormAbility传

1.问题描述：分享的时候，如何获取精准的utd类型？解决方案：使用Share Kit时，宿主应用和目标应用定义数据类型须遵照UDMF（统一数据管理框架）定义的UTD（统一类型描述符）规范。UTD中定义的标准化数据类型在设计原则上按物理和逻辑分为两类: 按物理分类的根节点为general.entity，用于描述类型的物理属性，比如文件、目录等，具体可见图1。 按逻辑分类的根

1.问题描述：获取应用是否开启了允许通知权限后，如何引导跳转开启权限通知的设置页面？解决方案： 通过isNotificationEnabled方法查询通知是否授权，参考isNotificationEnabled用法。2.若申请通知权限被拒绝后，后续调用requestEnableNotification()方法不再弹窗，同时会返回错误，错误码是1600004。具体参考请求通知授权。3.如果想二次

1.问题描述：接入微信登录后，还要接华为登录吗？解决方案：为了帮助用户省去多次输入不同应用账号登录的繁琐过程，我们为HarmonyOS应用和元服务提供了使用华为账号快捷登录的能力。提交至华为应用市场的HarmonyOS应用和元服务，需要遵循如下规范： 如果开发者应用支持用户使用第三方账号登录，则该应用需提供华为账号登录选项。用户可通过华为账号快捷地登录您的应用，并获得华为账号的安全配置。其中登录场

1.问题描述：在系统网络代理在被清除后，鸿蒙web组件尝试打开网页时，获取到了系统网络代理，导致网页打开失败。解决方案： 检查网络权限配置 确保在 module.json5 配置文件中已声明必要的网络权限："requestPermissions": [   {     "name&q

1.问题描述：Push token什么场景下会发生变化？解决方案：下列场景Push Token会发生变化： 卸载应用后重新安装。 设备恢复出厂设置。 应用显式调用deleteToken()接口后重新调用getToken()接口。 应用显式调用deleteAAID()接口后重新调用getToken()接口。 将设备（仅涉及We

1.问题描述：主app进入后台，此时切换系统菜单暗黑模式按钮，卡片如何监听系统colorMode ，此时卡片如何做暗黑模式切换？解决方案：适配 方案依靠资源目录，当系统对应的设置项发生变化后（如系统语言、深浅色模式等），应用会自动加载对应资源目录下的资源文件。系统为深色模式预留了dark目录，该目录在应用创建时默认不存在，在进行深色模式适配时，需要开发者在src/main/resources中手动