随着HarmonyOS生态的蓬勃发展，越来越多的开发者投身应用创新，开发过程中可能遇到各种技术挑战，为优化您的开发体验，我们倾力打造了这份HarmonyOS 常见问题手册。

  手册覆盖了应用开发全流程（开发、测试、发布）中的高频痛点，提供架构、功能、版本、交互设计等开发常见问题的处理方案，针对不同行业应用较普遍的故障问题给出高效的解决路径，展示应用上架和分发过程中的常例问题解决办法。
助力18大行业实践，鸿蒙应用开发常见问题手册来了！

  我们按照18类行业的不同特性整理出这份手册，立即获取常见问题手册，让它助您在鸿蒙广阔的生态蓝海中，更高效地创造精彩、实现价值！

  更多精彩常见问题分享：
  助力18大行业实践，鸿蒙应用开发常见问题手册来了！（第二期）
  助力18大行业实践，鸿蒙应用开发常见问题手册来了！（第三期）

  本文原创发布在华为开发者社区，更多鸿蒙应用开发常见问题请见华为开发者联盟官网“行业实践与常见问题”专题页。

常见问题索引

1. 汽车类常见问题

• hdc命令无法获取蓝牙HCI日志该怎么处理

• Web组件加载视频时无法隐藏下载按钮怎么处理

• Web组件中如何展示沙箱路径文件

• 如何判断db数据库事务批量执行sql语句是否执行成功

• 如何通过PersistentStorage持久化储存把对象类型数据存储到硬盘里

• 使用zlib进行字符串gzip压缩，输出结果不正确如何解决

• 在TextInput组件获取焦点时，如何解决点击组件外软键盘无法收起的问题

• 怎么解决Progress组件配合animateTo实现循环动画无反应问题

• 如何判断应用程序是否安装

• 如何控制Swiper组件只能向一个方向滑动

2. 便捷生活类常见问题

• 调用系统定位API失败如何解决

• 路径规划场景中绘制渐变颜色路径，颜色不生效问题如何解决

• 如何解决Canvas画板绘制多条路径时缩放过程中出现的app闪退
  

• 如何解决Grid组件拖拽到边缘时无法继续拖动的问题

• 如何解决Menu组件在数据为空时依旧显示的问题

• 如何解决RichText设置backgroundColor无效的问题

• 如何解决Tabs组件在嵌套Grid组件后，无法触发Tabs滑动的问题

• 如何解决Web组件发送跨域Ajax请求时服务端校验失败的问题

• 如何解决标题栏颜色渐变导致标题栏控件不显示的问题

• 如何解决存在较大量的蓝牙设备时，低功耗蓝牙连接效率低问题

• 如何解决地理编码后坐标在地图定位不准确的问题

• 如何解决生成的二维码无法使用的问题

• 如何解决无法准确获取手机卡运营商信息的问题

• 如何解决自定义扫码界面创建的截图与预览流中不一致问题

• 首次登录日历日程不生效如何解决

• 拖拽List组件内的子组件时，如何解决被拖拽的子组件位置会向两边偏移的问题

• 在自定义扫码界面时，退到后台再回到前台，扫码停止该如何解决

• 长按Image组件拖动，如何避免唤醒小艺

• 地图组件添加自定义图片标记且含数字角标

• 三方应用无法拉起时自定义提示弹窗

• preferences实现数据跨进程读取

• 进行网络请求时报错

• 页面组件间颜色相近

• ArkUI页面加载缓慢

• 应用内页面跳转错误

• 应用加载页面时有短暂的白屏

• 应用内页面内容异常

• 页面上文本内容显示异常

• 应用获取远程数据失败

3. 运动健康类常见问题

• 如何通过安全控件、弹窗授权实现媒体资源保存

• HarmonyOS中如何实现图片取色

• 人脸活体检测结果获取方法

• PDF下载和预览

• 开启定位后没有定位授权的弹窗

4. 教育类常见问题

• List组件中加载多个Web组件只显示最后一个页面怎么解决

• Scan Kit扫码服务，如何监听无操作返回事件

• Swiper如何控制在最边缘时弹性距离

• 如何获取ListItemGroup组件当前可见的ListItem元素索引值

• 如何解决Column无法自适应背景图片大小的问题

• 如何解决Web组件中的视频无法横屏全屏播放的问题

• 如何解决屏幕停止录制后，无法开始第二次录制的问题

• 如何控制Popup在指定时间消失

• 设置了List组件的divider属性，item隐藏时分割线仍然显示如何解决

• 悬浮窗拖动与悬浮窗内的Web组件事件冲突如何解决

• 怎么解决进入RichEditor组件页面无法自动拉起软键盘的问题

• 输入框组件禁止长按粘贴功能

• 使用drawing模块进行文本绘制的常见问题

• 如何通过ArrayBuffer流数据的方式注册全局字体

• 实现去除内边距的导航指示器效果

• Apng格式的动态图片如何展示

• Web组件调用WebviewController相关接口报17100001错误

• 应用未适配分屏模式

• 应用切换深色模式时发生闪退

5. 综合办公类常见问题

• 如何解决Text组件copyOption全选和自定义弹窗无法同时出现的问题

• 如何定位Preview Kit预览文件显示异常

• 应用内Web组件打开本地PDF和访问远程PDF，出现异常如何解决

• 网络图片加载的两种方式及常见问题

• 如何实现CanvasRenderingContext2D绘制长文本时自动换行

• 重新初始化XComponent导致闪退

• 应用在折叠屏展开态下布局异常

• 应用未适配悬浮窗模式

• Flutter页面滑动卡顿

6. 公交地铁类常见问题

• AudioCapturer录制音频问题

• 实现页面栈中指定页面置底方法

• 定位与实际位置有偏差

7. 理财保险类常见问题

• H5页面如何加载应用沙箱内图片

• List组件拖拽时动画属性不生效如何解决

• Text组件字符超过特定长度时，超出部分如何隐藏与显示

• 如何解决napi_create_bool无法创建C++的bool类型

• 如何解决Scroll组件无法设置某个元素一直固定在首位的问题

• 如何解决TextInput设置为密码输入模式时无法输入部分特殊字符问题

• 如何解决Web组件加载失败，出现白屏、加载内容不全的问题

• 如何解决Web组件设置Cookie属性无法生效的问题

• 如何解决Web组件设置透明背景失效问题

• 如何解决Web组件无法使用Devtools工具进行调试问题

• 如何解决Web组件在嵌套如Scroll组件后，无法跟随页面整体滑动的问题

• 如何解决父组件的fling效果无法被子组件继承滚动问题

• 如何解决组件宽高过长导致组件截图失败的问题

• 新请求数据和上次数据相同时，LazyForEach内子组件不更新的问题如何解决

• 怎么处理List自定义子组件UI不跟随数据刷新的问题

• 怎么处理自定义键盘编辑输入的时候光标乱跳的问题

• 项目多人开发时会导致signingConfigs冲突，该如何协调

• 实现TabBar居左样式

• 使用axios发起http请求，header中大小写参数会被替换成全小写

• 对卡证识别结果的处理

• 通过页面跳转将CardRecognition控件拍照界面关闭

• 应用内容未避让导航条、状态栏、挖孔区

• 应用在平板或PC上的布局异常

• H5页面加载缓慢

• Pura X进行人脸识别时黑屏

• 图片存在拉伸或压缩的现象

• 应用启动时页面周边有白边

8. 儿童教育类常见问题

• 使用clipShape进行裁剪后，borderRadius无法生效怎么处理

9. 旅游园区类常见问题

一份简单的的问卷反馈

亲爱的Harmony Next开发者，您好！

为了提升您应用开发中处理问题的效率，为更好地向您提供鸿蒙技术支持服务，希望您在浏览或使用文档后抽1分钟填写一份简单的问卷，我们将会收集您的宝贵意见进行优化~

点击此处填写问卷