# 获取ASCF开发工具

## 在DevEco Studio中使用

### 获取方式

1. 单击[链接下载](https://developer.huawei.com/consumer/cn/download/)，下载ASCF Plugin。

2. 在DevEco Studio中，手动安装插件。

   在DevEco Studio顶部菜单栏中选择"**File** > **Setting** "。在打开的设置框中，选择"**Plugins** "。在"**Plugins** "页签中，点击"顶部的齿轮![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f/v3/25dmK6O3QUC93BF3SF9atw/zh-cn_image_0000002800577521.png?HW-CC-KV=V1&HW-CC-Date=20261026T033630Z&HW-CC-Expire=31536000000&HW-CC-Sign=474F946C09A8C35CC48C235F1AC6F3E2B6FB7C422E335D568DAACE1465A2A44D) > **Install Plugin from Disk...** "，将插件手动安装到DevEco Studio中。
   > 注意
   >
   > 请直接安装下载的zip文件，不要解压后安装。MacOS用户如果使用Safari浏览器下载，请关闭自动解压缩功能。

ASCF框架版本发布的新增特性及变更说明请查阅[版本变更说明](https://developer.huawei.com/consumer/cn/doc/doccenter-atomic-service/release-note-ascf-runtime)。

### 自动升级ASCF Plugin

ASCF Plugin新版本发布后，支持自动检查版本并提示升级，请确保能够正常访问互联网。

### 升级已有项目的ASCF运行时版本

修改entry/oh-package.json5中的"@atomicservice/ascfapi": "^1.0.0"为最新的已发布ohpm中的@atomicservice/ascfapi版本。

### 升级已有项目的ASCF Toolkit版本

**场景1**：当前为1.0.1版本，升级到1.0.2版本：

请手动修改hvigor/hvigor-config.json5的dependencies设置为"@atomicservice/ascf-toolkit-hvigor-plugin": "~1.0.2"。

**场景2**：在beta版本阶段，当前为1.0.1版本，升级到1.0.1-beta.1版本：

请手动修改hvigor/hvigor-config.json5的dependencies设置为"@atomicservice/ascf-toolkit-hvigor-plugin": "~1.0.1-beta.1"。

## 在VS Code中使用

### 获取方式

在VSCode中，点击"扩展"，在应用商店搜索"ASCF Assistant"并选择安装。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/eb/v3/JawaqjOaQYK-kTq4lilhgw/zh-cn_image_0000002771257698.png?HW-CC-KV=V1&HW-CC-Date=20261026T033630Z&HW-CC-Expire=31536000000&HW-CC-Sign=1FAA335200695F72B1D812C5A07D68733EB6677DE4F4735EDEA55819B3D70C37)

在侧边栏出现元服务图标![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/97/v3/3IO7kB6vRV-uXVU4MCmDkw/zh-cn_image_0000002771097734.png?HW-CC-KV=V1&HW-CC-Date=20261026T033630Z&HW-CC-Expire=31536000000&HW-CC-Sign=A0FB419744CEE11C5AA81F2EF8B3F611243B5049C00CA1371F6EE4B70FF748E5)即安装成功。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/92/v3/iMGKqPB3R-GMnbGiHJjdJQ/zh-cn_image_0000002800417599.png?HW-CC-KV=V1&HW-CC-Date=20261026T033630Z&HW-CC-Expire=31536000000&HW-CC-Sign=AD7B8BA5E1332A61AB9641E99AAEDFF60B6F2D5F46DE7B43AF59DBFB36BAAB1C)

### 支持的设备

|平台|OS版本|SDK版本|ASCF工具链版本|快应用加载器版本|
|:--------|:---------------|:--------------------|:--------|:--------|
|HarmonyOS|HarmonyOS 4及以下|HMSCore 6.11.0.300及以上|1.0.15及以上|16.0.1及以上|
|HarmonyOS|HarmonyOS 5.0及以上|ASCF 1.0.0及以上|1.0.0及以上|不涉及|

在HarmonyOS 4及以下设备中需要使用快应用加载器调试运行。使用ASCF开发助手运行会自动安装快应用加载器，也可以[手动下载快应用加载器](https://developer.huawei.com/consumer/cn/doc/doccenter-atomic-service/faqs-quickapp-loader-manual-installation)安装。

使用华为快应用加载器调试快应用的方法参见[华为快应用加载器使用指导](https://developer.huawei.com/consumer/cn/doc/quickApp-Guides/quickapp-loader-user-guide-0000001115925960)。

快应用加载器安装后，支持手动加载元服务app包运行。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f3/v3/1MbLCGcHR1SPnkuMYOCOvg/zh-cn_image_0000002800577523.png?HW-CC-KV=V1&HW-CC-Date=20261026T033630Z&HW-CC-Expire=31536000000&HW-CC-Sign=83C88D4CEA5E9E06FF8EDFADC57158E998F54C38FBDE7D723E8DC2C443D9BEB6 "点击放大")

支持关闭管控规则，临时放通域名管控和敏感权限管控，方便本地调试，通过"进入快应用加载器 >右上角![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6d/v3/k3Eo8XlwROemXxsxk4cJkA/zh-cn_image_0000002771257700.jpg?HW-CC-KV=V1&HW-CC-Date=20261026T033630Z&HW-CC-Expire=31536000000&HW-CC-Sign=60D314489D1595DE13D5EB88ABE2E516AEF85A7D18621E493E6690821A928007 "点击放大") > 设置 > 豁免管控"选择开启后关闭管控规则 。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a2/v3/8ku9tkI9RUmsbV8F5dTgJA/zh-cn_image_0000002771097736.png?HW-CC-KV=V1&HW-CC-Date=20261026T033630Z&HW-CC-Expire=31536000000&HW-CC-Sign=89A02035D6E75D6C0C82ECCDE1B4E392AF0BF5DD6245E71578A73A273A293B49 "点击放大")

* **[ASCF Toolkit（CLI工具）](https://developer.huawei.com/consumer/cn/doc/atomic-guides/run-ascf-cli)**   
* **[ASCF插件](https://developer.huawei.com/consumer/cn/doc/atomic-guides/ascf-plugins)**   
* **[使用HarmonyOS开发助手开发](https://developer.huawei.com/consumer/cn/doc/atomic-guides/harmony_bot_ascf_docs)**