Agrupar archivos Realm - .NET SDK

Crear un archivo de reino para agrupar

1. Crea un nuevo proyecto con los mismos modelos de datos que tu aplicación de producción. Abre un dominio existente con los datos que quieres agrupar o crea uno nuevo.

2. Utilice el método WriteCopy() para crear una copia del dominio en una nueva ubicación o nombre. El siguiente código lo demuestra.

   Reino local

   Reino sincronizado

   // open an existing realm
   var realm = Realm.GetInstance("myRealm.realm");
   // Create a RealmConfiguration for the *copy*
   var config = new RealmConfiguration("bundled.realm");
   // Make sure the file doesn't already exist
   Realm.DeleteRealm(config);
   // Copy the realm
   realm.WriteCopy(config);
   // Want to know where the copy is?
   var locationOfCopy = config.DatabasePath;

   Importante

   Copiar reinos sincronizados

   Al copiar un dominio sincronizado, debe asegurarse de que no haya procesos de sincronización pendientes. Para ello, llame a WaitForUploadAsync y WaitForDownloadAsync.

   // open an existing realm
   var existingConfig = new PartitionSyncConfiguration("myPartition", user);
   var realm = await Realm.GetInstanceAsync(existingConfig);
   // Create a RealmConfiguration for the *copy*
   // Be sure the partition name matches the original
   var bundledConfig = new PartitionSyncConfiguration("myPartition", user, "bundled.realm");
   // Make sure the file doesn't already exist
   Realm.DeleteRealm(bundledConfig);
   // IMPORTANT: When copying a Synced realm, you must ensure
   // that there are no pending Sync operations. You do this
   // by calling WaitForUploadAsync() and WaitForDownloadAsync():
   var session = realm.SyncSession;
   await session.WaitForUploadAsync();
   await session.WaitForDownloadAsync();
   // Copy the realm
   realm.WriteCopy(bundledConfig);
   // Want to know where the copy is?
   var locationOfCopy = existingConfig.DatabasePath;

   Nota

   Solo sincronización del mismo tipo

   Este método solo permite copiar una configuración de sincronización basada en particiones para otro usuario de sincronización basada en particiones, o una configuración de sincronización flexible para otro usuario de sincronización flexible. No se puede usar este método para convertir entre un dominio de sincronización basada en particiones y uno de sincronización flexible, ni viceversa.

Agrupar un archivo de reino en su aplicación de producción

Ahora que tiene una copia del dominio con los datos "semilla", debe empaquetarla con su aplicación de producción. El proceso de empaquetado depende de si está creando una aplicación móvil o de Unity:

Abrir un reino desde un archivo de reino incluido

Ahora que tienes una copia del realm incluido en tu aplicación, necesitas añadir código para utilizarlo. El código que se agregue dependerá del tipo de aplicación:

// If you are using a local realm
var config = RealmConfiguration.DefaultConfiguration;
// If the realm file is a synced realm
var app = App.Create(Config.AppId);
var user = await app.LogInAsync(Credentials.Anonymous());
config = new PartitionSyncConfiguration("myPartition", user);
// Extract and copy the realm
if (!File.Exists(config.DatabasePath))
{
    using var bundledDbStream = Assembly.GetExecutingAssembly()
        .GetManifestResourceStream("bundled.realm");
    using var databaseFile = File.Create(config.DatabasePath);
    bundledDbStream!.CopyTo(databaseFile);
}
// Open the Realm:
var realm = Realm.GetInstance(config);

// After copying the above created file to the project folder,
// we can access it in Application.dataPath
// If you are using a local realm
var config = RealmConfiguration.DefaultConfiguration;
// If the realm is synced realm
var app = App.Create("myRealmAppId");
var user = await app.LogInAsync(Credentials.Anonymous());
config = new PartitionSyncConfiguration("myPartition", user);
if (!File.Exists(config.DatabasePath))
    FileUtil.CopyFileOrDirectory(Path.Combine(Application.dataPath,
        "bundled.realm"), config.DatabasePath);
}
var realm = Realm.GetInstance(config);