Mac下Py2App打包Python应用：添加CefPython库及解决报错

我之前也踩过类似的坑，Py2App对CefPython这种带大量二进制资源的库支持不太友好，直接加packages参数会因为它的非标准包结构报错。咱们一步步来搞定：

核心问题分析 #

CefPython不只是纯Python模块，它还包含CEF的二进制框架、资源文件等，Py2App默认不会自动识别这些额外资源；而直接在OPTIONS里加packages=['cefpython3']，Py2App解析模块时会因为某些内部路径问题抛出TypeError: None is not a string。

修正后的setup.py配置 #

改用includes指定Python模块，同时手动把CefPython的所有二进制资源加入data_files，这样既能保证模块被打包，又能把核心依赖的资源复制到.app里。示例代码如下：

from setuptools import setup
import os
import cefpython3

# 替换成你的主脚本文件名
APP = ['main.py']
DATA_FILES = []
OPTIONS = {
    'argv_emulation': True,
    # 确保Python模块被包含
    'includes': ['cefpython3', 'objc'],
    'plist': {
        'CFBundleName': '你的应用名称',
        'CFBundleDisplayName': '你的应用名称',
        'CFBundleVersion': '1.0.0',
        'NSHighResolutionCapable': True,
    },
}

# 手动遍历CefPython的安装目录，收集所有非pyc的资源文件
cef_install_path = os.path.dirname(cefpython3.__file__)
for root, _, files in os.walk(cef_install_path):
    for file in files:
        # 跳过编译后的pyc文件
        if not file.endswith('.pyc'):
            source_path = os.path.join(root, file)
            # 计算相对路径，保证资源在.app里的结构和原目录一致
            dest_rel_path = os.path.relpath(root, cef_install_path)
            DATA_FILES.append((dest_rel_path, [source_path]))

setup(
    app=APP,
    data_files=DATA_FILES,
    options={'py2app': OPTIONS},
    setup_requires=['py2app', 'cefpython3'],
)

额外调试与注意事项 #

1. 清理缓存：打包前先删除之前的构建文件，避免旧缓存干扰：

   rm -rf build dist
   

2. 别名模式测试：用别名模式快速打包测试，不用生成完整的.app，节省时间：

   python setup.py py2app -A
   

3. CefPython初始化：确保你的主脚本里正确初始化和销毁CefPython，比如：

   import cefpython3 as cef
   import sys
   
   def main():
       cef.Initialize()
       # 你的应用逻辑
       cef.MessageLoop()
       cef.Shutdown()
   
   if __name__ == '__main__':
       main()
   

4. 版本兼容性：确认你的Python版本（建议3.8+）、Py2App版本和CefPython版本相互兼容，老版本可能会有各种奇怪的问题。

内容的提问来源于stack exchange，提问作者We are Borg