PyArmor跨平台运行时文件查找问题分析与解决方案

问题背景

在使用PyArmor进行Python代码混淆和打包时，开发者遇到了一个典型问题：当尝试为MacOS的两种不同架构(x86_64和aarch64)生成单一可执行文件时，系统报错"RuntimeError: no pyarmor runtime files found"。这个问题在MacOS系统升级和Python版本降级后出现，但在Windows环境下仍能正常工作。

问题根源分析

深入分析后发现，问题的核心在于PyArmor运行时文件的查找机制。当为多个平台架构(如darwin.x86_64和darwin.aarch64)生成运行时文件时，PyArmor会创建如下目录结构：

runtime_folder/
    __init__.py
    darwin_aarch64/
        pyarmor_runtime.so
    darwin_x86_64/
        pyarmor_runtime.so

然而，PyArmor的repack函数中的查找逻辑仅检查运行时目录的根层，不会递归搜索子目录。这导致在多架构打包场景下无法正确找到运行时文件。

技术细节

PyArmor的原始查找逻辑如下：

for x in os.listdir(rtpath):
    ext = os.path.splitext(x)[-1]
    if x.startswith('pyarmor_runtime') and ext in ('.so', '.pyd'):
        rtbinary = os.path.join(rtpath, x)
        rtbinname = os.path.join(rtname, x)
        break
else:
    raise RuntimeError('no pyarmor runtime files found')

这段代码仅检查运行时目录的根层文件，而不会递归搜索子目录中的运行时文件。

解决方案

针对这一问题，可以修改查找逻辑为递归搜索：

def find_pyarmor_runtime(rtpath, rtname):
    for root, dirs, files in os.walk(rtpath):
        for filename in files:
            if filename.startswith('pyarmor_runtime') and filename.endswith(('.so', '.pyd')):
                return os.path.join(root, filename), os.path.join(rtname, filename)
    raise RuntimeError('no pyarmor runtime files found')

需要注意的是，此修改会返回第一个找到的运行时文件，可能无法同时支持多种架构。对于需要同时支持多种架构的场景，可能需要更复杂的处理逻辑。

跨平台打包建议

对于需要支持多种架构的MacOS应用打包，开发者应考虑以下方案：

1. 为每种架构单独打包：创建两个独立的可执行文件，分别针对x86_64和aarch64架构

2. 使用通用二进制(Universal Binary)：虽然PyArmor目前可能不完全支持，但可以探索将两种架构的运行时文件合并的方案

3. 检查PyArmor版本：确保使用最新版本，因为运行时文件处理逻辑可能在不同版本间有所变化

总结

PyArmor在多平台架构打包时存在运行时文件查找的限制，开发者需要了解这一限制并根据实际需求选择合适的解决方案。对于关键业务场景，建议进行充分的测试验证，确保混淆后的应用在各目标平台上都能正常运行。

这个问题也提醒我们，在进行系统升级或Python版本变更时，需要对依赖工具链进行全面测试，确保所有功能仍能按预期工作。