Conéctate a Atlas App Services - Kotlin SDK

Default App Client

Para inicializar una aplicación con valores de configuración por defecto, pasa el ID de la aplicación de tu App Services App 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 permite configurar el cliente de la aplicación con argumentos opcionales para un control más detallado de los detalles de la conexión de la aplicación, como encabezados de solicitud personalizados y claves para 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.

Multiplexing is disabled by default. You can enable it on the AppConfiguration using the .enableSessionMultiplexing() method, which accepts a Boolean value.

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

Cuando está habilitada, la conexión compartida no se cierra de inmediato cuando todas las sesiones se cierran. En su lugar, permanece abierta durante el connectionLingerTime, que por defecto es 30 segundos. Puedes anular esta duración proporcionando un nuevo valor a SyncTimeoutOptions.connectionLingerTime() en el AppConfiguration.

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

Para obtener más información, consulta la sección Configurar límites de tiempo 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()

For a complete list of the available timeout properties and their definitions, refer to the SyncTimeoutOptionsBuilder API reference.

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, pasa tu llave de cifrado a la propiedad encryptionKey al iniciar la aplicación:

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

Establecer HTTP Headers personalizados

Si usas App Services o Device Sync con una configuración de proxy, es posible que necesites establecer cabeceras HTTP personalizadas. El Kotlin SDK admite la configuración de HTTP headers personalizados en la aplicación. Estos encabezados se añaden a cada solicitud a la App Services App, incluidas las llamadas a funciones.

When you initialize the App, you can pass:

• el valor personalizado de authorizationHeaderName String

• cualquier customRequestHeaders en un mapa de claves y valores String de encabezados (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

Atlas Device SDK's platform networking lets you use your platform's networking stack instead of the default WebSocket client for Device Sync traffic.

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.

El networking de la plataforma está deshabilitado por defecto. Puedes activarlo en el AppConfiguration utilizando el AppConfiguration.usePlatformNetworking() método, que acepta un valor booleano.

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