Android
本节以Android Studio工具为例,介绍如何在Android环境中集成API请求签名的SDK。您可以直接导入示例工程体验,然后参考调用说明部分将签名SDK集成到您的应用中。
准备环境
获取并安装Android Studio 4.1.2或以上版本,可至Android Studio官方网站下载。
获取SDK
签名SDK只包含签名功能,不包含云服务的SDK功能,云服务SDK请参见SDK。
解压后目录结构如下:
名称 |
说明 |
---|---|
app\ |
安卓工程代码 |
build.gradle |
gradle配置文件 |
gradle.properties |
|
settings.gradle |
打开工程
- 打开Android Studio,选择“File > Open”。
在弹出的对话框中选择解压后的SDK路径。
- 打开工程后,目录结构如下。
请求签名与API调用
- 在Android工程中的“app/libs”目录下,加入SDK所需jar包。其中jar包必须包括:
- java-sdk-core-x.x.x.jar
- commons-logging-1.2.jar
- joda-time-2.9.9.jar
- 在“build.gradle”文件中加入okhttp库的依赖。
在“build.gradle”文件中的“dependencies”下加入“implementation 'com.squareup.okhttp3:okhttp:3.11.0'”。
1 2 3 4 5
dependencies { ... ... implementation 'com.squareup.okhttp3:okhttp:3.11.0' }
- 创建request,输入AK和SK,并指定域名、方法名、请求uri和body。
- 本示例以AK和SK保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。以Linux系统为例在本地将已获取的AK/SK设置为环境变量。
- 创建request,填入已设置的环境变量,并指定域名、方法名、请求uri和body。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Request request = new Request(); try { // Directly writing AK/SK in code is risky. For security, encrypt your AK/SK and store them in the configuration file or environment variables. // In this example, the AK/SK are stored in environment variables for identity authentication. Before running this example, set environment variables HUAWEICLOUD_SDK_AK and HUAWEICLOUD_SDK_SK. request.setKey(System.getenv("HUAWEICLOUD_SDK_AK")); request.setSecret(System.getenv("HUAWEICLOUD_SDK_SK")); request.setMethod("GET"); request.setUrl("https://service.region.example.com3/v1/{project_id}/vpcs"); request.addQueryStringParam("name", "value"); request.addHeader("Content-Type", "text/plain"); //request.setBody("demo"); } catch (Exception e) { e.printStackTrace(); return; }
- 对请求进行签名,生成okhttp3.Request对象来访问API。
1 2 3
okhttp3.Request signedRequest = Client.signOkhttp(request); OkHttpClient client = new OkHttpClient.Builder().build(); Response response = client.newCall(signedRequest).execute();