From 7f41ffd781111fbdd85dbdb07a85cdbb20b164f0 Mon Sep 17 00:00:00 2001 From: pragmatic_jiang Date: Fri, 15 Aug 2025 13:48:59 +0800 Subject: [PATCH 1/2] Update GETTING-STARTED.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit fix 元服务文档不准确问题 --- docs/GETTING-STARTED.md | 21 +++------------------ 1 file changed, 3 insertions(+), 18 deletions(-) diff --git a/docs/GETTING-STARTED.md b/docs/GETTING-STARTED.md index b39bda90a772..95ce09acab99 100644 --- a/docs/GETTING-STARTED.md +++ b/docs/GETTING-STARTED.md @@ -757,7 +757,6 @@ $ npx taro build --type harmony-hybrid 若需将 Taro 代码编译为 ASCF 元服务，需在编译命令中指定平台参数为 `ascf`，并确保满足以下条件： - 代码中需包含 ASCF 元服务编译条件：`"ascf"`（需在项目配置中声明）。 -- 配置文件 `project.ascf.json` 需存在于项目根目录。 示例命令： ```bash @@ -799,16 +798,6 @@ $ NODE_ENV=production taro build --type ascf --watch # Bash 导入项目： 打开鸿蒙开发者工具，选择 导入项目。 选择项目根目录下的 dist/ascf 目录（需确保已通过编译命令生成）。 -配置校验： -确认项目中存在 project.ascf.json 文件（元服务专属配置）。 -检查配置文件字段是否符合规范（如 minPlatformVersion、permissions 等）。 -注意事项 - -在开发者工具中需设置： - -关闭 ES6 转 ES5 功能（开启可能导致语法错误）。 -关闭 上传代码时样式自动补全（开启可能引发样式异常）。 -关闭 代码压缩上传（开启可能影响调试信息）。 格式说明 @@ -817,19 +806,15 @@ $ NODE_ENV=production taro build --type ascf --watch # Bash 支持 dev:ascf（开发模式）和 build:ascf（生产模式）。 开发者工具： 明确指向编译后的 dist/ascf 目录，与微信小程序的 dist 目录逻辑一致。 -强调 project.ascf.json 为必需配置文件（类比 project.swan.json）。 -注意事项： -与其他小程序保持完全一致的关闭选项，避免开发者混淆。 效果验证 执行编译命令后，检查 dist/ascf 目录是否包含以下文件： -manifest.json（元服务描述文件） +app.json（元服务描述文件） 页面代码及资源文件 -在鸿蒙开发者工具中运行项目，确保： -页面渲染正常，无白屏或报错。 -声明的权限（如定位、相机）可正常触发弹窗申请。 +参考鸿蒙元服务ASCF项目[开发环境搭建指南](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-development-process) 搭建好环境后，创建ASCF元服务项目，将dist/ascf替换ascf/ascf_src目录内容，然后调试运行。 +如果运行有异常，可以参考[调试指南](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/debug-ascf-code)解决。 ## 渐进式入门教程 From b3f7bad425a06682bd74341a11bec54530ebdc62 Mon Sep 17 00:00:00 2001 From: pragmatic_jiang Date: Fri, 15 Aug 2025 14:08:17 +0800 Subject: [PATCH 2/2] Update GETTING-STARTED.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit fix 元服务的文档不准确问题 --- docs/GETTING-STARTED.md | 21 ++++++--------------- 1 file changed, 6 insertions(+), 15 deletions(-) diff --git a/docs/GETTING-STARTED.md b/docs/GETTING-STARTED.md index 95ce09acab99..055a51836c81 100644 --- a/docs/GETTING-STARTED.md +++ b/docs/GETTING-STARTED.md @@ -794,27 +794,18 @@ $ NODE_ENV=production taro build --type ascf --watch # Bash 开发者工具 工具准备： -下载并安装 鸿蒙开发者工具，确保已配置ASCF元服务开发环境。 -导入项目： -打开鸿蒙开发者工具，选择 导入项目。 -选择项目根目录下的 dist/ascf 目录（需确保已通过编译命令生成）。 +下载并安装 鸿蒙元服务ASCF项目[开发环境搭建指南](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-development-process)，确保已配置ASCF元服务开发环境。 -格式说明 +在taro项目根目录下创建ascf-project目录，并使用工具在该目录下创建ASCF元服务项目。 + +修改taro项目下config/index.{js,ts}配置文件，编译ASCF项目情况下将 outputRoot: 'dist/ascf' 修改为 outputRoot: process.env.TARO_ENV === 'ascf' ? 'ascf-project/ascf/ascf_src' : 'dist', 编译命令： 使用 --type ascf 指定平台类型，与其他小程序（如 --type weapp）格式统一。 支持 dev:ascf（开发模式）和 build:ascf（生产模式）。 -开发者工具： -明确指向编译后的 dist/ascf 目录，与微信小程序的 dist 目录逻辑一致。 - -效果验证 - -执行编译命令后，检查 dist/ascf 目录是否包含以下文件： -app.json（元服务描述文件） -页面代码及资源文件 -参考鸿蒙元服务ASCF项目[开发环境搭建指南](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-development-process) 搭建好环境后，创建ASCF元服务项目，将dist/ascf替换ascf/ascf_src目录内容，然后调试运行。 -如果运行有异常，可以参考[调试指南](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/debug-ascf-code)解决。 +调试运行： +编译后文件在ascf-project/ascf/ascf_src目录下。参考鸿蒙元服务ASCF项目[开发流程](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-development-process) 调试运行ascf-project项目。如果运行有异常，可以参考[调试指南](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/debug-ascf-code)解决。 ## 渐进式入门教程