Você pode usar o Atlas Device SDK for Flutter em um projeto do Flutter ou em um projeto standalone do Dart. Este guia fornece instruções para instalar o SDK em ambos os tipos de projetos.
Pré-requisitos
Para começar a usar o Atlas Device SDK para Flutter, você precisa instalar o seguinte, dependendo do tipo de aplicativo que está desenvolvendo:
Para aplicativos Flutter ou Dart, instale o Flutter com o Dart em seu ambiente de desenvolvimento. A instalação do Flutter inclui o Dart. Para saber como, consulte o Guia oficial de instalação do Flutter.
Para aplicativos Dart autônomo , você pode instalar o Dart em seu ambiente de desenvolvimento sem o Flutter. Para saber como, consulte o Guia oficial da Instalação do Dart.
A versão mais recente do Flutter SDK requer as seguintes versões mínimas:
Versão do Flutter 3.19.0 ou posterior.
Dart versão 3.3.0 ou posterior.
Plataformas suportadas
O Flutter SDK é compatível com as seguintes plataformas:
iOS
Android
macOS
Windows em execução na arquitetura 64bits
Linux em execução na arquitetura de bits
Importante
Plataformas não suportadas
O Flutter SDK não é compatível com as seguintes plataformas:
Web
Windows em execução em arquiteturas ARM64 ou 32-bit
Linux em execução em arquiteturas ARM64 ou 32 bits
Instalar o SDK
O Atlas Device SDK for Flutter tem dois pacotes disponíveis para instalação, dependendo se você estiver desenvolvendo um aplicativo standalone do Flutter ou do Dart:
realm: O pacote do Flutter SDK para uso em aplicativos do Flutter.realm_dart: O pacote do Dart SDK independente para uso em aplicativos Dart, como aplicativos CLI ou que executam o Dart em um ambiente de servidor.
O pacote Dart standalone tem o mesmo uso que o pacote Flutter, exceto onde indicado de outra forma.
Dica
Atlas Device SDK e Realm
O Flutter SDK usa o banco de dados Realm Core para persistência de dados do dispositivo. Quando você instala o Flutter SDK, os nomes dos pacotes refletem o nome do Realm .
Criar um projeto
Para criar um projeto do Flutter, execute os seguintes comandos:
flutter create <app_name> cd <app_name>
Para obter mais informações, consulte o Guia de Introdução do Flutter.
Para criar um projeto Dart, execute os seguintes comandos:
dart create <app_name> cd <app_name>
Para obter mais informações, consulte o Guia de Introdução do Dart para aplicativos de servidor e linha de comando Dart autônomo.
Adicionar o SDK ao projeto
Para adicionar o Flutter SDK ao seu projeto, execute o seguinte comando:
flutter pub add realm
Isto baixa o pacote do Realm e adiciona - o ao seu projeto.
Em seu arquivo pubspec.yaml , você verá:
dependencies: realm: <latest_version>
Observação
Usando rede em sua aplicação macOS
Se você estiver desenvolvendo com o Flutter SDK no macOS App Sandbox e precisar de acesso à rede, deverá ativar os direitos de rede em seu aplicativo. Por padrão, as solicitações de rede não são permitidas devido às configurações de segurança integradas do macOS.
Para usar a rede em seu aplicativo macOS, você deve alterar os direitos de rede do macOS do seu aplicativo. Para saber como, consulte Usar o Realm com o macOS App Sandbox.
Para adicionar o SDK ao seu projeto, execute o seguinte comando:
dart pub add realm_dart
Isto baixa o pacote realm_dart e adiciona - o ao seu projeto.
Em seu arquivo pubspec.yaml , você verá:
dependencies: realm_dart: <latest_version>
Depois que o pacote for adicionado, execute o seguinte comando para instalá-lo:
dart run realm_dart install
Esta ação transfere e copia os binários nativos necessários para o diretório de aplicativos.
Atualizar a versão do pacote
Para alterar a versão do SDK em seu projeto, execute as seguintes etapas, dependendo se você está utilizando o pacote realm ou realm_dart :
Instale o pacote atualizado
Execute o seguinte comando para instalar a versão atualizada:
dependencies: realm: <updated_version>
Execute o seguinte comando para instalar a versão atualizada:
dart pub upgrade realm_dart
Em seguida, execute o seguinte comando para instalar os binários nativos do SDK atualizados:
dart run realm_dart install
Regenerar modelos de objetos
dart run realm generate
Importante
Flutter SDK v2.0.0 Alteração significativa nos arquivos gerados
Versão do Flutter SDK 2.0.0 introduz uma atualização no construtor, que afeta a forma como os arquivos são gerados. Na2.0.0 e posterior, todos os arquivos gerados usam a convenção de nomenclatura .realm.dart em vez de .g.dart.
Esta é uma alteração interruptiva significativa para aplicativos existentes. Para obter informações sobre como atualizar um aplicativo existente de uma versão anterior do SDK para a v2.0.0 ou posterior, consulte Atualizar para o Flutter SDK v2.0.0.
Solução de problemas
Se você tiver problemas ao usar a versão atualizada do SDK em seu aplicativo, poderá excluir o arquivo de banco de dados .realm criado pelo SDK e reiniciar o aplicativo. Observe que excluir o arquivo .realm também exclui todos os dados armazenados no banco de dados desse cliente.
Para obter mais informações, consulte Excluir um arquivo do Realm - Flutter SDK.
Manifesto de privacidade da Apple
Novidades na versão 2.2.0.
A Apple exige que quaisquer apps ou SDKs de terceiros que utilizem APIs de motivos exigidos forneçam um manifesto de privacidade. O manifesto contém detalhes sobre as práticas de coleta e uso de dados do aplicativo ou do SDK e deve ser incluído ao enviar novos aplicativos ou atualizações de aplicativos para a Apple App Store. Para obter mais detalhes sobre esses requisitos, consulte Próximos requisitos de SDK de terceiros no website para programadores da Apple.
A partir da versão 2.2.0 do SDK Flutter SDK , o SDK é fornecido com um manifesto de privacidade para os ambientes iOS e macOS, contidos no pacote realm. Ambos os manifestos de privacidade contêm as informações sobre as API obrigatórias da Apple e os motivos para usar essas APIs.
Você pode visualizar estes manifestos de privacidade no pacote do SDK ou diretamente no repositório do Github do realm-dart:
iOS: https://github.com/ Realm/realm-dart/blob/main/packages/ Realm/ios/Resources/PrivacyInfo.xcprivacymacOS: https://github.com/ Realm/realm-dart/blob/main/packages/ Realm/macos/Resources/PrivacyInfo.xcprivacy
O Flutter SDK não:
Inclua código analítico em compilações para a App Store.
Faça login no Atlas em seu próprio nome.
Importante
Dicultações adicionais podem ser necessárias para o Atlas App Services
O manifesto de privacidade do Flutter SDK não inclui publicações para APIs do Atlas App Services .
Se a sua aplicação utiliza qualquer funcionalidade dos Atlas App Services, como autenticação de usuário ou Device Sync, talvez seja necessário fornecer descrições adicionais que detalham sua collection de dados e práticas de uso ao usar essas APIs. Por exemplo, se sua aplicação inicializar um cliente de aplicação para:
Para obter mais informações, consulte a documentação dos Arquivos de manifesto de privacidade da Apple.