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 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 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 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 do Dart autônomo .
Adicionar o SDK ao projeto
Para adicionar o Flutter SDK ao seu projeto, execute o seguinte comando:
flutter pub add realm
Isso baixa o domínio pacote e o adiciona 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
Isso baixa o realm_dart pacote e o adiciona 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
dart run realm_dart 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 do SDK de terceiros no site da Apple Developer.
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 Arquivos de manifesto de privacidade da Apple documentação.