Menu Docs

Página inicial do DocsDesenvolver aplicaçõesAtlas Device SDKs

Arquivos Realm do pacote - .NET SDK

Nesta página

  • Criar um arquivo Realm para agrupamento
  • Agrupe um arquivo Realm em seu aplicativo de produção
  • Abrir um Realm a partir de um arquivo de Realm agrupado

Talvez você queira semear seu aplicativo móvel com alguns dados iniciais que estarão disponíveis aos usuários no lançamento inicial do aplicativo. Para fazer isso, você:

  • Construa um aplicativo Realm temporário,

  • Faça uma cópia de um Realm existente (apenas com os dados que você deseja agrupar) e, em seguida,

  • Agrupe o Arquivo de Realm no projeto compartilhado do seu aplicativo.

Em seu aplicativo de produção (aquele que usará esse Realm agrupado no primeiro carregamento), adicione algumas linhas de código para extrair o Realm e salvá-lo nos dados do aplicativo. As seções a seguir fornecem mais informações sobre essas etapas.

Importante

Agrupar domínios sincronizados

Se o seu aplicativo de backend usar o Flexible Sync, os usuários poderão sofrer um reinício do cliente na primeira vez que abrirem o arquivo de domínio incluído. Isso pode ocorrer quando o tempo máximo offline do cliente está habilitado (o tempo máximo offline do cliente é habilitado por padrão). Se o arquivo de domínio agrupado tiver sido gerado mais do que o número de dias especificado pela configuração de tempo máximo offline do cliente antes de o usuário sincronizar pela primeira vez, o usuário experimenta um reinício do cliente.

Os aplicativos que executam uma redefinição do cliente baixam o estado completo do domínio do backend do aplicativo. Isso nega as vantagens de agrupar um arquivo de domínio. Para evitar o reinício do cliente e preservar as vantagens do agrupamento de arquivos realm:

  • Evite usar o tempo offline máximo do cliente em aplicativos que agrupam um domínio sincronizado.

  • Se o seu aplicativo usar o tempo máximo offline do cliente, certifique-se de que o download do aplicativo sempre inclua um arquivo de domínio sincronizado recentemente. Gere um novo arquivo a cada versão do aplicativo e garanta que nenhuma versão permaneça atual por mais do que o número máximo de dias de tempo offline do cliente .

  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 domínio para um novo local e/ou nome. O seguinte código demonstra isso.

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:

Observação

Compatibilidade entre plataformas

Os Arquivo de Realm não criptografados são compatíveis com várias plataformas, e é por isso que você pode agrupar o arquivo no projeto compartilhado.

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:

← Excluir um Realm - .NET SDK