想自己编译 AnyPS5?先看完这篇:网上流传的 CMake 参数,一半是错的

原创2026-10-27 09:59:351,892 阅读
文章标签:游戏开发逆向工程编译器图形学开发工具

想自己编译 AnyPS5?先看完这篇:网上流传的 CMake 参数,一半是错的

最近科技圈最让人上头的开源项目之一,大概就是 AnyPS5。

它干的事听起来很“反常识”:不用模拟器,直接把 PS5 的游戏程序改造成 Windows 或 Linux 上能跑的原生程序。消息一出来,评论区立刻分成两派——一派喊“PS5 独占要完了”,另一派已经默默 clone 仓库,准备自己动手编译一个。

然后,绝大多数人卡在了第二步。

不是卡在原理,而是卡在编译。有人在群里问“为什么我 configure 就报错”,有人编译了四十分钟发现改的库根本没生效,还有人照着某篇教程敲了一行 -DENABLE_TESTS=ON,CMake 一声不吭地把它当成了空气——因为这个参数在这个项目里压根不存在。

今天这篇,就把“自己动手编译 AnyPS5”这件事,用大白话捋清楚:哪些坑是真的,哪些教程是抄错的,以及你到底该不该折腾。

先说清楚:这工具到底在干嘛

用一句人话概括:AnyPS5 是一个“翻译官”。

PS5 里的游戏程序,说的是 PS5 系统才听得懂的“方言”;AnyPS5 做的事,就是把这些程序重新打包、重新布线,让它们改说 Windows 或 Linux 的“普通话”,然后当作一个普通软件直接跑起来。

所以它不需要模拟一台 PS5,也不需要额外开一个“模拟器进程”在旁边伺候。游戏跑起来就是一个正常的 PC 程序,图形部分走的是 Vulkan 这条原生显卡管线。

打个比方:模拟器像是把整栋 PS5 的房子连人带家具搬进 PC,再在里面演戏;AnyPS5 更像是把房子的水电、门锁、开关全部按 PC 的规范重新改一遍,改完之后人直接住进去。

也正因为如此,它的编译不是“下一个安装包、双击运行”那么简单——它其实包含了好几个角色:负责改程序的“重链接器”、负责冒充 PS5 系统库的一整套替代库(项目里叫 prx 库),还有一个把 PS5 显卡指令翻译成 Vulkan 能懂的着色器编译器。

这些东西的编译方式,完全不一样。

第一个大坑:你以为在编译一个东西,其实是两个

这是最多人栽跟头的地方。

AnyPS5 的构建分成两条完全不同的路线,很多人上来就照着“全量编译”的命令敲,结果被一堆第三方依赖和系统库按在地上摩擦。

第一条路线,只编译“翻译官”本体。

如果你只是想体验“把一个程序转成另一个格式”这个过程,或者你想给这个项目提代码、跑跑单元测试,那么你根本不需要显卡、不需要一堆系统库、不需要拉取第三方子模块。

官方给这条路留了一个专门的开关,打开之后,它只编译重链接器和它的测试,几分钟就能出结果,Linux、Windows、甚至苹果电脑的 M 系列芯片都能跑。

这条路的意义在于:它把“我要用这个工具”和“我要开发这个工具”这两种需求彻底分开了。很多人根本不需要第二条路,却硬着头皮去啃最硬的那块骨头。

第二条路线,全量编译。

这才是能真正把游戏跑起来的那一套。它要编译那一堆冒充 PS5 系统库的共享库、着色器编译器、图形驱动层、音频解码、字体渲染……官方仓库里挂着 22 个第三方子模块,从 SDL 到 ffmpeg 到 Vulkan 相关组件,一个都不能少。

代价是什么?官方自己的持续集成里,Linux 全量构建加测试给的时间窗接近一个小时,而且是台性能不错的机器。换成一台普通笔记本,泡杯茶、洗个澡、回来看看进度条,属于正常操作。

所以第一句忠告:先问自己需要哪一条路,再决定敲哪条命令。

第二个大坑:网上流传的参数名,是编的

搜索“AnyPS5 编译参数”,你会看到不少文章信誓旦旦地写着 ENABLE_TESTS、SHADER_VERIFICATION 这些开关。

听着很合理,实际上在项目里根本搜不到。

真实存在的开关名字要“丑”一些,但很坦诚:

想编译并注册测试,用的是 BUILD_TESTING,而且默认是关的。

想启用着色器校验和优化,用的是 ANYPS5_ENABLE_SPIRV_TOOLS,默认也是关的。打开它之后,项目会在编译着色器时顺手做一遍合法性检查——相当于写完作文自己再通读一遍,慢一点,但错得少。

除此之外还有几个值得知道的:ANYPS5_RELINKER_ONLY 就是前面说的“只编译翻译官”;ANYPS5_BUILD_WASM 是编译网页版用的;ANYPS5_USE_SYSTEM_DEPS 是让你用系统里已经装好的 SDL、FreeType、Vulkan 头文件,而不是用仓库自带的版本。

还有一个特别容易被忽略的:FFMPEG_PREBUILT_DIR。默认情况下,配置阶段会自动去网上下载 FFmpeg 的预编译包。国内网络环境下这一步经常卡住,不少人以为是自己命令写错了,其实是下载超时。提前准备好本地目录,指给它,世界就安静了。

至于那个传说中的 SHADER_VERIFICATION——它不存在。你要找的功能,名字是上面那个 SPIRV 开关。

第三个大坑:编完了,却不生效

这个坑最气人,因为它不报错。

项目里的那一整套 PS5 系统库,默认是“不参与默认构建”的。也就是说,你敲一句最普通的构建命令,主程序编好了,但那些 .prx 库文件可能一个都没生成。

结果就是:你兴冲冲跑起来,发现根本找不到库;或者更糟——你明明改了某个库的代码,重新编译了一次,跑起来却和没改一样。

原因很简单:你跑的还是上一次编译出来的旧库。

正确姿势是,在常规构建之后,再单独点名构建一次库这个目标。官方文档里专门用一段话强调这件事,语气几乎是“求你别忘”。

还有一层:这些库编译出来之后,不是躺在原地等你,而是要按运行时要求的目录结构摆放好,游戏才认。Windows 上更麻烦一点,除了库文件,还得把编译器自带的三个运行时 DLL 一起拷过去——否则你会收获一个经典的“错误码 126”,翻译成人话就是“我找不到依赖”。

第四个大坑:环境准备,比命令本身更重要

这部分最枯燥,但也最决定生死。

Linux 上,最容易翻车的不是编译器,而是显示和音频相关的开发包。SDL 在配置阶段会检查 X11、Wayland、音频后端这些东西,少一个它就直接配置失败。很多人看到报错第一反应是“项目有 bug”,其实是系统里少装了几个开发包。Fedora 上还有个经典问题:CMake 报找不到线程库,装两个静态库就好。

Windows 上,坑集中在工具链。这个项目对编译器的异常处理机制有明确要求,官方点名推荐了两种:一种是 WinLibs 的特定版本,另一种是 MSYS2 的 UCRT64 版本。而某些包管理器里那个“独立版 GCC”,看着版本号挺新,实际上用的异常模型不对,全量编译必然失败——但它编译“翻译官”本体是没问题的,所以你会看到有人说“能编”,有人说“编不了”,其实大家说的不是同一件事。

另外还有两个很“现实”的坑:一是 Windows 自带的杀毒软件,可能会把测试过程中生成的小程序当成可疑文件隔离掉,导致一堆测试莫名其妙失败;二是系统里那个脚本执行策略,可能让某个第三方库的头文件生成步骤直接停摆。

这些都不是技术难题,纯粹是“知道就一分钟,不知道就一整天”。

那到底该怎么排顺序?

把上面的东西串起来,其实就三步,顺序别乱:

先拉齐所有第三方依赖,这一步偷懒,后面全是玄学错误。

然后配置 + 构建主程序,这一步决定你有没有工具可用。

最后单独构建系统库,这一步决定你转出来的程序能不能真的跑起来。

中间那个把函数名改写成 PS5 内部编号的工具,是跟着库一起自动完成的,不用你手动操心。

如果只是想做转换、不碰底层,那就老老实实走“只编译翻译官”那条路,别为难自己。

普通人真的需要编译吗?

说实话,大概率不需要。

项目方自己也知道这件事有多劝退,所以他们做了一个网页版转换器:打开网页,把打包好的程序拖进去,选 Windows 还是 Linux,点转换,等进度条走完下载结果。

最关键的一点:文件不上传,全程在你自己的电脑上算。这对很多介意隐私的人来说,比什么功能都重要。

当然网页版有天花板——内存下载有容量限制,大一点的东西就得改成“打包成压缩包存到硬盘”,再大的就得老老实实回到本地用命令行工具。

所以人群其实很清楚:

只想试试水、转个小程序看看效果的,用网页版就够了;想研究兼容性、想看某个游戏卡在哪一步、想给项目提改进的,才需要折腾本地全量编译。

最后说点冷静的

网上有些标题写得像“PS5 游戏全面登陆 PC”,这话现在说太早。

项目自己的进度数据很诚实:系统库那部分,已知函数实现了大约一半多一点;着色器指令这一块倒是做到了全覆盖;真正完整验证过的游戏,目前还只有一款,在核显上跑到三十多帧,在入门独显上能稳六十帧。

而且这个项目的脾气很“硬”:遇到不支持的情况,它不装死、不假装成功,而是直接抛错、打印原因、然后退出。对普通玩家来说这很扫兴,但对想参与的人来说,这是最好的设计——因为它把“哪里不行”明明白白写在了脸上。

也正因为如此,“自己编译一遍”这件事,对真正的技术爱好者来说不是折磨,而是一次难得的现场教学:你会亲眼看到,把一个平台的东西搬到另一个平台,中间要填多少坑。

如果你真的动手了,欢迎回来聊聊——你是在哪一步卡住的?是那个不存在的参数,还是那个忘记编译的库?

说不定你踩的那个坑,正好能帮下一个省下三小时。

登录后查看全文
AnyPS5