OSS-Android SDK 搭建总结

背景

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

分解

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

下载工具

安装

JDK

OSS-Android SDK 搭建总结

典型下一步的操作
OSS-Android SDK 搭建总结

OSS-Android SDK 搭建总结

环境变量配置

OSS-Android SDK 搭建总结

JAVA_HOME

OSS-Android SDK 搭建总结

编辑Path

OSS-Android SDK 搭建总结

CLASSPATH变量

OSS-Android SDK 搭建总结

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

OSS-Android SDK 搭建总结

安装 Android Studio

OSS-Android SDK 搭建总结

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

OSS-Android SDK 搭建总结

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

OSS-Android SDK 搭建总结

Android Studio配置

  • 加载本地配置信息提示

OSS-Android SDK 搭建总结

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

OSS-Android SDK 搭建总结

  • 直接点击 Cancel 进入 SDK 配置

OSS-Android SDK 搭建总结

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

OSS-Android SDK 搭建总结

OSS-Android SDK 搭建总结

配置 SDK

OSS-Android SDK 搭建总结

OSS-Android SDK 搭建总结

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

OSS-Android SDK 搭建总结

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

OSS-Android SDK 搭建总结

集成 OSS SDK

1、 集成工程到 Android Studio 中;

  • 直接 git clone 工程;

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

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

OSS-Android SDK 搭建总结

OSS-Android SDK 搭建总结

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

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

OSS-Android SDK 搭建总结

注意:

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

OSS-Android SDK 搭建总结

2.2 OSSAuthCredentialsProvider 自动鉴权

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

OSS-Android SDK 搭建总结

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

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

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

OSS-Android SDK 搭建总结

OSS-Android SDK 搭建总结

2.4 demo 的测试集合类

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

OSS-Android SDK 搭建总结

测试上传

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

OSS-Android SDK 搭建总结

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

OSS-Android SDK 搭建总结

上一篇:国内十大上市移动医疗企业盘点


下一篇:Docker 环境搭建