IPATool 完整实操指南从 App Store 拉取 IPA 文件只需 4 步【免费下载链接】ipatoolCommand-line tool that allows you to search for iOS, iPadOS, tvOS, visionOS, and macOS apps on the App Store, and download .ipa or macOS .pkg app packages.项目地址: https://gitcode.com/GitHub_Trending/ip/ipatoolIPATool 是一个跨平台的命令行工具CLI可以在 App Store 中搜索 iOS、iPadOS、tvOS、visionOS 和 macOS 的应用并下载对应的.ipa或 macOS.pkg安装包。它覆盖从 Apple ID 登录、应用搜索、许可证获取到按版本下载 IPA 的完整链路适合在终端手工操作也适合放进 CI 流水线批量执行。从一个任务说起在构建里拉取某个 App 的测试包假设你的需求是每周定时拉取某个 App 的最新 IPA投进内部测试设备农场。用 Xcode 手工点按无法脚本化而 IPATool 把整条链路拆成了 7 个子命令每一步都可以单独执行、单独输出 JSON命令作用auth login / info / revoke登录 App Store、查看账号、撤销凭据search按关键词搜索五大平台的应用purchase为目标应用获取下载许可证list-purchases分页列出账号已拥有的应用list-versions列出某应用可下载的 external version IDget-version-metadata解析某个版本的显示版本号与发布日期download下载.ipa/.pkg到指定路径所有命令都支持按应用 ID-i, --app-id或 Bundle ID-b, --bundle-identifier会覆盖 app ID定位目标应用--platform的值固定为iphoneiOS、ipadiPadOS、appletvtvOS、visionos、macos五种。拿到二进制Homebrew、发布包或源码编译环境要求很简单Windows、Linux 或 macOS 任一系统加上一个可用 App Store 的 Apple ID。安装方式平台命令/步骤特点HomebrewmacOSbrew install ipatool一条命令便于后续更新官方发布包全平台从项目 Releases 页下载对应平台的二进制无需 Go 环境源码编译全平台go build -o ipatool需要 Go 1.25.0功能最新源码编译的完整流程如下编译后建议放到$PATH内再验证git clone https://gitcode.com/GitHub_Trending/ip/ipatool cd ipatool go build -o ipatool如果你是参与开发而不是使用仓库自带测试入口跑通它们再改代码go generate ./... go test -v ./...跑通第一次登录auth login 与 2FA 验证码登录后一切功能才可用。交互模式下运行auth login时先输入--email指定的 Apple ID密码会提示你在终端直接键入不回显ipatool auth login --email youexample.com两个容易踩的点首次登录会提示 the first login may take a few minutes期间工具在和 Apple 服务端协商会话耐心等它完成不要中途 Ctrl-C。开启双重认证的账号会触发 2FA 流程终端提示 enter 2FA code: 时输入受信任设备收到的验证码即可。验证码在 Apple 的账号安全设置中管理也可以把参数一次性给全--auth-code直接携带验证码ipatool auth login --email youexample.com --password xxx --auth-code 123456登录成功后会话 cookie 与会话令牌分开存放cookie 落在状态目录默认~/.ipatool/cookies可通过XDG_STATE_HOME或XDG_DATA_HOME重定向密码类凭据写入系统密钥环服务名ipatool-auth.servicemacOS 走 Keychain、Linux 走 Secret Service二者都不可用时回退到文件后端。确认与清理账号状态用ipatool auth info # 查看当前登录账号 ipatool auth revoke # 撤销本工具的 App Store 凭据搜索 → 版本 → 元数据 → 下载四步走通下面用搜索 telegram 为例走一遍从发现应用到拿到 IPA 的完整流程。第一步搜索拿到应用 ID--limit默认 5 条visionOS 上限 12 条ipatool search telegram --limit 10第二步列出该应用所有可下载的 external version identifier历史版本回退就靠它ipatool list-versions --app-id 686449807第三步可选把某个 external version ID 解析成人类可读的版本号与发布日期ipatool get-version-metadata --app-id 686449807 --external-version-id ID第四步执行下载。不指定--external-version-id时默认拉最新版本-o指定落盘路径ipatool download --app-id 686449807 --output ~/Downloads/telegram.ipa需要指定历史版本时加上--external-version-id ID账号尚未持有该应用许可证时加上--purchase工具会在检测到 license required 后自动走一次购买再重试下载。macOS 应用走同一套命令产物为.pkg。非交互模式CI 里的三个必配参数默认是交互模式带进度条、终端提示。放进 GitHub Actions 这类无 TTY 环境时全局参数--non-interactive必须加上同时还有两个配套要求登录必须显式传密码非交互模式下--password成为必填否则直接报错退出。若账号需要 2FA第一次执行会打印提示要求带--auth-code重跑ipatool auth login --email $APPLE_ID --password $APPLE_PW \ --auth-code $APPLE_2FA --non-interactive文件密钥环需要口令当凭据落在文件后端时非交互模式必须提供--keychain-passphrase否则解锁密钥环这一步会失败注意它与 Apple ID 密码不是一回事。用--format json接管输出默认 text 格式面向人眼脚本解析请切 json再配合jq取字段排查问题时叠加--verbose输出详细日志。一条典型的流水线下载命令长这样ipatool download --app-id 414478124 --output /tmp/app.ipa \ --purchase --non-interactive --format json卡住了怎么办6 个高频故障的排查路径现象登录卡住不动。排查首次登录本身就需要数分钟与 Apple 完成会话握手。解决等待其完成若长时间无输出加--verbose观察停在哪个请求。现象2FA 验证码提示无效或失败。排查验证码有时效且必须输入受信任设备上的最新一条。解决重新触发登录流程取新码交互模式直接重新输入非交互模式带--auth-code重跑。现象password is required when not running in interactive mode。排查CI 环境漏传凭据。解决auth login补上--password参数。现象密钥环解锁提示在自动化里无法响应。排查凭据使用文件后端且未提供口令。解决全局参数--keychain-passphrase传入口令或改用系统 Keychain/Secret Service 后端。现象下载报 license required应用明明存在。排查该账号名下没有这个应用的许可证。解决加--purchase让下载自动购证或先单独执行ipatool purchase --app-id ID也可用list-purchases核对名下已购应用清单。现象--platform报解析错误。排查拼写或取值不对。解决只使用iphone / ipad / appletv / visionos / macos这五个值注意是appletv而不是tvos。另外注意令牌过期这类错误工具内部会自动重登录重试登录类命令 2 次、下载 3 次偶发的重连失败不用人工干预持续失败再看--verbose日志。读代码仓库各部分各管什么IPATool 用 Go 编写目录职责划分清晰想深入时按这张表找入口目录职责cmd/cobra 命令层auth、search、download、purchase 等 7 个子命令的参数解析与重试编排pkg/appstore/App Store 协议实现登录、搜索、购证、分片下载、macOS pkg 发布、SINF 复制等pkg/keychain/ 与 pkg/http/密钥环凭据读写set/get/remove与带持久 cookie 的 HTTP 客户端封装internal/sap/与 Store Agent 相关的内部实现cpio 读取、Mach-O 镜像解析、storeagent 协议internal/sap/unicorn/应用包解包引擎zip、tar.zstd、7zWindows解档与运行时补丁会话状态的落盘逻辑在 cmd/state_directory.go默认使用~/.ipatool旧版本残留目录会自动迁移到 XDG 路径下迁移失败时保留原地以避免丢登录态——换机器或清目录重装会话时可以参考这个文件。下一步跑通本地流程后自然的延伸是把search --format json的输出接进你自己的监控脚本定期比对list-versions里的 external version ID 来发现应用更新。若发现协议层的行为不符合预期pkg/appstore/下的下载与购证模块以及对应的*_test.go是定位起点修完跑一遍go test -v ./...验证回归。【免费下载链接】ipatoolCommand-line tool that allows you to search for iOS, iPadOS, tvOS, visionOS, and macOS apps on the App Store, and download .ipa or macOS .pkg app packages.项目地址: https://gitcode.com/GitHub_Trending/ip/ipatool创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 IPATool 完整实操指南：从 App Store 拉取 IPA 文件只需 4 步
IPATool 完整实操指南从 App Store 拉取 IPA 文件只需 4 步【免费下载链接】ipatoolCommand-line tool that allows you to search for iOS, iPadOS, tvOS, visionOS, and macOS apps on the App Store, and download .ipa or macOS .pkg app packages.项目地址: https://gitcode.com/GitHub_Trending/ip/ipatoolIPATool 是一个跨平台的命令行工具CLI可以在 App Store 中搜索 iOS、iPadOS、tvOS、visionOS 和 macOS 的应用并下载对应的.ipa或 macOS.pkg安装包。它覆盖从 Apple ID 登录、应用搜索、许可证获取到按版本下载 IPA 的完整链路适合在终端手工操作也适合放进 CI 流水线批量执行。从一个任务说起在构建里拉取某个 App 的测试包假设你的需求是每周定时拉取某个 App 的最新 IPA投进内部测试设备农场。用 Xcode 手工点按无法脚本化而 IPATool 把整条链路拆成了 7 个子命令每一步都可以单独执行、单独输出 JSON命令作用auth login / info / revoke登录 App Store、查看账号、撤销凭据search按关键词搜索五大平台的应用purchase为目标应用获取下载许可证list-purchases分页列出账号已拥有的应用list-versions列出某应用可下载的 external version IDget-version-metadata解析某个版本的显示版本号与发布日期download下载.ipa/.pkg到指定路径所有命令都支持按应用 ID-i, --app-id或 Bundle ID-b, --bundle-identifier会覆盖 app ID定位目标应用--platform的值固定为iphoneiOS、ipadiPadOS、appletvtvOS、visionos、macos五种。拿到二进制Homebrew、发布包或源码编译环境要求很简单Windows、Linux 或 macOS 任一系统加上一个可用 App Store 的 Apple ID。安装方式平台命令/步骤特点HomebrewmacOSbrew install ipatool一条命令便于后续更新官方发布包全平台从项目 Releases 页下载对应平台的二进制无需 Go 环境源码编译全平台go build -o ipatool需要 Go 1.25.0功能最新源码编译的完整流程如下编译后建议放到$PATH内再验证git clone https://gitcode.com/GitHub_Trending/ip/ipatool cd ipatool go build -o ipatool如果你是参与开发而不是使用仓库自带测试入口跑通它们再改代码go generate ./... go test -v ./...跑通第一次登录auth login 与 2FA 验证码登录后一切功能才可用。交互模式下运行auth login时先输入--email指定的 Apple ID密码会提示你在终端直接键入不回显ipatool auth login --email youexample.com两个容易踩的点首次登录会提示 the first login may take a few minutes期间工具在和 Apple 服务端协商会话耐心等它完成不要中途 Ctrl-C。开启双重认证的账号会触发 2FA 流程终端提示 enter 2FA code: 时输入受信任设备收到的验证码即可。验证码在 Apple 的账号安全设置中管理也可以把参数一次性给全--auth-code直接携带验证码ipatool auth login --email youexample.com --password xxx --auth-code 123456登录成功后会话 cookie 与会话令牌分开存放cookie 落在状态目录默认~/.ipatool/cookies可通过XDG_STATE_HOME或XDG_DATA_HOME重定向密码类凭据写入系统密钥环服务名ipatool-auth.servicemacOS 走 Keychain、Linux 走 Secret Service二者都不可用时回退到文件后端。确认与清理账号状态用ipatool auth info # 查看当前登录账号 ipatool auth revoke # 撤销本工具的 App Store 凭据搜索 → 版本 → 元数据 → 下载四步走通下面用搜索 telegram 为例走一遍从发现应用到拿到 IPA 的完整流程。第一步搜索拿到应用 ID--limit默认 5 条visionOS 上限 12 条ipatool search telegram --limit 10第二步列出该应用所有可下载的 external version identifier历史版本回退就靠它ipatool list-versions --app-id 686449807第三步可选把某个 external version ID 解析成人类可读的版本号与发布日期ipatool get-version-metadata --app-id 686449807 --external-version-id ID第四步执行下载。不指定--external-version-id时默认拉最新版本-o指定落盘路径ipatool download --app-id 686449807 --output ~/Downloads/telegram.ipa需要指定历史版本时加上--external-version-id ID账号尚未持有该应用许可证时加上--purchase工具会在检测到 license required 后自动走一次购买再重试下载。macOS 应用走同一套命令产物为.pkg。非交互模式CI 里的三个必配参数默认是交互模式带进度条、终端提示。放进 GitHub Actions 这类无 TTY 环境时全局参数--non-interactive必须加上同时还有两个配套要求登录必须显式传密码非交互模式下--password成为必填否则直接报错退出。若账号需要 2FA第一次执行会打印提示要求带--auth-code重跑ipatool auth login --email $APPLE_ID --password $APPLE_PW \ --auth-code $APPLE_2FA --non-interactive文件密钥环需要口令当凭据落在文件后端时非交互模式必须提供--keychain-passphrase否则解锁密钥环这一步会失败注意它与 Apple ID 密码不是一回事。用--format json接管输出默认 text 格式面向人眼脚本解析请切 json再配合jq取字段排查问题时叠加--verbose输出详细日志。一条典型的流水线下载命令长这样ipatool download --app-id 414478124 --output /tmp/app.ipa \ --purchase --non-interactive --format json卡住了怎么办6 个高频故障的排查路径现象登录卡住不动。排查首次登录本身就需要数分钟与 Apple 完成会话握手。解决等待其完成若长时间无输出加--verbose观察停在哪个请求。现象2FA 验证码提示无效或失败。排查验证码有时效且必须输入受信任设备上的最新一条。解决重新触发登录流程取新码交互模式直接重新输入非交互模式带--auth-code重跑。现象password is required when not running in interactive mode。排查CI 环境漏传凭据。解决auth login补上--password参数。现象密钥环解锁提示在自动化里无法响应。排查凭据使用文件后端且未提供口令。解决全局参数--keychain-passphrase传入口令或改用系统 Keychain/Secret Service 后端。现象下载报 license required应用明明存在。排查该账号名下没有这个应用的许可证。解决加--purchase让下载自动购证或先单独执行ipatool purchase --app-id ID也可用list-purchases核对名下已购应用清单。现象--platform报解析错误。排查拼写或取值不对。解决只使用iphone / ipad / appletv / visionos / macos这五个值注意是appletv而不是tvos。另外注意令牌过期这类错误工具内部会自动重登录重试登录类命令 2 次、下载 3 次偶发的重连失败不用人工干预持续失败再看--verbose日志。读代码仓库各部分各管什么IPATool 用 Go 编写目录职责划分清晰想深入时按这张表找入口目录职责cmd/cobra 命令层auth、search、download、purchase 等 7 个子命令的参数解析与重试编排pkg/appstore/App Store 协议实现登录、搜索、购证、分片下载、macOS pkg 发布、SINF 复制等pkg/keychain/ 与 pkg/http/密钥环凭据读写set/get/remove与带持久 cookie 的 HTTP 客户端封装internal/sap/与 Store Agent 相关的内部实现cpio 读取、Mach-O 镜像解析、storeagent 协议internal/sap/unicorn/应用包解包引擎zip、tar.zstd、7zWindows解档与运行时补丁会话状态的落盘逻辑在 cmd/state_directory.go默认使用~/.ipatool旧版本残留目录会自动迁移到 XDG 路径下迁移失败时保留原地以避免丢登录态——换机器或清目录重装会话时可以参考这个文件。下一步跑通本地流程后自然的延伸是把search --format json的输出接进你自己的监控脚本定期比对list-versions里的 external version ID 来发现应用更新。若发现协议层的行为不符合预期pkg/appstore/下的下载与购证模块以及对应的*_test.go是定位起点修完跑一遍go test -v ./...验证回归。【免费下载链接】ipatoolCommand-line tool that allows you to search for iOS, iPadOS, tvOS, visionOS, and macOS apps on the App Store, and download .ipa or macOS .pkg app packages.项目地址: https://gitcode.com/GitHub_Trending/ip/ipatool创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考