Conectarse a una aplicación Atlas App Services - SDK de React Native

Antes de comenzar

1. Crear una aplicación de servicios de aplicaciones

2. Obtenga su ID de aplicación

Configurar el cliente de la aplicación

Para configurar su cliente de aplicación, pase la cadena de ID de la aplicación a id AppProviderpropiedad de. Envuelva cualquier componente que necesite acceder a la aplicación AppProvider con. En este ejemplo, envolvemos UserProvider en AppProvider para autenticar a un usuario.

import React from 'react';
import {AppProvider, UserProvider} from '@realm/react';

export const AppWithAuthHook = () => {
  return (
    <View>
      <AppProvider id={APP_ID}>
        <UserProvider fallback={LogIn}>
          <MyApp />
        </UserProvider>
      </AppProvider>
    </View>
  );
};

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.

Recuperar una instancia del cliente de la aplicación

Todos los componentes envueltos dentro de un AppProvider pueden acceder al cliente de la aplicación con el useApp() gancho.

import React from 'react';
import {useApp} from '@realm/react';

function MyApp() {
  const app = useApp();
  // Proceed to app logic...
}

Recuperar la aplicación fuera del proveedor de la aplicación

Para recuperar una instancia del App Client desde cualquier lugar de su aplicación, cree una nueva instancia de Realm.App() desde el realm paquete y luego pase App ID su.

import Realm from 'realm';
const app = Realm.App.getApp("<Your App ID>");

Encriptar Metadatos de la aplicación

Puedes cifrar los metadatos que aplicación Services almacena en los dispositivos de los clientes. Utiliza los valores del enumerado MetadataMode para determinar el comportamiento de cifrado.

Para cifrar los metadatos de la aplicación:

1. Importar MetadataMode desde Realm e importar otras dependencias:

   import React from 'react';
   import {Text, View} from 'react-native';
   import {MetadataMode} from 'realm';
   import {AppProvider} from '@realm/react';

2. Cree un objeto de configuración de aplicación que contenga la propiedad metadata.

3. Establezca metadata.mode en MetadataMode.Encryption.

4. Configura metadata.encryptionKey como la clave que deseas usar para el cifrado.

5. Pase el objeto de configuración de la aplicación a new Realm.App().

const EncryptMetadata = ({
  encryptionKey,
}: {
  encryptionKey: ArrayBuffer;
}) => {
  const metadataConfig = {
    mode: MetadataMode.Encryption,
    encryptionKey: encryptionKey,
  };
  return (
    <AppProvider
      id={APP_ID}
      metadata={metadataConfig}>
      <RestOfApp />
    </AppProvider>
  );
};