3 条命令从 App Store 取回 IPAipatool 命令行工具完整上手指南【免费下载链接】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当你需要从 App Store 拿一个 iOS 应用的安装包去做测试或备份通常得在 iTunes 或 Xcode 的图形界面里反复翻找文件落到哪里还不一定。ipatool 就是为这种场景准备的在终端里搜索应用、用 Apple ID 完成认证、把 .ipa 文件下载落盘全程不打开任何图形界面。它覆盖 iOS、iPadOS、tvOS、visionOS 和 macOS 五个商店macOS 应用下载的是 .pkg 安装包。工具定位ipatool 是一个用 Go 编写的命令行工具核心能力就两个跨平台搜索 App Store 应用以及把应用的 .ipa 或 macOS .pkg 安装包取回本地。登录、授权、版本查询也都拆成了独立子命令。准备工作三种方式装好并验证方式适用环境操作HomebrewmacOSbrew install ipatool手动下载全平台从发布页下载对应系统二进制放入 PATH源码编译全平台需 Go克隆仓库后编译源码编译的完整流程git clone https://gitcode.com/GitHub_Trending/ip/ipatool cd ipatool go build -o ipatool装好后跑一条最简单的命令验证ipatool --help能看到auth、search、purchase、download、list-versions这些子命令就说明可用了。下面的动图演示了一次完整的「搜索应用并下载包文件」过程可以对照着看输出长什么样。核心流程一免界面完成 Apple ID 认证登录是所有后续命令的前提跳过这一步后面全会报错。ipatool auth login -e your-idexample.com执行后终端提示输入密码不回显账号开了双重认证的话还会再提示输入 6 位验证码。成功后会输出账号姓名和邮箱。常用变体ipatool auth info随时查看当前登录的账号ipatool auth revoke清掉旧凭据再重新登录脚本里没法交互输入时用--password加--auth-code直接传参。为什么必须先认证取包本质上是向商店申请「允许我拿走这个文件」工具得用你的 Apple ID 身份和商店通信。凭据写入系统钥匙串之后的命令自动复用不用反复输密码。凭据存的是系统钥匙串而非明文文件但在共享电脑上建议用临时账号登录、用完auth revoke清掉。核心流程二从应用名定位到目标版本手里往往只有一个应用名搜索负责把名字变成 ID。ipatool search 微信 -l 10输出是匹配列表每条含应用数字 ID、名称、当前版本和 Bundle Identifier。-l控制返回条数默认 5 条。记下数字 ID对应-i或 Bundle Identifier对应-b二选一即可定位应用想查 tvOS 商店加--platform appletv。要某个历史版本而非最新版先列出可用版本ipatool list-versions -b com.example.app记下目标版本的 external version id下载时传给--external-version-id即可。想确认某版的发布时间和说明再用get-version-metadata解析。-b和-i同时传时以 Bundle Identifier 为准版本不指定时默认拿最新版。核心流程三把包文件取回本地拿到 ID 之后一条命令取回文件ipatool download -i 414478124 -o ~/Downloads/app.ipa下载过程有进度条结束后打印落盘路径用ls确认文件存在即可。-o决定存到哪里-b可换成 Bundle Identifier 定位应用。如果账号缺少该应用授权加--purchase工具会在出错后自动补一次授权再重试下载。下载到的是加密包装机要配合对应授权和分发渠道如企业签名、开发者工具它不等于「能在任意设备上直接打开」。排错手册 ️报错2FA code is required; run the command again and supply a code using the --auth-code flag非交互环境登录却没传验证码命令直接提示这句。重新执行auth login并带--auth-code传入 6 位验证码即可交互模式下终端会显示enter 2FA code:提示按提示输入。手头没有可信设备时macOS 可以进「系统设置 登录与安全性 双重认证」点「获取验证码」补一个。报错license is required当前账号下没有该应用的有效授权记录已下架的免费应用也可能出现。download加--purchase工具自动补授权并重试。报错either the app ID or the bundle identifier must be specifieddownload时-i和-b都没传两者至少填一个。报错password is required when not running in interactive mode; use the --password flag开了--non-interactive却没显式给密码。交互模式密码可以手敲非交互模式必须--password显式传入。延伸方向JSON 输出几乎所有命令都支持--format json管道接jq就能抽字段比如从搜索结果里批量提取应用 ID再喂给一批download命令。非交互自动化--non-interactive让工具不等待任何输入放进 CI 或定时任务不会卡住钥匙串带锁时再用--keychain-passphrase解锁。把「登录 → 搜索 → 下载」串成定时任务就是一个应用更新监控管道。这些全局参数都定义在 cmd/root.goApp Store 通信逻辑在 pkg/appstore/想改行为前看一眼源码最清楚。写在最后ipatool 把「从 App Store 拿 IPA」从图形界面操作压缩成了认证、搜索、下载三步命令配合 JSON 输出和非交互模式也能平滑接进脚本与 CI。现在就可以打开终端挑一个想分析的应用跑一遍search和download卡住了翻上面的排错小节。留个问题给你如果要做「每晚检查名下应用有没有更新、有就抓新版」的定时任务从list-purchases列表遍历入口还是逐个应用名走search哪条路请求更省、也更容易绕开商店限流【免费下载链接】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），仅供参考