连接 Atlas App Services APP - React Native SDK

开始之前

1. 创建 App Services App

2. 获取应用程序 ID

配置应用程序客户端

要设置 App 客户端，请将应用程序 ID 字符串传递给id 的AppProvider 属性。使用AppProvider封装需要访问应用的任何组件。 在此示例中，我们将UserProvider包装在AppProvider中以对用户进行身份验证。

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>
  );
};

您可以创建多个应用客户端实例以连接多个应用。 股票相同 App ID的所有 App客户端实例使用相同的根本的连接。

检索应用程序客户端的实例

包装在AppProvider中的所有组件都可以使用useApp()钩子访问权限应用程序客户端。

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

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

检索应用程序提供商外部的应用程序

要从应用程序中的任何位置检索 App Client 实例，请从realm包中实例化Realm.App()的新实例，然后传入App ID 。

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

加密应用元数据

您可以对Atlas App Services在客户端设备上存储的元数据进行加密。 使用MetadataMode 枚举的值来确定加密行为。

要加密应用元数据，请执行以下操作：

1. 从Realm导入MetadataMode并导入其他依赖项：

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

2. 创建包含metadata属性的应用配置对象。

3. 将 metadata.mode 设置为 MetadataMode.Encryption。

4. 将metadata.encryptionKey设置为要用于加密的密钥。

5. 将应用配置对象传递给new Realm.App() 。

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

连接到特定MongoDB Server

默认情况下，Atlas Device SDK 使用https://services.cloud.mongodb.com的全局baseURL连接到 Atlas。 在某些情况下，您可能想要连接到不同的服务器：

• 您的 App Services App 使用本地部署，并且您希望直接连接到您所在区域的本地baseURL 。

您可以指定baseURL作为AppProvider的属性。 所有AppConfiguration键都可以作为属性传递给AppProvider 。