目录

获取ASCF开发工具

在DevEco Studio中使用

[h2]获取方式

  1. 单击链接下载,下载ASCF Plugin。

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

    在DevEco Studio顶部菜单栏中选择“File > Setting”。在打开的设置框中,选择“Plugins”。在“Plugins”页签中,点击“顶部的齿轮 > Install Plugin from Disk... ”,将插件手动安装到DevEco Studio中。

    请直接安装下载的zip文件,不要解压后安装。MacOS用户如果使用Safari浏览器下载,请关闭自动解压缩功能。

ASCF框架版本发布的新增特性及变更说明请查阅版本变更说明。

[h2]自动升级ASCF Plugin

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

[h2]升级已有项目的ASCF运行时版本

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

[h2]升级已有项目的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中使用

[h2]获取方式

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

在侧边栏出现元服务图标即安装成功。

[h2]支持的设备

平台 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开发助手运行会自动安装快应用加载器,也可以手动下载快应用加载器安装。

使用华为快应用加载器调试快应用的方法参见华为快应用加载器使用指导。

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

支持关闭管控规则,临时放通域名管控和敏感权限管控,方便本地调试,通过“进入快应用加载器 >右上角 > 设置 > 豁免管控”选择开启后关闭管控规则 。