Menu Docs
Página inicial do Docs
/ /
Serviços Atlas App
/

Migrar um aplicativo somente para local para um aplicativo habilitado para sincronização

Nesta página

  • Criar um App Services App
  • Habilitar autenticação
  • Habilitar a sincronização
  • Atualizar o aplicativo do cliente
  • Copiar dados existentes

Se você tiver um aplicativo móvel que usa um Realm local e deseja converter o aplicativo para usar a Sincronização, há três tarefas principais:

  • Criar e configurar um App Services App

  • Modifique seu código do cliente para ponto para este novo aplicativo de backend

  • Copie os dados locais para o novo Realm sincronizado

Quando se trata de ler e gravar em um reconhecimento de data center Realm, não há diferença entre trabalhar com um Realm local e um Realm sincronizado. Depois de configurar a sincronização e abrir o Realm, seu código existente continuará funcionando da mesma forma que antes da migração.

Uma imagem mostrando um aplicativo móvel apenas com dados locais e, em seguida, com sincronização.

Observação

Um aplicativo pode ter vários realms, e você pode migrar qualquer número deles para usar a Sincronização. Por exemplo, seu aplicativo pode continuar a usar um Realm somente local para informações específicas do dispositivo e, ao mesmo tempo, usar um Realm sincronizado para outros dados.

Para sincronizar seus dados entre dispositivos e MongoDB Atlas, primeiro você cria um App Services App. Este aplicativo fornece um gateway para os dados com segurança na forma de autenticação de usuário, criptografia de dados e controle de acesso.

Para começar a criar o aplicativo de backend, siga as etapas em Criar um App Services App.

O Realm Mobile Sync requer usuários autenticados. Atlas App Services fornece muitos provedor de autenticação diferentes, como e-mail/senha e OAuth. Depois de habilitar e configurar a autenticação, você terá controle total sobre quem tem acesso a quais dados.

Para saber mais e começar, consulte provedor de autenticação.

No seu App Services App, configurar a sincronização é a etapa final. Ao configurar a sincronização, você permite que usuários autenticados tenham acesso online aos dados atuais. Enquanto estiver offline, os usuários podem trabalhar com os dados mais recentes, mas suas alterações não serão sincronizadas até que estejam online novamente.

Com o Flexible Sync, os clientes sincronizam subconjuntos de dados com base em queries a campos de query. Ao configurar o Flexible Sync, você decide quais campo os clientes podem fazer query. Para habilitar a Flexible Sync, siga as etapas de Procedimento.

Agora que você configurou o backend para o Realm Mobile Sync, será necessário fazer algumas alterações no código do aplicativo cliente. Siga as etapas para configurar a Flexible Sync no Início Rápido para o idioma/plataforma que você está usando:

  • Início rápido - .NET SDK

  • Início rápido - SDK do Node.js

  • Início rápido - React Native SDK

  • Início rápido - Swift SDK

Neste ponto, seus dados ainda existem apenas no reconhecimento de data center local. Você precisa realizar uma cópia inicial para que o Realm sincronize os dados. Para fazer isso, siga estas etapas e consulte o diagrama:

  1. Verifique se já existe um Realm sincronizado.

  2. Caso contrário, crie um. Abra uma conexão com ele e com o domínio local.

  3. Leia cada registro do Realm local e modifique-o para corresponder ao esquema do Realm sincronizado.

  4. Copie o registro modificado para o novo Realm sincronizado. A sincronização copia automaticamente o registro para o MongoDB Atlas quando conectado ao seu aplicativo.

  5. Confirme se todos os registros que você deseja preservar estão no novo Realm.

  6. Exclua o Arquivo de Realm local.

  7. Em cada carregamento de aplicativo subsequente, verifique se o Realm local foi excluído.

Gráfico de fluxo mostrando as etapas para converter de local para sincronizado

Observação

Se você encontrar erros ao configurar a sincronização ou copiar dados, verifique os registros do App Services App. Os registros fornecem detalhes sobre erros de sincronização. Em muitos casos, executar um reinício do cliente é útil para resolver problemas de migração de sincronização.

Voltar

Compactar um Volume Atlas