React Native 上的 Realm Sync 离线优先：如何实现？

Question

我正在开发一个offline-first 应用，在 React Native 上使用 Realm Sync。

我要解决的具体编程问题是如何在我的应用程序中使用 React Native 实现这种离线优先的行为，以便登录用户无论是在线还是离线都能获得无缝体验。我正在寻找代码，以说明使用实现此功能的 Realm Sync 离线优先的最佳实践。

其他优秀的 Realm 文档在离线优先和 demo app in the MongoDB Realm documentation 实现同步时非常有限，但不是为离线而设计的。当然，我的出发点是那个应用程序，因为它是文档和论坛中推荐的应用程序。

我已经测试了 iOS Swift 和 React Native 'Task Tracker' 应用程序，但他们的工程师证实了这一点，他们目前没有离线优先功能。

来自该应用的TaskProvider.js 中的重要代码是：

useEffect(() => {
    const config = {
      sync: {
        user: user,
        partitionValue: projectPartition,
      },
    };
    // open a realm for this particular project
    Realm.open(config).then((projectRealm) => {
      realmRef.current = projectRealm;

      const syncTasks = projectRealm.objects("Task");
      let sortedTasks = syncTasks.sorted("name");
      setTasks([...sortedTasks]);
      sortedTasks.addListener(() => {
        setTasks([...sortedTasks]);
      });
    });

    // ...
  }, [user, projectPartition]);

由于我需要在自己的应用程序中使用这样的代码，第一个问题是如何更改此代码以正确执行离线优先使用。此外，如果您有一个离线优先的 Realm Sync 应用程序可以在 React Native 上工作，请提供链接或相关示例代码。

Answer 1

我提交了一个 PR，它使示例 Task Tracker App by MongoDB Realm Sync 更加离线。这不是一个完整的解决方案，但它解决了离线时无法访问任务列表的主要问题。

重要的一点是，要在后台同步更改 Realm 需要同步而不是异步打开。

TaskProvider.js 的新代码与下面链接的文档中的 cmets：

  useEffect(() => {
    // You may want to sync changes in the background to display partial data to
    // the user while the synced realm downloads data from the server,
    // preventing the user experience from being blocked. We recommend syncing
    // changes in the background for applications in which the user's device
    // may go offline.
    const OpenRealmBehaviorConfiguration = {
      type: 'openImmediately',
    };
    // Create a Configuration object, which must include the sync property
    // defining a SyncConfiguration object. Set this
    // OpenRealmBehaviorConfiguration object as the value for the
    // newRealmFileBehavior and existingRealmFileBehavior fields of
    // the SyncConfiguration.
    const config = {
      sync: {
        user: user,
        partitionValue: projectPartition,
        // The behavior to use when this is the first time opening a realm.
        newRealmFileBehavior: OpenRealmBehaviorConfiguration,
        // The behavior to use when a realm file already exists locally,
        // i.e. you have previously opened the realm.
        existingRealmFileBehavior: OpenRealmBehaviorConfiguration,
      },
    };

    // open a realm for this particular project
    Realm.open(config).then((projectRealm) => {
      realmRef.current = projectRealm;

      const syncTasks = projectRealm.objects('Task');
      let sortedTasks = syncTasks.sorted('name');
      setTasks([...sortedTasks]);
      sortedTasks.addListener(() => {
        setTasks([...sortedTasks]);
      });
    });

    //...
  }, [user, projectPartition]);

Sync Changes Between Devices - React Native SDK — MongoDB Realm

更多细节在这里：enable offline-first in TaskProvider, syncing changes in the background by agape-apps · Pull Request #9 · mongodb-university/realm-tutorial-react-native · GitHub

这仍然有 PR 中所述的重大限制。因此，我继续从那些使用 Realm Sync 和 React Native 的离线优先应用程序中寻找更完整的实现细节或代码示例。