本文介绍如何安装Android SDK。

环境要求

  • Android系统版本:2.3及以上
  • 有阿里云账户,并开通OSS服务。

下载SDK

  • Android SDK开发包

    Android Studio环境下:

    dependencies { compile 'com.aliyun.dpa:oss-android-sdk:+' }
  • Github地址:点击查看

安装SDK

  • 方式一:在Maven项目中加入依赖项(推荐方式)
    dependencies {
    	compile 'com.aliyun.dpa:oss-android-sdk:+'
    }
    
  • 方式二:源码编译jar包
    1. clone 工程源码,运行gradle命令打成jar包:
      # 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-x.x.x.jar、okhttp-3.x.x.jarokio-1.x.x.jar 3 个 jar 包导入 libs 目录。

相关设置

  • 权限设置

    OSS Android SDK 所需 Android 权限如下:

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
    
    说明 请确保您的 AndroidManifest.xml 文件中配置了以上权限,否则 SDK 将无法正常工作。
  • 混淆设置

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

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