配置同步 Realm — React Native SDK

AppProvider

@realm/react AppProvider允许您访问 App Services App 的实例。

要设置 App 客户端，请将 App ID 字符串传递给 AppProvider 的 id 属性。用 AppProvider 将所有需要访问 App 的组件括起来。

import React from 'react';
import {AppProvider} from '@realm/react';
function AppWrapper() {
  return (
    <View>
      <AppProvider id={APP_ID}>
        <MyApp />
      </AppProvider>
    </View>
  );
}

有关 AppProvider 的更多信息，请访问“连接到 Atlas App Services”页面。

UserProvider

UserProvider可让您访问 Realm 用户。应用程序需要UserProvider才能使用钩子。

首先，您需要使用AppProvider和UserProvider配置用户身份验证。 然后，使用 useApp() 和 useUser() 钩子进行身份验证。

要设置用户身份验证，请执行以下操作：

1. 将您想要与 App Services 一起使用的所有组件封装在 AppProvider 中。

2. 在 AppProvider 内部，使用 UserProvider 包装需要经过身份验证的用户有权访问的所有组件。

3. 在 UserProvider 中，在另一个用于用户登录的组件中加入 fallback 属性。如果没有经过身份验证的用户，该应用则会显示此组件。

4. 在传递给UserProvider.fallback属性的组件中，使用Realm.App.logIn()对用户进行身份验证，您可以使用useApp()钩子访问该用户。

仅当您的应用程序具有经过身份验证的用户时，UserProvider 封装的组件才会渲染。这些组件可以通过 useUser() 钩子访问已经过身份验证的用户。

import React from 'react';
import {useApp, UserProvider, AppProvider} from '@realm/react';
import {Button} from 'react-native';
function AppWrapper() {
  return (
    <AppProvider id={APP_ID}>
      {/* If there is no authenticated user,
          the app mounts the `fallback` component.
          Once the user successfully authenticates,
          the app unmounts the component in the
          `UserProvider.fallback` prop
          (the `LogIn` component in this example). */}
      <UserProvider fallback={LogIn}>
        {/* Components with access to the user.
            These components only mount
            if there's an authenticated user.*/}
        <RestOfApp />
      </UserProvider>
    </AppProvider>
  );
}
function LogIn() {
  const app = useApp();
  // This example uses anonymous authentication.
  // However, you can use any authentication provider
  // to log a user in with this pattern.
  async function logInUser() {
    await app.logIn(Realm.Credentials.anonymous());
  }
  return (
    <Button
      title='Log In'
      onPress={logInUser}
    />
  );
}

您可以在用户身份验证页面找到有关 UserProvider 的详情。

RealmProvider

RealmProvider是一个向其子组件公开 Realm 的包装器。您可以通过将属性传递给RealmProvider来配置 Realm。

呈现RealmProvider时，会打开 Realm。这意味着如果呈现失败，子组件将无法访问 Realm。

要配置一个同步 Realm，请执行以下操作：

1. 从@realm/react导入提供商。

2. 配置 AppProvider。

3. 配置 UserProvider 并将其嵌套在 AppProvider 中。

4. 将对象模型传递给 RealmProvider 的 schema 属性。

5. 创建FlexibleSyncConfiguration对象。

6. 将 SyncConfiguration 对象传递给 sync 属性，或在行内添加对象。

7. 在 RealmProvider 子组件中设置初始订阅或创建新订阅。

8. 将其他配置对象属性作为属性添加到RealmProvider以进一步配置您的 Realm。

import React from 'react';
import {AppProvider, UserProvider, RealmProvider} from '@realm/react';
function AppWrapperSync() {
  return (
    <AppProvider id={APP_ID}>
      <UserProvider fallback={LogIn}>
        <RealmProvider
          schema={[YourObjectModel]}
          sync={{
            flexible: true,
            initialSubscriptions: {
              update(subs, realm) {
                subs.add(realm.objects(YourObjectModel));
              },
            },
          }}>
          <RestOfApp />
        </RealmProvider>
      </UserProvider>
    </AppProvider>
  );
}

有关配置和使用 RealmProvider 的更多信息，请查看配置 Realm 页面。

打开特定路径上的同步 Realm

使用AppConfiguration.baseFilePath和Realm.BaseConfiguration.path ，您可以控制 Realm 和元数据文件在客户端设备上的存储位置。

为此，请设置AppProvider.baseFilePath 。如果未设置baseFilePath ，则使用当前工作目录。您还可以设置RealmProvider.sync.path以进行更多控制。

如果设置了baseFilePath ，则元数据始终存储在<baseFilePath>/mongodb-realm/中。 如果未设置baseFilePath ，则元数据存储在<Realm.defaultPath>/mongodb-realm中。

Realm 文件的确切存储位置可能会有所不同，具体取决于您设置Realm.BaseConfiguration.path 的方式：

• Realm.Configuration.path 未设置，baseFilePath 已设置。您的 Realm 文件存储在 baseFilePath。

• Realm.Configuation.path 设置为相对路径。您的 Realm 文件的存储路径是相对于 baseFilePath 而言的。

• Realm.Configuration.path 是绝对路径。您的 Realm 文件存储在 Realm.Configuration.path 中。

通过后台同步立即访问

您可能希望在后台同步变更，以便在同步 Realm 从服务器下载数据时向用户显示部分数据，防止用户体验受限。对于用户设备可能离线的应用程序，我们建议在后台同步变更。要在后台同步变更，请同步打开同步 Realm。

后台同步超时后访问

如果您想要同步数据，但所处环境不确定用户是否有 Internet 连接，请指定timeOut 。 当出现以下任一情况时，此功能会自动打开 Realm：

• 超时时间已过。

• Realm 已完全下载。

如果 Realm 在超时之前未完成下载，则将在后台继续进行初始同步。