移动端接入指南

---

移动端快速接入

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接入

1. 将libpag的aar文件放置在android工程项目的libs目录下
2. 添加添加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及以上版本进行编译

Framework接入

1. 将libpag的framework文件放置在iOS工程项目目录下
2. 在项目工程中，配置所使用Target的General->Embedded Binaries，添加libpag.framework
3. 由于libpag暂时不支持Bitcode，需要配置Build Settings->Build Options->Enable Bitcode 为No

cocoapods接入

修改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

---