助力18大行业实践，鸿蒙应用开发常见问题手册来了！（第一期） 原创

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

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

  我们按照18类行业的不同特性整理出这份手册，立即获取常见问题手册，让它助您在鸿蒙广阔的生态蓝海中，更高效地创造精彩、实现价值！
  更多精彩示例分享：
  助力18大行业实践，鸿蒙应用开发常见问题手册来了！（第二期）

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

常见问题索引

1. 汽车类常见问题

• hdc命令无法获取蓝牙HCI日志该怎么处理
• Web组件加载视频时无法隐藏下载按钮怎么处理
• Web组件中如何展示沙箱路径文件
• 如何判断db数据库事务批量执行sql语句是否执行成功
• 如何通过PersistentStorage持久化储存把对象类型数据存储到硬盘里
• 使用zlib进行字符串gzip压缩，输出结果不正确如何解决
• 在TextInput组件获取焦点时，如何解决点击组件外软键盘无法收起的问题
• 怎么解决Progress组件配合animateTo实现循环动画无反应问题
• 如何判断应用程序是否安装
• 如何控制Swiper组件只能向一个方向滑动
• 实现Navigation首页和子页面互相跳转时的显隐监听
• 动态属性的使用场景
• 上架审核提示软著不通过
• 使用AVTranscoder进行视频转码失败
• 蓝牙相关业务开发中长时任务的使用流程以及注意事项

2. 便捷生活类常见问题

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• preferences实现数据跨进程读取

• 进行网络请求时报错

• 页面组件间颜色相近

• ArkUI页面加载缓慢

• 应用内页面跳转错误

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

• 应用内页面内容异常

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

• 应用获取远程数据失败

• Grid单元格合并布局

• 如何判断app启动来源（桌面图标，三方应用拉起等）

• @ObservedV2与@Trace装饰的对象key都带有_ob_导致反序列化异常

• 文件操作API常见参数类型转换以及场景

• List展示不全

• 多个弹窗链式调用时失败

• PersistentStorage、Preferences、键值型数据库、关系型数据库的区别及适用场景

• ArkTs中常见的日期处理

• 如何在应用沙箱内新建文件或者文件夹

• 音频转码后有杂音

• 使用PixelMap完成图像变换及常见问题

• 拉起软键盘时会遮挡页面的内容

• 侧滑返回上一级页面后又跳转回原来的页面

• 应用内在转场时出现亮度突变

• 页面和导航条区域的色调不一致

• 使用输入法进行文本输入时，输入框无响应

• 双击页面时会发生缩放的动效

• 点击搜索框时会短暂出现多余的方框

• 列表中有多余的空白选项

• 平板设备上应用中的H5页面显示不全

• 图片在查看时会有闪烁的情况

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. 旅游园区类常见问题