四十六、PhoneGap
PhoneGap 可能是 Android 最初的替代应用框架,于 2009 年初出现。PhoneGap ( [www.phonegap.com/](http://www.phonegap.com/)
)是开源的,由 Nitobi 支持,Nitobi 传统上提供开源和商业产品的混合,以及咨询和培训服务。截至 2011 年 10 月,Nitobi 已同意被 Adobe 收购。为了确保 PhoneGap 代码的持久性,Nitobi 将 PhoneGap 代码库提交给了 Apache 软件基金会,该项目现在被命名为 Apache Callback。大多数人仍然知道这个项目的原始名称,许多文档仍然提到 PhoneGap,所以我们将坚持使用传统的名称。
什么是 PhoneGap?
PhoneGap 是一个围绕 HTML5 构建的平台,使您能够从一个代码库开发应用,并将它们部署到多个平台。使用 PhoneGap 只需遵循以下步骤:
- 使用 HTML5 和 JavaScript 等 web 标准语言构建您的应用。
- 用 PhoneGap 包装您的应用,以获得对本机 API 的访问。
- 将您的应用部署到多个平台。
在[www.phonegap.com/about](http://www.phonegap.com/about)
阅读更多关于 PhoneGap 及其工作原理的信息。
你在写什么?
PhoneGap 应用由 HTML、CSS 和 JavaScript 组成,与移动网站或 HTML5 应用没有什么不同,只是在 PhoneGap 中,web 素材与应用打包在一起,而不是即时下载。
因此,预装的 PhoneGap 应用可能包含相对较大的素材,如复杂的 JavaScript 库,可能太慢而无法通过较慢的 EDGE 连接下载。然而,PhoneGap 仍然受到移动设备速度以及 WebKit 浏览器加载和处理这些素材的速度的限制。
此外,WebKit for mobile 的开发不同于 WebKit for desktops 的开发,特别是在触摸和鼠标事件方面。在可行的情况下,您可能希望使用 JavaScript 框架的移动层进行开发(例如,jQTouch 与普通 jQuery)。
你有什么特点?
与 HTML5 应用一样,PhoneGap 为您提供了 web 浏览器的基本功能,包括 AJAX 支持。除此之外,PhoneGap 还增加了许多 JavaScript APIs,让你可以了解 Android 平台的底层特性。在撰写本文时,包括以下内容:
- 加速度计接入,用于检测设备的移动
- 录音
- 相机接入,用于拍摄静态照片
- 指南针访问,用于定向活动
- 联系人访问,用于使用内置联系人提供程序
- 数据库访问,既可以访问您创建的数据库(SQLite),也可以访问 Android 内置的其他数据库(例如,联系人)
- 文件系统访问,例如对 SD 卡或其他外部存储器的访问
- 地理定位,用于确定设备的位置
- 通知服务,包括警报和声音效果
- 存储,设备上和 SD 卡
- 振动,用于摇动电话(例如,力反馈)
因为其中一些是 HTML5 规范的一部分(例如,地理定位),所以您可以选择 API。此外,这个列表会随着时间的推移而变化,但你会看到前面的列表是大多数当代 Android 设备上的本机功能的一个非常全面的列表。
app 是什么样子的?
PhoneGap 应用看起来像网页,比原生 Android 应用更像,如图图 46–1所示,这是 PhoneGap 附带的示例应用的截图。您可以使用 CSS 和图像在某种程度上模仿 Android 的外观和感觉,但仅限于那些可以在 Android 和 HTML 中创建的小部件。例如,Android Spinner
小部件,类似于一个下拉列表,可能很难在 HTML 中模仿。
图 46–1。PhoneGap 附带的示例应用
分销是如何运作的?
分发 PhoneGap 应用与分发任何其他标准 Android 应用非常相似,只是有一些额外的选项。使用独立的 PhoneGap,在测试之后,您使用 Android 构建工具从 PhoneGap 为您生成的 Android 项目中创建一个标准的 APK 文件。这个项目将包含 Java、XML 和其他必要的部分,来包装 HTML、CSS 和 JavaScript,以构成您的应用。然后,您对应用进行数字签名,并将其上传到 Android Market 或您希望使用的任何其他分发机制。Nitobi 还提供了一个托管构建服务,叫做 PhoneGap Build,我们将在本章稍后讨论。
其他平台呢?
PhoneGap 不只是针对 Android。你可以为 iPhone,Blackberry,Symbian,微软 Windows Phone,Samsung Bada 和 Palm 的 WebOS 创建 PhoneGap 应用。至少在理论上,您可以使用 HTML、CSS、JavaScript 和 PhoneGap JavaScript APIs 创建一个应用,并让它在许多设备上运行。
有几个限制会阻碍你实现这个目标:
- PhoneGap 在所有这些平台上使用的网络浏览组件并不相同。根据 WebKit 集成到给定设备的固件中时可用的版本,即使使用 WebKit 的多个平台也会有不同的 WebKit 版本。因此,您需要进行测试,以确保您的 CSS 能够在尽可能多的设备上正常运行。
- 由于各种因素,并非所有 PhoneGap JavaScript APIs 都可以在所有设备上使用(例如,没有在平台的本机 API 中公开,缺乏将功能提升到 PhoneGap APIs 中的工程时间,等等)。).PhoneGap wiki 可以让你知道在不同的设备上什么有效,什么无效。您将希望限制您的功能使用以匹配您想要的平台,或者限制您的平台以匹配您想要的功能。
使用 PhoneGap
现在,让我们来看看使用 PhoneGap 的更多技巧。在撰写本文时,PhoneGap 的安装和使用通常需要一名基于 Java 的 Android 开发专家。您需要安装一整套工具,手动编辑配置文件,等等。如果您想做到所有这些,PhoneGap 网站上提供了文档,我们将在下面简单介绍一下。如果你正在读这一章,你很有可能会跳过所有这些。同样,您可以使用 PhoneGap 构建服务([http://build.phonegap.com/](http://build.phonegap.com/)
),我们将很快介绍它。
安装
您可以从 PhoneGap 网站下载最新的 PhoneGap 工具,作为一个 ZIP 存档,它可以重定向到 Apache Software Foundation 的 Apache Callback incubator 存储库。只要对您的开发机器和平台有意义,就将这些工具解包。对于 Android 开发,这就是你需要的所有 PhoneGap 特有的安装。但是,您将需要 Android SDK 和相关工具(例如,如果您希望使用 Eclipse,可以使用 Eclipse)来设置项目。
创建并安装您的项目
PhoneGap Android 项目本质上是一个常规的 Android 项目,您可以按照本书前面概述的说明来创建它。要将标准生成的“Hello,World”应用转换为 PhoneGap 项目,您需要执行以下操作:
- 从解压 PhoneGap ZIP 文件的位置的
Android/
目录,将 PhoneGap JAR 文件复制到项目的libs/
目录。如果您正在使用 Eclipse,您还需要将它添加到您的构建路径中。 - 在您的项目中创建一个
assets/www/
目录。然后,从您解压 PhoneGap ZIP 文件的位置的Android/
目录中复制 PhoneGap JS 文件。 - 将标准的“Hello,World”活动调整为继承自
DroidGap
而不是Activity
。这就需要你导入com.phonegap.DroidGap
。 - 在活动的
onCreate()
方法中,用super.loadUrl("file:///android_asset/www/index.html");
替换setContentView()
。 - 在您的清单中,添加 PhoneGap 请求的所有权限,这些权限将在本章后面列出。
- 同样在您的清单中,根据您想要测试和支持的屏幕尺寸添加一个合适的
<supports-screens>
元素。 - 同样在您的清单中,将
android:configChanges="orientation|keyboardHidden"
添加到您的<activity>
元素中,因为DroidGap
处理与方向相关的配置更改。
此时,您可以在项目中创建一个assets/www/index.html
文件,并开始使用 HTML、CSS 和 JavaScript 创建 PhoneGap 应用。您需要包含对 PhoneGap JavaScript 文件的引用(例如,<script type="text/javascript" charset="utf-8" src="phonegap.1.2.0.js" />
)。当您想要测试应用时,您可以像任何其他 Android 应用一样构建和安装它(例如,如果您使用命令行构建过程,可以使用ant clean install
)。
对于有 Android SDK 开发经验的人来说,设置这个并不是一个很大的挑战。
PhoneGap 构建
PhoneGap Build 是一种工具即服务(TaaS)托管的创建 PhoneGap 项目的方法。所有 Android 构建过程都由 PhoneGap 提供的服务器为您处理。您只需专注于创建您认为合适的 HTML、CSS 和 JavaScript。
当您登录 PhoneGap Build 时,首先会提示您创建您的初始项目,提供名称和 web 素材以进入应用,如Figure 46–2所示。
图 46–2。 在 PhoneGap Build 中创建您的第一个项目
你以后可以通过一个新的应用按钮添加新的项目,这给了你同样的选项。
您提供素材的选择是上传一个包含所有素材的 ZIP 文件,或者指定一个公共 GitHub 存储库的 URL,PhoneGap Build 可以从这个存储库中提取素材。如果您习惯于使用 Git 进行版本控制,并且您的项目是开源的(因此有一个公共存储库),后一种方法会更方便。
点击上传按钮后,PhoneGap Build server 立即开始为 Android、Blackberry、Symbian 和其他支持的平台或您选择的平台构建您的应用,如图Figure 46–3所示。
图 46–3。 在 PhoneGap Build 中构建您的第一个项目
每个目标都有自己的文件扩展名(例如,Android 的apk
)。单击该链接将允许您下载该文件。或者,点击项目名称,您将获得快速响应(QR)代码,以便直接下载到您的测试设备,如图Figure 46–4所示。
图 46–4。 你项目的二维码在 PhoneGap 建立
该页面还提供了从 GitHub 资源库更新应用的链接(如果您选择了该选项)。或者,您可以点击编辑来指定更多选项,如您的应用版本或其启动器图标,如图Figure 46–5所示。
图 46–5。 您的项目在 PhoneGap Build 中的设置
总而言之,如果您的开发机器上不需要 Android SDK 和相关工具,PhoneGap Build 无疑简化了 PhoneGap 构建过程。
Nitobi 推出了 PhoneGap Build,作为面向非开源应用的商业服务,价格可从 PhoneGap Build 网站获得。
PhoneGap 和清单示例
PhoneGap 的美妙之处在于它包装了 HTML、CSS 和 JavaScript。换句话说,你不需要做太多 PhoneGap 特有的事情,就可以利用 PhoneGap 为你提供一个适合安装在 Android 设备上的 APK。也就是说,PhoneGap 确实向您展示了比您从标准中获得的更多的东西,如果您需要它们并且愿意为它们使用专有的 PhoneGap APIs 的话。
坚持标准
给定一个现有的 HTML5 应用,要使它成为一个可安装的 APK,您需要做的就是将它包装在 PhoneGap 中。例如,要将 HTML5 版本的Checklist
(来自第 45 章)转换成一个 APK 文件,你需要做以下事情:
- 按照本章前面概述的步骤创建一个空的 PhoneGap 项目。
- 将 HTML5 项目中的 HTML、CSS、JavaScript 和图像复制到 PhoneGap 项目的
assets/www/
目录中(注意,您不需要 HTML5 特有的任何东西,比如缓存清单)。 - 确保您的 HTML 入口点文件名与您在活动中使用的
loadUrl()
调用的路径相匹配(例如,index.html
)。 - 从 HTML 中添加对 PhoneGap JavaScript 文件的引用。
- 构建并安装项目。
这是我们应用的DroidGap
活动,来自PhoneGap/Checklist
项目:
`package com.commonsware.pg.checklist;
import android.app.Activity; import android.os.Bundle; import com.phonegap.DroidGap;
public class Checklist extends DroidGap { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); super.loadUrl("file:///android_asset/www/index.html"); } }`
下面是清单,添加了 PhoneGap 要求的所有设置:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.commonsware.pg.checklist"
android:versionCode="1"
android:versionName="1.0">
<application android:label="@string/app_name" android:icon="@drawable/cw">
<activity android:name="Checklist"
android:configChanges="orientation|keyboardHidden"
android:label="@string/app_name">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
<supports-screens
android:largeScreens="true"
android:normalScreens="true"
android:smallScreens="true"
android:resizeable="true"
android:anyDensity="true"
/>
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
</manifest>
这里是 HTML,它几乎与 HTML5 的原始版本相同,但删除了一些 HTML5 离线内容(例如,iPhone 图标),并添加了对 PhoneGap 的 JavaScript 文件的引用:
`<!DOCTYPE html>
Checklist MailChecklist
AddTotal: 0 Remaining: 0
- Loading…
`
对于许多应用,这就是你所需要的。你只是简单地看着 PhoneGap 给你一些你可以在 Android Market、iOS 应用商店等等上分发的东西。
添加 PhoneGap APIs
如果您想利用更多的设备功能,您可以扩充您的 HTML5 应用来使用 PhoneGap 特定的 API。这些功能涵盖了从告诉你设备的型号到让你获得指南针读数的所有范围。因此,它们的复杂性会有所不同。为了本章的目的,我们将看一些更简单的。
设置设备就绪事件处理程序
由于各种原因,当您的页面被加载时,PhoneGap 不会立即响应它的所有 API。相反,您需要寻找一个deviceready
事件来确认使用 PhoneGap 特定的 JavaScript 全局变量是安全的。以下是典型的食谱:
- 向您的
<body>
标签添加一个onload
属性,引用一个全局 JavaScript 函数(例如,onLoad()
)。 - 在
onLoad()
中,使用addEventListener()
为deviceready
事件注册另一个全局 JavaScript 函数(如onDeviceReady()
)。 - 在
onDeviceReady()
中,开始使用 PhoneGap APIs。
使用 PhoneGap 提供的功能
PhoneGap 通过一系列虚拟 JavaScript 对象为您提供了许多方法。这里,“虚拟”意味着您不能检查对象是否存在,但是您可以调用方法并读取它们的属性。例如,有一个device
对象有一些有用的属性,比如phonegap
返回 PhoneGap 版本,而version
返回 OS 版本。这些虚拟对象准备好在deviceready
事件中或之后使用。
例如,下面是一个 JavaScript 文件(PhoneGap/ChecklistEx
项目中的props.js
),它实现了一个onLoad()
函数(为deviceready
注册)和一个onDeviceReady()
函数(使用device
对象的属性):
`// PhoneGap's APIs are not immediately ready, so set up an // event handler to find out when they are ready
function onLoad() { document.addEventListener("deviceready", onDeviceReady, false); }
// Now PhoneGap's APIs are ready
function onDeviceReady() { var element=document.getElementById('props');
element.innerHTML='
onDeviceReady()
函数需要一个id
为props
的列表元素。这再加上首先加载这个 JavaScript,将需要对我们的 HTML 进行一些小的修改:
`<!DOCTYPE html>
Checklist MailChecklist
AddTotal: 0 Remaining: 0
- Loading…
Device Properties
`
Figure 46–6显示了最终的应用。
图 46–6。 带有设备属性的 PhoneGap 清单应用
显然,读取一些属性远比用设备的摄像头拍照简单。然而,复杂性的差异主要在于 PhoneGap 的虚拟 JavaScript 对象给了你什么以及你如何使用它们,这比 Android 特有的任何东西都要多。
你可能遇到的问题
PhoneGap 是创建跨平台应用的绝佳选择。然而,它也不是没有问题。其中一些问题可能会及时得到解决;有些可能是 PhoneGap 特有的性质。
安全
Android 应用使用权限系统来请求访问某些系统功能,例如提出互联网请求或读取用户的联系人。应用必须在安装时请求这些权限,因此如果请求的权限可疑,用户可以选择放弃安装。
一般的经验法则是,您应该请求尽可能少的权限,并确保您可以证明您为什么请求它们。
PhoneGap,对于一个新项目,请求相当多的权限:
CAMERA
VIBRATE
ACCESS_COARSE_LOCATION
ACCESS_FINE_LOCATION
ACCESS_LOCATION_EXTRA_COMMANDS
READ_PHONE_STATE
INTERNET
RECEIVE_SMS
RECORD_AUDIO
MODIFY_AUDIO_SETTINGS
READ_CONTACTS
WRITE_CONTACTS
WRITE_EXTERNAL_STORAGE
ACCESS_NETWORK_STATE
保持这个花名册不变将使您的应用可以使用 PhoneGap 为您的 JavaScript 提供的所有 API...和一个会吓跑很多用户的应用。毕竟,您的应用不太可能能够使用所有这些权限,更不用说证明这些权限的合理性了。
您当然可以通过修改 PhoneGap 项目根目录下的AndroidManifest.xml
文件来缩减这个列表。然而,您将需要彻底测试您的应用,以确保您没有放弃您实际需要的权限。此外,您可能不清楚可以安全删除哪些权限。
最终,PhoneGap 项目可能会有工具来帮助指导您选择权限,也许是通过静态分析您的 JavaScript 代码来查看您正在使用哪些 PhoneGap APIs。不过,与此同时,获得适当的权限集将涉及大量的尝试和错误。
屏幕尺寸和密度
普通的 web 应用主要关注屏幕分辨率和窗口大小作为它们的主要变量。移动网络应用不必担心窗口大小,因为浏览器和应用通常全屏运行。但是,移动 web 应用需要处理物理大小和密度——这些问题与传统 web 开发无关。
上网本的屏幕可以是 10 英寸或更小,而台式机的屏幕可以是 24 英寸或更大。因此,物理屏幕尺寸似乎是 web 开发人员需要解决的问题。然而,在上网本/笔记本/台式机领域,屏幕分辨率(以像素为单位)通常与物理尺寸相符。这是因为 LCD 的屏幕密度相当一致,而且密度相当低。
另一方面,智能手机有几种不同的密度,导致分辨率和尺寸之间的联系被打破。一些低端手机,尤其是小尺寸(例如 3 英寸)的 LCD,其密度与漂亮的显示器相当。中档手机的密度是普通手机的两倍(240 dpi 对 120 dpi)。苹果的 iPhone 4 密度更高,很可能很快也会有一些配备所谓视网膜显示屏的 Android 设备。因此,例如,800×480 的分辨率可以在 4 英寸到 7 英寸的屏幕上显示。平板电脑增加了更多可能的尺寸。
触摸屏带来的问题更是雪上加霜。鼠标点击可以获得像素级的精度。手指就没那么精确了。因此,你可能需要在触摸屏上把你的按钮和类似的东西做得大一点,这样才方便手指操作。这导致了素材缩放的一些问题,尤其是图像。在低密度 3 英寸设备上可能对手指友好的东西对于高密度 4 英寸设备来说可能完全太小了。
原生 Android 应用具有用于处理该问题的内置逻辑,其形式为多组资源(例如,图像),可以基于设备特征进行交换。最终,PhoneGap 和类似的工具将需要为他们的用户提供相关的建议,告诉他们如何创建同样能适应环境的应用。
观感
一个 web 应用看起来永远不会像一个本地应用。这未必是一件坏事。然而,一些用户可能会感到不安,特别是因为他们不明白为什么他们新安装的应用(例如,用 PhoneGap 制作的)与他们已经拥有的任何其他类似应用如此不同。
随着 HTML5 应用在 Android 上变得更加突出,这个问题的重要性应该会下降。然而,这是需要记住的事情。如果您正在创建自己的图形元素(图标等)。)你几乎肯定会从使用 Android Asset Studio 中受益,这将在第 43 章中介绍,承担一些杂务:制作必要大小的图标,创建与你的图标和其他风格一致的网络图像,等等。
了解更多信息
在撰写本文时,还没有专门介绍 PhoneGap 开发的书籍。目前,关于 PhoneGap 的最佳信息可以在 PhoneGap 网站上找到,包括它的 API 文档,也可以在其他网站上的许多其他公开的教程中找到。
版权属于:月萌API www.moonapi.com,转载请注明出处