适用于 Flutter 的 Atlas Device SDK

开始使用 Flutter SDK

快速入门

关于如何使用 Flutter SDK 的简短解释代码示例。

查看代码示例

有效示例应用

剖析使用 Flutter SDK 的有效应用，从示例中学习。

探索示例应用

导引式教程

通过导引式教程，学习如何调整示例应用以创建自己的可运行的应用程序。

按照教程执行

使用 SDK 开发应用程序

使用 SDK 的开源数据库 Realm 作为设备上的对象存储。使用 Device Sync 使数据与 MongoDB Atlas 集群以及其他客户端保持同步。

使用 SDK 存储数据

跨设备同步数据

使用 Atlas App Services 进行构建

1

安装 Flutter SDK

要开始使用，请安装 Flutter SDK。然后，将 SDK 导入项目文件中。

2

定义对象模式

使用 Dart 以惯用方式定义对象模式。

3

配置和打开数据库

可以将数据库配置为执行加载时填充初始数据、使用加密密钥保护数据等操作。要开始处理数据，请配置并打开一个数据库。

4

读取和写入数据

可以在设备上创建、读取、更新和删除数据库中的对象。构建复杂的查询来过滤数据。

5

响应变更

活动对象意味着数据始终是最新的。注册变更监听器以对更改做出反应并执行更新用户界面等逻辑。

1

配置 Atlas Device Sync

在 App Services App 中配置 Device Sync 。 定义数据访问规则或使用开发模式从客户端的数据模型推断模式。

2

连接到 Atlas App Services App

要在 Flutter 应用中将 App Services App 与 Device Sync 结合使用，请连接到后端应用。

3

验证用户身份

通过 App Services 可以使用自定义 JWT 身份验证、我们的内置电子邮件/密码提供程序、匿名身份验证以及 Apple、Google、Facebook 等流行的身份验证提供程序。使用这些提供程序在客户端中对用户进行身份验证。

4

打开同步数据库

要开始同步数据，请 打开一个已同步数据库。要确定已同步数据库可以读写哪些数据，请订阅查询。

5

读取和写入同步数据

无论您使用同步数据库还是非同步数据库，读取和写入数据的 API 都相同。您读取和写入的数据会自动与您的 Atlas 集群和其他客户端保持同步。应用程序保持离线工作，并且只要网络连接可用，就会同步更改。

调用无服务器函数

您可以从客户端应用程序调用在 App Services 后端运行的无服务器 Atlas Function。

验证用户身份

使用内置和第三方身份验证提供程序对用户进行身份验证。使用经过身份验证的用户访问 App Services。

推荐阅读

Flutter API 参考文档

在 pub.dev 网站上查阅 SDK 的 Dart 和 Flutter 参考文档。

Flutter API 参考文档

安装 SDK

了解如何将 SDK 添加到您的 Flutter 项目。

将 SDK 添加到 Flutter 项目

Dart 独立 SDK

除了将 SDK 与 Flutter 结合使用之外，还可以将 SDK 与仅使用 Dart 的项目结合使用，例如 CLI 应用程序或 Web 服务器。

将 SDK 和 Dart 结合使用与 Flutter SDK 相同，除了您必须安装并设置一个单独的包。

了解如何在 Dart 项目中设置 SDK。

示例项目

探索工程和专家团队提供的示例项目，了解使用 Flutter SDK 的最佳实践和常见开发模式。查看示例项目页面，了解更多 Flutter 示例应用。

离线登录和数据库访问

登录 Device Sync 用户并离线打开已同步数据库。

示例项目

用户的在线状态

检测用户和设备的连接与活动。

示例项目

Provider Shopper

构建一个经修改过的 Flutter 示例应用，使用非同步数据库在设备上存储数据。

示例项目