macOS安装包自定义.app安装路径的实现方案咨询

搞定这个macOS安装包的特殊路径需求其实不难，我给你分两种场景来拆解——优先实现用户自定义安装路径，要是有特殊限制没法做的话，就 fallback 到自动把App解压到安装包所在目录的方案，全用苹果官方工具实现，稳得很：

这个方案需要用pkgbuild和productbuild配合自定义的分发配置文件，让用户在安装过程中选择自己想要的路径。

步骤1：先构建基础组件包 #

把你的SomeApp.app打包成一个不带固定安装路径的组件包，临时安装到系统临时目录：

pkgbuild --component SomeApp.app --identifier com.yourcompany.someapp --version 1.0 --install-location "/tmp/someapp_temp" SomeAppComponent.pkg

这里的identifier和version换成你自己的信息就行。

步骤2：创建分发配置文件（distribution.xml） #

这个文件用来定义安装界面的行为，包括让用户选择路径的逻辑。新建一个distribution.xml文件，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<installer-gui-script minSpecVersion="1">
    <title>SomeApp 安装器</title>
    <welcome file="welcome.html" />
    <license file="license.html" />
    <choice description="安装 SomeApp" id="choice1" title="SomeApp">
        <pkg-ref id="com.yourcompany.someapp"/>
    </choice>
    <!-- 强制显示自定义安装选项 -->
    <options customize="always" require-scripts="false" />
    <!-- 允许安装到任意位置、当前用户目录 -->
    <domains enable_anywhere="true" enable_currentUserHome="true" enable_localSystem="false" />
    <!-- 自定义选择路径的脚本 -->
    <script>
        function chooseDestination() {
            var result = installer.chooseFolder("请选择 SomeApp 的安装路径：", "选择安装路径");
            if (result != null) {
                var pkgRef = installer.packageReferenceWithIdentifier("com.yourcompany.someapp");
                pkgRef.setInstallLocation(result.path());
            }
            return true;
        }
        installer.registerDefaultCallback("chooseDestination", chooseDestination);
    </script>
</installer-gui-script>

说明： 如果你不需要欢迎页或协议页，可以删掉<welcome>和<license>行；enable_localSystem="false"是禁止安装到系统级目录（比如/Applications），符合你的需求。

步骤3：打包成最终安装包 #

把组件包和分发配置文件合并成最终的.pkg，如果有欢迎页、协议页的资源，放在resources文件夹里：

productbuild --distribution distribution.xml --package-path . --resources ./resources SomeApp.pkg

没有资源文件夹的话，去掉--resources ./resources就行。

如果自定义路径的方案因为签名、权限等限制没法实现，就用这个方案——安装时自动把SomeApp.app放到和安装包同目录的SomeApp子文件夹里。

步骤1：构建带临时安装路径的组件包 #

还是先把App打包到临时目录：

pkgbuild --component SomeApp.app --identifier com.yourcompany.someapp --version 1.0 --install-location "/private/tmp/someapp_temp" SomeAppComponent.pkg

步骤2：编写postinstall脚本 #

新建一个scripts文件夹，里面放postinstall脚本，给脚本加执行权限chmod +x scripts/postinstall，内容如下：

#!/bin/bash

# 获取安装包所在的原始路径
PKG_PATH="$PACKAGE_PATH"
# 兜底：如果环境变量取不到，从安装日志里找最近的pkg路径
if [ -z "$PKG_PATH" ]; then
    PKG_PATH=$(grep -o '/.*\.pkg' /var/log/install.log | tail -n 1)
fi

if [ -n "$PKG_PATH" ]; then
    # 目标目录：安装包所在目录下的SomeApp文件夹
    INSTALL_DIR=$(dirname "$PKG_PATH")/SomeApp
    # 创建目录（如果不存在）
    mkdir -p "$INSTALL_DIR"
    # 把App从临时目录移动到目标目录
    mv "/private/tmp/someapp_temp/SomeApp.app" "$INSTALL_DIR/"
    # 清理临时文件
    rm -rf "/private/tmp/someapp_temp"
fi

exit 0

步骤3：重新构建带脚本的组件包 #

把脚本加入到组件包中：

pkgbuild --component SomeApp.app --identifier com.yourcompany.someapp --version 1.0 --install-location "/private/tmp/someapp_temp" --scripts ./scripts SomeAppComponent.pkg

步骤4：生成最终安装包 #

直接把组件包打包成最终的安装包就行：

productbuild --package SomeAppComponent.pkg SomeApp.pkg

• 签名：如果要分发到外部，记得用productsign给安装包签名，比如：

  productsign --sign "Developer ID Installer: Your Company Name" SomeApp.pkg SignedSomeApp.pkg
  

• 权限测试：一定要在不同目录测试（比如~/Downloads、~/Desktop），确保App能被正确移动，且普通用户能访问目标目录的App。
• 日志排查：如果安装出问题，查看/var/log/install.log找错误信息。

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