使用 iPhone App 執行預覽
從 App Store 安裝 Tuist iOS App,即可尋找並存取你的 Apple 預覽。發布流程的簽署與裝置資格要求仍然適用。
依 App 名稱或版本說明搜尋,然後選擇軌道以篩選預覽。選擇 全部 可瀏覽所有軌道,包括未設定軌道的預覽。開啟預覽即可查看完整的版本說明。
用戶端與伺服器相容性#
保持 Tuist App 為最新版本。若你自行託管 Tuist,請更新伺服器以使用軌道篩選與版本說明功能。在較舊的伺服器上,你仍可不經篩選地瀏覽預覽。
App 內更新通知#
Tuist SDK 能讓你的 Apple App 偵測較新的預覽並通知測試人員。它會在相同的 預覽軌道 內檢查更新。對於使用 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 建置中,更新檢查會自動停用。