更新时间:2024-06-26 GMT+08:00

Android

本节以Android Studio工具为例,介绍如何在Android环境中集成API请求签名的SDK。您可以直接导入示例工程体验,然后参考调用说明部分将签名SDK集成到您的应用中。

准备环境

获取并安装Android Studio 4.1.2或以上版本,可至Android Studio官方网站下载。

获取SDK

点此下载SDK与Demo

解压后目录结构如下:

名称

说明

app\

安卓工程代码

build.gradle

gradle配置文件

gradle.properties

settings.gradle

打开工程

  1. 打开Android Studio,选择“File > Open”。

    在弹出的对话框中选择解压后的SDK路径。

  2. 打开工程后,目录结构如下。

请求签名与API调用

  1. 在Android工程中的“app/libs”目录下,加入SDK所需jar包。其中jar包必须包括:

    • java-sdk-core-x.x.x.jar
    • commons-logging-1.2.jar
    • joda-time-2.9.9.jar

  2. 在“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'
    }
    

  3. 创建request,输入AK和SK,并指定域名、方法名、请求uri和body。

    1. 本示例以AK和SK保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。以Linux系统为例在本地将已获取的AK/SK设置为环境变量。
      1. 打开终端,输入以下命令打开环境变量配置文件。

        vi ~/.bashrc

      2. 设置环境变量,保存文件并退出编辑器。
        export HUAWEICLOUD_SDK_AK="已获取AK值" 
        export HUAWEICLOUD_SDK_SK="已获取SK值" 
      3. 输入以下命令使配置文件生效。

        source ~/.bashrc

    2. 创建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;
      }
      

  4. 对请求进行签名,生成okhttp3.Request对象来访问API。

    1
    2
    3
    okhttp3.Request signedRequest = Client.signOkhttp(request);
    OkHttpClient client = new OkHttpClient.Builder().build();
    Response response = client.newCall(signedRequest).execute();