You need to enable JavaScript to run this app.
导航
集成准备
最近更新时间:2024.10.22 17:39:03首次发布时间:2022.10.18 20:15:10

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

环境要求

类别说明
开发环境Android Studio (推荐使用最新版本)
系统版本minSdkVersion:16 及以上
ABI 兼容性架构要求:armv7 或 arm64

添加 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 最新版本。

说明

Android 端 Applog 最新版本号请参考 Applog 更新日志获取。

添加 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"
    implementation "com.bytedanceapi:ttsdk-ttlicense2: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.** {*;}
-keep class com.pandora.ttlicense2.**{*;}

后续操作

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