使用 SwiftUI 处理同步错误 - Swift SDK
在此页面上
Atlas Device SDK 已弃用。有关详细信息,请参阅弃用页面。
处理同步错误
在开发使用 Device Sync 的应用程序时,应设置错误处理程序。 此错误处理程序将检测并响应任何失败的同步相关 API 调用。
提示
另请参阅:
For a complete example app with a working Sync error handler implementation, create a template app and check out the SwiftUI client. The error handler implementation is in the App.swift
file.
对于同步错误处理程序的 SwiftUI 友好实施,请创建一个带有可选@Published
变量的 ObservableObject
,以包含潜在的错误。 此处理程序使用SyncManager侦听错误。 SyncManager
报告SyncError
类型的错误,并且还报告其他连接问题。
有关更多信息,请参阅底层 Objective-C RLMSyncError。
final class ErrorHandler: ObservableObject { var error: Swift.Error? init(app: RealmSwift.App) { // Sync Manager listens for sync errors. app.syncManager.errorHandler = { error, syncSession in if let error = error as? SyncError { /* Handle specific SyncError cases, or use a switch * statement to handle all Sync error codes. * In this case, ignore a .connectionFailed error and * continue executing the app code. */ if error.code == .connectionFailed { return } self.error = error } else if let error = error as? POSIXError { /* The error handler may also report NSError types to * allow for error handling in a platform-idiomatic way. * In this case, handle a connection timeout error as * an .ETIMEDOUT error in the POSIXError domain. */ if error.code == .ETIMEDOUT { return } self.error = error } } } }
将错误处理程序初始化为@StateObject
。将其作为环境对象注入到视图层次结构中。在此示例中,当发生同步错误时,我们会向用户显示.alert
。
let app = App(id: flexibleSyncAppId) @main struct realmSwiftUIApp: SwiftUI.App { // Initialize the error handler var errorHandler = ErrorHandler(app: app) var body: some Scene { WindowGroup { NextView(app: app) // Inject the error handler as an environment object .environmentObject(errorHandler) // Display an alert to the user containing the error when a Sync error occurs .alert(Text("Error"), isPresented: .constant(errorHandler.error != nil)) { Button("OK", role: .cancel) { errorHandler.error = nil } } message: { Text(errorHandler.error?.localizedDescription ?? "") } } } }
然后,在观察 Realm App
的视图中,您可以使用错误处理程序作为@EnvironmentObject
来响应同步错误。此处发生的错误会使用上面视图中设置的.alert
向用户弹出警报。
struct NextView: View { var app: RealmSwift.App // Use the error handler that you injected into the environment var errorHandler: ErrorHandler var body: some View { Text("You might log users in or handle errors in this view") } }