集成准备

本文为您介绍集成 Android 上传 SDK 前的准备工作，包括环境准备、集成操作等内容。

环境要求

添加 maven 仓库

确保 project 根目录下的 build.gradle 文件中的 repositories 中配置了 mavenCentral() 和 火山引擎maven 服务。

allprojects {
    repositories {
        google()
        jcenter()
        mavenCentral()
        maven {
            url "https://artifact.bytedance.com/repository/Volcengine/" // volc public maven repo
        }
    }
}

获取 SDK 最新版本

请参考上传 SDK 发版历史，获取 SDK 最新版本。

添加 SDK 依赖

在 module 目录下的 build.gradle 文件中的 dependencies 中添加 SDK 依赖。

dependencies {
     ...
    // 推荐使用最新稳定版，历史版本信息请参考上节「获取 SDK 最新版本」
    implementation "com.bytedanceapi:ttsdk-ttuploader:x.x.x.x"
    implementation "com.bytedanceapi:ttsdk-ttcommon:x.x.x.x"
    // 埋点上报 SDK，用于埋点上报。推荐使用最新稳定版，历史版本信息请参考上节「获取 SDK 最新版本」
    implementation "com.bytedance.applog:RangersAppLog-Lite-cn:x.x.x.x"
}

权限声明

在 AndroidManifest.xml 文件中声明 SDK 需要的权限。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

混淆规则

在 proguard-rules.pro 文件中配置 SDK 混淆规则。

# 上传模块
-keep class com.pandora.common.applog.**{*;}
-keep class com.pandora.ttuploader2.** {*;}
-keep class com.ss.bduploader.** {*;}

后续操作

至此，您已完成上传 SDK 的集成准备，接下来请参考快速开始使用上传 SDK。