Atlas App Services アプリへの接続 - React Native SDK

始める前に

1. App Services アプリの作成

2. アプリ ID の取得

アプリ クライアントの構成

アプリクライアントを設定するには、アプリ ID string をAppProviderの idプロンプトに渡します。 アプリにアクセスするために必要なコンポーネントを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>
  );
};

複数のアプリに接続するには、複数のアプリクライアントインスタンスを作成します。 同じアプリ ID を共有するすべてのアプリクライアント インスタンスは、同じ基礎の接続を使用します。

アプリ クライアントのインスタンスの取得

AppProviderでラップされたすべてのコンポーネントは、 useApp()フックを使用してアプリクライアントにアクセスできます。

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

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

アプリ プロバイダー外でアプリを取得する

アプリケーション内のどこからでもアプリクライアントのインスタンスを取得するには、 realmパッケージからRealm.App()の新しいインスタンスをインスタンス化し、 App IDを渡します。

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

アプリ メタデータの暗号化

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

特定のサーバーへの接続

デフォルトでは、Atlas Device SDK はhttps://services.cloud.mongodb.comのグローバルbaseURLを使用して Atlas に接続します。 場合によっては、別のサーバーに接続する必要があるかもしれません。

• App Services Appはローカル配置を使用しており、リージョン内のローカル baseURL に直接接続する場合があります。

AppProviderのプロパティとしてbaseURLを指定できます。 すべてのAppConfigurationキーは、プロパティとしてAppProviderに渡すことができます。