Puedes usar el SDK de dispositivos Atlas para Flutter en un proyecto de Flutter o en un proyecto independiente de Dart. Esta guía proporciona instrucciones para instalar el SDK en ambos tipos de proyectos.
Requisitos previos
Para comenzar a utilizar el Atlas Device SDK para Flutter, debe instalar lo siguiente, según el tipo de aplicación que esté desarrollando:
Para aplicaciones de Flutter o Dart, instala Flutter con Dart en tu entorno de desarrollo. La instalación de Flutter incluye Dart. Para saber cómo, consulta la página oficial. Guía de instalación de Flutter.
Para aplicaciones Dart independientes, puedes instalar Dart en tu entorno de desarrollo sin Flutter. Para saber cómo, consulta la Guía de instalación oficial de Dart.
La última versión del SDK de Flutter requiere las siguientes versiones mínimas:
Versión de Flutter 3.19.0 o posterior.
Versión Dart 3.3.0 o posterior.
Plataformas compatibles
El SDK de Flutter es compatible con las siguientes plataformas:
iOS
Android
macOS
Windows ejecutándose en una arquitectura de 64bits
Linux ejecutándose en una arquitectura de 64bits
Importante
Plataformas no compatibles
El SDK de Flutter no es compatible con las siguientes plataformas:
Web
Windows ejecutándose en arquitecturas ARM64 o de 32bits
Linux ejecutándose en arquitecturas ARM64 o de 32bits
Instalar el SDK
El Atlas Device SDK para Flutter tiene dos paquetes disponibles para instalar, dependiendo de si está desarrollando una aplicación independiente de Flutter o Dart:
realm:El paquete SDK de Flutter para usar en aplicaciones de Flutter.realm_dart:El paquete SDK de Dart independiente para usar en aplicaciones Dart, como aplicaciones CLI o ejecutar Dart en un entorno de servidor.
El paquete Dart independiente tiene el mismo uso que el paquete Flutter excepto que se indique lo contrario.
Tip
SDK de dispositivos Atlas y Realm
El SDK de Flutter utiliza la base de datos Realm Core para la persistencia de los datos del dispositivo. Al instalar el SDK de Flutter, los nombres de los paquetes reflejan la nomenclatura de Realm.
Crear un proyecto
Para crear un proyecto Flutter, ejecute los siguientes comandos:
flutter create <app_name> cd <app_name>
Para obtener más información, consulte la Guía de introducción de Flutter.
Para crear un proyecto en Dart, ejecuta los siguientes comandos:
dart create <app_name> cd <app_name>
Para obtener más información, consulte la Guía de inicio rápido de Dart para aplicaciones de servidor y de línea de comandos de Dart independientes.
Agregar el SDK al proyecto
Para agregar el SDK de Flutter a su proyecto, ejecute el siguiente comando:
flutter pub add realm
Esto descarga el paquete realm y lo agrega a su proyecto.
En su archivo pubspec.yaml, debería ver:
dependencies: realm: <latest_version>
Nota
Cómo usar la red en tu aplicación macOS
Si desarrollas con el SDK de Flutter en el entorno de pruebas de aplicaciones de macOS y necesitas acceso a la red, debes habilitar los permisos de red en tu aplicación. De forma predeterminada, las solicitudes de red no están permitidas debido a la configuración de seguridad integrada de macOS.
Para usar la red en tu app de macOS, debes cambiar los permisos de red de macOS. Para saber cómo, consulta Usar Realm con el entorno de pruebas de apps de macOS.
Para agregar el SDK a su proyecto, ejecute el siguiente comando:
dart pub add realm_dart
Esto descarga el paquete realm_dart y lo agrega a su proyecto.
En su archivo pubspec.yaml, debería ver:
dependencies: realm_dart: <latest_version>
Después de agregar el paquete, ejecute el siguiente comando para instalarlo:
dart run realm_dart install
Esto descarga y copia los binarios nativos necesarios al directorio de la aplicación.
Actualizar la versión del paquete
Para cambiar la versión del SDK en su proyecto, realice los siguientes pasos, dependiendo de si está utilizando el paquete realm o realm_dart:
Instalar el paquete actualizado
Ejecute el siguiente comando para instalar la versión actualizada:
dependencies: realm: <updated_version>
Ejecute el siguiente comando para instalar la versión actualizada:
dart pub upgrade realm_dart
Luego, ejecute el siguiente comando para instalar los binarios nativos del SDK actualizado:
dart run realm_dart install
Regenerar modelos de objetos
dart run realm generate
dart run realm_dart generate
Importante
Cambio importante en los archivos generados del SDK de Flutter v2.0.0
La versión 2.0.0 del SDK de Flutter incluye una actualización del compilador que afecta la generación de archivos. A partir de la versión2.0.0, todos los archivos generados usan la convención de nomenclatura .realm.dart en lugar de .g.dart.
Este es un cambio importante para las aplicaciones existentes. Para obtener información sobre cómo actualizar una aplicación existente desde una versión anterior del SDK a la v2.0.0 o posterior, consulta "Actualizar a la v del SDK de Flutter".2.0.0
Solución de problemas
Si tiene problemas al usar la versión actualizada del SDK en su aplicación, puede eliminar el archivo de base de datos .realm creado por el SDK y reiniciar la aplicación. Tenga en cuenta que al eliminar el archivo .realm también se eliminan todos los datos almacenados en la base de datos de ese cliente.
Para obtener más información, consulte Eliminar un archivo de reino - Flutter SDK.
Manifiesto de privacidad de Apple
Nuevo en la versión 2.2.0.
Apple exige que todas las apps o SDK de terceros que utilicen las API de motivos obligatorios proporcionen un manifiesto de privacidad. Este manifiesto contiene detalles sobre las prácticas de recopilación y uso de datos de la app o el SDK, y debe incluirse al enviar nuevas apps o actualizaciones a la App Store de Apple. Para obtener más información sobre estos requisitos, consulta los próximos requisitos de los SDK de terceros en el sitio web para desarrolladores de Apple.
A partir de la versión 2.2.0 del SDK de Flutter, este se entrega con un manifiesto de privacidad para los entornos iOS y macOS, incluido en el paquete realm. Ambos manifiestos de privacidad contienen las divulgaciones de API requeridas por Apple y las razones para usarlas.
Puede ver estos manifiestos de privacidad en el paquete SDK o directamente en el repositorio de GitHub 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
El SDK de Flutter no:
Incluye el código de análisis en compilaciones para la App Store.
Inicie sesión en Atlas en su propio nombre.
Importante
Es posible que se requieran divulgaciones adicionales para los servicios de aplicaciones
El manifiesto de privacidad del SDK de Flutter no incluye divulgaciones para las API de Servicios de aplicación.
Si su aplicación utiliza alguna funcionalidad de Atlas App Services, como la autenticación de usuarios o la sincronización de dispositivos, es posible que deba proporcionar información adicional que detalle sus prácticas de recopilación y uso de datos al usar estas API. Por ejemplo, si su aplicación inicializa un cliente de aplicación para:
Para obtener más información, consulte la documentación de los archivos de manifiesto de privacidad de Apple.