简体中文

输入关键字搜索

开发者能力认证

鸿蒙高校创新赛

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）配置

本地知识库配置

日志收集和诊断数据

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

复制页面

若开发过程中遇到DevEco Studio卡顿、卡死或其他故障时，可通过如下两种方式回传日志信息，帮助DevEco Studio提升稳定性体验。

说明

该功能仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）。

方式一

可点击DevEco Studio Error问题弹窗中的Send Report，点击OK后向DevEco Studio回传日志信息。

方式二

开发者需要开启数据采集功能，请在File > Settings（macOS为DevEco Studio > Preferences/Settings）> Appearance & Behavior > System Settings > Data Sharing设置界面，勾选Send usage statistics。
回传DevEco Studio日志信息。
- 26.0.0及以上版本
  1. 点击菜单栏Help > Collect Logs and Diagnostic Data或点击工具窗口右侧的Feedback按钮。
  2. 在Problem Description中填写问题描述，点击Add可上传图片或视频文件，点击View Details查看和选择要上传的.log文件。若需上传日志文件，请勾选Upload DevEco Studio Logs。点击Submit，向DevEco Studio回传日志信息。
    
    说明
    附件和日志文件最大支持上传500MB的文件，且附件仅支持上传图片或视频文件。
- 26.0.0以下版本
  1. 点击菜单栏Help > Collect Logs and Diagnostic Data。
  2. 选择.log文件后，点击OK向DevEco Studio回传日志信息。

关闭数据采集

OHPM版本号规则

意见反馈

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

意见反馈

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

社区提问智能客服提问