El cliente de la aplicación es la interfaz con el backend de App Services. Proporciona acceso a la funcionalidad de autenticación, funciones, consultas auna fuente de datos de MongoDB Atlas y sincronización de dispositivos.
Nota
Manifiesto de privacidad de Apple
El manifiesto de privacidad de Apple del SDK no cubre la conexión a Atlas ni el uso de datos a través del cliente de la aplicación. Si su aplicación se conecta a los Servicios de la Aplicación y pretende distribuirla a través de la App Store de Apple, es posible que deba proporcionar sus propias divulgaciones en el manifiesto de privacidad de Apple de su aplicación.
Para obtener más información, consulte el Manifiesto de privacidad de Apple.
Acceder al cliente de la aplicación
Pase el ID de la aplicación para su aplicación, que puede encuéntrelo en la interfaz de usuario de servicios de aplicaciones.
let app = App(id: YOUR_APP_SERVICES_APP_ID) // replace YOUR_APP_SERVICES_APP_ID with your App ID
Configuración
Puede pasar un objeto de configuración a App:
let configuration = AppConfiguration( baseURL: "https://services.cloud.mongodb.com", // You can customize base URL transport: nil, // Custom RLMNetworkTransportProtocol defaultRequestTimeoutMS: 30000 ) let app = App(id: "my-app-services-app-id", configuration: configuration)
Puedes crear varias instancias de cliente de aplicación para conectarte a varias aplicaciones. Todas las instancias de cliente de aplicación que comparten el mismo ID de aplicación usan la misma conexión subyacente.
Importante
Cambiar la configuración de una aplicación después de inicializarla
A partir de la versión 10.46.0 del SDK de Swift, se puede cambiar un baseURL en la configuración de la aplicación y el cliente de la aplicación usa el nuevo baseURL. En las versiones 10.45.3 y anteriores del SDK de Swift, al inicializar el cliente de la aplicación, la configuración se almacena en caché internamente. Intentar cerrar una aplicación y volver a abrirla con la configuración modificada dentro del mismo proceso no tiene ningún efecto. El cliente continúa usando la configuración almacenada en caché.
Compartir conexión de sincronización
Nuevo en la versión 10.41.0.
Puede establecer el valor enableSessionMultiplexing booleano en AppConfiguration para especificar si Realm Swift SDK debe abrir una conexión al servidor para cada reino sincronizado o compartir una conexión al servidor para todos los reinos sincronizados.
Si no especifica un valor para este valor bool, Realm, por defecto, usa el uso compartido de una única conexión por usuario de aplicación Services para todos los realms sincronizados.
let configuration = AppConfiguration(enableSessionMultiplexing: false) let app = App(id: YOUR_APP_SERVICES_APP_ID, configuration: configuration)
Opciones de tiempo de espera de sincronización
Nuevo en la versión 10.41.0.
Puede configurar varias opciones de tiempo de espera de sincronización en AppConfiguration. La syncTimeouts propiedad puede aceptar un SyncTimeoutOptions objeto para anular los valores predeterminados de estas configuraciones.
Para obtener una lista completa de las configuraciones de tiempo de espera disponibles y sus definiciones, consulte RLMSyncTimeoutOptions.
let syncTimeoutOptions = SyncTimeoutOptions( connectTimeout: 30000, connectionLingerTime: 5000, pingKeepalivePeriod: 10000, pongKeepaliveTimeout: 10000, fastReconnectLimit: 30000 ) let configuration = AppConfiguration(syncTimeouts: syncTimeoutOptions) let app = App(id: YOUR_APP_SERVICES_APP_ID, configuration: configuration)
Sistemas operativos compatibles
El SDK de Realm Swift permite la conexión a una aplicación de Atlas App Services para diversos sistemas operativos de Apple, según la versión de Xcode y la versión del SDK de Realm Swift. Conectarse a una aplicación de App Services permite:
Autenticación y gestión de usuarios
Llamar a una función Atlas
Consulta de una fuente de datos Atlas de MongoDB
Sincronización de dispositivos
Para obtener información actualizada sobre los sistemas operativos compatibles, consulte Soporte del sistema operativo.
En este momento, el SDK Realm Swift no admite la conexión a una aplicación de Servicios de aplicaciones desde watchOS.