Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
75 changes: 75 additions & 0 deletions docs/GETTING-STARTED.md
Original file line number Diff line number Diff line change
Expand Up @@ -753,6 +753,81 @@ $ npx taro build --type harmony-hybrid

- 把 Taro 项目目录下的 `dist` 目录的编译产物复制到鸿蒙应用的 `src/main/resources/rawfile` 目录下,编译运行鸿蒙应用进行开发调试。

### ASCF元服务

若需将 Taro 代码编译为 ASCF 元服务,需在编译命令中指定平台参数为 `ascf`,并确保满足以下条件:
- 代码中需包含 ASCF 元服务编译条件:`"ascf"`(需在项目配置中声明)。
- 配置文件 `project.ascf.json` 需存在于项目根目录。

示例命令:
```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元服务开发环境。
导入项目:
打开鸿蒙开发者工具,选择 导入项目。
选择项目根目录下的 dist/ascf 目录(需确保已通过编译命令生成)。
配置校验:
确认项目中存在 project.ascf.json 文件(元服务专属配置)。
检查配置文件字段是否符合规范(如 minPlatformVersion、permissions 等)。
注意事项

在开发者工具中需设置:

关闭 ES6 转 ES5 功能(开启可能导致语法错误)。
关闭 上传代码时样式自动补全(开启可能引发样式异常)。
关闭 代码压缩上传(开启可能影响调试信息)。

格式说明

编译命令:
使用 --type ascf 指定平台类型,与其他小程序(如 --type weapp)格式统一。
支持 dev:ascf(开发模式)和 build:ascf(生产模式)。
开发者工具:
明确指向编译后的 dist/ascf 目录,与微信小程序的 dist 目录逻辑一致。
强调 project.ascf.json 为必需配置文件(类比 project.swan.json)。
注意事项:
与其他小程序保持完全一致的关闭选项,避免开发者混淆。

效果验证

执行编译命令后,检查 dist/ascf 目录是否包含以下文件:
manifest.json(元服务描述文件)
页面代码及资源文件
在鸿蒙开发者工具中运行项目,确保:
页面渲染正常,无白屏或报错。
声明的权限(如定位、相机)可正常触发弹窗申请。


## 渐进式入门教程

我们提供了一个由浅入深的实战教程,请参考[《教程》](./guide)。
Expand Down