Agrupar um Realm - SDK do Flutter

Agrupar um Local Realm

print("Bundling realm");
final config = Configuration.local([Car.schema], path: 'bundle.realm');
final realm = Realm(config);
realm.write(() {
  realm.add(Car(ObjectId(), "Audi", model: 'A8'));
  realm.add(Car(ObjectId(), "Mercedes", model: 'G Wagon'));
});
print("Bundled realm location: " + realm.config.path);
realm.close();

flutter:
  assets:
  - realm/bundle.realm

// Also import Realm schema and Flutter widgets
import 'package:flutter/services.dart';
import 'package:realm/realm.dart';
import 'dart:io';
Future<Realm> initBundledRealm(String assetKey) async {
  final config = Configuration.local([Car.schema]);
  final file = File(config.path);
  if (!await file.exists()) {
    final realmBytes = await rootBundle.load(assetKey);
    await file.writeAsBytes(
        realmBytes.buffer
            .asUint8List(realmBytes.offsetInBytes, realmBytes.lengthInBytes),
        mode: FileMode.write);
  }
  return Realm(config);
}
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  final realm = await initBundledRealm("assets/bundle.realm");
  runApp(const MyApp());
}

Agrupar um realm sincronizado

Na maioria dos casos, você não deve agrupar um domínio sincronizado. Se o domínio agrupado tiver sido atualizado pela última vez mais no passado do que o tempo máximo offline do cliente, o usuário sofrerá um reinício do cliente na primeira vez que abrir o arquivo de domínios agrupado. A redefinição do cliente faz com que o aplicativo baixe o estado completo do domínio do backend do aplicativo. Isso nega as vantagens de agrupar um arquivo de domínio.

Em vez de agrupar um domínio sincronizado, você pode preencher seu aplicativo com dados usando assinaturas de sincronização. Se você adicionar dados usando assinaturas de sincronização, não precisará se preocupar com o fato de os dados serem mais antigos do que o tempo máximo on-line do cliente, aproveitando o recurso de reduçãodo Flexible Sync. Para saber mais sobre como usar assinaturas de sincronização, consulte Gerenciar assinaturas de sincronização.

Você só deve agrupar um Realm sincronizado se o seu caso de uso atender aos seguintes critérios:

• Você pode garantir que os usuários tenham uma versão do aplicativo com o Realm sincronizado em pacote que foi criado mais recentemente do que o tempo máximo offline do cliente.

• Os dados iniciais agrupados são muito grandes e o aplicativo está sendo usado em uma situação com largura de banda limitada de internet, portanto, um download inicial de dados usando assinaturas de sincronização levaria muito tempo.

• Todos os usuários do aplicativo têm permissão de backend para visualizar os dados incluídos no pacote. Se um usuário não tiver permissão para visualizar esses dados, ele será removido do dispositivo quando o Realm for sincronizado com o Atlas por meio de um erro de gravação compensatório.

Para agrupar um Realm sincronizado, execute o seguinte:

1. Conecte-se ao seu aplicativo App Services e autentique um usuário.

2. Adicione uma assinatura ao Realm. Você precisa de uma assinatura para escrever em um Realm sincronizado.

3. Adicione dados ao Realm sincronizado.

4. Aguarde todas as alterações locais para sincronizar com o servidor do Realm Mobile Sync.

5. Use Realm.writeCopy() para criar uma nova versão do domínio sincronizado. Você deve usar Realm.writeCopy() para agrupar o domínio sincronizado porque o método remove metadados que associam o domínio ao usuário, o que permite que outros usuários abram o arquivo de domínio também.

print("Bundling synced realm");
// You must connect to the Device Sync server with an authenticated
// user to work with the synced realm.
final app = App(AppConfiguration(APP_ID));
// Check if current user exists and log anonymous user if not.
final user = app.currentUser ?? await app.logIn(Credentials.anonymous());
final config = Configuration.flexibleSync(user, [Car.schema]);
final realm = Realm(config);
// Add subscription that match the data being added
// and your app's backend permissions.
realm.subscriptions.update((mutableSubscriptions) {
  mutableSubscriptions.add(realm.all<Car>());
});
await realm.subscriptions.waitForSynchronization();
// Add data to realm
realm.write(() {
  realm.add(Car(ObjectId(), "Audi", model: 'A8'));
  realm.add(Car(ObjectId(), "Mercedes", model: 'G Wagon'));
});
// Sync changes with the server
await realm.syncSession.waitForUpload();
await realm.syncSession.waitForDownload();
// Create new configuration for the bundled realm.
// You must specify a path separate from the realm you
// are copying for Realm.writeCopy() to succeed.
final bundledConfig = Configuration.flexibleSync(user, [Car.schema],
    path: 'sync_bundle.realm');
realm.writeCopy(bundledConfig);
print("Bundled realm location: " + bundledConfig.path);
realm.close();

Depois de criar o Realm, siga as instruções das seções acima Agrupar um Arquivo de Realm em sua aplicação e Abrir um Realm a partir de um Arquivo de Realm agrupado.