简体中文

输入关键字搜索

开发者能力认证

鸿蒙高校创新赛

HarmonyOS 7

animation

HarmonyOS行业解决方案

layoutWeight

HarmonyOS模板&组件

bindPopup

bindsheet

CTRL+K

文档管理中心

我的

Hello，

欢迎来到开发者联盟

工具问题

DevEco Studio

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

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日志落盘存储常见问题

应用框架开发

ArkTS线程模型和并发

ArkTS线程创建方式常见问题

后台任务开发（Background Tasks）

如何在Stage模型中创建后台任务

应用在后台如何继续执行业务

应用运行时进程资源使用规格

如何确认延迟任务WorkSchedulerExtensionAbility回调方法onWorkStart、onWorkStop实现是否正确、是否可以成功回调

如何查询后台任务中短时任务/长时任务/延迟任务/后台代理提醒相关的系统日志

音视频播放开发中长时任务的使用流程以及注意事项

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

代理提醒如何实现自定义铃音

后台录音类型长时任务的实现指导方案

后台位置上报类型长时任务开发指导

进程间通信（IPC）

IPC跨进程通信中是否支持异步返回数据

卡片开发（Form）

点击服务卡片如何跳转至指定的页面

元服务与服务卡片的区别

卡片数据同步异常

卡片组件的圆角显示异常

服务卡片拉起编辑页，出现闪屏

点击服务卡片有概率无法打开详情页

应用桌面服务卡片上图片显示不全

主应用如何获取卡片列表中某个卡片添加/移除

如何在卡片上刷新展示多张图片

如何对服务卡片进行调试

如何在服务卡片上实现分钟级刷新的效果

如何通过AddFormMenuItem组件将沙箱图片刷新至卡片

如何实现拖拽卡片调整大小

如何根据不同尺寸的卡片适配不同的UI

如何判断卡片是否添加到桌面

卡片跳转到应用页面

卡片中引用HAR包中组件的实现方式及白屏问题解决

如何将卡片添加至桌面

卡片的生命周期回调函数有哪些

如何定位并解决卡片白屏展示的问题

服务卡片实现长期破窗效果

卡片数据更新时应用内数据不会自动更新

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

ForEach与LazyForEach区别

页面加载Loading效果实现

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

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

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

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

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

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

如何设置截图透明背景色

如何设置禁止分屏

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

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

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

穿戴侧应用开发方案

ArkUI一多适配布局问题定位

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

本地数据和文件

本地数据库管理

数据存储沙箱路径获取常见问题

媒体文件管理（Media Library）

媒体资源保存常见问题

删除媒体库资源方法区别

Web开发（ArkWeb）

ArkWeb执行JS脚本常见问题

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

ArkWeb第三方WebView内核支持说明

系统开发

网络（Network）

WebSocket协议支持问题

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

基础服务（Basics Service）

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

如何获取系统时间戳

传感器（Sensor Service）

设备竖立状态判断

媒体开发

拍照和图片

图片处理（Image）

图片压缩常见问题

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

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

PixelMap创建崩溃问题定位

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

音频和视频

音频（Audio）

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

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

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

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

AudioRenderer播放音频杂音问题定位

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

音视频播控（AVSession）

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

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

图形开发

2D图形（ArkGraphics 2D）

如何实现图片模糊效果

应用服务开发

地图服务（Map Kit）

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

鸿蒙支付服务（Payment Kit）

收银台支付报错排查

内容分享服务（Share Kit）

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

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

实况视图服务（Live View Kit）

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

消息推送服务（Push Kit）

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

应用内支付服务（IAP Kit）

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

应用市场服务（AppGallery Kit）

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

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

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

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

AGC软件包上传与打包签名常见问题

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

AGC创建应用包名已存在问题排查与解决

AGC软件包上传报错996问题排查与解决

用户通知服务（Notification Kit）

系统公共事件监听

AI功能开发

场景化视觉（Vision）

卡证识别PixelMap转换问题排查

元服务开发

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

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

元服务基础概念常见问题

线上运维与监控

APMS

告警规则配置

稳定性报告

云监控

典型应用场景

查看告警记录

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

常见问题

更新时间: 2026-10-14 08:40

复制页面

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

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

意见反馈

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

意见反馈

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

社区提问 AI 助手提问