简体中文

探索
探索
了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
应用形态
HarmonyOS 应用
One as All，All as One
元服务
秒开直达服务随行无处不在
游戏
为游戏创意玩法带来无限可能
多设备应用开发
穿戴
折叠屏手机
鸿蒙电脑
开发者学堂
视频课程
Codelabs
设计
设计
了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
开发
开发
获取官方开发工具和文档等资源，将创意转化为鸿蒙应用
开发工具
DevEco Studio
应用开发 IDE, AI Agent 和 CLI
小艺开放平台
Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery Connect
DevEco Testing
开发资源
工具下载
示例代码
开发文档
最佳实践
分发
分发
通过华为应用市场发布你的应用，多渠道触达用户
应用分发
应用市场
纯净安全的全场景应用分发平台
游戏中心
应用审核政策
服务分发
小艺
HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档
内容分发
主题服务
内容分发文档
推广与变现
推广与变现
一站式流量增长与营销变现平台
推广
应用推广引擎
全链路应用推广与增长服务平台
鲸鸿动能广告
为企业广告主提供广告营销服务
联运服务
推广文档
变现
鲸鸿动能流量变现
使能应用展示广告，实现流量变现
应用内支付
变现文档
生态合作
生态合作
携手伙伴共建共享鸿蒙智能终端生态
伙伴 SDK
一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务
鸿蒙应用开发、培训和人力服务
服务商伙伴中心
华为终端云服务商伙伴的统一门户
伙伴入驻指南
生态市场介绍，卖家和买家服务指引
廉洁政策
合作伙伴诚信廉洁政策
支持
支持
获取客服帮助、技术支持、活动资讯等信息
智能客服
24小时 AI 在线自助服务，即问即答
社区问答
在官方论坛提问，与开发者互动交流
在线提单
提交工单，获得技术支持
开发者活动
HDD 等线下活动速览及报名入口
资讯
帮助指南

输入关键字搜索

开发者能力认证

鸿蒙高校创新赛

HarmonyOS 7

animation

HarmonyOS行业解决方案

layoutWeight

HarmonyOS模板&组件

bindPopup

bindsheet

CTRL+K

文档管理中心

我的

Hello，

欢迎来到开发者联盟

全部文档

DevEco Studio

开发环境搭建

下载与安装DevEco Studio

工程目录结构介绍

工程模板介绍

创建一个新的工程

添加和删除模块

导入和引用模块

卸载和加载模块

开发发布和管理共享包

开发静态共享包

开发动态共享包

发布共享包

引用及管理共享包

ohpm-repo私仓搭建工具

ohpm-repo install

ohpm-repo start

ohpm-repo restart

ohpm-repo --version

ohpm-repo encrypt_password

ohpm-repo deploy

ohpm-repo restore

ohpm-repo mirror_storage

ohpm-repo check_storage

ohpm-repo remove_instance

数据迁移相关命令

ohpm-repo export_pkginfo

ohpm-repo batch_download

ohpm-repo batch_publish

ohpm-repo export_userinfo

ohpm-repo import_userinfo

ohpm-repo export_pkgPermission

ohpm-repo import_pkgPermission

多实例部署

页面功能介绍

个人中心主页

包权限管理

安全配置指南

常见问题FAQ

1.0.1升级至2.X.X/5.X.X版本

1.1.0升级至2.X.X/5.X.X版本

2.X.X/5.X.X升级至更高版本

自定义存储插件

自定义存储插件配置

自定义认证插件

自定义认证插件配置

自定义登录验证插件

自定义登录验证插件配置

导出OpenHarmony三方库中心仓元数据至ohpm-repo

ohpm仓库接口协议

自定义元数据规则校验插件

自定义元数据规则校验插件配置

基于Dockerfile部署ohpm-repo私仓

生成单层图标

创建服务卡片

创建意图框架

端云一体化开发

注册华为开发者账号并实名认证

搭建开发环境

在AGC创建项目和HarmonyOS应用/元服务

开发端云工程

创建端云一体化开发工程

创建HarmonyOS应用工程

创建元服务工程

历史工程转换为端云一体化开发工程

开发云侧工程

开发云函数

创建并配置函数

开发云对象

创建云对象

开发云对象

调试云对象

部署云对象

开发云数据库

创建对象类型

添加数据条目

部署云数据库

(可选）一键生成Model Class

部署云侧工程

（可选）同步云端代码至DevEco Studio工程

开发端侧工程

在端侧调用云侧代码

在端侧调用云函数

在端侧调用云对象

在端侧访问云数据库

在端侧调用云存储

（可选）通过CloudDev面板获取云开发资源支持

附录：云开发工程模板

通用云开发模板

离线环境配置指导

编写与调试应用

代码生成/补全

代码实时检查及快速修复

Code Linter代码检查

Code Linter代码检查规则

规则变更说明

recommended推荐规则清单

通用规则@typescript-eslint

@typescript-eslint/adjacent-overload-signatures

@typescript-eslint/array-type

@typescript-eslint/await-thenable

@typescript-eslint/ban-ts-comment

@typescript-eslint/ban-tslint-comment

@typescript-eslint/ban-types

@typescript-eslint/brace-style

@typescript-eslint/class-literal-property-style

@typescript-eslint/comma-dangle

@typescript-eslint/comma-spacing

@typescript-eslint/consistent-indexed-object-style

@typescript-eslint/consistent-type-assertions

@typescript-eslint/consistent-type-definitions

@typescript-eslint/consistent-type-imports

@typescript-eslint/default-param-last

@typescript-eslint/dot-notation

@typescript-eslint/explicit-function-return-type

@typescript-eslint/explicit-member-accessibility

@typescript-eslint/explicit-module-boundary-types

@typescript-eslint/func-call-spacing

@typescript-eslint/init-declarations

@typescript-eslint/keyword-spacing

@typescript-eslint/lines-between-class-members

@typescript-eslint/member-delimiter-style

@typescript-eslint/member-ordering

@typescript-eslint/method-signature-style

@typescript-eslint/naming-convention

@typescript-eslint/no-array-constructor

@typescript-eslint/no-base-to-string

@typescript-eslint/no-confusing-non-null-assertion

@typescript-eslint/no-confusing-void-expression

@typescript-eslint/no-dupe-class-members

@typescript-eslint/no-duplicate-imports

@typescript-eslint/no-dynamic-delete

@typescript-eslint/no-empty-function

@typescript-eslint/no-empty-interface

@typescript-eslint/no-explicit-any

@typescript-eslint/no-extraneous-class

@typescript-eslint/no-extra-non-null-assertion

@typescript-eslint/no-extra-parens

@typescript-eslint/no-extra-semi

@typescript-eslint/no-floating-promises

@typescript-eslint/no-for-in-array

@typescript-eslint/no-implicit-any-catch

@typescript-eslint/no-implied-eval

@typescript-eslint/no-inferrable-types

@typescript-eslint/no-invalid-this

@typescript-eslint/no-invalid-void-type

@typescript-eslint/no-loop-func

@typescript-eslint/no-loss-of-precision

@typescript-eslint/no-magic-numbers

@typescript-eslint/no-misused-new

@typescript-eslint/no-misused-promises

@typescript-eslint/no-namespace

@typescript-eslint/no-non-null-asserted-optional-chain

@typescript-eslint/no-non-null-assertion

@typescript-eslint/no-parameter-properties

@typescript-eslint/no-redeclare

@typescript-eslint/no-require-imports

@typescript-eslint/no-restricted-syntax

@typescript-eslint/no-shadow

@typescript-eslint/no-this-alias

@typescript-eslint/no-throw-literal

@typescript-eslint/no-type-alias

@typescript-eslint/no-unnecessary-boolean-literal-compare

@typescript-eslint/no-unnecessary-condition

@typescript-eslint/no-unnecessary-qualifier

@typescript-eslint/no-unnecessary-type-arguments

@typescript-eslint/no-unnecessary-type-assertion

@typescript-eslint/no-unnecessary-type-constraint

@typescript-eslint/no-unsafe-argument

@typescript-eslint/no-unsafe-assignment

@typescript-eslint/no-unsafe-call

@typescript-eslint/no-unsafe-member-access

@typescript-eslint/no-unsafe-return

@typescript-eslint/no-unused-expressions

@typescript-eslint/no-unused-vars

@typescript-eslint/no-use-before-define

@typescript-eslint/no-useless-constructor

@typescript-eslint/prefer-as-const

@typescript-eslint/prefer-enum-initializers

@typescript-eslint/prefer-for-of

@typescript-eslint/prefer-function-type

@typescript-eslint/prefer-includes

@typescript-eslint/prefer-literal-enum-member

@typescript-eslint/prefer-namespace-keyword

@typescript-eslint/prefer-nullish-coalescing

@typescript-eslint/prefer-optional-chain

@typescript-eslint/prefer-readonly

@typescript-eslint/prefer-readonly-parameter-types

@typescript-eslint/prefer-reduce-type-parameter

@typescript-eslint/prefer-regexp-exec

@typescript-eslint/prefer-string-starts-ends-with

@typescript-eslint/prefer-ts-expect-error

@typescript-eslint/promise-function-async

@typescript-eslint/quotes

@typescript-eslint/require-array-sort-compare

@typescript-eslint/require-await

@typescript-eslint/restrict-plus-operands

@typescript-eslint/restrict-template-expressions

@typescript-eslint/return-await

@typescript-eslint/semi

@typescript-eslint/space-before-function-paren

@typescript-eslint/space-infix-ops

@typescript-eslint/strict-boolean-expressions

@typescript-eslint/switch-exhaustiveness-check

@typescript-eslint/triple-slash-reference

@typescript-eslint/type-annotation-spacing

@typescript-eslint/typedef

@typescript-eslint/unbound-method

@typescript-eslint/unified-signatures

安全规则@security

@security/no-commented-code

@security/no-cycle

@security/no-unsafe-aes

@security/no-unsafe-dh

@security/no-unsafe-dsa

@security/no-unsafe-dh-key

@security/no-unsafe-dsa-key

@security/no-unsafe-ecdsa

@security/no-unsafe-hash

@security/no-unsafe-mac

@security/no-unsafe-rsa-encrypt

@security/no-unsafe-rsa-key

@security/no-unsafe-rsa-sign

@security/no-unsafe-3des

@security/specified-interface-call-chain-check

@security/no-unsafe-kdf

@security/no-unsafe-sm4

@security/no-unsafe-sm2-key

@security/no-unsafe-sm2-cipher

@security/no-unsafe-ecdh

@security/no-unsafe-huks

性能规则@performance

@performance/avoid-overusing-custom-component-check

@performance/bad-deep-clone-check

@performance/constant-property-referencing-check-in-loops

@performance/crypto-replacement-check

@performance/custom-node-memory-leak-check

@performance/dark-color-mode-check

@performance/datashare-query-unrelease-check

@performance/foreach-args-check

@performance/foreach-index-check

@performance/gif-hardware-decoding-check

@performance/hp-arkui-avoid-update-auto-state-var-in-aboutToReuse

@performance/hp-arkui-avoid-empty-callback

@performance/hp-arkui-combine-same-arg-animateto

@performance/hp-arkui-image-async-load

@performance/hp-arkui-load-on-demand

@performance/hp-arkui-limit-refresh-scope（已下线）

@performance/hp-arkui-no-func-as-arg-for-reusable-component

@performance/hp-arkui-no-high-freq-log（已下线）

@performance/hp-arkui-no-stringify-in-lazyforeach-key-generator

@performance/hp-arkui-no-state-var-access-in-loop

@performance/hp-arkts-no-use-any-export-current

@performance/hp-arkts-no-use-any-export-other

@performance/hp-arkui-remove-container-without-property

@performance/hp-arkui-replace-nested-reusable-component-by-builder

@performance/hp-arkui-reduce-pangesture-distance

@performance/hp-arkui-remove-redundant-nest-container

@performance/hp-arkui-remove-redundant-state-var

@performance/hp-arkui-remove-unchanged-state-var

@performance/hp-arkui-set-cache-count-for-lazyforeach-grid

@performance/hp-arkui-suggest-cache-avplayer

@performance/hp-arkui-suggest-reuseid-for-if-else-reusable-component

@performance/hp-arkui-suggest-use-effectkit-blur

@performance/hp-arkui-suggest-use-get-anonymousid-async

@performance/hp-arkui-use-attributeUpdater-control-refresh-scope

@performance/hp-arkui-use-grid-layout-options

@performance/hp-arkui-use-id-in-get-resource-sync-api

@performance/hp-arkui-use-local-var-to-replace-state-var

@performance/hp-arkui-use-onAnimationStart-for-swiper-preload

@performance/hp-arkui-use-object-link-to-replace-prop

@performance/hp-arkui-use-row-column-to-replace-flex

@performance/hp-arkui-use-reusable-component

@performance/hp-arkui-use-scale-to-replace-attr-animateto

@performance/hp-arkui-use-taskpool-for-web-request

@performance/hp-arkui-use-transition-to-replace-animateto

@performance/hp-arkui-use-word-break-to-replace-zero-width-space

@performance/hp-arkui-wrap-waterflow-if-else-footer（已下线）

@performance/high-frequency-log-check

@performance/hp-ffrt-no-use-std

@performance/hp-performance-no-closures

@performance/hp-performance-no-dynamic-cls-func

@performance/init-list-component

@performance/js-code-cache-by-interception-check

@performance/js-code-cache-by-precompile-check

@performance/lazyforeach-args-check（已下线）

@performance/lottie-animation-destroy-check

@performance/multiple-associations-state-var-check

@performance/monitor-invisible-area-in-image-animation

@performance/no-use-any-import

@performance/no-high-loaded-frame-rate-range

@performance/number-init-check

@performance/nested-post-frame-callback-check

@performance/object-creation-check（已下线）

@performance/reasonable-audio-use-check

@performance/reasonable-gps-use-check

@performance/reuse-date-instances-check

@performance/reasonable-sensor-use-check

@performance/sparse-array-check

@performance/start-window-icon-check

@performance/state-variable-usage-in-ui-format-check

@performance/typed-array-check

@performance/timezone-interface-check

@performance/tabs-on-change-check

@performance/update-state-var-between-animatetos-check

@performance/web-cache-mode-check

@performance/web-on-active-check

@performance/waterflow-data-preload-check

预览规则@previewer

@previewer/mandatory-default-value-for-local-initialization

@previewer/no-page-method-on-preview-component

@previewer/no-unallowed-decorator-on-root-component

一次开发多端部署规则@cross-device-app-dev

@cross-device-app-dev/color-contrast

@cross-device-app-dev/color-value

@cross-device-app-dev/font-size-unit

@cross-device-app-dev/font-size

@cross-device-app-dev/grid-columns-span

@cross-device-app-dev/grid-span-value

@cross-device-app-dev/one-multi-breakpoint-check

@cross-device-app-dev/sidebar-navigation

@cross-device-app-dev/size-unit

@cross-device-app-dev/touch-target-size

@cross-device-app-dev/window-size-change-listener-check

@cross-device-app-dev/immersive-effect-check

ArkTS代码风格规则@hw-stylistic

@hw-stylistic/array-bracket-spacing

@hw-stylistic/brace-style

@hw-stylistic/comma-spacing

@hw-stylistic/curly

@hw-stylistic/file-naming-convention

@hw-stylistic/indent

@hw-stylistic/keyword-spacing

@hw-stylistic/max-len

@hw-stylistic/no-multi-spaces

@hw-stylistic/no-tabs

@hw-stylistic/object-property-newline

@hw-stylistic/one-var-declaration-per-line

@hw-stylistic/operator-linebreak

@hw-stylistic/quotes

@hw-stylistic/semi-spacing

@hw-stylistic/space-before-blocks

@hw-stylistic/space-before-function-paren

@hw-stylistic/space-infix-ops

正确性规则@correctness

@correctness/avsession-buttons-check

@correctness/audio-interrupt-check

@correctness/audio-pause-or-mute-check

@correctness/avsession-metadata-check

@correctness/image-pixel-format-check

@correctness/image-interpolation-check

@correctness/listen-default-network-change

@correctness/listen-multi-network-concurrent

@correctness/multimedia-use-stride-in-image-receiver

@correctness/redundant-dependency-check

@correctness/v1-nested-object-property-change-format-check

@correctness/v1-state-object-member-used-in-function-parameter-check

@correctness/accessibility-label-check

@correctness/accessibility-focus-redundancy-check

@correctness/accessibility-type-redundancy-check

@correctness/accessibility-status-missing-check

兼容性规则@compatibility

@compatibility/api-compatibility-check

@compatibility/deprecate-api-check

Code Scanner代码检查

Clang-Tidy代码检查

生成ArkTSDoc文档

快速插入场景化代码片段

跨语言代码编辑

代码索引（clangd）

PreviewChecker检测规则

查看ArkTS/JS预览效果

查看ArkUI预览效果

Profile Manager

查看多端设备预览效果

Inspector双向预览

预览数据模拟

使用预览器调试应用

支持使用预览器的API清单

配置调试签名

使用本地真机运行应用

使用仿真器运行轻量级智能穿戴应用

使用模拟器运行应用

设备支持类型

模拟器与真机的差异

管理模拟器

创建模拟器

启动和关闭模拟器

使用模拟器

使用工具栏

移动和缩放模拟器

模拟器访问网络

安装应用程序包和上传文件

更多的扩展能力

修改模拟器

自定义屏幕配置

通过命令行使用模拟器

离线部署模拟器

模拟器错误码

自定义运行/调试配置

ArkTS代码调试

调试场景说明

debug启动调试

attach启动调试

extension调试

多进程调试

打印表达式

查看异步函数堆栈

Native代码调试

查看内存信息

使用LLDB调试命令

堆栈可视化

so信息可视化

设置执行点

Native调试启动加速

调试Native子进程

使用调试器

跨语言调试

三方库源码调试

查看ArkUI状态变量

开发者模式

开发者选项

开发者关怀

访问设备文件

数据库调试

调试错误码

运行配置错误码

热重载和增量调试错误码

调试失败错误码

hdc命令失败错误码

日志与故障分析

查看Cpp Crash（进程崩溃）日志

查看AppFreeze（应用冻屏）日志

查看App Killed（应用终止）日志

解析应用minidump/coredump文件

堆栈轨迹分析

异常堆栈解析原理

使用ASan检测内存错误

使用HWASan检测内存错误

使用TSan检测线程错误

使用UBSan检测未定义行为

方舟运行时检测

开发自测试

Instrument Test

黑盒覆盖率测试

测试框架错误码

仪器测试错误码

本地测试错误码

命令行测试错误码

应用与元服务体检

场景化体检

上架前体检

上架合规体检

导入DevEco Testing的检测报告进行诊断

导入上架检测报告进行诊断

管理体检报告

点击操作响应快

点击操作完成快

滑动操作响应快

滑动过程流畅

转场操作流畅

动态内存峰值占用

前台场景内存峰值占用

后台CPU占用峰值

节点数超过500过多

启动加载完成快

Terminal环境变量说明

DevEco Studio配置参数列表

关闭数据采集

日志收集和诊断数据

OHPM版本号规则

pac.json5隐私清单文件

构建应用

构建系统生命周期

构建任务说明

构建产物说明

配置文件概述

hvigor-config.json5文件

工程级build-profile.json5文件

模块级build-profile.json5文件

配置构建流程

多模块管理

添加依赖项

配置多目标产物

预构建库快速链接

多工程构建

HAP唯一性校验逻辑

自定义.hvigor目录路径

灵活定制编译选项

获取自定义编译参数

动态修改编译配置

提升构建效率

模块化编译

分析构建过程

性能/内存优化：多目标编译优化实践

性能/内存优化：多HAP/HSP工程编译优化实践

性能优化：自定义插件和任务优化实践

性能优化：混合语言工程Sync优化实践

性能优化：缓存插件实践

内存优化：远程编译实践

扩展构建能力

开发Hvigor任务

开发Hvigor插件

扩展构建API

基础构建能力

插件上下文

API使用示例

任务可视化与执行

构建报错排查

使用日志记录

编译构建常见问题

编译构建错误码

依赖错误码

脚本错误码

配置错误码

资源缺失错误码

语法错误码

规格错误码

权限错误码

操作异常错误码

ArkTS编译错误码

签名工具错误码

优化应用性能

性能调优工具简介

DevEco Profiler调优工具简介

使用Profiler进行性能调优

性能优化过程简介

性能问题定界：实时监控

性能问题定位：深度录制

卡顿丢帧分析

案例：使用Frame模板分析应用卡顿问题

冷启动：Launch分析

Launch模板基本操作

案例：应用冷启动首帧完成时延问题分析

内存泄漏：Snapshot分析

Snapshot模板基本操作

案例：ArkTS内存泄漏分析

基础内存：Allocation分析

内存分析介绍

内存分析数据筛选

启动时内存分析

案例：Native内存泄漏分析

UI组件内存：ComMemory分析

能耗诊断：Energy分析

加载丢帧：ArkWeb分析

网络诊断：Network分析

并行并发：Concurrency分析

GPU活动分析

基础耗时：Time分析

CPU活动分析

IO耗时：FileSystem分析

GPU帧捕获工具：Graphics Profiler抓帧入口

DevEco Profiler术语

发布应用

命令行工具

获取Command Line Tools

代码检查工具（codelinter）

ArkTSDoc文档生成工具（arktsdoc）

模拟器工具（Emulator）

命令行构建工具（hvigorw）

堆栈解析工具（hstack）

三方依赖管理工具（ohpm）

系统平台要求

oh-package.json5

ohpm prepublish

ohpm cache clean

ohpm dependency-check

ohpm config错误码

ohpm info错误码

ohpm install错误码

ohpm list错误码

ohpm publish错误码

ohpm uninstall错误码

ohpm unpublish错误码

ohpm update错误码

ohpm root错误码

ohpm version错误码

ohpm cache clean错误码

ohpm run错误码

ohpm ping错误码

ohpm clean错误码

ohpm dist-tags错误码

ohpm convert错误码

ohpm dependency-check错误码

ohpm命令公共错误码

搭建流水线

AI Coding

下载与安装

常用开发任务

使用AI智能辅助编程（不推荐）

编辑区代码生成

编辑区对话

万能卡片生成

单元测试用例生成

代码智能解读

编译报错智能分析

意图装饰器生成和小艺智能体创建

自定义智能体配置

自定义智能体（Agent）配置和调用

模型上下文协议（MCP）配置

模型（Model）配置

规则（Rules）配置

技能（Skills）配置

记忆（Memory）配置

自定义提示词库（Prompts）配置

自定义指令（Commands）配置

本地知识库配置

DevEco CLI

更新时间: 2026-08-29 09:41

意见反馈

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

意见反馈

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

社区提问智能客服提问

在工具 DevEco Studio 中进行搜索

仅搜索标题及章节标题

请输入您想要搜索的关键词