OSS-Android SDK 搭建总结-阿里云开发者社区

开发者社区> 阿里云支持与服务> 正文

OSS-Android SDK 搭建总结

简介: 背景 很多小伙伴对 Android 的 SDK 搭建熟悉,但是对于上云的 OSS Android SDK 使用有些一门疑问,今天从环境搭建到客户端使用全面给大家梳理一遍个人的使用总结; 分解 下载jdk和Android studio 安装jdk 配置环境变量 安装Android Studio 配.

背景

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

分解

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

下载工具

安装

JDK

image

典型下一步的操作
image

image

环境变量配置

image

JAVA_HOME

image

编辑Path

image

CLASSPATH变量

image

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

image

安装 Android Studio

image

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

image

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

image

Android Studio配置

  • 加载本地配置信息提示

image

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

image

  • 直接点击 Cancel 进入 SDK 配置

image

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

image

image

配置 SDK

image

image

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

image

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

image

集成 OSS SDK

1、 集成工程到 Android Studio 中;

  • 直接 git clone 工程;

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

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

image

image

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

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

image

注意:

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

image

2.2 OSSAuthCredentialsProvider 自动鉴权

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

image

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

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

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

image

image

2.4 demo 的测试集合类

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

image

测试上传

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

image

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

image

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:

分享阿里云支持与服务团队最佳实践、经典案例与故障排查。

官方博客
文档