IPATool 完整使用教程：如何从 App Store 搜索、购买并下载 IPA 安装包
【免费下载链接】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
IPATool 是一个命令行工具，让你在终端里直接搜索、购买并下载 App Store 的 .ipa 或 macOS .pkg 应用包，省得开模拟器或在浏览器里点来点去。做应用测试、版本对比、批量备份时用得上，全文按"先跑通、再练手、最后看原理"的顺序讲。
🔧 三分钟上手：装好、登录、跑通第一次
要求只有两条：系统支持 Windows、Linux 或 macOS；账号是一个能正常登录 App Store 的 Apple ID。
第一步，装上工具。macOS 上有 Homebrew 一行搞定；其他平台建议从源码构建，仓库是 Go 写的，go build出一条可执行文件：
# macOS brew install ipatool # 其他平台：从源码构建 git clone https://gitcode.com/GitHub_Trending/ip/ipatool cd ipatool && go build -o ipatool第二步，登录 Apple ID。登录会把密码写进系统钥匙串（macOS Keychain / Linux Secret Service / Windows Credential Manager），后续命令不用反复输密码：
ipatool auth login --email you@example.com # 按提示输入密码；账号开了两步验证的话，再输入一次验证码 ipatool auth info # 确认账号状态，输出 name / email / success如果你平时用双重认证，先在系统设置的 Sign-In & Security 里确认"获取验证码"入口可用，登录卡住时好取码。不想让这台机器继续保存凭据时，执行ipatool auth revoke清掉即可。
最常用的三个操作
🔍 搜索应用：先拿到应用 ID
搜索是起点，输出列表里每个应用都带数字 ID 和包名，后面的命令都靠它定位。
ipatool search "微信" --limit 10 --platform iphone高频参数是--limit（默认只返回 5 条）和--platform，可选 iphone、ipad、appletv、visionos、macos。想接脚本时加--format json，输出直接变 JSON。
📥 下载应用包：一条命令存到本地
download 必须用-i传应用 ID，或用-b传包名（包名优先），再用-o指定输出文件。
ipatool download -i 414478124 -o wechat.ipa高频参数是--external-version-id，用来下载指定历史版本而不是最新版；macOS 应用加--platform macos，产物是 .pkg 而不是 .ipa。
💰 购买付费应用：先授权再下载
付费应用没有授权就下载会失败，得先跑 purchase 拿到 license。命令形态和下载一致，同样是-i或-b定位应用：
ipatool purchase -i 123456789 --platform iphone已经买过的应用会提示 license 已存在，不会重复扣费。更省事的做法是下载时直接加--purchase，工具发现缺授权会自动补一次购买。
进阶用法
场景一：归档应用的多个历史版本。测试应用行为差异时，老版本往往比最新版更有价值。先用list-versions列出可下载的版本号，再按--external-version-id逐个下载：
ipatool list-versions -b com.tencent.xin ipatool download -b com.tencent.xin --external-version-id 8.0.20 -o wechat_8.0.20.ipa把不同版本下到独立目录，解压后对比 Resources 和 Info.plist 就能看出版本间的改动。
场景二：批量下载 + 脚本化。把要下载的 ID 写进文本文件，配合--non-interactive跑批处理，适合 CI 或重装系统后恢复应用库：
while read -r id; do ipatool download -i "$id" -o "apps/${id}.ipa" --non-interactive done < app_ids.txt脚本环境里密钥串可能解不开，记得加--keychain-passphrase传入口令；排查时统一加--verbose看详细日志，输出会带上output、purchased、success这些字段，方便定位卡在哪一步。
⚠️ 高频问题速查
| 报错现象 | 可能原因 | 一行解决 |
|---|---|---|
either the app ID or the bundle identifier must be specified | download / purchase 没传应用标识 | 补上-i <id>或-b <包名>再执行 |
| 登录反复提示需要 2FA 验证码 | 账号开了两步验证，非交互模式没带码 | ipatool auth login -e you@x.com --password ... --auth-code 123456 |
| 下载前提示需要 license | 应用是付费的且当前账号没授权 | 先ipatool purchase -i <id>，或下载时加--purchase |
keychain passphrase is required | 非交互环境读不到密钥串口令 | 加--keychain-passphrase <口令>重跑 |
它是怎么工作的
IPATool 做的事情，等价于你在 iPhone 上"打开 App Store → 搜索 → 点下载"这一整套流程。它用你的 Apple ID 登录 App Store 的接口，拿到账号凭据后，搜索、购买、下载全部走 Apple 自己的服务，不绕道。下到的 .ipa 本质是个 zip，里面是 .app 目录，外加证书和许可证文件，工具会在下载完把 sinf 许可证复制进包里。密码和会话存在系统钥匙串里，下次运行直接复用。整个过程不需要越狱，也不需要额外的开发者证书。具体交互逻辑可以看 pkg/appstore/ 目录下的源码。
visionOS 和 tvOS 的应用生态还在长大，这个工具能覆盖的范围只会变宽。现在就可以 clone 仓库装好 ipatool，先搜一个你天天用的应用，把 .ipa 存下来试试。
【免费下载链接】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），仅供参考
