XCode 编译 PAG 源码

最近工作中要使用PAG替换Lottie,为了方便阅读源码,使用XCode对其源码进行了编译。

1 下载源码

编译源码首先要下载源码,有关PAG源码可直接到github上下载。

2 添加相关依赖

下载源码之后,进入到PAG项目根目录,执行如下脚本:

bash 复制代码
./sync_deps.sh

3 构建 iOS PAGViewer 工程

PAG项目包含多种平台下的代码,包括iOSWindowsLinux等。我们只关注iOS

从根目录进入到iOS目录,双击gen_ios文件。执行完毕后,目录下会多出一个PAGViewer.xcworkspace

4 设置 XCode 签名证书

点击PAGViewer.xcworkspace,进入到PAG项目工程,做下图配置,这样可以将PAGViewer编译到自己手机上:

当设置完Team之后会报错,可以删除Bundle Identifier,然后点击Signing Certification下面的Try Again按钮。

5 编译

XCode中选择PAGViewer``Target以及要iPhone手机,点击进行编译:

6 脚本设置

能一帆风顺的源码编译经常是可遇而不可求,PAG源码编译也一样。

编译过程中,会收到如下报错:

看报错信息,是在编译tgfx项目,运行脚本时,脚本命令出错,出错的命令是node命令。

首先查看Mac上是否安装了node

Mac终端运行node -v,如果输出如下版本信息,说明已经安装:

bash 复制代码
v22.5.1

既然安装了node,那XCode为啥还报错找不到呢?

原因是XCode运行脚本时的PATH环境变量与终端中的PATH环境变量不同。

XCode的进程环境变量是由macOS系统在启动时设定的,而不是由用户的Shell配置文件(如~/.bash_profile)直接设定的。

也就是说,我们安装的node的路径,不在XCodePATH环境变量下。

为了查看XCodePATH环境变量,可以按照下图进行设置,将XCodePATH环境变量输出到XCodeReport面板:

上图中CMake PostBuild Rules会执行一个脚本,正是这个脚本在编译中报错。

在脚本中添加echo命令,输出XCodePATH信息:

bash 复制代码
echo "当前 PATH: $PATH"

再次编译PAGViewer Target,仍然失败,但是XCodeReport面板已有输出信息:

将上面XCodePATH信息拷贝保存下来,然后在Mac终端运行which node命令,查看Macnode的安装目录:

bash 复制代码
localhost:~$ which node
/opt/homebrew/bin/node

可以验证,Mac上的node安装目录/opt/homebrew/bin不在XCodePATH环境变量中。

为了解决这个问题,我们需要将这个目录添加到XCode的环境变量中,方式就是在刚才的脚本里,添加一条export语句:

完成之后,会发现编译tgfx-vendor也会出现同样的脚本问题,也是按照上述方式解决:

最后,再次编译,就会发现PAG源码被你成功编译了!!

相关推荐
HH思️️无邪6 个月前
iOS 腾讯Pag动画框架-实现PagView的截图功能
ios·swift·pag
好名全被用1 年前
vue使用,引用 腾讯pag 播放文件,且解决销毁问题
前端·javascript·vue.js·pag