majd/ipatool

来源：https://github.com/majd/ipatool

IPATool 发布版 (https://GitHub.com/majd/ipatool/releases/)

许可协议 (https://github.com/majd/ipatool/blob/main/LICENSE)

ipatool 是一个命令行工具，允许你在 App Store（https://apps.apple.com）上搜索 iOS、iPadOS、tvOS 和 visionOS 应用，并下载应用安装包（即 _ipa_ 文件）的副本。

演示

• 要求
• 安装
• 手动安装
• 包管理器（macOS）
• 使用方法
• 编译
• 许可协议
• 发布版
• 常见问题

要求

• 支持的操作系统（Windows、Linux 或 macOS）。
• 已设置用于 App Store 的 Apple ID。

安装

手动安装

你可以从 GitHub 发布页 (https://github.com/majd/ipatool/releases) 获取最新版本的 ipatool。

包管理器（macOS）

你可以使用 Homebrew (https://brew.sh) 安装 ipatool。

$ brew install ipatool

使用方法

要向 App Store 进行身份验证，请使用 auth 命令。

向 App Store 进行身份验证
用法：ipatool auth [command]

可用命令：
  info      显示当前账户信息
  login     登录 App Store
  revoke    吊销你的 App Store 凭据

参数：
  -h, --help   获取 auth 的帮助信息

全局参数：
  --format string   设置命令的输出格式；可以是 'text'、'json'（默认 text）
  --non-interactive 在非交互式会话中运行
  --verbose         启用详细日志

使用 "ipatool auth [command] --help" 获取有关命令的更多信息。

要在 App Store 上搜索应用，请使用 search 命令。

在 App Store 上搜索可用的 iOS、iPadOS、tvOS 和 visionOS 应用
用法：ipatool search [flags]

参数：
  -h, --help           获取 search 的帮助信息
  -l, --limit int      检索的最大搜索结果数量；visionOS 最多支持 12 个（默认 5）
  --platform string    搜索平台：iphone (iOS), ipad (iPadOS), appletv (tvOS), 或 visionos

全局参数：
  --format string   设置命令的输出格式；可以是 'text'、'json'（默认 text）
  --non-interactive 在非交互式会话中运行
  --verbose         启用详细日志

要获取应用的许可证，请使用 purchase 命令。

从 App Store 获取应用的许可证
用法：ipatool purchase [flags]

参数：
  -b, --bundle-identifier string   目标 iOS 应用的 Bundle ID（必填）
  -h, --help                       获取 purchase 的帮助信息

全局参数：
  --format string   设置命令的输出格式；可以是 'text'、'json'（默认 text）
  --non-interactive 在非交互式会话中运行
  --verbose         启用详细日志

要列出已验证账户拥有的应用，请使用 list-purchases 命令。结果按购买日期排序，最新的在前。

列出已验证 App Store 账户拥有的应用
用法：ipatool list-purchases [flags]

参数：
  -h, --help                获取 list-purchases 的帮助信息
  -l, --max-results int     每页返回的最大应用数量（默认 10）
  -p, --page int            返回拥有的应用所在的页码（默认 1）

全局参数：
  --format string           设置命令的输出格式；可以是 'text'、'json'（默认 text）
  --keychain-passphrase string  用于解锁钥匙串的密码
  --non-interactive         在非交互式会话中运行
  --verbose                 启用详细日志

要获取可下载的应用版本列表，请使用 list-versions 命令。

列出 iOS 应用的可用版本
用法：ipatool list-versions [flags]

参数：
  -i, --app-id int                      目标 iOS 应用的 ID（必填）
  -b, --bundle-identifier string        目标 iOS 应用的 Bundle ID（覆盖 app ID）
  -h, --help                            获取 list-versions 的帮助信息

全局参数：
  --format string                       设置命令的输出格式；可以是 'text'、'json'（默认 text）
  --keychain-passphrase string          用于解锁钥匙串的密码
  --non-interactive                     在非交互式会话中运行
  --verbose                             启用详细日志

要下载 ipa 文件的副本，请使用 download 命令。

从 App Store 下载（加密的）iOS、iPadOS、tvOS 和 visionOS 应用安装包
用法：ipatool download [flags]

参数：
  -i, --app-id int                      目标应用的 ID（必填）
  -b, --bundle-identifier string        目标应用的 Bundle ID（覆盖 app ID）
  --external-version-id string          目标应用的外部版本标识符（未指定时默认为最新版本）
  -h, --help                            获取 download 的帮助信息
  -o, --output string                   下载的应用安装包的目标路径
  --platform string                     要下载的平台：iphone (iOS), ipad (iPadOS), appletv (tvOS), 或 visionos
  --purchase                            如果需要，为应用获取许可证

全局参数：
  --format string                       设置命令的输出格式；可以是 'text'、'json'（默认 text）
  --keychain-passphrase string          用于解锁钥匙串的密码
  --non-interactive                     在非交互式会话中运行
  --verbose                             启用详细日志

要解析由 list-versions 命令返回的外部版本标识符，请使用 get-version-metadata 命令。

获取应用特定版本的元数据
用法：ipatool get-version-metadata [flags]

参数：
  -i, --app-id int                      目标 iOS 应用的 ID（必填）
  -b, --bundle-identifier string        目标 iOS 应用的 Bundle ID（覆盖 app ID）
  --external-version-id string          目标 iOS 应用的外部版本标识符（必填）
  -h, --help                            获取 get-version-metadata 的帮助信息

全局参数：
  --format string                       设置命令的输出格式；可以是 'text'、'json'（默认 text）
  --keychain-passphrase string          用于解锁钥匙串的密码
  --non-interactive                     在非交互式会话中运行
  --verbose                             启用详细日志

注意： 该工具默认以交互模式运行。如果在自动化环境中运行，请使用 --non-interactive 标志。

编译

该工具可以使用 Go 工具链编译。

$ go build -o ipatool

单元测试可以通过以下命令执行。

$ go generate ./...
$ go test -v ./...

许可协议

IPATool 根据 MIT 许可协议发布 (https://github.com/majd/ipatool/blob/main/LICENSE)。