OSS-Android SDK 搭建总结

背景

很多小伙伴对 Android 的 SDK 搭建熟悉，但是对于上云的 OSS Android SDK 使用有些一门疑问，今天从环境搭建到客户端使用全面给大家梳理一遍个人的使用总结；

分解

• 下载jdk和Android studio
• 安装jdk
• 配置环境变量
• 安装Android Studio
• 配置Android Studio

下载工具

• JDK
• Android Studio

安装

JDK

典型下一步的操作

环境变量配置

JAVA_HOME

编辑Path

CLASSPATH变量

测试环境变量是否配置成功 “开始” -》 输入 -》 “cmd” 打开命令行窗口输入 javac

安装 Android Studio

• 建议典型安装，如果不是很懂安装过程，不要建议更改配置

• 上面是 Android Studio的安装目录 下面是sdk的目录，自行选择即可；

Android Studio配置

• 加载本地配置信息提示

• 刚开始打开的时候会问我们是否加载本地的配置信息，就是 Android Studio 的配置环境信息等，如果你以前没有用过，忽略掉就好了。直接按默认的点 ok 启动 Android Studio

• 直接点击 Cancel 进入 SDK 配置

• 然后一路下一步，直至finish，finish后会下载一些插件，等一下就好；

配置 SDK

这里我们选择我们刚才sdk的安装目录即可；
这时候我们就可以点击 Start a new Android Studio project 来新建一个工程了；
弹出新建工程对话框

新建工程，依次填写项目名称 公司域名 包名 等信息，注意选择自己的工作区不要用默认的；
然后一路next全默认最后到finish

集成 OSS SDK

1、 集成工程到 Android Studio 中；

• 直接 git clone 工程；

https://github.com/aliyun/aliyun-oss-android-sdk.git

• 引入 git 工程，这里要注意下，模式切换为 project；

2、引入成功后，了解主要的 java 类

2.1 Config 是我们主要的配置文件，里面存放的是 OSS 操作的 bucket 配置，以及回调、STS 获取地址、endpoint 等信息；

注意：

• 现在 SDK 基本都采用 STS 的方式上传，用户需要自己维护一台 STS Server 服务器，目的是用来获取 STS token 临时令牌的信息； STS 的搭建可以参考：快速搭建移动服务
• callback 是上传成功后回调用户的地址，也是用户自己维护，目的是接收 OSS 上传成功后回调信息，用户的回调服务器必须能返回 200 并且是 JSON 的字符串，类似截图中

2.2 OSSAuthCredentialsProvider 自动鉴权

这个类主要功能，是根据用户设置的 STS URL 地址，自动解析出返回的变量，并且在 STS 过期后自动去获取新的 STS token；STS 返回的鉴权信息格式一定要如下，并且返回 200

STS 地址返回的鉴权信息格式

{"StatusCode":200,"AccessKeyId":"STS.NJxxxxxxxxxxx1zMxm6Q","AccessKeySecret":"EDLc9CxxxxxxxPcSDxqrzW1kwCh5z7","Expiration":"2019-04-12T04:24:32Z","SecurityToken":"CAIS9xxxxxxxxxxKH6"}

2.3 这个路径下面主要是 Android 测试的类文件；

2.4 demo 的测试集合类

OssService 中集合 demo 的测试方式 （PutObject , PutImage ....）当使用者需要修改设置上传回调时可以通过这个地址进行修改；

测试上传

按照截图顺序，点击 设置，提示成功后 ，点击 选择图片，输入 object 名称，点击上传

通过 DEBUG 结果我们可以看到文件上传成功，导致我们的初步测试已经成功