macOS下py2app打包的应用上传Google Drive后他人下载无法启动怎么办

第一步：获取精准报错信息 #

当前报错过于笼统无法定位，优先让朋友执行以下操作获取完整日志：

• 右键点击应用图标，选择「显示包内容」
• 依次进入Contents/MacOS目录，双击目录内和应用同名的可执行文件
• 终端会弹出完整运行日志，将日志内容发送给你即可精准定位问题根因

常见问题排查与修复方案 #

以下是该场景下最高发的几类问题及对应修复方式：

• 文件权限/隔离属性丢失
  未压缩的.app包直接通过网盘传输时，大概率会丢失执行权限、扩展属性，或者苹果的隔离标记异常。你可以编写以下shell脚本，和应用放在同一目录下发给朋友执行即可修复：

  #!/bin/bash
  # 将MyApp.app替换为你的实际应用名称
  TARGET_APP="MyApp.app"
  # 清除所有扩展属性（包括隔离标记）
  xattr -cr "$TARGET_APP"
  # 修复可执行文件权限
  chmod -R 755 "$TARGET_APP/Contents/MacOS/"
  # 临时本地签名绕开签名校验
  codesign --force --deep --sign - "$TARGET_APP"
  

• 未使用独立模式打包
  若打包时未加--standalone参数，生成的app不会内置Python解释器，会依赖用户本地的Python环境，版本不匹配就会崩溃。重新打包时使用以下指令即可：

  python3 setup.py py2app --standalone
  

  该模式会将你开发用的Python版本、所有依赖库全部打包进app，用户无需安装任何Python相关环境即可运行。
• 系统版本兼容问题
  py2app默认仅兼容和打包设备（macOS Big Sur 11.6）相同或更高版本的系统，若朋友使用更低版本的macOS，会出现框架依赖缺失报错。打包前先在终端执行以下指令指定最低兼容版本，再执行打包命令即可：

  export MACOSX_DEPLOYMENT_TARGET=10.15
  

  可根据实际需要调整版本号。
• 资源文件路径错误
  若代码中使用相对路径读取资源文件，打包后运行的工作目录会发生变化，导致资源读取失败崩溃。将代码中资源路径替换为以下适配逻辑即可：

  import os
  import sys
  
  if getattr(sys, 'frozen', False):
      # 打包后运行时的资源目录
      RES_BASE = os.path.join(os.path.dirname(sys.executable), '..', 'Resources')
  else:
      # 开发阶段的资源目录
      RES_BASE = os.path.dirname(os.path.abspath(__file__))
  
  # 所有资源读取都使用该路径拼接，例如:
  # icon_path = os.path.join(RES_BASE, "icon.png")
  

后续分发优化建议 #

打包完成后，先右键将.app包压缩为zip格式再上传到网盘，zip可以完整保留macOS应用的目录权限、扩展属性，避免传输过程中的文件属性损坏，用户下载后解压即可正常启动，无需额外操作。

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