简体中文

输入关键字搜索

开发者能力认证

鸿蒙高校创新赛

HarmonyOS 7

animation

HarmonyOS行业解决方案

layoutWeight

HarmonyOS模板&组件

bindPopup

bindsheet

CTRL+K

文档管理中心

我的

Hello，

欢迎来到开发者联盟

工具问题

DevEco Studio

npm包安装失败问题排查

App加固与代码混淆配置常见问题

HAR包编译脚本编写常见问题

构建任务执行shell脚本配置常见问题

应用编译打包CPU架构配置常见问题

Stage模型项目依赖FA模型编译报错问题排查

FA模型config.json配置错误编译报错问题排查

编译构建useNormalizedOHMUrl配置不匹配报错排查

Hvigor版本更新依赖报错问题排查

Release包混淆开启后运行异常问题排查

C/C++项目三方so库未打包入HAP问题排查

登录超时说明

Windows x86模拟器三方C/C++库使用限制

模拟器运行内存配置常见问题

Native应用运行ABI配置报错问题排查

DevEco Studio安装HAP包FileTransfer Failed错误排查

Release应用堆栈解析错误排查常见问题

设备强制重启操作常见问题

真机调试与测试包安装方法常见问题

C++调试启动报错问题排查

真机安装HAP包失败故障排查

应用UI生成插件解压APK文件报错问题排查

DevEco Testing

DevEco Testing设备识别问题排查

DevEco Testing模拟器支持情况常见问题

安全基础质量测试

DevEco Testing安全基础质量测试常见问题

开发与测试问题

多设备场景

Pura X常见问题

Pura X外屏展示申请前，需要做什么

Pura X外屏适配申请提交后，多长时间能完成审核

更多：若以上FAQ仍不能解决，可通过在线提单反馈

Pura X设备人脸识别黑屏

折叠屏切换展开态，视频弹幕只显示半屏

在折叠屏展开态打开应用后折叠，页面内容显示不全

折叠屏展开态下，图片被拉伸

应用在Pura X上打开时，组件存在遮挡

解决应用页面通过折叠屏展开出现自动放大的问题

阔折叠布局适配处理方式

折叠屏状态监听

三折叠常见问题

折叠屏折叠态，应用页面底部未避让导航栏

三折叠设备横屏播放视频时退出全屏，无法回归竖屏显示

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

平板设备上打开应用时，不显示状态栏

平板相机拍照预览画面拉伸

应用在平板设备上的拍照取景框发生了旋转

弹窗在平板横竖屏切换后不显示

横屏播放视频导致页面布局异常如何解决

平板分屏状态下，点击跳转后的页面变为全屏展示

平板设备上应用的Web页面中，字体显示过大或过小

平板切换自由多窗模式后，页面横向滑动失效

平板端页面背景与字体颜色对比度不足

平板全屏播放视频时四周有留白

应用在平板设备竖屏时，界面下方有留白且文字溢出界面

平板上视频显示不全

平板页面局部图片被截断

悬浮窗模式，组件大小与显示内容大小不一致

分屏模式下组件卡片内大面积空白

平板全屏播放视频时下方标题仍然显示

自由多窗模式关闭后状态栏与页面内容重叠

平板竖屏场景，底部组件位置错乱

应用横屏打开会自动切换成竖屏

平板横竖屏切换，底部图标隐藏不见

平板开启强制横屏选择分栏视图，应用横屏后分栏显示异常

应用指南针在平板上有90度偏差

平板上自定义键盘弹出，显示不全

平板横屏显示时，页面滑动区域过小

平板打开应用，部分组件不可见

平板横屏状态下，页面两侧出现大量黑边

页面内容在平板上显示不全

分屏模式，不支持分栏显示

悬浮窗模式下，应用窗口放置在屏幕不同位置时，内部弹窗位置也随着变化

平板全屏播放视频时页面异常

平板设备上，应用页面横屏状态下不显示内容

PC打开应用布局异常

PC上不能通过鼠标控制图片滑动

PC设备上，页面滚动方向与预期不符

应用在PC设备上页面文字显示过大或过小

自由多窗模式下，应用页面与标题栏三键区域重叠

startAbility启动小窗口后requestFocus原页面组件报错

PC应用如何隐藏导航栏右上角三键

鼠标对应光标丢失和样式变化

如何设置PC窗口透明

PC端点击Dock栏关闭窗口时，如何弹窗确认

如何实现多个独立窗口

PC端设置窗口大小不生效

PC中List如何通过上下键循环走焦

自由窗口下如何自定义窗口标题栏

如何实现PC登录流程的窗口变化效果

智能表可滚动页面无法响应表冠旋转事件

方舟UI框架（ArkUI）

横竖屏切换时应用布局会发生留白、溢出屏幕的现象

控制折叠屏展开态和折叠态时弹窗的位置

一次开发多端部署

应用在平板桌面和手机桌面显示的图标不一样

折叠屏展开态直接打开应用与折叠后再打开应用字体大小不一致

应用未适配自由多窗，在平板设备上出现截断、挤压、堆叠等现象

手机端应用在PC端无法全屏展示

弹窗页面文本重叠

折叠屏或分栏模式下观看视频时，画面拉伸

应用在折叠屏展开态下，页面展示的内容比例变大

折叠屏展开态和折叠态下呈现的内容不一致

如何实现横屏页面返回切换竖屏/单页面横竖屏

如何实现全局悬浮窗功能

应用接续任务失败

不同APPID的应用如何实现应用接续

应用接续功能使用失败

应用质量

hdc file recv命令接收文件失败问题排查与解决

ArkUI-SaveButton点击无响应问题定位

NFC提示弹窗无法关闭

应用导入大量图片后卡死

AVPlayer内存泄漏导致应用闪退问题定位

后台音频播放或录音应用闪退问题定位

应用闪退与崩溃问题定位

Web页面点击响应慢

点击页签，页面切换响应慢

ArkUI-Canvas组件图片放大卡顿问题定位

H5页面加载缓慢

console.log与hilog区别及使用选择常见问题

hilog应用日志过滤设置常见问题

hilog日志落盘存储常见问题

hdc命令发送本地文件至远端设备常见问题

设备CPU信息获取方法常见问题

HDC命令安装.app文件常见问题

HDC命令截屏与相册图片获取常见问题

系统设备信息获取常见问题

应用框架开发

程序包结构

应用安装状态检查常见问题

调试时出现安装错误

HSP多包加载崩溃cppcrash异常问题排查

应用包信息查询与免安装配置常见问题

方舟编程语言（ArkTS）

ArkTS-ArrayList元素获取与截取常见问题

如何生成随机的uuid

ArkTS AOP代码插桩功能实现常见问题

ArkTS-Record工具类型使用常见问题

ArkTS正则表达式使用常见问题

Uint8Array与String及hex类型转换常见问题

Base64编码与转换常见问题

ArkTS语法特性与使用常见问题

页面上展示的日期与实际时间不符

ArkTS线程模型和并发

ArkTS线程创建方式常见问题

HAR包中创建Worker失败问题定位

程序框架（Ability）

Context功能使用常见问题

Context类型与关系常见问题

拉起浏览器应用常见问题

PC端应用关闭拦截与回调处理常见问题

Emitter与EventHub事件通信机制常见问题

字体设置与效果常见问题

应用流转对账号有什么要求

UIAbility间数据传递方法常见问题

UIAbility生命周期变化订阅常见问题

UIAbility生命周期与耗时操作常见问题

Stage模型与FA模型对象共享差异

UIAbility生命周期与启动问题定位

后台任务开发（Background Tasks）

应用后台业务执行与任务申请常见问题

进程间通信（IPC）

IPC跨进程异步返回数据

卡片开发（Form）

元服务卡片多张图片刷新展示常见问题

Native侧文件操作常见问题

Native侧ArkTS对象释放常见问题

任务并发调度（Function Flow Runtime）

下载任务切换到后台下载中断

NDK与Native开发问题定位

Image组件图片加载与缓存常见问题

ForEach与LazyForEach区别

页面加载Loading效果实现

Navigation传参与导航栏设置常见问题

ArkUI-布局margin设置不生效常见问题

ArkUI-Swiper组件滑动与切换常见问题

px2vp单位转换方法及常见问题

Slider组件常见问题

ArkUI-List组件布局与渲染常见问题

bindPopup弹窗常见问题

ArkUI-List组件滚动与滑动常见问题

ArkUI设置图形效果与颜色渐变的常见问题

自定义弹窗弹出或关闭异常如何排查

跑马灯效果实现常见问题

如何使子组件间自适应保持相同间距

滚动与滑动组件实现吸顶效果常见问题

如何控制TextArea最多显示多少行，超出尺寸的显示滚动条

Swiper嵌套Scroll组件滑动问题

ArkUI-Image组件图片显示与处理常见问题

ArkUI-RichEditor键盘弹出与焦点问题定位

ArkUI-Image图片拖拽与缩放平移问题定位

智能表表冠旋转事件无响应问题定位

ArkUI标题栏渐变导致控件不显示问题定位

Grid组件拖拽边缘无法继续拖动问题

开启“高对比度文字”时应用文字显示模糊

ArkUI-List组件滑动与展示问题定位

router参数传递和接收示例

Video组件播放与显示问题定位

折叠屏状态监听与可折叠特性判断常见问题

如何设置截图透明背景色

如何设置禁止分屏

软键盘事件监听与避让模式设置常见问题

应用无交互超时弹窗提示功能实现常见问题

屏幕常亮设置常见问题

自定义弹窗和子窗口间的层级关系

应用所有页面不允许截图和录屏

切换智慧多窗模式后页面内容遮挡如何排查

List列表子组件顺序动画展示常见问题

穿戴侧应用开发方案

ArkUI动画效果实现与控制常见问题

ArkUI-Row组件布局问题排查

RichEditor组件常见问题

ArkUI状态管理与组件通信常见问题

TextInput组件常见问题

Text组件常见问题

组件背景拉伸常见问题

如何实现防截屏功能

如何判断当前设备是手机还是折叠屏手机

如何获取安全区域（状态栏、导航条、三键导航等）的高度并实现沉浸式下的避让

如何控制窗口旋转方向

ArkUI-Canvas组件绘制功能常见问题

List组件下拉刷新与加载

居中显示TimePicker的文本

ArkUI-Grid组件布局与交互常见问题

ArkUI页面路由跳转常见问题

ArkUI手势常见问题

ArkUI自定义弹窗功能实现与控制常见问题

ArkUI一多适配布局问题定位

ArkUI复杂嵌套对象属性更新失效问题定位

使用输入法时无法输入部分字符问题定位

ArkUI平板自由多窗挖孔区避让问题定位

窗口横竖屏旋转问题排查与解决

ArkUI-Scroll滑动透明度渐变重叠显示问题定位

ArkUI-Image组件图片闪烁问题定位

页面跳转后弹窗不关闭问题定位

NavDestination首页跳转动画异常问题

本地数据和文件

Web开发（ArkWeb）

ArkWeb执行JS脚本常见问题

ArkWeb网页加载问题排查与解决

ArkWeb第三方WebView内核支持说明

ArkWeb网页加载常见问题

ArkWeb多媒体文件加载常见问题

ArkWeb H5与原生交互常见问题

ArkWeb页面跳转常见问题

ArkWeb视频加载布局异常问题定位

ArkWeb页面顶部显示链接信息问题定位

ArkWeb网页视频全屏问题排查与解决

ArkWeb视频横屏全屏播放问题定位

ArkWeb页面跳转问题定位

系统开发

加解密算法（Crypto Architecture）

加解密与签名验签问题定位

公钥数据格式转换常见问题

网络（Network）

HTTP分片上传报错问题定位

WebSocket协议支持问题

网络信息获取与状态监听常见问题

HTTP请求配置常见问题

HTTP请求底层原理与机制常见问题

远场通信（Remote Communication）

rcp如何实现文件上传

短距通信（Connectivity）

BLE蓝牙数据传输与广播报错问题排查

BLE蓝牙扫描与广播问题排查

HID蓝牙配对后如何实现自动连接

蓝牙BLE扫描与状态监听常见问题

基础服务（Basics Service）

剪贴板权限请求弹窗频繁问题定位

API兼容性保护判断常见问题

如何获取系统时间戳

zip压缩数据长度获取

设备标识符获取与说明

桌面拓展服务（Desktop Extension Kit）

PC应用状态栏接入与气泡提示实现常见问题

传感器（Sensor Service）

设备竖立状态判断

媒体开发

拍照和图片

相机开发（Camera）

相机设备查询与获取常见问题

图片处理（Image）

图片压缩常见问题

ArkUI-Image图片数据转换与显示常见问题

PixelMap图片处理与转换常见问题

如何读取相册中的图片

PixelMap创建崩溃问题定位

系统相册大图加载与解码报错问题定位

音频和视频

音频（Audio）

音频设备路由与扬声器听筒切换常见问题

音频播放功能实现常见问题

音频录制功能实现与状态检测常见问题

AudioRenderer播放控制与跳转帧接口常见问题

手机设置静音，重启时开机动画有声音

ArkWeb网页音频播放中断与续播适配

AudioRenderer播放音频杂音问题定位

应用进入后台音频停止播放问题定位

音视频播放音量不同步与被打断后状态异常问题定位

音视频播控（AVSession）

AVSession播控中心不显示问题排查

音视频播控（AVSession）问题定位

音视频编解码（AVCodec）

视频播放画面异常常见问题定位

音视频编解码与转码常见问题

图形开发

2D图形（ArkGraphics 2D）

如何实现图片模糊效果

应用服务开发

地图服务（Map Kit）

地图组件Marker标记与样式自定义常见问题

Map Kit地图加载Marker不展示问题

华为账号服务（Account Kit）

华为账号登录与授权常见问题

华为支付服务（Payment Kit）

收银台支付报错排查

内容分享服务（Share Kit）

系统分享与数据接收常见问题

华为分享将应用的页面分享到另一个手机后不能引导下载应用

碰一碰分享未跳转应用内页面问题

日历服务（Calendar Kit）

日程删除方式及耗时的对比

实况视图服务（Live View Kit）

系统服务自动接入实况窗常见问题

位置服务（Location Kit）

模拟器虚拟定位设置常见问题

应用获取定位权限问题排查与解决

消息推送服务（Push Kit）

消息推送后手机未收到消息提示怎么处理

Push Kit推送服务接入常见错误码和解决方案

应用链接跳转服务（App Linking Kit）

App Linking跳转失败问题排查

应用内支付服务（IAP Kit）

JWS数据解码与验签常见问题

应用市场服务（AppGallery Kit）

AppGallery邀请测试创建与使用常见问题

拉起应用市场跳转详情页常见问题

HarmonyOS应用上架备案流程与常见问题

私有云部署应用备案配置常见问题

HarmonyOS 开发者中心软件包上传与打包签名常见问题

应用内检查更新实现及常见问题

企业主体能否多个开发者账号实名认证

应用内支付商品类型与ID配置常见问题

HarmonyOS 开发者中心创建应用包名已存在问题排查与解决

HarmonyOS 开发者中心软件包上传报错996问题排查与解决

用户通知服务（Notification Kit）

系统公共事件监听

用户通知服务常见问题

AI功能开发

场景化视觉（Vision）

卡证识别PixelMap转换问题排查

AI识图识别沙箱图片问题排查

场景化语音（Speech）

如何解决朗读控件播放列表中加载失败的问题

AI字幕与AI识图多语言配置常见问题

基础语音（Core Speech）

初始化语音识别引擎报错

自然语言理解（Natural Language）

AI中英文语义分词功能

元服务开发

元服务逆地理编码获取地址信息

如何将GIF图设置为组件背景

元服务基础概念常见问题

Payment Kit与IAP Kit区别

线上运维与监控

APMS

告警规则配置

稳定性报告

云监控

典型应用场景

查看告警记录

您当前正在浏览新版开发者文档中心，目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标，可切换文档分类。了解新版目录

任务并发调度（Function Flow Runtime）

更新时间: 2026-10-20 11:25

复制页面

故障排查

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问 AI 助手提问