Merge pull request #322 from 2extliuweijian32/feat/ascf

docs:更新ascf资料

Author: 2extliuweijian32

docs/README.mdx

@@ -11,7 +11,7 @@ import News from './news'
 
 ## 简介
 
-**Taro** 是一个开放式跨端跨框架解决方案，支持使用 React/Vue/Nerv 等框架来开发 [微信](https://mp.weixin.qq.com/) / [京东](https://mp.jd.com/?entrance=taro) / [百度](https://smartprogram.baidu.com/) / [支付宝](https://mini.open.alipay.com/) / [字节跳动](https://developer.open-douyin.com/) / [QQ](https://q.qq.com/) / [飞书](https://open.feishu.cn/document/uYjL24iN/ucDOzYjL3gzM24yN4MjN) / [快手](https://mp.kuaishou.com/) 小程序 / H5 / RN 等应用。
+**Taro** 是一个开放式跨端跨框架解决方案，支持使用 React/Vue/Nerv 等框架来开发 [微信](https://mp.weixin.qq.com/) / [京东](https://mp.jd.com/?entrance=taro) / [百度](https://smartprogram.baidu.com/) / [支付宝](https://mini.open.alipay.com/) / [字节跳动](https://developer.open-douyin.com/) / [QQ](https://q.qq.com/) / [飞书](https://open.feishu.cn/document/uYjL24iN/ucDOzYjL3gzM24yN4MjN) / [快手](https://mp.kuaishou.com/) 小程序 / H5 / RN / [ASCF元服务](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-overview) 等应用。
 
 现如今市面上端的形态多种多样，Web、React Native、微信小程序等各种端大行其道。当业务要求同时在不同的端都要求有所表现的时候，针对不同的端去编写多套代码的成本显然非常高，这时候只编写一套代码就能够适配到多端的能力就显得极为需要。
 
@@ -36,6 +36,7 @@ Taro 3 可以支持转换到 H5、ReactNative 以及任意小程序平台。
 - [<img title="支付宝 IOT 小程序" src={require('@site/static/img/platform/alipay.png').default} className="icon_platform" width="25px" /> 支付宝 IOT 小程序](https://opendocs.alipay.com/iot/multi-platform/vcs0fv?from=taro)
 - [<img title="飞书小程序" src={require('@site/static/img/platform/lark.png').default} className="icon_platform" width="25px" /> 飞书小程序](https://open.feishu.cn/document/uYjL24iN/uMjNzUjLzYzM14yM2MTN?from=taro)
 - [<img title="快手小程序" src={require('@site/static/img/platform/kuaishou.png').default} className="icon_platform" width="25px" /> 快手小程序](https://mp.kuaishou.com/docs/develop/frame/config/conf_appjson.html?from=taro)
+- [<img title="ASCF元服务" src={require('@site/static/img/platform/ascf.png').default} className="icon_platform" width="25px" /> ASCF元服务](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-overview)
 
 ### 框架支持
 

docs/project-config.md

@@ -11,7 +11,7 @@ title: 项目配置
 - 支付宝小程序，[mini.project.json](https://opendocs.alipay.com/mini/framework/project)
 - 京东小程序，暂无发现
 - 飞书小程序，[project.config.json](https://open.feishu.cn/document/uYjL24iN/uEzMzUjLxMzM14SMzMTN/gadget-project-configuration?from=taro)
-- ASCF元服务，[project.config.json](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/project-json-config)
+- ASCF元服务，[ascf.config.json](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/project-json-config)
 
 为了能够适配不同小程序平台的配置文件不同的情况，Taro 支持为各个小程序平台添加各自的项目配置文件。
 

static/img/platform/ascf.png

@@ -705,6 +705,64 @@ $ npx taro build --type harmony-hybrid
 
 - 把 Taro 项目目录下的 `dist` 目录的编译产物复制到鸿蒙应用的 `src/main/resources/rawfile` 目录下，编译运行鸿蒙应用进行开发调试。
 
+### ASCF 元服务
+
+> Taro v3.6.38+ 开始支持
+
+若需将 Taro 代码编译为 ASCF 元服务，需在编译命令中指定平台参数为 `ascf`，并确保满足以下条件：
+
+- 代码中需包含 ASCF 元服务编译条件：`"ascf"`（需在项目配置中声明）。
+
+示例命令：
+
+```bash
+taro build --type ascf
+
+#### 编译命令
+
+# pnpm
+$ pnpm dev:ascf
+$ pnpm build:ascf
+
+# yarn
+$ yarn dev:ascf
+$ yarn build:ascf
+
+# npm script
+$ npm run dev:ascf
+$ npm run build:ascf
+
+# 仅限全局安装
+$ taro build --type ascf --watch
+$ taro build --type ascf
+
+# npx 用户也可以使用
+$ npx taro build --type ascf --watch
+$ npx taro build --type ascf
+
+# watch 同时开启压缩
+$ set NODE_ENV=production && taro build --type ascf --watch # CMD
+$ NODE_ENV=production taro build --type ascf --watch # Bash
+
+
+```
+
+开发者工具
+
+工具准备：
+下载并安装 鸿蒙元服务 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（生产模式）。
+
+调试运行：
+编译后文件在 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)解决。
+
 ## 渐进式入门教程
 
 我们提供了一个由浅入深的实战教程，请参考[《教程》](./guide)。

versioned_docs/version-3.x/GETTING-STARTED.md

@@ -11,7 +11,7 @@ import News from './news'
 
 ## 简介
 
-**Taro** 是一个开放式跨端跨框架解决方案，支持使用 React/Vue/Nerv 等框架来开发 [微信](https://mp.weixin.qq.com/) / [京东](https://mp.jd.com/?entrance=taro) / [百度](https://smartprogram.baidu.com/) / [支付宝](https://mini.open.alipay.com/) / [字节跳动](https://developer.open-douyin.com/) / [QQ](https://q.qq.com/) / [飞书](https://open.feishu.cn/document/uYjL24iN/ucDOzYjL3gzM24yN4MjN) / [快手](https://mp.kuaishou.com/) 小程序 / H5 / RN 等应用。
+**Taro** 是一个开放式跨端跨框架解决方案，支持使用 React/Vue/Nerv 等框架来开发 [微信](https://mp.weixin.qq.com/) / [京东](https://mp.jd.com/?entrance=taro) / [百度](https://smartprogram.baidu.com/) / [支付宝](https://mini.open.alipay.com/) / [字节跳动](https://developer.open-douyin.com/) / [QQ](https://q.qq.com/) / [飞书](https://open.feishu.cn/document/uYjL24iN/ucDOzYjL3gzM24yN4MjN) / [快手](https://mp.kuaishou.com/) 小程序 / H5 / RN / [ASCF元服务](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-overview) 等应用。
 
 现如今市面上端的形态多种多样，Web、React Native、微信小程序等各种端大行其道。当业务要求同时在不同的端都要求有所表现的时候，针对不同的端去编写多套代码的成本显然非常高，这时候只编写一套代码就能够适配到多端的能力就显得极为需要。
 
@@ -36,6 +36,7 @@ Taro 3 可以支持转换到 H5、ReactNative 以及任意小程序平台。
 - [<img title="支付宝 IOT 小程序" src={require('@site/static/img/platform/alipay.png').default} className="icon_platform" width="25px" /> 支付宝 IOT 小程序](https://opendocs.alipay.com/iot/multi-platform/vcs0fv?from=taro)
 - [<img title="飞书小程序" src={require('@site/static/img/platform/lark.png').default} className="icon_platform" width="25px" /> 飞书小程序](https://open.feishu.cn/document/uYjL24iN/uMjNzUjLzYzM14yM2MTN?from=taro)
 - [<img title="快手小程序" src={require('@site/static/img/platform/kuaishou.png').default} className="icon_platform" width="25px" /> 快手小程序](https://mp.kuaishou.com/docs/develop/frame/config/conf_appjson.html?from=taro)
+- [<img title="ASCF元服务" src={require('@site/static/img/platform/ascf.png').default} className="icon_platform" width="25px" /> ASCF元服务](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-overview)
 
 ### 框架支持
 

versioned_docs/version-3.x/README.mdx

@@ -658,3 +658,34 @@ export default {
   animation: false,
 }
 ```
+
+## ASCF 元服务支持的属性
+
+### ASCF 支持的全局参数
+
+这些配置需在项目的入口配置文件（如 app.config.js）中声明，以实现对 ASCF 元服务的适配。
+
+| 属性        | 类型    | 必填 | 默认值 | 说明                                                                          |
+| :---------- | :------ | :--- | :----- | :---------------------------------------------------------------------------- |
+| ascfAppId   | String  | 是   | 无     | ASCF 元服务的唯一应用标识，需在 ASCF 开发者平台申请后填写。                   |
+| serviceType | String  | 是   | 无     | 元服务类型，可选值：miniprogram（小程序式元服务）、webapp（轻应用式元服务）。 |
+| enableAuth  | Boolean | 否   | false  | 是否开启 ASCF 的全局用户鉴权功能，需配合 ASCF 的 API 使用。                   |
+| apiBaseUrl  | String  | 否   | 无     | ASCF 后端 API 的统一请求地址，用于元服务与服务器的通信。                      |
+
+#### 代码示例
+
+```js title="app.config.js"
+export default {
+  pages: ['pages/index/index'],
+  window: {
+    navigationBarTitleText: 'Taro Demo',
+  },
+
+  ascf: {
+    ascfAppId: 'ASCF_123456',
+    serviceType: 'miniprogram',
+    enableAuth: true,
+    apiBaseUrl: 'https://api.ascf.com',
+  },
+}
+```

versioned_docs/version-3.x/app-config.md

@@ -12,7 +12,7 @@ Taro 在编译时提供了一些内置的环境变量来帮助用户做一些特
 
 用于判断当前的编译平台类型。
 
-取值：`weapp` / `swan` / `alipay` / `tt` / `qq` / `jd` / `h5` / `rn`
+取值：`weapp` / `swan` / `alipay` / `tt` / `qq` / `jd` / `h5` / `rn` / `ascf`
 
 可以通过这个变量来区分不同环境，从而使用不同的逻辑。在编译阶段，**会移除不属于当前编译类型的代码，只保留当前编译类型下的代码**，例如：
 

versioned_docs/version-3.x/envs.md

@@ -103,23 +103,23 @@ export default function Index() {}
 
 ### 各端支持程度
 
-| 属性                         | 微信小程序                         | 百度小程序                 | 抖音小程序 | 支付宝小程序 | H5  | RN  |
-| ---------------------------- | ---------------------------------- | -------------------------- | -------------- | ------------ | --- | --- |
-| navigationBarBackgroundColor | ✔️                                 | ✔️                         | ✔️             | ✔️           | ✔️  | ✔️  |
-| navigationBarTextStyle       | ✔️                                 | ✔️                         | ✔️             | ✘            | ✔️  | ✔️  |
-| navigationBarTitleText       | ✔️                                 | ✔️                         | ✔️             | ✔️           | ✔️  | ✔️  |
-| navigationStyle              | ✔️（微信客户端 6.6.0）               | ✔️（百度 App 版本 11.1.0）   | ✔️             | ✘            | ✘   | ✔️  |
-| transparentTitle             | -                                  | -                          | -              | ✔️           | -   | -   |
-| backgroundColor              | ✔️                                 | ✔️                         | ✔️             | ✘            | ✘   | ✔️  |
-| backgroundTextStyle          | ✔️                                 | ✔️                         | ✔️             | ✘            | ✘   | ✔️  |
-| backgroundColorTop           | ✔️（微信客户端 6.5.16）              | ✘                          | ✔️             | ✘            | ✘   | ✘   |
-| backgroundColorBottom        | ✔️（微信客户端 6.5.16）              | ✘                          | ✔️             | ✘            | ✘   | ✘   |
-| enablePullDownRefresh        | ✔️                                 | ✔️                          | ✔️              | ✔️            | ✘   | ✘   |
-| onReachBottomDistance        | ✔️                                 | ✔️                          | ✔️              | ✘            | ✘   | ✘   |
-| pageOrientation              | ✔️2.4.0 (auto) / 2.5.0 (landscape) | ✘                          | ✘              | ✘            | ✘   | ✘   |
-| disableScroll                | ✔️                                 | ✘                          | ✘              | ✘            | ✘   | ✔️   |
-| disableSwipeBack             | ✔️                                 | ✘                          | ✘              | ✘            | ✘   | ✘   |
-| enableShareAppMessage        | ✔️                                 | ✘                          | ✘              | ✘            | ✔️   | ✘   |
-| enableShareTimeline          | ✔️                                 | ✘                          | ✘              | ✘            | ✔️   | ✘   |
-| usingComponents              | ✔️                                 | ✔️                          | ✔️              | ✔️            | ✘   | ✘   |
-| renderer                     | ✔️                                 | ✘                          | ✘              | ✘            | ✘   | ✘   |
+| 属性                         | 微信小程序                         | 百度小程序                 | 抖音小程序 | 支付宝小程序 | H5  | RN  |  ASCF |
+| ---------------------------- | ---------------------------------- | -------------------------- | -------------- | ------------ | --- | --- | --- |
+| navigationBarBackgroundColor | ✔️                                 | ✔️                         | ✔️             | ✔️           | ✔️  | ✔️  | ✔️  | 
+| navigationBarTextStyle       | ✔️                                 | ✔️                         | ✔️             | ✘            | ✔️  | ✔️  | ✔️  |
+| navigationBarTitleText       | ✔️                                 | ✔️                         | ✔️             | ✔️           | ✔️  | ✔️  | ✔️  |
+| navigationStyle              | ✔️（微信客户端 6.6.0）               | ✔️（百度 App 版本 11.1.0）   | ✔️             | ✘            | ✘   | ✔️  | ✔️  |
+| transparentTitle             | -                                  | -                          | -              | ✔️           | -   | -   | ✘   |
+| backgroundColor              | ✔️                                 | ✔️                         | ✔️             | ✘            | ✘   | ✔️  | ✔️  |
+| backgroundTextStyle          | ✔️                                 | ✔️                         | ✔️             | ✘            | ✘   | ✔️  | ✘   |
+| backgroundColorTop           | ✔️（微信客户端 6.5.16）              | ✘                          | ✔️             | ✘            | ✘   | ✘   | ✘   |
+| backgroundColorBottom        | ✔️（微信客户端 6.5.16）              | ✘                          | ✔️             | ✘            | ✘   | ✘   | ✘   |
+| enablePullDownRefresh        | ✔️                                 | ✔️                          | ✔️              | ✔️            | ✘   | ✘   | ✔️  |
+| onReachBottomDistance        | ✔️                                 | ✔️                          | ✔️              | ✘            | ✘   | ✘   | ✘   |
+| pageOrientation              | ✔️2.4.0 (auto) / 2.5.0 (landscape) | ✘                          | ✘              | ✘            | ✘   | ✘   | ✘   |
+| disableScroll                | ✔️                                 | ✘                          | ✘              | ✘            | ✘   | ✔️   | ✘   |
+| disableSwipeBack             | ✔️                                 | ✘                          | ✘              | ✘            | ✘   | ✘   | ✘   |
+| enableShareAppMessage        | ✔️                                 | ✘                          | ✘              | ✘            | ✔️   | ✘   | ✘   |
+| enableShareTimeline          | ✔️                                 | ✘                          | ✘              | ✘            | ✔️   | ✘   | ✘   |
+| usingComponents              | ✔️                                 | ✔️                          | ✔️              | ✔️            | ✘   | ✘   | ✔️  |
+| renderer                     | ✔️                                 | ✘                          | ✘              | ✘            | ✘   | ✘   | ✘   |

versioned_docs/version-3.x/page-config.mdx

@@ -11,6 +11,7 @@ title: 项目配置
 - 支付宝小程序，[mini.project.json](https://opendocs.alipay.com/mini/framework/project)
 - 京东小程序，暂无发现
 - 飞书小程序，[project.config.json](https://open.feishu.cn/document/uYjL24iN/uEzMzUjLxMzM14SMzMTN/gadget-project-configuration?from=taro)
+- ASCF元服务，[ascf.config.json](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/project-json-config)
 
 为了能够适配不同小程序平台的配置文件不同的情况，Taro 支持为各个小程序平台添加各自的项目配置文件。
 
@@ -24,6 +25,7 @@ title: 项目配置
 | QQ 小程序    | project.qq.json     |
 | 支付宝小程序 | project.alipay.json |
 | 飞书小程序   | project.lark.json   |
+| ASCF元服务  | ascf.config.json    |
 
 :::caution 注意
 飞书小程序从[插件](https://www.npmjs.com/package/@tarojs/plugin-platform-lark)1.0.2 版本开始，配置文件修改为`project.lark.json`，之前版本为`project.tt.json`。