Agregar sincronización de dispositivos a una aplicación - Swift SDK

Requisitos previos

Antes de poder acceder a un reino sincronizado desde el cliente, debe Habilite la sincronización en la interfaz de usuario de Atlas App Services. Durante este proceso, debe definir campos consultables que coincidan con los campos de su esquema. También debe definir permisos de lectura y escritura para los usuarios de la aplicación.

En este ejemplo, nuestro modelo incluye un ownerId campo que se asigna al user.id del usuario de Flexible Sync.

class Todo: Object {
    @Persisted(primaryKey: true) var _id: ObjectId
    @Persisted var name: String = ""
    @Persisted var ownerId: String
    @Persisted var status: String = ""
    convenience init(name: String, ownerId: String) {
        self.init()
        self.name = name
        self.ownerId = ownerId
    }
}

Agregue Device Sync a una aplicación de cliente

let app = App(id: FLEX_SYNC_APP_ID) // Replace FLEX_SYNC_APP_ID with your Atlas App ID

func login() async throws -> User {
    // Authenticate with the instance of the app that points
    // to your backend. Here, we're using anonymous login.
    let user = try await app.login(credentials: Credentials.anonymous)
    print("Successfully logged in user: \(user)")
    return user
}

@MainActor
func openSyncedRealm(user: User) async {
    do {
        var config = user.flexibleSyncConfiguration(initialSubscriptions: { subs in
            subs.append(
                QuerySubscription<Todo> {
                    $0.ownerId == user.id
                })
        })
        // Pass object types to the Flexible Sync configuration
        // as a temporary workaround for not being able to add a
        // complete schema for a Flexible Sync app.
        config.objectTypes = [Todo.self]
        let realm = try await Realm(configuration: config, downloadBeforeOpen: .always)
        useRealm(realm, user)
    } catch {
        print("Error opening realm: \(error.localizedDescription)")
    }
}

Utilice el reino

La sintaxis para leer, escribir y observar cambios en un dominio sincronizado es idéntica a la de los dominios no sincronizados. Mientras trabaja con datos locales, un subproceso en segundo plano integra, carga y descarga conjuntos de cambios de forma eficiente.

El siguiente código crea un nuevo objeto Task y lo escribe en el reino:

@MainActor
func useRealm(_ realm: Realm, _ user: User) {
    // Add some tasks
    let todo = Todo(name: "Do laundry", ownerId: user.id)
    try! realm.write {
        realm.add(todo)
    }
}

Cada transacción de escritura para un conjunto de suscripciones tiene un coste de rendimiento. Si necesita realizar varias actualizaciones a un objeto de Realm durante una sesión, considere mantener los objetos editados en memoria hasta que se completen todos los cambios. Esto mejora el rendimiento de la sincronización al escribir solo el objeto completo y actualizado en su reino, en lugar de cada cambio.