Conéctate a Atlas App Services - Kotlin SDK

Cliente de aplicación predeterminado

Para inicializar una aplicación con valores de configuración predeterminados, pase el ID de la aplicación de App Services al método App.create():

// Creates an App with default configuration values
val app = App.create(YOUR_APP_ID) // Replace with your App ID

Cliente de aplicación configurado

La interfaz AppConfiguration le permite configurar su cliente de aplicación con argumentos opcionales para un control más granular de los detalles de conexión de su aplicación, como encabezados de solicitud personalizados y claves para el cifrado local.

Para controlar las opciones de configuración, utilice AppConfiguration.Builder y llame al .build() método para pasar un objeto de configuración:

// Creates an App with custom configuration values
AppConfiguration.Builder(YOUR_APP_ID)
    // Specify your custom configuration values
    .appName("my-app-name")
    .appVersion("1.0.0")
    .baseUrl("http://localhost:9090")
    .build()

Compartir conexiones de sincronización

De forma predeterminada, el SDK abre una conexión independiente al servidor para cada dominio sincronizado. En Kotlin v1.13.0 y versiones posteriores, se puede habilitar la multiplexación de sesiones. Al habilitarla, el SDK comparte una conexión al servidor para todos los dominios sincronizados abiertos con un solo usuario de App Services. Compartir una conexión entre varias sesiones reduce los recursos y puede mejorar el rendimiento.

La multiplexación está deshabilitada por defecto. Puede habilitarla en mediante AppConfiguration el método `.enableSessionMultiplexing()`, que acepta un valor booleano.

val config = AppConfiguration.Builder(YOUR_APP_ID)
    .enableSessionMultiplexing(true)
    .build()

Cuando está habilitada, la conexión compartida no se cierra inmediatamente al cerrar todas las sesiones. En su lugar, permanece abierta connectionLingerTime durante, que por defecto es 30 segundos. Puede anular esta duración pasando un nuevo valor a SyncTimeoutOptions.connectionLingerTime() AppConfigurationen.

val configCustomLingerTime = AppConfiguration.Builder(YOUR_APP_ID)
    .enableSessionMultiplexing(true)
    .syncTimeouts {
        connectionLingerTime = 10.seconds // Overrides default 30 secs
    }
    .build()

Para obtener más información, consulte la sección Configurar tiempos de espera de sincronización en esta página.

Configurar tiempos de espera de sincronización

En Kotlin v1.13.0 y posteriores, puedes anular la configuración por defecto de timeout utilizada para sincronizar datos entre el backend de Atlas y la aplicación cliente.

Puedes configurar varios tiempos de espera de sincronización en AppConfiguration mediante el método .syncTimeouts(). Introduce los valores específicos de las propiedades de tiempo de espera que quieras anular. Los tiempos de espera configurados se aplican a todas las sesiones de sincronización de la aplicación.

val config = AppConfiguration.Builder(YOUR_APP_ID)
    .syncTimeouts {
        connectTimeout = 1.minutes
        connectionLingerTime = 15.seconds
        pingKeepalivePeriod = 30.seconds
        pongKeepalivePeriod = 1.minutes
        fastReconnectLimit = 30.seconds
    }
    .build()

Para obtener una lista completa de las propiedades de tiempo de espera disponibles y sus definiciones, consulte la referencia de API de SyncTimeoutOptionsBuilder.

Encriptar Metadatos de la aplicación

Al conectarse a App Services, Realm crea archivos de metadatos adicionales en un dispositivo. Para obtener más información sobre estos archivos de metadatos, consulte el SDK de dispositivos Atlas para Kotlin.

Puedes cifrar los metadatos que App Services almacena en los dispositivos cliente, de forma similar a como cifras un dominio sincronizado.

Para cifrar los metadatos de la aplicación, pase su clave de cifrado a la propiedad encryptionKey cuando inicialice la aplicación:

val config =
    AppConfiguration.Builder(YOUR_APP_ID)
        // Specify the encryption key
        .encryptionKey(myEncryptionKey)
        .build()

Establecer HTTP Headers personalizados

Si usa App Services o Device Sync con un proxy, es posible que necesite configurar encabezados HTTP personalizados. El SDK de Kotlin permite configurar encabezados HTTP personalizados en la aplicación. Estos encabezados se añaden a cada solicitud a la aplicación App Services, incluidas las llamadas a funciones.

Al inicializar la aplicación, puedes pasar:

• el valor personalizado de authorizationHeaderName String

• cualquier customRequestHeaders en un mapa de String claves y valores de encabezado (el SDK acepta valores vacíos pero no claves vacías)

AppConfiguration.Builder(YOUR_APP_ID)
    .authorizationHeaderName("MyApp-Authorization")
    .customRequestHeaders { put("X-MyApp-Version", "1.0.0") }
    .build()

Habilitar la red de plataformas

La red de plataforma de Atlas Device SDK le permite utilizar la pila de red de su plataforma en lugar del cliente WebSocket predeterminado para el tráfico de sincronización de dispositivos.

Cuando está habilitado, puede configurar aplicaciones que se ejecutan en plataformas Android y Java Virtual Machine (JVM) para usar WebSockets administrados a través de OkHttpLos WebSockets administrados brindan soporte de configuración avanzado para servidores proxy y firewalls que requieren autenticación.

La red de plataformas está deshabilitada de forma predeterminada. Puede habilitarla en AppConfiguration mediante el método AppConfiguration.usePlatformNetworking(), que acepta un valor booleano.

val config =
    AppConfiguration.Builder(YOUR_APP_ID)
        .usePlatformNetworking(true)
        .build()