使用create-dmg工具制作dmg安装包

简介

create-dmg 是一个用来创建磁盘镜像文件(dmg)的 shell 脚本命令行工具。本文将介绍如何使用 create-dmg 来创建一个 dmg 磁盘镜像文件,即 macOS 系统的安装包。

准备工作

create-dmg 可以通过 Homebrew 来安装,使用以下命令安装 create-dmg

bash 复制代码
brew install create-dmg

创建 DMG 文件

在创建 dmg 文件之前,确保你的应用程序已经打包好,并且所有的资源文件都已经放置在正确的位置。通常为 xxx.app 的 bundle 形式文件。

创建一个文件夹,将你的应用程序拖放进去。这个文件夹将作为 dmg 文件的根目录。这里以 dmg-demo 作为目录为例:

复制代码
dmg-demo
├── QtProjectDemo.app
├── bg.svg

只需要额外提供一张背景图即可。当然也可再提供一个 icns 图标文件作为磁盘镜像文件的图标(双击 dmg 后,桌面显示的磁盘镜像图标)

如图,上面为默认的磁盘镜像图标,下图为自行替换的图标:

这里提供的是SVG格式的背景图:

在应用程序文件夹所在的目录打开终端。然后运行以下命令:

bash 复制代码
create-dmg \
  --volname "Application Installer" \
  --background "bg.svg" \
  --window-pos 400 200 \
  --window-size 660 400 \
  --icon-size 100 \
  --icon "QtProjectDemo.app" 160 185 \
  --hide-extension "QtProjectDemo.app" \
  --app-drop-link 500 185 \
  "Installer.dmg" \
  "QtProjectDemo.app/"

这个命令中包含了多个参数:

  • --volname:设置卷的名称。
  • --background:设置窗口的背景图。
  • --window-pos:设置双击 dmg,打开窗口的位置坐标。
  • --window-size:设置窗口的大小。
  • --icon-size:设置应用程序图标的大小。
  • --icon:设置应用程序的图标和位置坐标。
  • --hide-extension:隐藏应用程序文件的扩展名。
  • 最后两个参数分别是输出的 dmg 文件名和包含应用程序的文件夹名称。

输出信息:

bash 复制代码
Creating disk image...
..................................................................................................
created: /Users/leo/Downloads/dmg-demo/rw.74691.Installer.dmg
Mounting disk image...
Device name:     /dev/disk5
Searching for mounted interstitial disk image using /dev/disk5s...
Mount dir:       /Volumes/dmg.kaLqeq
Copying background file 'bg.svg'...
Making link to Applications dir...
/Volumes/dmg.kaLqeq
Running AppleScript to make Finder stuff pretty: /usr/bin/osascript "/var/folders/mn/vvr3gxpn7b38rlkyfl_j5m2h0000gn/T/createdmg.tmp.XXXXXXXXXX.SfFuKvgIMf" "dmg.kaLqeq"
waited 1 seconds for .DS_STORE to be created.
Done running the AppleScript...
Fixing permissions...
Done fixing permissions
Skipping blessing on sandbox
Deleting .fseventsd
Unmounting disk image...
"disk5" ejected.
Compressing disk image...
正在准备映像引擎...
正在读取Protective Master Boot Record(MBR:0)...
   (CRC32 $0821720F:Protective Master Boot Record(MBR:0))
正在读取GPT Header(Primary GPT Header:1)...
   (CRC32 $2718773B:GPT Header(Primary GPT Header:1))
正在读取GPT Partition Data(Primary GPT Table:2)...
   (CRC32 $D08A2D56:GPT Partition Data(Primary GPT Table:2))
正在读取(Apple_Free:3)...
   (CRC32 $00000000:(Apple_Free:3))
正在读取disk image(Apple_HFS:4)...
.........................................................................................................................
   (CRC32 $FC0F7A84:disk image(Apple_HFS:4))
正在读取(Apple_Free:5)...
.........................................................................................................................
   (CRC32 $00000000:(Apple_Free:5))
正在读取GPT Partition Data(Backup GPT Table:6)...
.........................................................................................................................
   (CRC32 $D08A2D56:GPT Partition Data(Backup GPT Table:6))
正在读取GPT Header(Backup GPT Header:7)...
.........................................................................................................................
   (CRC32 $E02061DB:GPT Header(Backup GPT Header:7))
正在添加资源...
.........................................................................................................................
已耗时: 3.355s
文件大小:31846419字节,校验和:CRC32 $7457A18C
已处理扇区:213072,已压缩158148
速度:23.0MB/秒
节省:70.8%
created: /Users/leo/Downloads/dmg-demo/Installer.dmg
hdiutil does not support internet-enable. Note it was removed in macOS 10.15.
Disk image done

创建完成后,双击 dmg 文件,检查它是否按照预期显示和工作。

这里需要注意的点在于,安装界面的图标位置计算。图标的位置是中心坐标,而不是左上角坐标。

这里指定了宽度 660 px 和高度 400 px 的窗口大小,是整个窗口(包含标题栏),而标题栏本身会占有 30 px 的高度,也就是实际上的区域只有 (660,370),这就导致,如果你要想要图标都居中,那么图标的的中心坐标位置将是 (x, 370/2)。

背景图的制作也是,中间的▶️图标如果要中心居中,那么实际上需要向上偏移 30 px 高度,才会居中。

另外,虽然 create-dmg 文档说支持 png、gif、jpg,但实测还支持 SVG、tiff 格式。

总结

通过使用 create-dmg,你可以为你的 Mac 应用程序创建 DMG 磁盘镜像文件,同时也能方便地集成到 CI/CD 流程中。

附录

create-dmg 用法:

xml 复制代码
create-dmg [options ...] <output_name.dmg> <source_folder>

参数选项:

  • --volname <name>:设置卷标名称(在 Finder 侧边栏和窗口标题中显示)
  • --volicon <icon.icns>:设置卷标图标
  • --background <pic.png>:设置文件夹背景图像(提供 png、gif、jpg 格式)
  • --window-pos <x> <y>:设置文件夹窗口的位置
  • --window-size <width> <height>:设置文件夹窗口的大小
  • --text-size <text_size>:设置窗口文本大小(10-16)
  • --icon-size <icon_size>:设置窗口图标大小(最大 128)
  • --icon <file_name> <x> <y>:设置文件图标的位置
  • --hide-extension <file_name>:隐藏文件的扩展名
  • --app-drop-link <x> <y>:在位置 x, y 创建一个指向应用程序的快捷链接
  • --ql-drop-link <x> <y>:在位置 x, y 创建一个指向 /Library/QuickLook 的快捷链接
  • --eula <eula_file>:附加一个许可协议文件到 dmg
  • --rez <rez_path>:指定包含许可协议文件的 Rez 工具的自定义路径
  • --no-internet-enable:禁用自动挂载和复制
  • --format:指定最终图像格式(UDZO|UDBZ|ULFO|ULMO)(默认为 UDZO)
  • --filesystem:指定图像文件系统(HFS+|APFS)(默认为 HFS+,APFS 支持 macOS 10.13 或更新版本)
  • --encrypt:启用结果磁盘镜像的加密(AES-256 - 将提示输入密码)
  • --encrypt-aes128:启用结果磁盘镜像的加密(AES-128 - 将提示输入密码)
  • --add-file <target_name> <file|folder> <x> <y>:添加额外的文件或文件夹(可多次使用)
  • --disk-image-size <x>:手动设置磁盘镜像大小为 x MB
  • --hdiutil-verbose:以详细模式执行 hdiutil
  • --hdiutil-quiet:以安静模式执行 hdiutil
  • --codesign <signature>:使用指定的签名对磁盘镜像进行代码签名
  • --notarize <credentials>:使用存储在钥匙串中的凭据对磁盘镜像进行签名(等待并装订)。更多信息请查看 Apple的文档
  • --skip-jenkins:跳过 Finder 美化 AppleScript,适用于沙盒和非 GUI 环境
  • --sandbox-safe:与沙盒兼容的 hdiutil,不祝福也不执行 AppleScript(不支持 APFS 磁盘镜像)
  • --version:显示工具版本号
  • -h, --help:显示帮助

create-dmg/create-dmg: A shell script to build fancy DMGs (github.com)

相关推荐
2501_9151063223 分钟前
Xcode 上传 ipa 全流程详解 App Store 上架流程、uni-app 生成 ipa 文件上传与审核指南
android·macos·ios·小程序·uni-app·iphone·xcode
他们都不看好你,偏偏你最不争气4 小时前
【iOS】AFNetworking
开发语言·macos·ios·objective-c
钟念6 小时前
【打包app】uniapp打包ios端和安卓端app
macos·objective-c·cocoa
森之鸟20 小时前
Mac电脑上如何打印出字体图标
前端·javascript·macos
m_136871 天前
Mac M 系列芯片 YOLOv8 部署教程(CPU/Metal 后端一键安装)
yolo·macos
搜狐技术产品小编20231 天前
CAEmitterLayer:iOS 中创建炫酷粒子效果的魔法工具
macos·ios·objective-c·cocoa
未来之窗软件服务2 天前
操作系统应用开发(七)mac苹果模拟器——东方仙盟练气期
macos·仙盟创梦ide·东方仙盟·系统模拟器
liliangcsdn2 天前
Mac本地docker安装Kibana+ElasticSearch
elasticsearch·macos·docker
千寻简2 天前
远程连接Mac操作ClaudeCode一直提示登录Invalid API key · Please run /login
macos
小朋友,你是否有很多问号?2 天前
Mac安装hadoop
hadoop·macos