移动端接入指南
移动端快速接入
SDK的接入和使用请遵守 PAG SDK个人信息保护规则
SDK 获取
最新 SDK:SDK下载页面
- Android 端 SDK 为 aar 文件,支持 armeabi、armv7a、arm64
- iOS 端 SDK 为 framework 文件,提供三个版本:动态库真机版本(arm64)、动态库完整版本(arm64、模拟器 x84_64/arm 64)、静态库完整版本(arm64、模拟器 x84_64/arm 64)
Android端接入
基本要求
- 支持android 4.4及以上系统
- 推荐使用gradle 3.0及以上版本编译
aar接入
- 将libpag的aar文件放置在android工程项目的libs目录下
- 添加添加aar库依赖
在app的gradle文件app/build.gradle,添加libpag的库依赖
android {
repositories {
flatDir {
dirs 'libs'
}
}
dependencies {
//libpag的核心库
//将libpag_release_4.0.5.5换成你下载的aar文件名
implementation(name: 'libpag_release_4.0.5.5', ext: 'aar')
implementation("androidx.exifinterface:exifinterface:1.3.3")
}
注意: 需要在混淆列表里面,添加libpag的keep规则:
-keep class org.libpag.** {*;}
-keep class androidx.exifinterface.** {*;}
配置完以后,sync一下,再编译。
maven接入
提供两个版本(以4.0.5.5版本为例):
full版本:com.tencent.tav:libpag:4.0.5.5,内部包含软件解码器,当硬解失败时使用
noffavc版本:com.tencent.tav:libpag:4.0.5.5-noffavc,内部不包含软件解码器,支持解码器外部注入
i. 在root工程目录下面修改build.gradle文件,增加mavenCentral()
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.1'
}
}
ii. 在app的gradle文件app/build.gradle,添加libpag的库依赖
dependencies {
//libpag的核心库
implementation 'com.tencent.tav:libpag:4.0.5.5'
}
注意: 需要在混淆列表里面,添加libpag的keep规则:
-keep class org.libpag.** {*;}
-keep class androidx.exifinterface.** {*;}
配置完以后,sync一下,再编译。
iOS端接入
- 支持iOS9及以上
- 需要使用Xcode11.0及以上版本进行编译
- 将libpag的framework文件放置在iOS工程项目目录下
- 在项目工程中,配置所使用Target的General->Embedded Binaries,添加libpag.framework
- 由于libpag暂时不支持Bitcode,需要配置Build Settings->Build Options->Enable Bitcode 为No
修改App目录下的Podfile文件,添加相应的libpag的引用.
pod 'libpag'
注意: 最新SDK版本请参考:SDK下载页面
DEMO下载
iOS DEMO下载:
https://github.com/libpag/pag-ios.git
Android DEMO下载:
https://github.com/libpag/pag-android.git
Flutter Demo下载:
https://github.com/libpag/pag-flutter.git
测试素材
PAG动效测试素材下载: pag_files.zip
接入使用过程若遇到问题请提交issue