捆绑 Realm 文件 - .NET SDK

创建用于捆绑的 Realm 文件

1. 使用与生产应用程序相同的Realm 数据模型创建一个新的项目。打开包含要捆绑的数据的现有 Realm，或创建新 Realm。

2. 使用WriteCopy()方法将域复制到新位置和/或名称。 以下代码对此进行了演示。

   Local Realm

   同步 Realm

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

   重要

   复制同步 Realm

   复制 Synced 域时，必须确保不存在待处理的同步进程。 您可以通过调用WaitForUploadAsync和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;

   注意

   仅限同类型同步

   此方法仅支持复制另一个基于分区的同步用户的基于分区的同步配置，或复制另一个 Flexible Sync 用户的 Flexible Sync 配置。 您不能使用此方法在基于分区的同步 Realm 和 Flexible Sync Realm 之间进行转换，反之亦然。

在生产应用程序中捆绑 Realm 文件

现在您已经拥有了包含“种子”数据的域副本，您需要将其与生产应用程序捆绑在一起。捆绑过程取决于您构建的是移动应用程序还是 Unity 应用程序：

从捆绑的 Realm 文件中打开 Realm

现在您已拥有应用中包含的 Realm 副本，您需要添加代码来使用它。 您添加的代码取决于应用的类型：

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