对于 macOS,Realm Object Server 捆绑了一个名为 RealmTasks 的演示应用——这是了解 Realm Mobile Platform 的最快方式。(在生产环境中,你应该会想要在 Linux 或云托管服务商上安装 Realm Object Server。)
通过下载 Object Server 以及 demo app 开始:
下载 macOS bundle
启动 Realm Object Server
找到下载文件夹,打开 “realm-mobile-platform” 文件夹。
双击 start-object-server.command
以开启 Realm Object Server。这个文件会打开一个终端窗口,然后为你开启 Realm Object Server。
启动服务器后会自动开启 Realm Dashboard(如果没有,点击 http://localhost:9080/)。
输入 email 和密码以创建一个管理员用户。注册后,可以使用这些资格登录。
Realm Dashboard 会为你显示 Realm Object Server 的状态、当前活动并且可以让你管理用户。
运行 RealmTasks
RealmTasks 是一个用 Realm Mobile Platform 实现的简单任务管理 app,受到 Realmac Software 公司的 Clear 启发。可用于 iOS、macOS 和 Android,全部源代码可以在 GitHub 上查看。
打开 “realm-mobile-platform” 中的 “Demo” 文件夹,然后打开 “RealmTasks” 文件夹。启动里买呢 RealmTasks app;这是 macOS 版本。
App 启动后,可以登录一个已经存在的用户,或注册一个新用户。因为这是你第一次使用这个 app,点击 “Register” 然后输入用户名和密码。(随便输;这是一个本地 demo。)
登录后,app 就可以使用了!
如下尝试
- 点击 “+” 按钮以添加任务
- 左滑任务以删除
- 右滑任务以标注“完成”
- 点击、按住和拖动来重排任务
这些任务被添加到 app 中的本地 Realm 里面,同时与 Object Server 实时同步。
如果你之前运行过 RealmTasks 并且需要重置状态,关闭 app,然后运行这行命令:
rm -rf ~/Library/Containers/io.realm.realmtasks.macos
Realm Browser
为了管理服务器上的 Realm,Realm 包括一个 browser,可以实时浏览与交互。打开 “realm-mobile-platform” 中叫做 “Realm Browser” 的 macOS app。
此 app 会打开一个带有初始选项的面板。点击 “Connect to Object Server”。
在 “Connect to Object Server” 对话框里,server URL 输入
realm://127.0.0.1:9080
。为了以管理员连接,我们需要一个 admin access token。在运行服务器的终端里,找到以
Your admin access token is:
开头的那行。拷贝长长的 token key 字符串,包括最后的两个等于号(==)。这就是 Object Server 的 admin access token。一个新的对话框会打开,列出了服务器上所有的 Realm。如果你只注册了一个用户,就只有一个 Realm。选择一个以查看内容。
如果你还开着 RealmTasks app,现在可以尝试编辑和重排任务,同时观察 browser 中的变化。在 browser 里的改动也会立即反应到 app 中。
下一步?
现在你可以按照教程 从头开始构建类似于 RealmTasks 的 iOS app ,或直接进入 Realm Object Server 文档 ,以集成已使用 Realm Mobile Database 的 app。
如果你之前从没使用过 Realm Mobile Database,可能希望 从挑选平台开始以及检阅文档 。在那里,你会了解为什么我们的数据库如此与众不同,例如强大的活动对象、自动更新查询以及再也不必使用 ORM。