本文包含创建 BlueList Android 应用程序的一个演示、示例代码和完整指令。您可应用所学的知识来将 MobileData、CloudCode 和 Push 服务集成到自己的应用程序中。
Code">name: BlueMix 是一款 beta 级产品,随着我们不断让其功能更加完善和更易于使用,它也将不断改进。我们会竭尽全力保持本文最新,但并不总是完全跟得上现状。感谢大家的理解!
您可能已了解 Codename:BlueMix 的一些优势,这是 IBM 用于开发和部署移动和 Web 应用程序的开放平台。BlueMix 中许多预先构建的服务,使构建和增强应用程序变得很轻松。
在本文中,我们将使用 Push 服务扩展一个 Android 应用程序。 本系列的其他文章 介绍了如何向应用程序添加更多基于云的服务。
上一篇文章 已经介绍过,BlueList 应用程序是一个简单的 Android 应用程序。本文将向 BlueList 应用程序添加 Push 和 CloudCode 服务,以便在一个设备以某种方式更新一个列表时,该列表会在所有设备上更新。
在 上一篇文章 中,我们添加了 MobileData 服务,我们持久保存了一个列表中的各项。现在,我们将添加推送通知和 CloudCode,以便在更新列表时获得通知。如果未阅读本系列的上一篇文章,您可从 v1 代码着手,但需要执行 Catch up 任务,然后才能执行添加 Push 和 CloudCode 服务所需的步骤。如果已经阅读完上一篇文章,那么您现在可从现有的代码着手,执行以下步骤来添加 Push 和 CloudCode 服务。如果希望下载并直接使用 v2 代码,则需要执行一些步骤才能让包含 MobileData、Push 和 CloudCode 服务的 BlueList 应用程序正常工作。v2 代码包含本文中对 v1 代码所做的更改。
完成您的应用程序的前提条件
阅读 上一篇文章,我们在上一篇文章中向 Android 应用程序添加了 MobileData 服务。该应用程序是本文的起点。
熟悉 Android 开发。
一个 Android 开发环境。我们使用了带 ADT 的 Eclipse,但您也可以使用自己喜欢的开发环境。
熟悉用来从 JazzHub 下载 v1 和 CloudCode 的 git。
JazzHub 上的 v1 代码(单击上面的按钮)或上一篇文章中的现有代码。
JazzHub 上的 CloudCode 模块。下载此模块,它包含一个 package.zip、package.json 和 itemlist.js。
来自 Google 的一个 GCM Sender ID 和 API 密钥。在 Google 的操作说明 或 我们的操作说明 中了解如何获取此密钥。
备注:您需要一个 Gmail 帐户来执行此任务。
补充任务:如果您跳过了上一篇文章
从 JazzHub 下载 v1 代码,如果尚未下载该代码。
参见 上一篇文章 中的第 1 步.在 BlueMix 上创建 Mobile App Services 包。
执行第 1.1 - 1.10 步,但有一处例外:这次不要删除 configuration.json 文件中额外的行。
执行这些步骤,登录到 BlueMix 上并创建一个应用程序 (BlueList),下载 Android SDK,使用您的 API 密钥更新 configuration.json 文件,并向您的 libs 目录添加 ibmcore.jar 和 ibmdata.jar。
要在添加 Push 服务之前在模拟器中运行此代码来验证您的 Android 开发环境,现在正是时候。您应该能够执行上一篇文章中的第 7 步. 运行应用程序和第 8 步. 在云中查看数据。
如果应用程序成功运行,则说明您赶上了进度,可以添加 Push 和 CloudCode 服务了!
开始之前:获取您的 GCM Sender ID 和 Push 所需的 JAR 文件
获取您的项目编号和 GCM API 密钥
打开 Google Developers Console。
单击 CREATE PROJECT,输入一个项目名称,单击 Create。
从页面顶部复制项目编号。这是您的 GCM Sender Id (Google API Project Number),以后会需要该信息!
单击页面左侧的 APIs & auth。
打开 Google Cloud Messaging for Android。
在 APIs & auth 下,单击 Credentials。
单击 Public API access 部分下的 CREATE NEW KEY。
单击 Server key。
单击 Create。
从 Public API access 部分复制 API 密钥。这是您的 GCM Sender Auth Token (GCM API Key)。以后将需要此信息!
将 gcm.jar 添加到您的项目中
打开 Eclipse,选择 Window > Android SDK Manager。
选择窗口底部的 Show:Obsolete 复选框。
滚动到底部,选择 Google Cloud Messaging for Android Library。
单击 Install 1 Package 并接受许可。
在您的文件资源管理器中找到 <Android_SDK_Location>\extras\google\gcm\gcm-client\dist
将 gcm.jar 文件复制到您项目的 libs 目录中。
将 ibmcloudcode.jar 和 ibmpush.jar 添加到您项目中
找到您在 上一篇文章 中第 1.7 步中下载的 Android SDK。
将 ibmcloudcode.jar 和 ibmpush.jar 文件复制到您项目的 libs 目录中。现在 libs 库中应该包含以下 5 个 jar 文件:
第 1 步. 在 BlueMix 中将 GCM API Key 添加到您的应用程序中
登录到 BlueMix。
假设您已完成 上一篇文章 中的步骤或上面补充的任务步骤,在 DASHBOARD 视图中单击您的应用程序。
单击 Push 服务 Your_app_name:Push。
在 Push 服务的 Configuration 选项卡下,单击 Google Cloud Messaging 下的 EDIT。
填入您之前从 Google 获得的 GCM API Key 和 Google API Project Number,单击 SAVE。