Docs 菜单

适用于 Kotlin 的 Atlas Device SDK

使用适用于 Kotlin 的 Atlas Device SDK,通过 Android 平台或 Kotlin Multiplatform (KMP) 来开发 Android 或 iOS 应用。

学习路径
功能图标

快速入门

关于如何使用 SDK 的最简单易懂的代码示例。写入设备数据库,并与其他设备同步。

查看代码示例

Atlas Device SDK 移动图标

有效示例应用

剖析使用 Kotlin SDK 的有效 Kotlin 客户端应用,从示例中学习。

探索示例应用

教程图标

导引式教程

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

按照教程执行

您能做什么

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

1

选择是安装 Kotlin SDK 的 Android 版本还是 Kotlin Multiplatform 版本。

在 Gradle 文件中导入 SDK,以开始使用。

2

使用 Kotlin 以惯用方式定义对象模式

3

SDK 的数据库 Realm 将对象存储在设备上的文件中。或者,您也可以打开不创建文件的内存中数据库。配置并打开数据库,以开始读取和写入数据。

4

创建读取更新删除数据库中的对象。使用 Realm 查询语言过滤数据

5

实时对象意味着数据始终是最新的。您可以注册通知处理程序来监视变化并执行一些逻辑,例如更新用户界面。

Atlas Device SDK移动插图
1

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

然后,从客户端连接到后端

2

使用我们的身份验证提供者之一对用户进行身份验证。 App Services提供对流行身份验证提供商的访问权限,例如 Apple、Google 或Facebook。 使用我们内置的电子邮件/密码提供商在没有第三方的情况下管理用户,或使用自定义JSON web token身份验证与其他身份验证提供程序集成。 匿名身份验证提供访问权限,无需登录或保留用户数据。

3

配置并打开同步数据库订阅查询以确定同步数据库可以读取和写入哪些数据。

4

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

Device Sync插图

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

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

App Services插图
基本文档
Atlas Device SDK 图标

Kotlin API 参考文档

探索为 SDK 的 Kotlin API 生成的参考 docs。

Kotlin API 参考文档

迁移图标

从 Java SDK 迁移到 Kotlin SDK

了解为什么以及如何从 Java SDK 迁移到 Kotlin SDK。

从 Java SDK 迁移到 Kotlin SDK

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

Atlas Device SDK 离线图标

离线登录和数据库访问

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

示例项目

用户图标

用户的在线状态

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

示例项目

云移动传输图标

连接状态变更和错误处理

了解关于处理同步错误和客户端重置策略的最佳实践。

示例项目