libpag 是 PAG (Portable Animated Graphics) 动画文件的渲染 SDK，目前已覆盖几乎所有的主流平台，包括：iOS, Android, macOS, Windows, Linux, 以及 Web 端。
PAG 方案是一套完善的动画工作流。提供从 AE（Adobe After Effects）导出插件，到桌面预览工具 PAGViewer，再到各端的跨平台渲染 SDK。 目标是降低或消除动画研发相关的成本，打通设计师创作到素材交付上线的极简流程，不断输出运行时可编辑的高质量动画内容。
PAG介绍
参考本站文章：腾讯推出移动端动画组件PAG，释放设计生产力
PAG使用
PAG 方案目前已经接入了腾讯系 40 余款应用，包括微信，手机QQ，王者荣耀，腾讯视频，QQ音乐等头部产品，稳定性经过了海量用户的持续验证，可以广泛应用于UI动画、贴纸 动画、视频编辑、模板设计等场景。典型应用场景可以参考官网案例。
PAG 优势
- 高效的文件格式
采用可扩展的二进制文件格式，可单文件集成图片音频等资源，实现快速交付。导出相同的 AE 动画内容，在文件解码速度和压缩率上均大幅领先于同类型方案。
- 全 AE 特性支持
在纯矢量导出方式上支持更多 AE 特性的同时，还引入了BMP预合成结合矢量的混合导出能力，实现支持所有 AE 特性的同时又能保持动画运行时的可编辑性。
- 性能监测可视化
通过导出插件内置的自动优化策略，以及预览工具集成的性能监测面板，能够直观地看到每个素材的性能状态，以帮助设计师制作效果和性能俱佳的动画特效。
- 运行时可编辑
运行时，可在保留动画效果前提下，动态修改替换文本或替换占位图内容，甚至对任意子图层进行增删改及移动，轻松实现照片和视频模板等素材的批量化生产。
系统要求
- iOS 9.0 版本及以上
- Android 4.4 版本及以上
- macOS 10.13 版本及以上
- Windows 7.0 版本及以上
- Chrome 69.0 版本及以上
- Safari 11.3 版本及以上
快速接入
由于大部分平台没有统一的上层业务框架，目前我们暂时只为 iOS, Android 和 Web 平台定期发布预编译的二进制库，其他平台的库需要通过 源码根据自己的实际需求调整参数进行编译。移动端最新的release库可以在 这里 下载。 详细的 SDK接入文档可以参考 SDK接入 。Web 平台的接入文档可以参考 Web SDK 接入
iOS 端接入
可以从 release 页面下载预编译的二进制库，或者通过CocoaPods接入
在Podfile中添加libpag依赖:
pod 'libpag'
然后运行:
pod install
然后在项目中引入libpag的头文件
#import <libpag/xxx.h>
Android 端接入
可以从 release 页面下载预编译的 aar 库文件，或者通过 Maven 将 libpag 添加到你的项目中：
编辑工程根目录下的 build.gradle 文件, 在repositories下面添加 mavenCentral() :
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.1'
}
}
在 app/build.gradle中添加libpag依赖 ( 3.2.7.40 应替换为最新发布版本):
dependencies {
implementation 'com.tencent.tav:libpag:3.2.7.40'
}
在混淆列表里面，添加libpag的keep规则
-keep class org.libpag.* {*;}
配置完以后，sync一下，再编译即可。
Web 端接入
直接拷贝如下代码，然后在浏览器中运行即可：
<canvas class="canvas" id="pag"></canvas>
<script src="https://unpkg.com/libpag@latest/lib/libpag.min.js"></script>
<script>
window.libpag.PAGInit().then((PAG) => {
const url = 'https://pag.io/file/like.pag';
fetch(url)
.then((response) => response.blob())
.then(async (blob) => {
const file = new window.File([blob], url.replace(/(.*\/)*([^.]+)/i, '$2'));
// Do Something.
});
});
</script>
Web 端更多接入方式请参考：Web端接入指南
范例工程
我们准备了如下各端的 Demo 工程，检出对应平台的 Demo 工程可以快速开始学习如何使用 libpag 的 API：
- https://github.com/libpag/pag-ios
- https://github.com/libpag/pag-android
- https://github.com/libpag/pag-web
API 手册：
- iOS API 参考
- Android API 参考
- Web API 参考
更多的其他文档可以访问官网 pag.io 获得。
开发指南
如果您希望参与到 libpag 项目的源码开发中，请务必严格按照以下步骤先配置完开发环境再进行开发和调试。
我们推荐使用 CLion 并在 macOS 平台上进行开发。
分支介绍
main 分支是我们主要的开发分支，日常会有频繁的修改合入。main 分支稳定后会不定期创建发布分支 release/{version}。release/ 下 的分支是我们推荐的在生产环境中使用的稳定版本。稳定版本一旦拉取出分支后，将不再合入新功能，只做缺陷问题的修复。
注：这个仓库只包含从 PAG 4.0 版本开始的最新代码。PAG 3.0 及以下版本的历史记录因开源合规的要求无法对外提供，如需使用 PAG 3.0 的预编译库 可以从 这里 下载。
编译环境
- Xcode 11.0 版本及以上
- GCC 7.0 版本及以上
- CMake 3.10.2 版本及以上
- Visual Studio 2019
- NDK 19.2.5345600 （其他 NDK 版本可能会存在编译报错)
依赖管理
libpag 使用 depsync 命令行工具管理第三方依赖项。如果您是在 macOS 平台上进行开发，可以直接在项目根目录下运行脚本安装所有必要工具并进行第三方仓库的同步：
./sync_deps.sh
如果在其他平台上，请参考以下步骤进行安装必要工具并进行第三方仓库同步：
首先确保您已经安装了最新版本的 node.js，然后使用 npm 安装 depsync 命令行工具 ：
npm install -g depsync
首次检出的仓库需要在项目根目录运行 depsync 命令来同步第三方依赖仓库：
depsync
同步过程可能出现要求输入 git 账号密码，请确保已开启了 git 的凭证存储功能，以便后续可以由 CMake 自动触发同步，无需重复输入密码。
编译项目
第三方依赖项都同步完成后，直接使用 CLion 打开项目根目录即可开始编译。若第三方依赖项发生改变，刷新 CMakeLists.txt 文件即可自动同步。** 如果在 CMake 编译过程中遇到报错，可以尝试更新 CMake 命令行工具到最新的版本然后重新编译**。
注：由于团队日常主要都在 macOS 平台上进行开发，Windows 平台偶尔可能会出现编译不通过的情况，如果遇到阻塞的问题欢迎通过提交 issue 或 QQ 群即时跟我们反馈。
文章转载Github：https://github.com/Tencent/libpag
评论区