一 、整体说明
SDK版本更新说明
二、开发流程
集成SDK
(一)前提条件
安装HUAWEI DevEco Studio 3.1及以上版本,配置 SDK API Version 9及以上,Compile SDK Version 9及以上,Compatible SDK Version 9及以上。
(二)添加应用配置文件
1.获取“agconnect-services.json”文件。
2.将“agconnect-services.json”文件拷贝到DevEco Studio项目的应用级资源目录“AppScope/resources/rawfile”下。
说明:“AppScope/resources”目录下默认不存在“rawfile”文件夹,需要您手动创建。
(三)配置SDK依赖
添加配置文件后,需要在DevEco Studio项目中配置SDK依赖,您可以通过以下任意一种方式配置SDK依赖:
方式一
打开DevEco Studio项目级“package.json”文件。
2.在package.json文件里面添加SDK依赖。
“dependencies”: {
"@hw-agconnect/core-ohos": "^1.0.9",
"@hw-agconnect/credential-ohos": "^1.0.9",
// 其他依赖
... ...
1.2.3.4.5.6.7.
}
3.在“dependencies”中添加认证服务的编译依赖。
“dependencies”: {
"@hw-agconnect/auth-ohos": "^1.0.9",
1.
}
4.打开修改完的package.json文件,右上方出现“Sync Now”链接,点击“Sync Now”等待同步完成。
方式二
1.打开您的工程,在命令行窗口执行cd directory命令,切换到工程的entry目录。
2.安装Auth Service OHOS SDK到您的项目中。
npm install --save @hw-agconnect/auth-ohos@1.0.9
(四)集成AGC SDK
说明 工程的应用框架必须为Stage模型,即“apiType为stageMode”。
Stage模型仅Compile API版本为9及以上版本时支持,请确保SDK的Compile API版本不低于9。
1.在您的项目中导入agc组件。
import agconnect from ‘@hw-agconnect/api-ohos’;
import “@hw-agconnect/core-ohos”;
import “@hw-agconnect/auth-ohos”;
2.在您的应用初始化阶段使用context初始化SDK,推荐在MainAbility 的onCreate中进行。
//初始化SDK
onCreate(want, launchParam) {
//务必保证resources/rawfile中包含agconnect-services.json文件
agconnect.instance().init(this.context.getApplicationContext());
1.
}
3.在“entry/src/main/module.json5”中添加网络权限。
“requestPermissions”: [
{
"name": "ohos.permission.INTERNET"
1.
}
]
(六)(可选)设置配置文件参数
1.在“项目设置 > 常规”页面中获取Client Secret和API密钥(凭据)。
2.如果您在下载配置文件时选择了“不包含密钥”,则配置信息中将不包含Client ID、Client Secret和API密钥(凭据)。
您需要参考如下方式,在应用启动调用AGC的初始化方法完成后将参数设置给AGC SDK。
agconnect.instance().init(this.context.getApplicationContext());
agconnect.instance().setApiKey(“xxx”); // 设置API密钥(凭据)
agconnect.instance().setClientSecret(“xxx”); // 设置Client Secret