本文介绍如何安装Android SDK及相关配置说明。

说明 使用Android SDK时，建议指定Android SDK的版本号。

前提条件

  • Android系统为2.3及以上版本。
  • 已开通OSS服务。

下载SDK

  • 通过添加依赖项下载

    在Android Studio环境中添加如下依赖：

    1
    dependencies { compile 'com.aliyun.dpa:oss-android-sdk:2.9.5' }
  • SDK安装包
  • 通过GitHub下载

安装SDK

您可以通过如下两种方式安装SDK：

  • 方式一：在Maven项目中加入依赖项（推荐方式）
    1
    2
    dependencies {
        compile 'com.aliyun.dpa:oss-android-sdk:2.9.5'}
  • 方式二：源码编译jar包
    1. clone工程源码，运行gradle命令生成jar包。
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      # clone工程源码。
      $ git clone https://github.com/aliyun/aliyun-oss-android-sdk.git
       
      # 进入目录。
      $ cd aliyun-oss-android-sdk/oss-android-sdk/
       
      # 执行打包脚本，要求jdk为1.7及以上版本。
      $ ../gradlew releaseJar
       
      # 进入打包生成目录，jar包将在此目录下生成。
      $ cd build/libs && ls
    2. 直接引入编译好的jar包。

      将aliyun-oss-sdk-android-2.9.5.jar、okhttp-3.x.x.jar、okio-1.x.x.jar 3个jar包导入libs目录。

相关配置

以下介绍使用OSS Android SDK前的相关配置。

  • 权限配置
    OSS Android SDK所需的Android权限如下：
    注意 请确保已在AndroidManifest.xml文件中配置所需权限，否则SDK将无法正常工作。
    1
    2
    <uses-permission android:name="android.permission.INTERNET"></uses-permission>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
  • 混淆配置

    请在混淆配置中加入以下内容：

    1
    2
    3
    -keep class com.alibaba.sdk.android.oss.** { *; }
    -dontwarn okio.**
    -dontwarn org.apache.commons.codec.binary.**