Realm 파일 번들 - .NET SDK

번들링을 위한 Realm 파일 만들기

1. 프로덕션 앱과 동일한 Realm 데이터 모델을 사용하여 새 프로젝트를 생성합니다. 번들로 만들 데이터가 있는 기존 Realm을 열거나 새 Realm을 만듭니다.

2. WriteCopy() 메서드를 사용하여 영역 의 복사본을 새 위치 및/또는 이름으로 만듭니다. 다음 코드는 이를 보여줍니다.

   로컬 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 복사

   동기화된 영역 을 복사할 때는 보류 중인 동기화 프로세스가 없는지 확인해야 합니다. 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 구성 복사만 지원합니다. 이 방법을 사용하여 파티션 기반 동기화 영역과 Flexible Sync 영역 간에 또는 그 반대로 변환할 수 없습니다.

프로덕션 애플리케이션에 Realm 파일 번들

이제 '시드' 데이터가 포함된 영역의 복사본이 있으므로 이를 프로덕션 애플리케이션과 번들로 묶어야 합니다. 번들 프로세스는 모바일 앱을 빌드하는지, 아니면 Unity 앱을 빌드하는지에 따라 다릅니다.

번들 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);