企业官网建设流程全解析

ipatool 实战：3 条命令从 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 接口，能搜索 iOS、iPadOS、tvOS、visionOS 和 macOS 应用，并下载对应的 .ipa 或 .pkg 安装包。下面按三个真实场景展开：本地第一次跑通下载、历史版本兼容性测试、把下载接进 CI 流水线。

场景一：把第一次 IPA 下载跑通

安装与登录

macOS 用户可以直接用 Homebrew，其他系统从源码编译：

brew install ipatool

git clone https://gitcode.com/GitHub_Trending/ip/ipatool go build -o ipatool

登录需要 Apple ID 邮箱和密码，交互式运行时省略-p会直接提示输入：

ipatool auth login -e your@email.com

开启双重验证的账号会卡在 2FA 环节。交互模式下按提示输入验证码即可；非交互模式则需要用--auth-code手动传入。验证码可在 macOS 的「设置 → 登录与安全性 → 双因素身份验证」里点 Get a Verification Code 获取，位置见下图红框：

登录成功后，凭证会存入系统密钥链（实现见 pkg/keychain/），后续命令自动复用。用ipatool auth info确认当前账号，ipatool auth revoke清除凭证。

搜索并下载

搜索一条命令拿到目标应用的 app-id 和 bundle identifier：

ipatool search "WeChat" -l 5

两者任选其一即可定位应用，下载最新版并指定输出路径：

ipatool download -b com.tencent.xin -o wechat.ipa --purchase

--purchase的作用是在缺少授权时自动补票。下载主流程（含重试与授权处理）在 cmd/download.go：令牌过期会自动重登，最多重试 3 次；遇到ErrLicenseRequired且带了--purchase时，会先购买授权再继续下载。

场景二：用 list-versions 拉历史版本做兼容性测试

验证旧版应用在新系统上的行为时，先列出该应用所有可用版本：

ipatool list-versions -b com.tencent.xin

输出中每个版本都带一个 External Version ID，它是下载时定位版本的唯一坐标。对某个 ID 存疑时，用get-version-metadata反查对应的元数据：

ipatool get-version-metadata -b com.tencent.xin \ --external-version-id 1677840000

核对无误后指定版本下载：

ipatool download -b com.tencent.xin \ --external-version-id 1677840000 -o wechat_old.ipa

场景三：在 CI 流水线里非交互下载 IPA

默认是交互模式，进 CI 后统一加--non-interactive。该模式下auth login必须通过-p显式传密码；2FA 账号用--auth-code配合完成验证：

ipatool auth login -e "$EMAIL" -p "$PASSWORD" \ --non-interactive

下载命令加--format json输出结构化结果，方便脚本解析；CI 机器的密钥链若设了口令，用--keychain-passphrase解锁。完整组合：

ipatool download -b com.example.app -o latest.ipa \ --purchase --non-interactive --format json

--verbose建议只在调试阶段开启，正式流水线保留精简日志即可。

下载失败时的排查路径

• 令牌过期（ErrPasswordTokenExpired）：download 内部会自动重登重试；手动场景下重新执行ipatool auth login刷新凭证
• 缺少下载授权（ErrLicenseRequired）：给 download 加--purchase，或单独执行ipatool purchase -b <bundle-id>补授权
• 版本不存在：先用get-version-metadata验证 External Version ID，再对照list-versions输出核对

下一步动作很明确：挑一个你熟悉的免费应用，把「搜索 → 下载 → 装进模拟器」这条链路完整跑一遍，跑通后再考虑接入 CI。

【免费下载链接】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