문서 홈 → 애플리케이션 개발 → Atlas Device SDK
Realm 파일 번들 - .NET SDK
앱을 처음 실행할 때 사용자가 사용할 수 있는 일부 초기 데이터를 모바일 앱에 시드할 수 있습니다. 이렇게 하려면 다음을 수행합니다.
임시 Realm 앱 빌드
기존 영역의 복사본을 만들고(묶고 싶은 데이터만 포함)
앱의 공유 프로젝트에 Realm 파일 을 번들로 제공합니다.
프로덕션 앱(처음 로드할 때 이 번들 영역을 사용하는 앱)에서 몇 줄의 코드를 추가하여 영역을 추출하고 앱 데이터에 저장합니다. 다음 섹션에서 이러한 단계에 대한 자세한 내용을 확인할 수 있습니다.
중요
동기화된 Realm 번들
백엔드 애플리케이션에서 Flexible Sync 를 사용하는 경우 사용자가 번들 Realm 파일을 처음 열 때 클라이언트 재설정을 경험할 수 있습니다. 이 문제는 클라이언트 최대 오프라인 시간 이 활성화된 경우(클라이언트 최대 오프라인 시간은 기본적으로 활성화되어 있음) 발생할 수 있습니다. 사용자가 처음 동기화하기 전에 번들 Realm 파일이 클라이언트 최대 오프라인 시간 설정에 지정된 일수보다 오래 생성된 경우 사용자는 클라이언트 재설정을 경험하게 됩니다.
클라이언트 재설정을 수행하는 애플리케이션은 애플리케이션 백엔드에서 영역의 전체 상태를 다운로드합니다. 이렇게 하면 Realm 파일을 번들로 제공할 때 얻을 수 있는 이점이 무효화됩니다. 클라이언트 재설정을 방지하고 Realm 파일 번들의 이점을 보존하려면 다음을 수행합니다.
동기화된 영역을 번들로 제공하는 애플리케이션에서는 클라이언트 최대 오프라인 시간을 사용하지 않도록 합니다.
애플리케이션에서 클라이언트 최대 오프라인 시간을 사용하는 경우 애플리케이션 다운로드에 항상 최근에 동기화된 Realm 파일이 포함되어 있는지 확인하세요. 각 애플리케이션 버전마다 새 파일을 생성하고 클라이언트 최대 오프라인 시간 (일)을 초과하는 버전이 최신 상태로 유지되지 않도록 합니다.
번들링을 위한 Realm 파일 만들기
프로덕션 앱과 동일한 Realm 데이터 모델을 사용하여 새 프로젝트를 생성합니다. 번들로 만들 데이터가 있는 기존 Realm을 열거나 새 Realm을 만듭니다.
WriteCopy() 메서드를 사용하여 영역의 복사본을 새 위치 및/또는 이름으로 만듭니다. 다음 코드는 이를 보여줍니다.
프로덕션 애플리케이션에 Realm 파일 번들
이제 '시드' 데이터가 포함된 영역의 복사본이 있으므로 이를 프로덕션 애플리케이션과 번들로 묶어야 합니다. 번들 프로세스는 모바일 앱을 빌드하는지, 아니면 Unity 앱을 빌드하는지에 따라 다릅니다.
참고
크로스 플랫폼 호환성
암호화되지 않은 영역 파일은 크로스 플랫폼과 호환되므로 공유 프로젝트에서 파일을 번들로 사용할 수 있습니다.
번들 Realm 파일에서 Realm 열기
이제 앱에 포함된 영역의 복사본이 있으므로 이를 사용하려면 코드를 추가해야 합니다. 추가하는 코드는 앱 유형에 따라 다릅니다.