使OS X安装程序包像Pro-Xcode Developer ID一样准备好pkg

Question

注意:这仅适用于OS X Installer程序包,提交到Mac App Store的程序包遵循不同的规则.

由于Mountain Lion的Gatekeeper,我终于不得不把我的PackageMaker构建脚本放在谷仓后面并拍摄它.PackageMaker已经从Xcode中删除并转移到"Xcode的辅助工具"中,所以希望它很快就会被遗忘.

现在的问题是我怎么用pkgbuild,productbuild和pkgutil来代替它？

Answer 1

我们的示例项目有两个构建目标:HelloWorld.app和Helper.app.我们为每个组件创建一个组件包,并将它们组合到一个产品档案中.

甲组件包包含要由OS X安装程序安装的有效载荷.虽然组件包可以单独安装,但它通常包含在产品存档中.

我们的工具:pkgbuild,productbuild和pkgutil

成功"构建和存档"后,在终端中打开$ BUILT_PRODUCTS_DIR.

$ cd ~/Library/Developer/Xcode/DerivedData/.../InstallationBuildProductsLocation
$ pkgbuild --analyze --root ./HelloWorld.app HelloWorldAppComponents.plist
$ pkgbuild --analyze --root ./Helper.app HelperAppComponents.plist

这为我们提供了组件 - plist,您可以在"组件属性列表"部分找到值描述.pkgbuild -root生成组件包,如果您不需要更改任何默认属性,则可以省略以下命令中的--component-plist参数.

productbuild --synthesize导致分布定义.

$ pkgbuild --root ./HelloWorld.app \
    --component-plist HelloWorldAppComponents.plist \
    HelloWorld.pkg
$ pkgbuild --root ./Helper.app \
    --component-plist HelperAppComponents.plist \
    Helper.pkg
$ productbuild --synthesize \
    --package HelloWorld.pkg --package Helper.pkg \
    Distribution.xml 

在Distribution.xml中,您可以更改标题,背景,欢迎,自述文件,许可证等内容.您可以使用此命令将组件包和分发定义转换为产品归档:

$ productbuild --distribution ./Distribution.xml \
    --package-path . \
    ./Installer.pkg

我建议您查看iTunes Installers Distribution.xml以了解可能的情况.您可以使用以下命令提取"安装iTunes.pkg":

$ pkgutil --expand "Install iTunes.pkg" "Install iTunes"

让我们把它放在一起

我的项目中通常有一个名为Package的文件夹,其中包括Distribution.xml,component-plists,resources和scripts等内容.

添加名为"Generate Package" 的运行脚本构建阶段,该阶段设置为仅在安装时运行脚本:

VERSION=$(defaults read "${BUILT_PRODUCTS_DIR}/${FULL_PRODUCT_NAME}/Contents/Info" CFBundleVersion)

PACKAGE_NAME=`echo "$PRODUCT_NAME" | sed "s/ /_/g"`
TMP1_ARCHIVE="${BUILT_PRODUCTS_DIR}/$PACKAGE_NAME-tmp1.pkg"
TMP2_ARCHIVE="${BUILT_PRODUCTS_DIR}/$PACKAGE_NAME-tmp2"
TMP3_ARCHIVE="${BUILT_PRODUCTS_DIR}/$PACKAGE_NAME-tmp3.pkg"
ARCHIVE_FILENAME="${BUILT_PRODUCTS_DIR}/${PACKAGE_NAME}.pkg"

pkgbuild --root "${INSTALL_ROOT}" \
    --component-plist "./Package/HelloWorldAppComponents.plist" \
    --scripts "./Package/Scripts" \
    --identifier "com.test.pkg.HelloWorld" \
    --version "$VERSION" \
    --install-location "/" \
    "${BUILT_PRODUCTS_DIR}/HelloWorld.pkg"
pkgbuild --root "${BUILT_PRODUCTS_DIR}/Helper.app" \
    --component-plist "./Package/HelperAppComponents.plist" \
    --identifier "com.test.pkg.Helper" \
    --version "$VERSION" \
    --install-location "/" \
    "${BUILT_PRODUCTS_DIR}/Helper.pkg"
productbuild --distribution "./Package/Distribution.xml"  \
    --package-path "${BUILT_PRODUCTS_DIR}" \
    --resources "./Package/Resources" \
    "${TMP1_ARCHIVE}"

pkgutil --expand "${TMP1_ARCHIVE}" "${TMP2_ARCHIVE}"

# Patches and Workarounds

pkgutil --flatten "${TMP2_ARCHIVE}" "${TMP3_ARCHIVE}"

productsign --sign "Developer ID Installer: John Doe" \
    "${TMP3_ARCHIVE}" "${ARCHIVE_FILENAME}"

如果你没有它与产生之后,更改包productbuild你可以摆脱pkgutil --expand和pkgutil --flatten步骤.您也可以在productbuild上使用--sign paramenter而不是运行productsign.

签署OS X安装程序

软件包使用Developer ID Installer证书进行签名,您可以从Developer Certificate Utility下载该证书.

他们使用pkgbuild,productbuild或productsign--sign "Developer ID Installer: John Doe"参数完成签名.

请注意,如果要使用productbuild 创建签名的产品归档,则没有理由签署组件包.

一路:将包复制到Xcode存档中

要将某些内容复制到Xcode存档中,我们无法使用" 运行脚本构建阶段".为此,我们需要使用Scheme Action.

编辑方案并展开存档.然后单击post-actions并添加New Run Script Action:

在Xcode 6中:

#!/bin/bash

PACKAGES="${ARCHIVE_PATH}/Packages"

PACKAGE_NAME=`echo "$PRODUCT_NAME" | sed "s/ /_/g"`
ARCHIVE_FILENAME="$PACKAGE_NAME.pkg"
PKG="${OBJROOT}/../BuildProductsPath/${CONFIGURATION}/${ARCHIVE_FILENAME}"

if [ -f "${PKG}" ]; then
    mkdir "${PACKAGES}"
    cp -r "${PKG}" "${PACKAGES}"
fi

在Xcode 5中,使用此值PKG代替:

PKG="${OBJROOT}/ArchiveIntermediates/${TARGET_NAME}/BuildProductsPath/${CONFIGURATION}/${ARCHIVE_FILENAME}"

如果你的版本控件没有存储Xcode Scheme信息,我建议将它作为shell脚本添加到你的项目中,这样你就可以通过将脚本从工作区拖到后期操作中来简单地恢复操作.

脚本

有两种不同的脚本:分发定义文件中的JavaScript和Shell脚本.

关于Shell Scripts的最佳文档我在WhiteBox - PackageMaker How-to中找到,但请仔细阅读,因为它引用了旧的包格式.

补充阅读

• 扁平包格式 - 缺少文档
• 安装人员问题和解决方案
• pkgbuild的愚蠢技巧
• 坚持过时

已知问题和解决方法

目的地选择窗格

向用户显示目标选择选项,只有一个选项 - "为此计算机的所有用户安装".该选项在视觉上被选中,但是用户需要单击该选项才能继续安装,从而引起一些混淆.

苹果文档建议使用,<domains enable_anywhere ... />但这会触发新的更多错误的目的地选择窗格,Apple不会在其任何包中使用.

使用deprecate可以获得<options rootVolumeOnly="true" />旧的目标选择窗格.

您想要将项目安装到当前用户的主文件夹中.

简短的回答:不要尝试!

答案很长:真的; 不要试试!阅读安装程序问题和解决方案.你知道我读完之后做了什么吗？我愚蠢到可以试试.告诉自己我确信他们已经解决了10.7或10.8中的问题.

首先,我不时看到上面提到的Destination Select Pane Bug.这本应该阻止我,但我忽略了它.如果您不想在发布软件后花一周的时间来回答支持电子邮件,那么一旦选择了漂亮的蓝色选项,就不要再使用它了.

您现在认为您的用户足够聪明,可以将面板弄清楚,不是吗？那么这是关于主文件夹安装的另一件事,他们不工作!

我在大约10台具有不同操作系统版本的机器上进行了为期两周的测试,但是它没有失败.所以我发货了.在发布后的一个小时内,我就回到那些无法安装它的用户那里.日志暗示许可问题,你无法解决.

所以让我们再重复一次:我们不使用安装程序进行主文件夹安装!

不接受RTFD for Welcome,Read-me,License和Results productbuild.

自开始使用RTFD文件以来,安装程序支持使用图像制作漂亮的欢迎屏幕,但是productbuild不接受它们.

解决方法:使用虚拟rtf文件并在productbuild完成后将其替换为包.

注意:您还可以在RTFD文件中包含Retina图像.为此使用多图像tiff文件:tiffutil -cat Welcome.tif Welcome_2x.tif -out FinalWelcome.tif.更多细节.

使用BundlePostInstallScriptPath脚本完成安装时启动应用程序:

#!/bin/bash

LOGGED_IN_USER_ID=`id -u "${USER}"`

if [ "${COMMAND_LINE_INSTALL}" = "" ]
then
    /bin/launchctl asuser "${LOGGED_IN_USER_ID}" /usr/bin/open -g PATH_OR_BUNDLE_ID
fi

exit 0

以登录用户身份运行应用程序非常重要,而不是安装程序用户.这是通过launchctl asuser uid path完成的.此外,我们只在不是命令行安装时运行它,使用安装程序工具或Apple Remote Desktop完成.

Answer 2

StéphaneSudre有一个非常有趣的应用程序,可以为您完成所有这些,可编写脚本/支持从命令行构建,具有超级漂亮的GUI并且是免费的.可悲的是:它被称为"包",这使得它无法在谷歌中找到.

http://s.sudre.free.fr/Software/Packages/about.html

在我开始手工制作自己的脚本之前,我希望我知道它.