ipatool 完全指南Windows、Linux、macOS 上 5 分钟完成从登录到下载 IPA【免费下载链接】ipatoolCommand-line tool that allows you to search for iOS, iPadOS, tvOS, watchOS, visionOS, and macOS apps on the App Store, and download .ipa or macOS .pkg app packages.项目地址: https://gitcode.com/GitHub_Trending/ip/ipatool想在 Windows 或 Linux 电脑上拿到一个 iOS 应用的 .ipa 安装包手机上操作并不方便。ipatool 就是为此写的 Go 语言命令行工具在 App Store 里搜索 iOS、iPadOS、tvOS、visionOS 和 macOS 五类应用把 .ipa 或 macOS 的 .pkg 包直接落到本地。做应用测试、版本备份或者想在 CI 里自动拉取应用包的开发者和测试工程师基本开箱即用三个平台命令完全一致。 三分钟跑通从装到下载到 IPA 落盘第一步准备先把工具装到机器上目的拿到可执行文件。有 Go 环境1.25仅编译时需要就克隆源码编译一条命令出二进制git clone https://gitcode.com/GitHub_Trending/ip/ipatool cd ipatool go build -o ipatool main.go # 生成可执行文件加进 PATH 即可macOS 用户省事一点直接brew install ipatool。第二步登录绕不开的鉴权一步目的让 ipatool 以你的 Apple 账号身份访问 App Store——搜索和下载都走这条鉴权链路。ipatool auth login -e 你的AppleID邮箱按提示输密码开了两步验证的账号会被要求补一个验证码。登录后顺手确认一下账号状态ipatool auth info第三步首次下载先搜再下目的验证整条链路能跑通。搜索结果的 bundle ID 直接喂给-bipatool search 微信 -l 5 # 最多返回 5 条结果里带 bundle ID ipatool download -b com.tencent.xin -o ~/Downloads/wechat.ipa到这一步你就完成了一次完整的登录 → 搜索 → 下载后面的内容都是在这一圈基础上加料。 三大平台怎么装凭据存哪儿差异最大命令三平台完全一致真正的差别在安装方式和登录凭据的存放位置对比项WindowsLinuxmacOS系统要求Windows 10内核 3.10macOS 10.14安装方式go build -o ipatool main.go编译go build编译源码编译或brew install ipatool凭据存储Windows 专用加密存储系统密钥环 Keyring依赖 libsecret系统钥匙串 Keychain额外依赖Visual C 运行时libsecret 开发库、密钥环守护进程无系统自动管理各平台特有的小坑先记这三条Windows确认系统装有 Visual C 运行时PowerShell 若被脚本策略拦截执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser放行。Linux先装密钥库依赖——Debian/Ubuntu 用sudo apt-get install libsecret-1-devFedora 用sudo dnf install libsecret-devel再确认密钥环守护进程在跑gnome-keyring-daemon --start。凭据读写逻辑可以看 pkg/keychain/。macOS什么都不用配钥匙串自动托管。想查它存了什么执行security find-generic-password -s ipatool-auth.service即可。另外在 WSL 里跑 Linux 版时密钥环依赖图形界面支持记得确认DISPLAY环境变量已配置。 按场景找答案你想干啥就翻哪节下面不按命令罗列按你遇到什么情况来查。所有命令都在 cmd/ 下有完整实现。场景 1不知道应用 ID先搜出 bundle ID适用情况你只知道应用名不知道它的标识。ipatool search 微信 -l 5-l返回条数默认 5--platform限定搜索范围可选iphone、ipad、appletv、visionos、macos避免同名应用刷屏。场景 2想锁定某个历史版本而不是最新版适用情况兼容性测试要固定版本或想回捞旧包。先列版本拿external-version-idipatool list-versions -b com.tencent.xin ipatool download -b com.tencent.xin --external-version-id 1677862400 -o wechat_v8.0.22.ipa-b与-iapp ID二选一-b优先级更高--external-version-id不指定时默认下最新版指定了就精确锁定那一版。场景 3下载报需要 license账号还没有下载许可适用情况App Store 拒绝直接分发该应用包免费应用也可能需要。先单独授权一次ipatool purchase -b com.tencent.xin或者干脆在下载时带上--purchase需要时工具自动补授权省掉一次手动操作。场景 4记不清账号买过哪些应用适用情况批量备份前想先盘点手上的应用。一条命令列出当前账号拥有的全部应用ipatool list-purchases场景 5输出要给脚本或程序消费适用情况人工阅读之外的自动化处理。全局参数--format json把结果切成 JSON--verbose打开详细日志排查问题ipatool search Safari --format json 效率进阶批量脚本与 CI/CD 流水线一次备份多个应用日常要备份一堆应用时写个循环脚本一次搞定。下面这个可直接存为~/bulk_download.sh使用#!/bin/bash APPS( com.tencent.xin # 微信 com.apple.mobilesafari # Safari ) mkdir -p ~/ipa_downloads for app in ${APPS[]}; do ipatool download -b $app --purchase -o ~/ipa_downloads/$app.ipa done--purchase保证遇到没有许可的应用时自动补授权不会中断整个循环。塞进 Jenkins 这类流水线ipatool 是纯命令行工具天然适合自动化。比如在构建阶段自动拉取依赖的 IPAstage(Download IPA) { steps { sh ipatool --non-interactive download -b com.example.app -o ./app.ipa } }--non-interactive是专为无人值守环境准备的全局参数配合--auth-code登录时使用就能在 CI 里完成首次 2FA 校验。 翻车急救高频翻车点的现象、原因与处理命令翻车 1认证失败命令报认证错误现象搜索、下载等命令直接报认证类错误。原因是本地保存的凭据过期或被吊销App Store 不再接受旧会话。处理先吊销再重登。ipatool auth revoke ipatool auth login -e 你的AppleID邮箱翻车 2登录时要求 2FA 验证码现象auth login走到一半要六位验证码。原因是 Apple ID 开了双重认证新客户端首次登录必须校验。交互式环境按提示输入即可CI 等非交互环境用--auth-code参数传入。手机不在手边时可以在另一台 Mac 上打开设置 → Apple 账号 → 登录与安全点获取验证码翻车 3下载时提示需要 license现象下载被拒提示缺少下载许可。原因是该账号还没有这个应用的分发授权。处理给下载命令加--purchase或先单独执行ipatool purchase -b bundle ID。ipatool download -b com.tencent.xin --purchase -o ~/Downloads/wechat.ipa翻车 4下载速度很慢现象包不大却半天跑不完。原因是请求命中的 App Store 商店区域离你的网络链路较远。先用--verbose看日志确认卡在哪一环再重试或换网络环境若账号所属商店区域与所在地不符可在 Apple 账号设置里调整商店区域后再下载。ipatool download -b com.tencent.xin -o wechat.ipa --verbose 命令备忘录一张表收口命令作用示例ipatool auth login登录 App Storeipatool auth login -e 你的邮箱ipatool auth info查看当前登录信息ipatool auth infoipatool auth revoke吊销认证凭据ipatool auth revokeipatool search搜索应用ipatool search 微信 -l 5ipatool list-versions列出应用版本ipatool list-versions -b com.tencent.xinipatool download下载 IPA / pkgipatool download -b com.tencent.xin -o wechat.ipaipatool purchase获取应用授权ipatool purchase -b com.tencent.xinipatool list-purchases列出账号拥有的应用ipatool list-purchases一句话收束ipatool 把登录 App Store → 搜索 → 查版本 → 下载/授权串成了一套跨平台一致的命令行接口无论你在哪台 Windows、Linux 还是 macOS 机器上姿势都相同。建议用ipatool --version检查当前版本、定期更新源码拿新功能遇到 bug 走项目 issue 反馈也欢迎直接读 pkg/appstore/ 的源码参与贡献。【免费下载链接】ipatoolCommand-line tool that allows you to search for iOS, iPadOS, tvOS, watchOS, 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），仅供参考