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 结果我们可以看到文件上传成功，导致我们的初步测试已经成功