ipatool 完整使用指南：3步完成认证，1条命令下载 App Store 的 IPA 安装包

ipatool 完整使用指南3步完成认证1条命令下载 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如果你需要直接、批量地获取 App Store 上的应用安装包开源命令行工具ipatool是绕不开的选项用 Apple ID 登录一次按关键词搜索应用随后把.ipa或 macOS 的.pkg包拉到本地全程 3 步、分钟级完成。下面这份指南带你从零配置到实战排错看完即可上手。1 能力速览1个二进制跑通搜索→购买→下载全链路五大平台覆盖搜索与下载支持iphoneiOS、ipadiPadOS、appletvtvOS、visionosvisionOS、macos五个平台产出物是.ipa或 macOS.pkg包。可直接进 CI--non-interactive--format json两个全局参数即可在自动化环境里无人值守运行无需人工交互。凭据零明文Apple ID 凭据默认存入系统钥匙串macOS Keychain / Linux Secret Service会话状态放在~/.ipatool磁盘上没有明文密码。2 落地准备1个 Apple ID 2项前置检查第 1 步准备 Apple ID。账号需要已经配置好 App Store 使用资格建议开启双重认证2FA开启后登录时会多一次 6 位验证码输入属正常流程。第 2 步确认系统支持。要求 Windows、Linux 或 macOS 三选一无其他运行时依赖单二进制直接跑。第 3 步验证命令可用。ipatool --help能列出auth、search、purchase、download等子命令即就绪。3 部署方式3条路径任选其一方案 AHomebrew 一键安装macOS推荐brew install ipatool方案 B预编译二进制跨平台最快从项目 Releases 页下载与你的操作系统、架构对应的压缩包解压后直接执行无需安装。方案 C源码编译开发者 / 想要最新特性git clone https://gitcode.com/GitHub_Trending/ip/ipatool cd ipatool go build -o ipatool注意go.mod声明了go 1.25.0请准备 Go 1.25 工具链。4 实战演示4个高频场景命令预期效果4.1 首次登录3步拿到会话 ipatool auth login -e youexample.com交互式模式下提示enter password:时输入密码不回显若开了 2FA随后在enter 2FA code:提示下输入设备短信/弹窗里的 6 位验证码。看到登录成功日志后用下面命令确认账号身份ipatool auth info自动化环境CI 等改用非交互参数把密码和验证码直接传进去ipatool auth login -e youexample.com -p 你的密码 --auth-code 123456 --non-interactive4.2 搜索应用按关键词定位 App IDipatool search 微信 --limit 5 ipatool search WhatsApp --platform macos预期效果返回最多--limit条默认 5 条visionOS 平台最多 12 条匹配应用结果里带有后续下载要用的App ID或 Bundle ID。4.3 下载安装包1条命令落地 IPAipatool download -i 414478124 -o ~/Downloads/ ipatool download -b com.tencent.xin --purchase -o ~/Downloads/预期效果交互式模式下显示下载进度条完成后.ipa保存到-o指定路径。两个实用开关-b传Bundle ID可省略 App ID--purchase表示需要时自动获取该应用的许可首次下载免费 App 时加它最省心。4.4 版本管理列出我的应用并锁定特定版本ipatool list-purchases --max-results 20 --page 1 ipatool list-versions -i 414478124 ipatool get-version-metadata -i 414478124 --external-version-id 版本号ID ipatool download -i 414478124 --external-version-id 版本号ID -o ./wechat-old.ipa预期效果list-purchases按购买日期倒序列出已购应用list-versions返回该应用所有可下载版本的external version identifier再用get-version-metadata查某个版本的具体信息或交给download --external-version-id精确下载历史版本不指定时默认最新版。5 避坑指南5个高频报错的解法①password is required when not running in interactive mode→ 原因加了--non-interactive却没传密码。解决补上-p--password参数。②2FA code is required→ 原因非交互模式下 2FA 验证码无法交互输入。解决重跑命令并附带--auth-code 123456。③either the app ID or the bundle identifier must be specified→ 原因download/purchase/list-versions等命令既没给-i也没给-b。解决两者至少提供一个-b优先级更高。④keychain passphrase is required when not running in interactive mode→ 原因凭据文件需要口令解锁而非交互模式下无法弹出输入框。解决传全局参数--keychain-passphrase。⑤ 首次登录特别慢→ 这是正常现象工具在首登时会提示 the first login may take a few minutes。另外登录令牌过期时工具会自动重试不必手动干预若账号状态彻底错乱可执行ipatool auth revoke撤销凭据再删除本地状态目录~/.ipatool重新登录。6 收尾30秒回顾ipatool 1次auth login 1次search 1次download即可把 App Store 应用包完整落到本地磁盘--purchase和--external-version-id两个开关分别解决首次购买和历史版本两个进阶需求。想二次开发时命令层看 cmd/如 cmd/download.goApp Store 协议实现集中在 pkg/appstore/macOS 安装包解析在 internal/sap/MIT 协议下直接上手改。【免费下载链接】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），仅供参考