跳至內容

使用 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 建置中,更新檢查會自動停用。