开发工具【免费下载链接】gibMacOSPy2/py3 script that can download macOS components direct from Apple项目地址https://gitcode.com/gh_mirrors/gi/gibMacOS点击查看免费下载本篇指南围绕开源工具 gibMacOS 展开它是一套同时兼容 Python 2 与 Python 3 的脚本能够直接从 Apple 的软件更新目录Software Update Catalog抓取并下载 macOS 系统组件在 Windows 平台上还可借助 dd 与 7-Zip 制作 Internet Recovery 恢复 U 盘。读完本文你将掌握 gibMacOS 的交互式菜单、全部命令行参数、断点续传机制、Windows 恢复盘制作流程以及 macOS 端安装 App 打包方法并能理解其目录解析与版本映射的底层实现。gibMacOS 是什么gibMacOS 是一个以 Python 编写的 macOS 组件下载工具核心定位是Py2/py3 script that can download macOS components direct from Apple——即直接从 Apple 官方渠道而非第三方镜像站下载 macOS 安装所需的各类组件。项目根目录下的 gibMacOS.py 是主程序配合 Scripts/ 目录下的downloader.py、utils.py、run.py、plist.py、disk.py、diskwin.py等模块共同完成目录解析、网络下载、界面交互与磁盘操作。除基础下载外该项目还提供了两套衍生能力Windows 端制作 Internet Recovery USB 安装盘通过 MakeInstall.py 与 MakeInstall.bat 实现依赖 dd 与 7zip 两个外部工具macOS 端组装安装 App通过 BuildmacOSInstallApp.py 与 BuildmacOSInstallApp.command 实现把下载到的组件文件拼装成完整的Install macOS xxx.app安装器。运行环境与启动方式Python 版本要求项目主程序同时兼容 Python 2 与 Python 3源码中大量使用sys.version_info分支与from Scripts import *的包结构来兼容两代语法例如 Scripts/plist.py 中针对 Py2 重实现了二进制 plist 解析器。不同平台使用不同的启动入口macOS / Linux双击或执行 gibMacOS.commandWindows双击或执行 gibMacOS.bat。启动器自动探测与安装 Python两个启动脚本的核心逻辑一致先探测系统中可用的 Python再调用同名.py主程序。以 gibMacOS.command 为例其内部维护use_py3三态变量取值行为TRUE优先使用 Python 3找不到时回退 Python 2默认值FALSE强制使用 Python 2FORCE强制使用 Python 3探测顺序为python3→python2→python并会选择 PATH 中版本号最高的解释器。如果系统中没有可用 Python脚本会询问是否自动下载安装最新版 Python仅 macOS 平台支持自动安装Windows 平台会提示前往官网安装并勾选 Add Python X.X to PATH。此外gibMacOS.command 对 macOS 10.15 的/usr/bin/python3占位桩stub做了专门处理若xcode-select -p未返回有效的开发者目录则该占位解释器会被跳过避免版本探测误判。若仅想安装 Python 而不运行主程序可执行./gibMacOS.command --install-pythonWindows 端 gibMacOS.bat 同样支持--install-python并通过 PowerShell 下载官方安装包后静默安装/quiet PrependPath1安装后还会通过注册表重新组装 PATH 供当前会话使用。工作原理Apple Software Update Catalog目录 URL 的构造gibMacOS 并不直接硬编码某个 macOS 版本的下载链接而是动态构造 Apple 软件更新目录sucatalog的 URL 并从中解析所有可用产品。核心逻辑位于 gibMacOS.py 的build_url()return https://swscan.apple.com/content/catalogs/others/index-{}.merged-1.sucatalog.format( -.join(reversed(self.get_macos_versions(self.min_macos, version, catalogself.catalog_suffix.get(catalog, )))) )即 URL 形如https://swscan.apple.com/content/catalogs/others/index-10.9-10.10-...-10.15.merged-1.sucatalog版本段由最低版本默认 10.5/Leopard到当前设定的最大版本倒序拼接而成。目录类型catalog映射gibMacOS.py 定义了目录后缀映射表self.catalog_suffix { public : beta, publicrelease : , customer : customerseed, developer : seed }publicrelease正式公开版本默认无后缀public公开 Beta 版对应beta后缀customer客户种子版本customerseeddeveloper开发者种子版本seed。非法输入会被安全回退为publicrelease见set_catalog()。版本号与版本名互转gibMacOS.py 内置了一张版本名 ↔ 版本号映射表覆盖 Tiger10.4到 Sequoia15的全部主流版本内部则用单一整数表示如 Catalina15、Big Sur16URL 构造与显示时再通过num_to_macos()转换。交互界面提示如eg. 10.15 for Catalina, 11 for Big Sur, 12 for Monterey正是这一机制的体现。本地设置持久化用户通过菜单或参数设定的偏好会被保存到Scripts/settings.json首次运行由程序自动创建保存字段见 gibMacOS.py 的settings_to_save{ current_macos : 20, current_catalog : publicrelease, print_urls : false, find_recovery : false, hide_pid : false }启动时程序会读取该文件恢复上次的选择gibMacOS.py。交互式菜单使用不带参数直接运行gibMacOS.py或双击启动脚本即进入交互模式主菜单由 main() 呈现包含按键功能数字选择列表中对应产品并下载M修改最大 macOS 版本影响目录 URL 的版本段C切换目录类型public / publicrelease / customer / developerI切换仅打印 URL模式print_urlsH隐藏产品 Package ID 与发布日期hide_pidR切换 Recovery 专用模式find_recoveryU显示当前构造的目录 URLS仅 macOS将当前目录 URL 写入系统softwareupdate --set-catalogL仅 macOS清除系统softwareupdate --clear-catalogQ退出目录下载成功后程序会遍历Products字典筛选出带有com.apple.mpkg.OSInstall标识或com.apple.pkg.InstallAssistant前缀 SharedSupport 标识的产品见 get_installers()再逐条拉取ServerMetadataURL获取版本号、标题、描述并汇总各 Packages 的 URL 与大小最后按发布日期倒序展示。进入 Recovery 模式R后筛选逻辑改为查找 URL 以RecoveryHDUpdate.pkg或RecoveryHDMetaDmg.pkg结尾的包gibMacOS.py并仅在下载时保留这两类文件——这正是 MakeInstall 制作恢复 U 盘所需的素材来源。命令行参数详解gibMacOS 提供完整的命令行参数体系gibMacOS.py适合脚本化与自动化调用参数说明-l, --latest下载当前目录中最新的版本优先级高于--build/--version/--product-r, --recovery改为查找 Recovery 包RecoveryHDUpdate.pkg/RecoveryHDMetaDmg.pkg并覆盖--dmg-d, --dmg仅下载.dmg文件-s, --savelocal优先使用本地已保存的sucatalog.plist-n, --newlocal重新下载目录并覆盖本地Scripts/sucatalog.plist-c, --catalog指定目录类型publicrelease/public/customer/developer-p, --product按产品 ID 搜索优先级高于--version-v, --version指定目标版本如-v 10.14或-v Yosemite-b, --build指定目标构建号如22G120必须与--version搭配-m, --maxos设置构造目录 URL 时考虑的最大版本如10.14-D, --device-id与--version或--latest配合筛选支持指定 Device ID如VMM-x86_64的版本-i, --print-urls仅打印下载链接不实际下载-j, --print-json仅以 JSON 输出产品元数据不下载--no-interactive非交互模式使用--product或--version时自动启用-o, --download-dir覆盖文件保存目录典型用法示例# 下载最新正式版 python3 gibMacOS.py --latest # 下载指定版本 构建号 python3 gibMacOS.py --version 10.14 --build 18G103 # 仅打印某产品的全部下载链接 python3 gibMacOS.py --product 001-12345 --print-urls # 只下载 x86_64 虚拟机可用版本并输出 JSON 元数据 python3 gibMacOS.py --latest --device-id VMM-x86_64 --print-json注意约束--build必须与--version同时使用或配合--latest/--product否则直接报错退出gibMacOS.py。参数解析后程序会依次执行set_prods()拉取并解析目录、get_latest()/get_for_product()/get_for_version()最终统一收敛到download_prod()执行实际下载。下载机制与断点续传保存目录结构默认情况下文件保存到macOS Downloads/{catalog}/{product} - {version} {title} ({build})/目录gibMacOS.py可使用-o覆盖。当同名目录已存在时交互模式会询问R. Resume Incomplete Files # 续传未完成文件 D. Redownload All Files # 全部重新下载 M. Return # 返回菜单 Q. Quit # 退出断点续传实现续传能力由 Scripts/downloader.py 的stream_to_file()提供若本地文件已存在且大小等于Content-Length则直接跳过若小于目标大小则以追加模式打开文件并通过Range: bytes{current_size}-请求头让服务器从断点继续发送实现真正的断点续传而非简单的覆盖重下。下载过程中通过多进程队列驱动进度条实时显示已下载/总量、百分比、瞬时速度与剩余时间。仅打印链接启用-i/--print-urls后程序逐条打印每个包的文件名、大小与完整 URL不执行下载gibMacOS.py方便配合wget、aria2等第三方下载器批量拉取。在 Windows 上制作 Internet Recovery USBMakeInstallMakeInstall.py 是独立的 Windows 工具用于把 Recovery 包写入 U 盘制作可引导的 Internet Recovery 安装盘。依赖工具启动时程序会逐一检查以下工具缺失则自动下载MakeInstall.pyddddrelease64.exe用于把.hfs镜像以块方式写入物理磁盘7-Zip7z.exe用于从 Recovery 包中逐层解出BaseSystem.dmg与.hfs镜像解包链路xar → dmg → hfsBOOTICEx64.exe用于向磁盘写入 MBR / PBR 引导代码。三者均存放于 Scripts/ 目录。该工具仅支持 Windows要求 Windows 8.1 及以上即 build 9600运行时会自动请求管理员权限MakeInstall.py。分区与格式化流程程序通过diskpart脚本擦除目标盘并重建分区diskpart_erase()默认 MBR 方案clean→convert mbr→ 创建 200MB FAT32BOOT主分区并设为active→ 创建第二个主分区并set idABAB 为 Apple Boot / Recovery 分区标识对应注释 AFHFSGPT 方案G选项clean→convert gpt→ 创建 200MB FAT32BOOT分区 → 创建第二个分区并指定 HFS GUID48465300-0000-11AA-AA11-00306543ECAC。随后程序用 7-Zip 解出.hfs镜像并调用 dd 将其写入第二分区of\\?\Device\Harddisk{n}\Partition2块大小bs8M最后写入引导管理器。选项速查菜单格式为[drive number][options] r[Clover revision, 可选]例如1B C r5092。选项优先级为B F E U G选项含义B仅安装引导管理器到第一分区不写恢复镜像F跳过格式化要求第一分区为 FAT32、第二分区为 RAW否则操作必然失败E将第一分区类型改为 EFIGUIDc12a7328-f81f-11d2-ba4b-00a0c93ec93bU类似 E但改为 Basic Data 类型ebd0a0a2-b9e5-4433-87c0-68b6b72699c7便于编辑G按 GPT 而非默认 MBR 格式化C使用 Clover 替代默认的 OpenCore 作为引导管理器L提供本地引导管理器归档OpenCore 需.zipClover 需.tar.lzma或.7zD不输入盘号时使用切换显示全部磁盘含本地盘危险默认引导管理器为 OpenCore可通过C切换为 Clover支持指定版本号如r5092。写入镜像后程序会把 EFI 目录复制到BOOT分区根目录用 BOOTICEx64 以boot0/boot1f32OpenCore或boot0af/boot1f32altClover恢复 MBR 与 PBRMakeInstall.py并把bootClover 为boot6复制到卷根目录。重要限制Big Sur 及以后自 macOS 11 Big Sur 起Apple 改变了系统分发方式MakeInstall 已无法在 Windows 上制作 Internet Recovery U 盘Catalina 及更早版本不受影响仍可正常制作。这是原文档明确标注的限制选择版本时需注意。在 macOS 上组装安装 AppBuildmacOSInstallAppBuildmacOSInstallApp.py 仅能在 macOS 上运行脚本入口会校验sys.platform darwin其作用是把 gibMacOS 下载的组件文件夹组装成可直接安装的Install macOS xxx.app。所需文件清单程序要求目标文件夹包含以下全部文件BuildmacOSInstallApp.pyBaseSystem.dmg BaseSystem.chunklist InstallESDDmg.pkg InstallInfo.plist AppleDiagnostics.dmg AppleDiagnostics.chunklist缺失任一文件都会中止并列出缺项。组装流程对文件执行chmod ax取得可读权限用hdiutil attach -plist -noverify挂载BaseSystem.dmg在其中定位.app安装器并整体复制到目标目录在 App 内创建Contents/SharedSupport目录将上述组件全部复制进去其中InstallESDDmg.pkg会重命名为InstallESD.dmg补丁InstallInfo.plist将Payload Image Info中的URL由InstallESDDmg.pkg改为InstallESD.dmg、id由com.apple.pkg.InstallESDDmg改为com.apple.dmg.InstallESD并移除chunklistURL/chunklistid键BuildmacOSInstallApp.py卸载挂载点完成。Big Sur 后的新分发方式自 macOS 11 Big Sur 起Apple 通过InstallAssistant.pkg分发系统。此时不再需要BuildmacOSInstallApp.command来创建安装 App——直接双击运行InstallAssistant.pkgmacOS 的 Installer 会自动把Install macOS [版本].app安装到你的/Applications文件夹。因此 BuildmacOSInstallApp.py 也内置了该分支检测到下载目录中存在InstallAssistant.pkg时直接执行open打开它跳过整个组装流程。常见问题与注意事项目录不可达若所选 catalog 无法下载且本地不存在Scripts/sucatalog.plist备用文件程序会提示检查网络连接gibMacOS.py。可用-s指定离线使用本地目录缓存-n强制刷新本地缓存。版本号与名称混用--version既接受10.14这类数字版本也接受Yosemite这类名称匹配时会对标题与版本号双重校验并规避 Sierra / High Sierra 之类的名称包含误匹配gibMacOS.py。Device ID 筛选从 Big Sur 起Apple 在 dist 文件中提供supportedDeviceIDs列表-D参数利用该数据过滤机型支持范围典型值VMM-x86_64代表 x86_64 虚拟机gibMacOS.py。平台差异S/L写入/清除系统 softwareupdate catalog仅存在于 macOS 平台菜单MakeInstall仅限 WindowsBuildmacOSInstallApp仅限 macOS。三套工具各自面向不同平台的用户可按需取用。致谢与参考来源原文档明确致谢以下项目与作者它们为 gibMacOS 的 URL 构造与安装器组装提供了重要参考FoxletFox 的 FetchMacOS——梳理了 Apple 目录 URL 的结构munki 的 macadmin-scriptstimsutton 的 brigadierwolfmannight 的 manOSDownloader_rcBuildmacOSInstallApp.command 即在其基础上实现。总结gibMacOS 提供了一条绕过第三方镜像、直连 Apple 官方目录的 macOS 组件获取链路在任意平台用 Python 拉取 sucatalog 并解析产品列表在 Windows 上用 MakeInstall 制作恢复 U 盘在 macOS 上用 BuildmacOSInstallApp 组装安装 App。需要特别牢记两个版本边界Big Sur 及以后无法再通过 MakeInstall 在 Windows 上制作 Internet Recovery U 盘Big Sur 及以后的分发载体是InstallAssistant.pkg直接运行即可获得安装 App。结合本文列出的全部命令行参数、交互菜单与源码实现细节你可以将这套流程稳定地接入自己的下载、归档与装机自动化场景。赞分享开发工具【免费下载链接】gibMacOSPy2/py3 script that can download macOS components direct from Apple项目地址https://gitcode.com/gh_mirrors/gi/gibMacOS点击查看免费下载相关推荐Windows用户福利用gibMacOS制作macOS恢复U盘Windows用户福利用gibMacOS制作macOS恢复U盘 你还在为没有Mac设备却需要制作macOS恢复U盘而烦恼吗尝试过各种工具却被复杂的操作步骤劝开发工具gibMacOS终极指南跨平台下载macOS与制作启动盘全流程gibMacOS终极指南跨平台下载macOS与制作启动盘全流程 还在为macOS安装文件的获取而烦恼吗无论你使用的是Windows、macOS还是Linux开发工具终极指南用gibMacOS在Windows环境轻松制作macOS恢复U盘终极指南用gibMacOS在Windows环境轻松制作macOS恢复U盘 还在为没有Mac设备却需要制作macOS恢复U盘而烦恼吗gibMacOS是一款开源开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考