在Mac M1上编译sioyek项目的注意事项

sioyek是一款PDF阅读器软件，在Mac平台上编译时可能会遇到一些特殊问题，特别是在Apple Silicon(M1/M2)架构的设备上。本文将详细介绍编译过程中可能遇到的问题及其解决方案。

环境准备

首先需要明确的是，sioyek的development分支要求使用Qt 6.7或更高版本，不再兼容Qt 5。这是编译前必须确认的关键点。

对于Mac用户，特别是使用Apple Silicon芯片的设备，需要特别注意以下几点：

1. 必须安装Qt 6.7+版本
2. 需要明确指定arm64架构
3. 可能需要处理macOS的安全限制

常见编译错误及解决方案

Qt版本不匹配错误

在编译过程中，如果出现类似"no matching function for call to 'invokeMethod'"的错误，这通常表明使用了不兼容的Qt版本。解决方案是确保安装了正确版本的Qt：

brew install qt@6

架构相关错误

在Apple Silicon设备上编译时，可能会遇到关于arm64架构的链接错误，如"Undefined symbols for architecture arm64"。这是因为默认配置可能没有正确指定目标架构。

解决方法是在pdf_viewer_build_config.pro文件的mac部分添加以下配置：

QMAKE_APPLE_DEVICE_ARCHS = arm64

运行时路径问题

编译完成后，可能会看到关于rpath的警告信息。这些警告通常不会影响最终生成的应用程序，但如果应用程序无法启动，可能需要检查Qt框架是否正确链接。

macOS安全限制处理

新版本的macOS引入了严格的安全机制，可能会导致从非App Store渠道安装的应用程序无法运行，并显示"应用程序已损坏"的提示。

解决这个问题的方法是使用以下命令移除应用的隔离属性：

xattr -cr /Applications/sioyek.app

总结

在Apple Silicon Mac上编译sioyek项目需要注意以下几点：

1. 使用Qt 6.7或更高版本
2. 明确指定arm64架构
3. 处理可能出现的运行时路径问题
4. 解决macOS的安全限制

遵循以上步骤，应该能够在M1/M2 Mac上成功编译并运行sioyek应用程序。如果遇到其他问题，可以参考项目的GitHub Actions配置，了解官方的构建流程。