概述及准备

实时发布为离线包提供 Java SDK,您可以通过调用开放接口来实现配置、创建、发布及管理离线包的操作。

准备工作

在使用 OpenAPI 前,您需要先获取 AccessKey、App ID、Workspace ID 与 Tenant ID,并配置 Maven 依赖及配置文件上传。

获取 AccessKey

AccessKey 包括 AccessKey IDAccessKey Secret点击此处 查看获取方式。

  • AccessKey ID:用于标识用户。

  • AccessKey Secret:用于验证用户的密钥,必须保密。

获取 App ID、Workspace ID 与 Tenant ID

  1. 登录 mPaaS 控制台,进入应用。

  2. 总览 页,依次点击 代码配置(可视情况选择 Android 或 iOS) > 下载配置文件 > 立即下载,在右侧弹出的 代码配置 窗口中,您可以看到 App ID、Workspace ID 和 Tenant ID 的值。

配置 Maven 依赖

在使用 OpenAPI 之前,您需要完成以下 Maven 依赖配置。

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-mpaas</artifactId>
  <version>3.0.5</version>
</dependency>

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <optional>true</optional>
  <version>[4.3.2,5.0.0)</version>
</dependency>

使用示例

使用 Maven 中的 Client 示例如下:

        private static final String REGION_ID = "cn-hangzhou"; //地域 ID,默认为 cn-hangzhou
        private static final String ACCESS_KEY_ID = "*****************"; // RAM 账号的 AccessKey ID
        private static final String ACCESS_SECRET = "******************"; //RAM 账号的 AccessKey Secret
        private static final String PRODUCT = "mpaas"; // 产品名称
        private static final String END_POINT = "mpaas.cn-hangzhou.aliyuncs.com"; // 调用的 endpoint
        DefaultProfile.addEndpoint(REGION_ID, PRODUCT, END_POINT);
        DefaultProfile profile = DefaultProfile.getProfile(REGION_ID, ACCESS_KEY_ID, ACCESS_SECRET);
        IAcsClient iAcsClient = new DefaultAcsClient(profile);
        QueryMcubeVhostRequest queryMcubeVhostRequest = new QueryMcubeVhostRequest();
        queryMcubeVhostRequest.setAppId(APP_ID);
        queryMcubeVhostRequest.setWorkspaceId(WORKSPACE_ID);
        queryMcubeVhostRequest.setTenantId(TENANT_ID);
        QueryMcubeVhostResponse acsResponse = null;
        try {
            acsResponse = iAcsClient.getAcsResponse(queryMcubeVhostRequest);
            System.out.println(acsResponse.getResultCode());
            System.out.println(acsResponse.getQueryVhostResult());
        } catch (ClientException e) {
            e.printStackTrace();
        }

配置文件上传

由于在所有的 API 接口中均不允许出现文件流,所以需要上传的文件都应先调用上传工具类来将文件上传至 OSS,再将返回的 OSS 地址作为参数传递到指定的 API 中。

您可下载相关的文件的上传工具类 OssPostObject.java.zip

使用示例

文件上传示例如下:

        GetMcubeFileTokenRequest getMcubeFileTokenRequest = new GetMcubeFileTokenRequest();
        getMcubeFileTokenRequest.setAppId(APP_ID);
        getMcubeFileTokenRequest.setOnexFlag(true);
        getMcubeFileTokenRequest.setTenantId(TENANT_ID);
        getMcubeFileTokenRequest.setWorkspaceId(WORKSPACE_ID);
        GetMcubeFileTokenResponse acsResponse = iAcsClient.getAcsResponse(getMcubeFileTokenRequest);
        System.out.println(JSON.toJSONString(acsResponse));

        GetMcubeFileTokenResponse.GetFileTokenResult.FileToken fileToken = acsResponse.getGetFileTokenResult().getFileToken();
        OssPostObject ossPostObject = new OssPostObject();
        ossPostObject.setKey(fileToken.getDir());
        ossPostObject.setHost(fileToken.getHost());
        ossPostObject.setOssAccessId(fileToken.getAccessid());
        ossPostObject.setPolicy(fileToken.getPolicy());
        ossPostObject.setSignature(fileToken.getSignature());
        ossPostObject.setFilePath("your/local/file/path");
        String s = ossPostObject.postObject();

有关 GetMcubeFileTokenRequest 的说明请参见 获取上传文件 token

阿里云首页 移动开发平台 mPaaS 相关技术圈