OpenHarmony端云一体化应用开发快速入门练习（上）基础配置 原创

一 、整体说明
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",

// 其他依赖

... ...

}

3.在“dependencies”中添加认证服务的编译依赖。

“dependencies”: {

"@hw-agconnect/auth-ohos": "^1.0.9",

}

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());

}

3.在“entry/src/main/module.json5”中添加网络权限。

“requestPermissions”: [

{

"name": "ohos.permission.INTERNET"

}

]

（六）（可选）设置配置文件参数
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