跳至内容

使用 iPhone App 运行预览

安装App Store 中的 Tuist iOS App,以便查找和访问你的 Apple 预览。发布工作流的签名和设备资格要求仍然适用。

按应用名称或发行说明搜索,然后选择一个轨道以过滤预览。选择全部可浏览所有轨道,包括没有分配轨道的预览。打开预览以阅读其完整的发行说明。

客户端与服务器兼容性#

保持 Tuist App 为最新版本。如果你自托管 Tuist,请更新服务器以使用轨道过滤和发行说明功能。在较旧的服务器上,你仍然可以不加过滤地浏览预览。

应用内更新通知#

Tuist SDK使你的 Apple 应用能够检测到更新的预览并通知测试人员。它会在同一预览轨道内检查更新。对于使用tuist share --track发布的预览,它会使用该明确指定的轨道。如果没有明确指定轨道,则使用 git 分支,因此从main构建的预览只会通知来自main的更新预览。

安装#

将 Tuist SDK 添加为 Swift Package 依赖项:

swift
.package(url: "https://github.com/tuist/sdk", .upToNextMajor(from: "0.1.0"))

监控更新#

使用monitorPreviewUpdates定期检查新的预览版本:

swift
import TuistSDK
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
.task {
TuistSDK(
fullHandle: "myorg/myapp",
apiKey: "your-api-key"
)
.monitorPreviewUpdates()
}
}
}
}

单次更新检查#

用于手动检查更新:

swift
let sdk = TuistSDK(
fullHandle: "myorg/myapp",
apiKey: "your-api-key"
)
if let preview = try await sdk.checkForUpdate() {
print("New version available: \(preview.version ?? "unknown")")
}

停止更新监控#

monitorPreviewUpdates返回一个可取消的Task:

swift
let task = sdk.monitorPreviewUpdates { preview in
// Handle update
}
// Later, to stop monitoring:
task.cancel()
Note

在模拟器和 App Store 构建中,更新检查会自动禁用。