桌面端接入指南

接入方式

桌面端（macOS、Windows、Linux）暂不提供统一的制品库，需要开发者根据源码自行构建，但我们会提供编译指引。PAG是跨平台的，不同平台之间的API接口具有一致性。

具体原因如下：

  1. Windows端没有统一的UI框架；
  2. Linux端由于服务端CPU型号或系统版本的差异，统一的制品库难以完全兼容

API接口使用

在PAG的源码工程中，C++层基本上所有对外提供的方法都进行了测试用例的覆盖，如果想了解具体方法的使用，查看相关测试用例是一种很便捷的途径。

macOS端接入

基本要求

  • macOS 10.14 or later

编译构建

macOS端的项目工程位于源码根目录mac文件夹下，为Xcode工程，开发者可以自行构建

Windows接入指南

编译工具

  • Visual Studio 最低版本要求VS2015
  • PAG Source Code 从Github获取最新的PAG源码
  • Node.js PAG依赖管理的基础
  • depsync 用于PAG的依赖管理

环境准备

  1. 从Node.js官网获取并安装Node.js
  2. 通过npm安装 
    npm install depsync -g

运行Demo

  1. 执行libpag\win\Win32Demo.sln启动Demo工程
  2. 运行Demo。首次执行时会同步依赖和编译PAG，会比较耗时
  3. 随Demo构建的pag.lib是release的，需要构建debug版可以参考下边的指引

使用PAG【Angle backend】

  1. 首次运行时，在libpag根目录下执行

    depsync

  2. 在根目录执行cmake-build生成PAG，会同时生成32位和64位的pag.lib

    node .\vendor_tools\cmake-build pag -p win -o .\win\paglib -v -i -DPAG_BUILD_SHARED=OFF
    • -p platform，在Windows下选择win
    • -o output，指定输出目录
    • -i incremental，增量编译开关，关闭时会清理编译目录
    • -d debug，debug开关
    • -v verbose，详细打印日志
    • DPAG_BUILD_SHARED 动态库编译开关

  1. 头文件位置

    libpag\include

  2. 在自己的工程内使用的时候，还需要在工程属性->链接器->输入->附加依赖项中添加两个系统库

    Bcrypt.lib
ws2_32.lib

  3. 在使用Angle backend时，可执行程序需要链接Angle动态库

    libpag\vendor\angle\win\

使用PAG【QT backend】

  • Demo的位置在 
    libpag\qt
  • 请提前安装好 VS2019 版本，至少必须同时安装 [使用 C++ 的桌面开发] 和 [通用 Windows 平台开发] 两个子模块。
  • 在 CLion 的选项菜单里搜索 ToolChain ，设置默认编译工具为 Visual Studio，并选择 amd64 架构。
  • 用 CLion 打开根目录下的 qt 文件夹，首次刷新会提示 QT SDK 找不到，请打开自动生成的 qt/QTCMAKE.cfg 配置文件，修改其中的 QT 路径为本地安装路径即可。例如：C:/Qt/Qt5.13.0/5.13.0/msvc2017_64/lib/cmake。
  • 在 CLion 中打开 PAGViewer 目标的配置面板，在 Environment Variables 一行填入本地 QT 的 DLL 库路径，例如：PATH=C:\Qt\Qt5.13.0\5.13.0\msvc2017_64\bin。
  • 最后编译并运行 PAGViewer 目标即可。

Linux端接入

基本要求

  • gcc版本不低于7.0

编译构建

  1. 开发者参照源码根目录下的Linux_build.md完成依赖环境的安装

  2. 通过根目录下的build_linux.sh完成pag库文件的构建

  3. 编译生成的头文件和库文件位于linux/vendor 目录下

Demo工程

Demo工程通过CMake来组织，依赖的库文件来自于上一步的构建

在linux目录下

 mkdir build
 cd build
 cmake ../
 make -j8
 ./pag-linux

Demo工程仅仅提供了库文件的编译和简单的使用范例，如果需要占位图填充视频或者导出视频，需要使用者自行开发

← 移动端接入指南Web端接入指南 →