Página inicial do Docs → Desenvolver aplicações → Atlas Device SDKs
Instalar o SDK do Flutter
Nesta página
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 SDKs 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 standalone, você pode instalar o Dart em seu ambiente de desenvolvimento sem o Flutter. Para saber como, consulte o Guia oficial de instalação do Dart.
A versão mais recente do SDK do Flutter requer as seguintes versões mínimas:
Versão 3 do Flutter.19.0 ou posterior.
Versão do Dart 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 SDK do Flutter 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 SDK do Flutter usa o banco de dados Realm Core para persistência de dados do dispositivo. Quando você instala o SDK do Flutter, os nomes dos pacotes refletem o nome do Realm.
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
:
Regenerar modelos de objetos
Importante
Flutter SDK v2.0.0 alteração interruptiva nos arquivos gerados
Flutter SDK versão 2.0.0 introduz uma atualização no construtor, que impacto a forma como os arquivos são gerados. Na v2.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 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 - SDK do Flutter.
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 do SDK de terceiros no site da Apple Developer.
A partir da versão 2 do SDK do Flutter.2.0, o SDK é fornecido com um manifesto de privacidade para os ambientes iOS
e macOS
, contido no pacote realm
. Ambos os manifestos de privacidade contêm as informações sobre as APIs obrigatórias da Apple e os motivos para usar essas APIs.
Você pode visualizar estes manifestos de privacidade no pacote SDK ou diretamente no repositório realm-dart
do GitHub:
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 SDK do Flutter 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 App Services
O manifesto de privacidade do SDK do Flutter não inclui publicações para APIs do 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 Arquivos de manifesto de privacidade documentação.