文档中心

集成准备

最近更新时间：2024.03.05 13:36:01

首次发布时间：2021.02.23 10:42:27

本文档为您介绍集成 Android 加载 SDK 前的准备工作。

适用版本

本文档适用于 Android 2.3 及以上开发版本。

开发环境

推荐您使用 Android Studio 作为开发工具，本开发文档基于 Android Studio 开发环境进行编写。

创建应用并获取 License

集成 Android BDFresco 加载 SDK 前，您需要登录 veImageX 控制台并参考 SDK 接入准备完成以下操作。

创建应用
获取 Token
购买 License 包
绑定 License 与应用
下载 License 文件

说明

测试版 License 不能在线上业务 App 使用，原因如下：

测试版 License 仅供联调测试，到期后无法续期。
测试版 License 到期会导致 App 鉴权不通过，从而影响业务使用。

添加 maven 仓库

确保 project 根目录下的build.gradle下配置服务，代码示例如下所示：

maven {
    url 'https://artifact.bytedance.com/repository/Volcengine/'
}

获取 SDK 最新版本

请参考版本发布历史，获取 SDK 最新版本号。

添加 SDK 依赖

在 module 目录下的build.gradle 文件中的dependencies中添加 SDK 依赖，填入获取 SDK 最新版本获取的最新版本号，代码示例如下所示：

implementation 'com.bytedance.fresco:fresco:2.7.2-tob'
implementation "com.bytedance.fresco:animated-gif:2.7.2-tob"  //gif 解码库
implementation "com.bytedance.fresco:animated-webp:2.7.2-tob" //webp animated
implementation "com.bytedance.fresco:webpsupport:2.7.2-tob"   //低版本 webp 支持
implementation "com.bytedance.fresco:drawee:2.7.2-tob"        //fresco 组件
implementation "com.bytedance.fresco:statistics:2.7.2-tob"    //监控+网络组件
// SDK 支持日志上报扩展功能，且日志上报能力依赖于 Applog 模块，为实现日志上报功能 Applog 会采集用户的 IMEI、MEID、硬件序列号、Android ID、OAID、MAC 等信息（详见隐私政策）。
// 如您无需使用日志上报相关功能或不想隐私数据被收集，请在添加依赖时剔除 AppLog 模块
//implementation "com.bytedance.fresco:statistics:2.7.2-tob" {     
//    exclude group:"com.bytedance.applog", module:"RangersAppLog-Lite-cn"
//}
implementation "com.bytedance.fresco:heif:2.7.2-tob"          //heif 静图解码
implementation "com.bytedance.fresco:animated-heif:2.7.2-tob" //heif 动图解码
implementation "com.bytedance.fresco:authorization:2.7.2-tob" //授权认证+云控配置

注意

您可根据实际情况自主选择是否接入 SDK 的日志上报扩展功能。若不接入，将无法使用日志上报、埋点日志上报回调、自定义日志上报采样率云控配置。同时，导致 veImageX 控制台的下行网络监控、客户状态监控、感知指标监控和告警管理无相关数据展示。

后续操作

请参考快速开始完成 SDK 初始化和基本使用。