Skip to content

Create 2025-06-19-taro-ascf.md #308

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
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
91 changes: 91 additions & 0 deletions 2025-06-19-taro-ascf.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
&emsp;&emsp;<span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">元服务是</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">HarmonyOS</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">提供的一种免安装轻量应用,以鸿蒙系统为入口,为用户提供轻量、便捷、安全的服务体验。为助力开发者快速融入鸿蒙生态,元服务特别推出了面向小程序生态的解决方案</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">——ASCF</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">框架。该框架支持采用类似小程序的开发技术,实现元服务的高效开发。如今,</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">ASCF</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">框架迎来重大突破,正式支持从</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">Taro</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">代码进行转换,这一创新举措不仅为开发者带来了更便捷的开发路径,也进一步凸显了</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">ASCF</span><span style="color:rgba(0, 0, 0, 0.9);background-color:rgb(255, 255, 255)">在元服务开发领域的技术优势。</span>

![](https://clouddocs.huawei.com/api/file/doc/preview/eb8e8e9d-3f70-4536-a76f-0018b5682936?documentId=fc82c62b-4e16-438d-9d4f-7a01354dc818 "640.webp")

## What is ASCF?

[ASCF(Atomic Service Cross Framework)](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-overview)是元服务为小程序生态定制的一套解决方案,能够使用类似于小程序的开发技术,高效开发元服务。

![](https://clouddocs.huawei.com/api/file/doc/preview/9b818f50-0012-4ed2-bc67-1c90cfb5ca42?documentId=fc82c62b-4e16-438d-9d4f-7a01354dc818 "image.png")

<p style="text-align:start">ASCF框架提供了系统级的运行时能力,开发阶段编译调试的工具链。同时提供了转换工具将已有的小程序项目快速转换为ASCF框架的元服务项目。换句话说,可以认为ASCF框架实现了将元服务(类似于小程序)运行在HarmonyOS上,其生而可信,<span style="color:rgb(36, 39, 40);background-color:rgb(255, 255, 255)">纯净清爽的特性极大提高了用户体验。同时拥有</span><span style="color:rgb(36, 39, 40);background-color:rgb(255, 255, 255)">HarmonyOS</span><span style="color:rgb(36, 39, 40);background-color:rgb(255, 255, 255)">系统加持,能实现更强大功能。</span></p>

<p style="text-align:start"></p>

## 跨界融合,技术新生

<p style="text-align:unset">Taro,这个在开发者社区中备受赞誉的开放式跨端跨框架解决方案,自2018年开源以来,凭借其强大的功能与灵活性,在 GitHub 上斩获 36000 + Stars 耀眼成绩。其“一份代码,多端通用”的设计理念与ASCF框架的设计初衷不谋而合。双方一拍即合,期望为开发者提供更便捷高效的开发解决方案。如今,ASCF与Taro强强联手,双方共同助力为鸿蒙生态深度赋能。</p>

<p style="text-align:unset"></p>

## 更灵活便捷的开发方式

<p style="text-align:unset">ASCF支持灵活将Taro以ASCF方式编译的产物快速集成运行。Taro项目可以使用ASCF中的组件、API,这些兼容性都由ASCF框架与Taro共同保证。开发者仅需将Taro编译产物替换至ASCF指定文件夹,即可流畅运行。将开发者使用流程尽力缩短,也正是ASCF的这种便捷性与灵活性,为开发者提供了更多的选择空间,无论是全新的ASCF-Taro项目,还是基于鸿蒙原生组件的混合开发,都能轻松应对,极大地降低了开发成本,提高了开发效率。</p>

<p style="text-align:unset"></p>

## 开发流程

![](https://clouddocs.huawei.com/api/file/doc/preview/089241cc-82fd-48d2-8093-6fe91459a58f?documentId=fc82c62b-4e16-438d-9d4f-7a01354dc818 "image.png")

<p style="text-align:unset">Taro框架开发ASCF元服务,和其他小程序平台类似,需要将Taro源码编译输出为ASCF框架源码,通过鸿蒙开发工具 DevEco Studio最终编译生成元服务包,在设备上运行。</p>

<p style="text-align:unset"></p>

Taro工具链已支持通过[命令构建ASCF元服务](https://docs.taro.zone/docs/GETTING-STARTED#ascf%E5%85%83%E6%9C%8D%E5%8A%A1),可一键编译生成ASCF源码。

ASCF工具链已支持在DevEco Studio中开发、编译、调试,详情参考[ASCF元服务开发指南](https://developer.huawei.com/consumer/cn/doc/atomic-ascf/ascf-development-guide)。

<p style="text-align:unset"></p>

### <span style="color:var(--koo-color-text-5);background-color:var(--koo-color-background-edit-right)">项目要求</span>

### Taro版本

* taro3项目建议新建taro4项目
* taro4项目将taro相关依赖的版本修改为^4.0.12




### ASCF框架版本

|<b>组件</b>|<b>最低版本号</b>|<b>发布时间</b>|
|---|---|---|
|ASCF Plugin|1.0.4.200|2025/05/30|
|ASCF Toolkit|1.0.5|2025/05/30|
|ASCF Runtime|1.0.11|2025/06/11|

### 编译指导

<p style="text-align:unset"><span style="color:rgb(28, 30, 33)">若需将</span><span style="color:rgb(28, 30, 33)"> Taro </span><span style="color:rgb(28, 30, 33)">代码编译为</span><span style="color:rgb(28, 30, 33)"> ASCF </span><span style="color:rgb(28, 30, 33)">元服务,需在编译命令中指定平台参数为</span><span style="color:rgb(28, 30, 33)"> </span><code>ascf</code><span style="color:rgb(28, 30, 33)">,并确保满足以下条件:</span></p>

* 代码中需包含 ASCF 元服务编译条件:<code>"ascf"</code>(需在项目配置中声明)。
* 配置文件 <code>project.ascf.json</code> 需存在于项目根目录。




<p style="text-align:unset"></p>

<p style="text-align:unset">示例命令参考Taro文档-ASCF元服务章节:</p>

[docs.taro.zone](https://docs.taro.zone/docs/GETTING-STARTED#ascf%E5%85%83%E6%9C%8D%E5%8A%A1)

<p style="text-align:unset"></p>

<p style="text-align:unset">优秀案例</p>

<p style="text-align:unset">当前基于ASCF-Taro的精品元服务如哈啰租车,服务商-二维火等正在积极开发,冲刺上架中,也欢迎越来越多的存量Taro小程序开发者体验ASCF-Taro的便捷,快速构建相应的鸿蒙元服务。</p>

![](https://clouddocs.huawei.com/api/file/doc/preview/75899a8b-e4f2-47c5-87b8-9c383f161cdf?documentId=fc82c62b-4e16-438d-9d4f-7a01354dc818 "%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20250617165037.png") ![](https://clouddocs.huawei.com/api/file/doc/preview/c26ce129-43b6-4040-a73d-e0d288ae9c6c?documentId=fc82c62b-4e16-438d-9d4f-7a01354dc818 "%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20250617104421.jpg") ![](https://clouddocs.huawei.com/api/file/doc/preview/9bf41594-b96c-41cf-a87a-e616df57c781?documentId=fc82c62b-4e16-438d-9d4f-7a01354dc818 "%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20250617104440.jpg")

<p style="text-align:unset"> <b>哈啰租车</b> <b>二维火点餐</b></p>

## 总结与展望

ASCF框架为众多小程序开发者提供了高效、便捷的元服务开发路径,通过与Taro的深度集成,ASCF-Taro框架不仅拓宽了元服务的开发方式,更让开发者能够快速融入鸿蒙生态,提供了小程序转元服务的便捷方式;同时,ASCF-Taro支持开发者高效复用现有项目资产,大幅减少重复开发成本,显著提升开发效率。

面向未来,ASCF-Taro将持续进化,致力于构建更易用、更高效的开发框架。不断扩展功能边界,深入探索更多技术场景,以满足开发者日益增长的多样化需求。在推动HarmonyOS生态繁荣的道路上,ASCF与Taro将继续携手共进,为开发者提供更便捷的开发体验,为用户呈现更优质、多元的服务。

我们诚挚邀请每一位开发者加入ASCF-Taro生态。您的每一次使用、每一条建议,都是推动框架不断完善的动力,让我们共同书写鸿蒙元服务的新篇章。
Loading