背景
很多小伙伴对 Android 的 SDK 搭建熟悉,但是对于上云的 OSS Android SDK 使用有些一门疑问,今天从环境搭建到客户端使用全面给大家梳理一遍个人的使用总结;
分解
- 下载jdk和Android studio
- 安装jdk
- 配置环境变量
- 安装Android Studio
- 配置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 结果我们可以看到文件上传成功,导致我们的初步测试已经成功