Arquivos Realm do pacote - .NET SDK

Criar um arquivo Realm para agrupamento

1. Crie um novo projeto com o mesmo Modelo de dados Realm como seu aplicativo de produção. Abra um Realm existente com os dados que você deseja agrupar ou crie um novo.

2. Use o método WriteCopy() para fazer uma cópia do Realm para um novo local e/ou nome. O seguinte código demonstra isso.

   Realm local

   Realm 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

   Copiando domínios sincronizados

   Ao copiar um Realm sincronizado, você deve garantir que não haja processos de sincronização pendentes. Você faz isso chamando WaitForUploadAsync e 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;

   Observação

   Somente sincronização do mesmo tipo

   Esse método oferece suporte apenas à cópia de uma configuração de Partition-Based Sync para outro usuário de Partition-Based Sync ou uma configuração de Flexible Sync para outro usuário de Flexible Sync. Você não pode usar esse método para converter entre um Partition-Based Sync realm e um Flexible Sync realm ou vice-versa.

Agrupe um arquivo Realm em seu aplicativo de produção

Agora que você tem uma cópia do domínio com os dados "seed", é necessário empacotá-lo com seu aplicativo de produção. O processo de agrupamento depende se você está construindo um aplicativo móvel ou aplicativo Unity:

Abrir um Realm a partir de um arquivo de Realm agrupado

Agora que você tem uma cópia do Realm incluída em seu aplicativo, é necessário adicionar o código para usá-lo. O código adicionado depende do tipo de aplicativo:

// 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);