Kii BLOG

为 PhoneGap App 添加一个即时后端

 

标题

 

在使用 PhoneGap 创建 HTML、CSS、 JavaScript 的 App?借助 Kii Javascript SDK 可为项目添加一个即时后端。由于 PhoneGap 的逻辑通常都由 Javascript 编写的和允许添加插件和库,所以借助云端的可靠性和灵活性可以十分容易地完成架构的扩展。

自定义工目演示

本教程由 Christophe Coenraets 出品 – 员工目录 App 作演示。我们加入 Kii Javascript SDK 和  Kii Data Adapter(关于 Adapter 的详细信息,请查阅这里),令数据存储到云端。在演示中,将学习如何使用不同的数据存储。

在原有的目中,可以切

  • In-Memory Adapter
  • LocalStorage Adapter
  • WebSQL Adapter
  • JSONP Adapter

每个 Adapter 提供初始化和通过名称、ID 搜索的 API。我们将编写一个新的 Kii Adapter,使所有的数据存储在云端上完成。

初始

1. 安装 PhoneGap

2. 按照快速入门指南的描述,在 developer.kii.com 创建一个 App;

3. 选择 Javascript作为您的平台、记下分配给您App 的 ID 和 Key,及将服务器位置选在美国;

4. 使用 Git Clone(或 Fork)演示,并在 kii-adapter.js 中替换 App ID 和 App Key。Kii js SDK 已经放在 www/lib 目录中或你可以从这里抓取它用于其他项目。

准备工作已完成,現在可以尝试运行演示了。例如,使用Android 手机执行:

phonegap local run android

你可以通过 logcat 查看 Kii 相关的调试信息。(打开支持 Android 的 Eclipse,然后打开 logcat)

演示的内容

演示运行后,你可以看到一个搜索框,用作查找员工资料的(使用 FindByName,详见下文)。当点击一个员工姓名时,可以看到他或她的联系资料(使用的是 FindById,详见下文)。

标题2

 

初始化

这些数据Adapter 提供3种方法:初始化、findByName 和 findById。我们捎带上App ID 和 Key 完成 Kii 的初始化:

标题3

请注意:为简单起见,我们使用固定的用户名和密码。你可能需要修改这个演示并提供一个欢迎屏幕允许用户登录/注册。注册过程非常简单:

标题4

登录过程也十分简单:

标题5

如果后端没有储存,我们还将在 Cloud 上创建他们:

标题6

 

FindByName

该方法将从姓氏和名称的头部开始匹配关键字,并显示前10个结果:

标题7借助 Kii 查询,你可以嵌套和过滤查询条件。

FindById

该方法使用员工 ID 作为参数进行匹配。无需考虑其他的联系方式:

标题8

 

该方法将检索指定联系人的所有信息。

如你所见,在 Phonegap 或 Titanium 项目中集成 Kii 的 Javascript SDK 是十分简便的。需要注意的是,从 Kii SDK 2.1.12 版开始,jQuery 不再是必选项(现在是可选项)和 SDK 会智能的按照如下优先权自动切换 XMLHttpClient:

  1. 如果定义了 jQuery,SDK 将使用 jQuery ajax。
  2. 如果定义了 XMLHttpRequest,SDK 将使用 XMLHttpRequest。
  3. 如果定义了 Titanium(在 Titanium 中使用 KiiSDK),SDK 将使用 Titanium.Network.HTTPClient。

我们很高兴能在这个演示中使用 Christophe 出品和更新的项目为大家讲解 Kii Javascript SDKKii Data Adapter。为了方便起见,你还可以在 GitHub 上找到包含 Adapter 的项目。

祝编码愉快!

发表评论