使用py2app构建Python独立应用，附setup.py配置代码

我帮你梳理下用py2app打包这个Pygame应用的正确步骤，你的setup.py已经有了基础框架，但还有几个关键细节需要调整，才能让自定义模块和资源文件正确被打包进去：

1. 修正setup.py的核心配置 #

首先，你的setup.py里有两个小问题需要调整，同时要补充自定义模块的包含规则：

（1）调整includes的格式 #

原代码里'includes': ('pygame'),会被当成字符串而非元组，建议直接用列表格式，同时要把你自定义的Button、Enemy模块加进去——py2app不会自动检测本地自定义模块，必须手动声明：

'includes': ['pygame', 'Button', 'Enemy'],

如果这些自定义模块放在某个子目录里（比如src/），那你需要用packages参数来指定整个目录，比如'packages': ['src'],

（2）规范数据文件的结构 #

原DATA_FILES的写法会把所有资源文件直接放到应用包的根资源目录，容易导致文件混乱，建议用**(目标目录, 源文件列表)**的结构，这样打包后资源会保持原文件夹结构：

DATA_FILES = [
    ('images', ['images/ship.png', 'images/ufo.png', 'images/ship.icns']),
    ('fonts', ['fonts/a_lcdnova.ttf'])
]

这样打包后，images和fonts文件夹会完整出现在应用包的Contents/Resources目录下，和你开发时的路径结构一致。

修正后的完整setup.py #

from setuptools import setup
import os

APP = ['main.py']
# 保持资源文件夹结构的DATA_FILES配置
DATA_FILES = [
    ('images', ['images/ship.png', 'images/ufo.png', 'images/ship.icns']),
    ('fonts', ['fonts/a_lcdnova.ttf'])
]
APP_NAME = "Alien Invasion"
OPTIONS = {
    'argv_emulation': True,
    # 包含pygame和自定义模块
    'includes': ['pygame', 'Button', 'Enemy'],
    'iconfile': 'images/ship.icns'
}

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

2. 调整代码中资源的加载路径 #

打包后，应用内部的资源路径会发生变化，你需要确保main.py和自定义模块里加载资源的代码能正确找到文件。比如原来的pygame.image.load('images/ship.png')需要改成基于资源目录的路径：

import os
import pygame

# 获取应用包内的资源目录路径
resource_dir = os.path.join(os.path.dirname(__file__), '..', 'Resources')
# 或者用py2app适配的方式（需提前安装pyobjc-core）
# from Foundation import NSBundle
# resource_dir = NSBundle.mainBundle().resourcePath()

# 加载资源
ship_img = pygame.image.load(os.path.join(resource_dir, 'images/ship.png'))
font = pygame.font.Font(os.path.join(resource_dir, 'fonts/a_lcdnova.ttf'), 24)

3. 执行打包命令 #

在终端里执行以下步骤：

• 先清理之前的构建缓存（避免旧文件干扰）：

  rm -rf build dist
  

• 运行打包命令：

  python setup.py py2app
  

如果用的是虚拟环境，确保已经激活虚拟环境再执行命令。

4. 测试打包后的应用 #

打包完成后，dist目录下会生成Alien Invasion.app，双击运行测试。如果出现资源找不到的错误，检查：

• DATA_FILES的配置是否正确
• 代码中资源路径的拼接是否正确
• 自定义模块是否都添加到了includes或packages里

内容的提问来源于stack exchange，提问作者user9539432