xTool

项目概述

xtool 是一款跨平台的 Xcode 替代方案，旨在让开发者能够在 Linux、Windows（WSL）以及 macOS 上使用 Swift Package Manager 构建并部署 iOS 应用。它以开放标准复刻 Xcode 的核心功能，摆脱对 macOS 工作站的依赖。

核心特性

• 将 SwiftPM 包打包为可安装的 iOS 应用
• 对 iOS 应用进行签名并安装到设备
• 通过命令行程序化访问 Apple 开发者服务
• 提供可在第三方 Swift 项目中复用的客户端库

命令行工具

xtool 的 CLI 由三组子命令组成，覆盖配置、开发与设备管理三大场景。

配置子命令

# 初始化 xtool 的 iOS 开发环境
xtool setup

# 管理 Apple 开发者服务的认证信息
xtool auth

# 安装与切换 Darwin Swift SDK
xtool sdk

开发子命令

# 基于模板创建一个新的 xtool SwiftPM 项目
xtool new

# 构建并运行当前目录下的 SwiftPM 项目
xtool dev

# 程序化访问 Apple 开发者服务（例如注册设备、申请证书）
xtool ds

设备子命令

# 列出当前已识别的 iOS 设备
xtool devices

# 将 .ipa 文件安装到指定设备
xtool install path/to/app.ipa

# 卸载指定 bundle identifier 的应用
xtool uninstall com.example.app

# 在设备上启动已安装的应用
xtool launch com.example.app

任意子命令后追加 xtool help <subcommand> 即可查看详细参数说明。

库 API（XKit）

xtool 同时发布名为 XKit 的 Swift 库，允许第三方应用直接集成 Apple 开发者服务、设备通信等功能。引入方式如下：

// 在 Package.swift 中声明依赖：
.package(url: "https://github.com/xtool-org/xtool", .upToNextMinor(from: "1.2.0"))

// 在 target 的 dependencies 中引用产品：
.product(name: "XKit", package: "xtool")

依赖项添加完成后，即可在自有 Swift 代码中调用设备管理、应用签名、服务端通信等接口，实现自动化流水线或自定义工具链。

快速上手

1. 根据运行环境选择安装指南，完成 xtool 的部署。
2. 按照官方教程创建首个由 xtool 驱动的 SwiftPM 项目，并在设备上构建运行。