Mac平台pkgbuild/ProductBuild打包：能否复制文件至用户文档及实现方法？

1. 能否复制到用户文档文件夹？ #

可以，但无法直接通过pkgbuild的基础参数实现。用户文档目录（~/Documents）属于每个用户的个人空间，而pkgbuild默认打包逻辑针对系统级路径（如/Applications、/Library），这类动态用户路径的文件复制，必须借助post-install脚本完成。

2. 用post-install脚本实现的具体步骤 #

2.1 源文件的存放位置 #

把需要复制的额外文件放在pkgbuild打包的payload目录下的临时占位路径中，比如/tmp/my_extra_files——这个路径会被打包进安装包，安装时会先解压到系统的对应临时目录里。

示例结构（假设要复制guide.pdf）：

payload/
└── tmp/
    └── my_extra_files/
        └── guide.pdf

2.2 脚本中路径的指定方式 #

post-install脚本默认以root权限执行，所以必须获取当前登录用户的Documents路径，不能直接用root的HOME目录。

示例post-install脚本：

#!/bin/bash

# 获取当前登录的普通用户（避免使用root的HOME）
CURRENT_USER=$(stat -f "%Su" /dev/console)
# 获取该用户的Documents目录绝对路径
USER_DOCUMENTS=$(su - "$CURRENT_USER" -c 'echo $HOME/Documents')

# 安装包解压后的源文件路径
SOURCE_FILE="/tmp/my_extra_files/guide.pdf"

# 执行复制（用当前用户权限，避免权限冲突）
if [ -f "$SOURCE_FILE" ]; then
    su - "$CURRENT_USER" -c "cp '$SOURCE_FILE' '$USER_DOCUMENTS'"
    # 可选：清理临时文件
    rm -rf /tmp/my_extra_files
fi
exit 0

2.3 打包时关联脚本 #

将脚本放在单独的scripts目录下，用pkgbuild的--scripts参数指定：

pkgbuild --root payload/ --scripts scripts/ --identifier com.yourcompany.yourapp --version 1.0 --install-location / your_app.pkg

注：--install-location /是因为payload里的/tmp路径要对应系统根目录下的/tmp，确保安装时文件能正确解压到临时位置。

3. productbuild是否有对应选项？ #

productbuild本身也没有直接复制到用户Documents目录的专属参数，同样需要借助post-install脚本实现。productbuild主要用于创建符合Mac App Store标准的安装包，或合并多个子pkg为分发包，你可以在子pkg中嵌入post-install脚本，或通过productbuild的--scripts参数指定全局脚本，实现逻辑和pkgbuild完全一致。

内容的提问来源于stack exchange，提问作者Navaneeth A S