
ipatool 完整指南在 Windows、Linux 与 macOS 上搜索并下载 IPA 的 7 个命令【免费下载链接】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在 PC 上拿一个 .ipa 文件通常绕不开 Mac 或 Xcode。ipatool 是一个用 Go 编写的命令行工具能直接对 App Store 发起搜索并下载 iOS、iPadOS、tvOS、visionOS 应用的 .ipa 包和 macOS 应用的 .pkg 包在 Windows、Linux、macOS 上都能跑。如果你需要抓应用包做测试、备份或想在 CI 里自动化获取 IPA它就是为此准备的。 端到端跑通从安装到第一个 IPA 文件整条主线只有三步按顺序执行即可复现。第 1 步安装。本地装有 Go 工具链的话从源码编译是最通用的方式编译期需要 Go 1.16git clone https://gitcode.com/GitHub_Trending/ip/ipatool cd ipatool go build -o ipatool main.go把生成的可执行文件加进 PATH 即可。macOS 用户可以直接走 Homebrew更省事brew install ipatool第 2 步登录。搜索和下载都要经过 App Store 的鉴权流程所以登录是绕不开的一步。执行后会按提示输入 Apple ID 密码开了双重认证的账号还需要输入一次验证码ipatool auth login -e your-appleidexample.com登录完成后用这条命令确认凭据已经生效ipatool auth info第 3 步搜索并下载。先用关键词把目标应用搜出来结果里带有 bundle IDipatool search 微信 -l 5再用-b传入搜到的 bundle ID把应用包落到本地指定路径。不指定版本时默认下载最新版ipatool download -b com.tencent.xin -o ~/Downloads/wechat.ipa执行到这里你已经跑通了安装 → 登录 → 下载的完整流程。 命令手册ipatool 的 7 个核心子命令命令作用关键参数示例ipatool auth login登录 App Store-e邮箱/手机号必填-p密码--auth-code2FA 验证码ipatool auth login -e your-appleidexample.comipatool auth info查看当前登录的账号信息—ipatool auth infoipatool auth revoke吊销本地保存的认证凭据—ipatool auth revokeipatool search按关键词搜索应用搜索词为位置参数-l结果条数默认 5visionOS 最多 12--platform限定平台ipatool search 微信 -l 5ipatool list-versions列出应用的历史可用版本-bbundle ID 或-iapp ID-b优先级更高ipatool list-versions -b com.tencent.xinipatool download下载 .ipa / .pkg 应用包-bbundle ID-o输出路径--external-version-id指定版本--purchase需要时自动获取授权ipatool download -b com.tencent.xin -o wechat.ipaipatool purchase为已购应用获取下载许可-bbundle IDipatool purchase -b com.tencent.xin几个容易踩的细节--platform的取值在搜索、查版本、下载三处一致iphoneiOS、ipadiPadOS、appletvtvOS、visionos、macos。下载指定版本时先执行list-versions拿到external-version-id再传给downloadipatool download -b com.tencent.xin --external-version-id 1677862400 -o ~/Downloads/wechat_v8.0.22.ipa输出默认是 text 格式加--format json可以拿到机器可读的结果方便接后续脚本。默认是交互式模式会在缺失信息时提示输入在 CI 等无终端环境里加--non-interactive改用参数传入邮箱、密码和 2FA 验证码。登录、搜索、下载等核心逻辑都集中在 pkg/appstore/凭据存取在 pkg/keychain/想理解底层行为可以直接翻这两处源码。️ 跨平台适配三个系统的差异一张表命令本身在三个系统上完全一致差异只在安装方式、凭据存放位置和额外依赖上。对比项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 开发库、GNOME 密钥环服务无系统自动管理各平台需要留意的配置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。在 WSL 中使用则需要图形界面支持并配置好DISPLAY环境变量。macOS无需额外配置。想手动检查存储的凭据可以用security find-generic-password -s ipatool。 进阶场景批量下载与 CI/CD 集成批量下载脚本日常要备份多个应用时写个循环一次搞定即可。下面这个脚本依次下载列表中的应用并在需要时自动获取授权可直接存为~/bulk_download.sh执行#!/bin/bash APPS( com.tencent.xin # 微信 com.apple.mobilesafari # Safari ) for app in ${APPS[]}; do ipatool download -b $app --purchase -o ~/ipa_downloads/$app.ipa done--purchase保证脚本不会因为账号缺少下载许可而中断。集成到 CI/CDipatool 是纯命令行工具塞进 Jenkins 等流水线没有门槛。构建阶段自动拉取依赖的 IPA 包只需保证 CI 环境已登录过凭据持久化在密钥环里并加上--non-interactivestage(Download IPA) { steps { sh ipatool download -b com.example.app -o ./app.ipa --non-interactive } }⚠️ 问题速查4 个高频报错怎么处理登录或请求报认证失败原因本地保存的凭据过期或被吊销App Store 不再接受旧会话。 解决先吊销旧凭据再重新登录ipatool auth revoke ipatool auth login -e your-appleidexample.com登录时要求输入 2FA 验证码原因Apple ID 开启了双重认证首次在新客户端登录必须校验一次。 解决交互式运行时按提示输入即可非交互环境用--auth-code参数传入。手机不在手边时可在 macOS 上打开设置 → Apple 账号 → 登录与安全通过获取验证码入口拿一个下载时提示需要 license原因你的账号还没有该应用的下载许可App Store 拒绝直接分发。 解决给下载命令加--purchase或先单独执行一次授权ipatool download -b com.tencent.xin --purchase -o ~/Downloads/wechat.ipa下载速度很慢原因请求命中的 App Store 商店区域storefront不理想网络链路绕远。 解决尝试切换请求的商店区域例如设置为美区export IPATOOL_STOREFRONT143441-1,20✅ 一句话总结ipatool 把登录 App Store → 搜索 → 查版本 → 下载/授权串成了一套统一的命令行接口让你在任何一台 Windows、Linux 或 macOS 机器上用同样的姿势拿到 iOS 应用包。命令速查命令功能示例ipatool auth login登录 App Storeipatool auth login -e your-appleidexample.comipatool 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下载 IPAipatool download -b com.tencent.xin -o wechat.ipaipatool purchase获取应用授权ipatool purchase -b com.tencent.xin用ipatool --version检查当前版本并定期更新源码以获取新功能版本历史跟踪、批量应用管理等正在路上。遇到问题可以通过项目 issue 反馈也欢迎直接参与代码贡献。【免费下载链接】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),仅供参考