智能客服
你问我答，随时在线为你解决问题
当开发者使用hvigor插件参数或者命令行参数控制编译行为与项目配置文件相冲突时，将会按照参数优先级覆写。
参数优先级为：用户自定义(hvigor插件参数或者命令行参数) > 个人配置文件(ascf.private.config.json) > 配置文件(ascf.config.json) > ascf系统默认。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
项目json配置
通过项目配置文件可以配置编译行为，方便开发者使用编译工具。
注意
依赖关系：ASCF Toolkit版本≥1.0.4
可以在项目根目录下新建ascf.config.json和ascf.private.config.json文件对项目进行配置。
可以在ascf.config.json 文件中配置公共的配置，在ascf.private.config.json配置个人的配置，可以将ascf.private.config.json写到.gitignore避免版本管理的冲突。
| 属性 | 类型 | 描述 |
|---|---|---|
| packOptions | Object | 打包配置选项。 |
| swc | boolean | 默认使用babel编译，开启后使用swc编译，提升编译构建性能。 依赖关系：ASCF Toolkit版本≥1.0.9 |
| templateHoist | boolean | 类Taro框架（采用了base.hxml模板技术）情况下设置为true，可减少重复的编译代码，减少包体积。 依赖关系：ASCF Toolkit版本≥1.0.9 |
| disableSubpackages | boolean | 在debug编译的情况下，将分包合并到主包以提升构建性能。 依赖关系：ASCF Toolkit版本≥1.0.9 |
| skipApiValidator | boolean | 跳过接口与组件的支持性校验，提升编译性能。 依赖关系：ASCF Toolkit版本≥1.0.9 |
| logging | string | 控制日志打印最低级别，level从低到高为： - debug：调试 - info：信息 - warn：警告 - error：错误 默认值：info。 依赖关系：ASCF Toolkit版本≥1.0.9 |
| devtool | string | 自定义Source Map的生成行为。type取值为Source Map的生成方式。 默认值：eval-cheap-source-map 依赖关系：ASCF Toolkit版本≥1.0.9 |
| cache | boolean | Object | 支持false关闭，默认开启。参考webpack的cache配置。 依赖关系：ASCF Toolkit版本≥1.0.9 |
| ascfDebugger | string | 配置为brk，会开启首行断点。 依赖关系：ASCF Toolkit版本≥1.0.9 |
| externalSwcHelpers | boolean | @swc/helpers的external模式纠错构建路径。仅swc功能异常情况下配置false关闭。 依赖关系：ASCF Toolkit版本≥1.0.9 |
| compileMode | string | 配置编译运行的项目类型。可选值 ascf、wx，默认值ascf。 依赖关系：ASCF Toolkit版本≥1.0.16 |
| emptyJsonpName | Array | 当存在多个Taro包并开启热更新时需要配置为对应Taro包中Webpack配置的output.jsonpFunction。 依赖关系：ASCF Toolkit版本≥1.0.16 |
| enableDevtools | boolean | 是否开启ASCF Console调试工具，可根据项目实际情况，控制在不同环境下是否开启。默认关闭 依赖关系：ASCF Toolkit版本≥1.0.17 |
| launchOptions | Object | 元服务启动参数。仅ascf.private.config.json配置有效。 依赖关系：ASCF Toolkit版本≥1.0.17 |
| experimental | Object | 实验性功能配置。 依赖关系：ASCF Toolkit版本≥1.0.9 |
packOptions
可以使用packOptions.ignore字段，对指定的文件或者文件夹跳过编译打包，这些文件或文件夹将不会出现在编译产物中。
| 属性 | 类型 | 描述 |
|---|---|---|
| value | string | 路径或排除规则。 |
| type | string | 排除的类型，可选值有： - folder：文件夹 - file：文件 - suffix：后缀 - prefix：前缀 - regexp：正则表达式 - glob：Glob规则 |
示例：
- {
- "packOptions": {
- "ignore": [
- {
- "type": "file",
- "value": "test/test.js"
- },
- {
- "type": "folder",
- "value": "test"
- },
- {
- "type": "suffix",
- "value": ".png"
- },
- {
- "type": "prefix",
- "value": "sub-"
- },
- {
- "type": "glob",
- "value": "test/*.js"
- },
- {
- "type": "regexp",
- "value": "^sub.*\\.js$"
- }
- ]
- }
- }
说明
为了确保运行正常，packOptions.ignore字段对app.json中配置的页面以及使用到的组件不生效。
launchOptions
元服务启动参数。
| 属性 | 类型 | 描述 |
|---|---|---|
| path | string | 启动元服务页面的路径 (代码包路径) |
| query | object | 启动参数，如：{"name": "vendor"} |
experimental
实验性特性。可以通过配置实验性特性，允许开发者开启和尝试实验性功能。
注意
ASCF Toolkit可能会对实验性功能做一些调整，并在更新日志中对这些变动进行详细的说明。因此，如果你使用了实验性特性，请留意 ASCF Toolkit 版本的更新日志。
| 属性 | 类型 | 描述 |
|---|---|---|
| cacheBaseHxml | boolean | 对于templateHoist为true情况下会默认开启base.hxml构建缓存。异常情况下可以配置false关闭缓存。 |
在 ASCF框架 中进行搜索
请输入您想要搜索的关键词