使用 Eclipse PhoneGap 构建 Android(安卓)应用程序入门

PhoneGap中文文档：http://bbs.phonegapcn.com/topic-api.html

Eclipse是一种支持多种技术的开源集成开发环境(IDE)，但本文重点介绍Java支持，这也是Android应用程序的“母语”。 Android是Google发布的开源移动操作系统。Android现已成为许多智能手机和平板设备的操作系统，其中包括三星Galaxy系列手机和平板电脑、亚马逊KindleFire平板电脑、BarnesandNobleNook平板电脑，以及大量制造商生产的许多其他设备。PhoneGap是一个开源应用程序平台，可让您使用HTML和JavaScript创建本机安装的移动应用程序。

安装Eclipse

在Android上建立PhoneGap应用程序开发环境的首要步骤是下载并安装EclipseIDE。

使用PhoneGap进行Android开发（可在Windows、OSX或Linux中完成。目前有许多不同的Eclipse安装包。虽然PhoneGap能够与其他程序包配置一同使用，但建议采用EclipseClassic程序包，该程序包中已经包含PhoneGap应用程序开发入门及使用所需的各种工具。

访问Eclipse下载页面，针对您的操作系统下载EclipseClassic程序包。Eclipse下载将是一个包含开发环境的存档文件。
将该存档文件提取到您的本地硬盘，并记住其所在位置。
提取完成后，只需双击Eclipse应用程序即可启动Eclipse，无需执行任何其他安装步骤。

安装Android工具

下载并安装Eclipse后，您需要配置自身环境以使用GoogleAndroid开发工具。此流程包含两个步骤。首先，下载并安装AndroidSDK。然后，为Eclipse安装ADT插件。

下载并配置AndroidSDK

在您的系统上配置Android工具的首要步骤是下载AndroidSDK。

访问AndroidSDK网站，针对您的操作系统下载相应的版本。
将下载的存档文件提取到您的本地硬盘，并记住其所在位置。

为Eclipse配置ADT插件

接下来，您需要为Eclipse安装ADT（Android开发工具）插件。ADT插件必须通过EclipseInstallNewSoftware向导来进行安装。

启动Eclipse。
按照ADT插件的下载说明（可在Android开发人员SDK页面-Eclipse获取）执行操作。这些步骤将指导您完成整个ADT插件的安装过程。
重新启动Eclipse。

在安装完ADT插件并重新启动Eclipse后，您需要将它配置为使用已下载至本地文件系统的AndroidSDK。

按照开发人员SDK页面–配置Eclipse上的说明，在ADT插件中设置适当的AndroidSDK位置。

下载并安装PhoneGap

下一步是下载并安装PhoneGap。

访问PhoneGap下载页面，然后单击橙色的下载链接以开始下载过程。
将存档文件提取到本地文件系统以备随后使用。

您现已为在Eclipse内创建首个AndroidPhoneGap项目做好准备。

注意：操作步骤针对PhoneGap1.5，但该流程须适用于所有版本的PhoneGap，并且所有版本PhoneGap的操作均相同。

在Eclipse中创建项目

请按照以下步骤在Eclipse中创建新的Android项目：

选择New>AndroidProject（参见图1）。

图1.创建新的Android项目。

创建全新的标准Android项目后，将更新该项目以使用PhoneGap。

在NewAndroidProject对话框中，键入项目名称，然后选中CreateNewProjectInWorkspace（参见图2）。
单击Next。

图2.NewAndroidProject对话框。

选择Android2.2作为构建目标，然后单击Next（参见图3）。

注意：选择Android2.2作为构建目标会将该编译器配置为以Android2.2SDK为目标，这样可确保您的PhoneGap应用程序在运行Android2.2及更新版本的操作系统的设备上运行。

图3.选择构建目标。

在ApplicationInfo屏幕上，键入您的主要Android应用程序的程序包名称（参见图4）。这将是一个从逻辑上展示程序包结构的命名空间，例如com.yourcompany.yourproject。
单击Finish。

图4.指定程序包名称。

配置项目以使用PhoneGap

此时，Eclipse创建了一个空白的Android项目。但是，并未将它配置为使用PhoneGap。接下来，您需要执行以下操作

在新Android项目内创建一个assets/www目录和一个libs目录。PhoneGap应用程序界面的所有HTML和JavaScript均将驻留在assets/www文件夹内（参见图5）。

图5.新项目目录。

要将PhoneGap的必要文件复制到项目内，首先找出下载PhoneGap的目录，然后导航至lib/android子目录（参见图6）。

图6.PhoneGaplib/android目录。

将cordova-1.5.0.js复制到Android项目内的assets/www目录。
将cordova-1.5.0.jar复制到Android项目内的libs目录。
将xml目录复制到Android项目内的res目录（参见图7）。

图7.复制资源。

接下来，在assets/www文件夹中创建一个名为index.html的文件。此文件将用作PhoneGap应用程序界面的主要入口点
在index.html中，添加以下HTML代码作为用户界面开发的起点：

<!DOCTYPEHTML><html><head><title>PhoneGap</title><scripttype="text/javascript"charset="utf-8"src="cordova-1.5.0.js"></script></head><body><h1>HelloPhoneGap</h1></body></html>

您需要将cordova-1.5.0.jar库添加到该Android项目的构建路径。右键单击cordova-1.5.0.jar，然后选择BuildPath>AddToBuildPath（参见图8）。

图8.将cordova-1.5.0.jar添加至构建路径。

更新Activity类

现在，您已经为更新Android项目以确保其开始使用PhoneGap做好准备。

打开您的主应用程序活动文件。此文件的名称与您的项目相同，并会在后面加上"Activity"一词。它将位于您先前在此流程中指定的项目程序包的src文件夹下。

对于我的项目（名为HelloGap）而言，主Android活动文件名为HelloGapActivity.java，位于我在NewAndroidProject对话框中指定的程序包com.tricedesigns.hello中。

在主Activity类中，为org.apache.cordova.DroidGap添加以下导入语句：

importorg.apache.cordova.DroidGap;

将基类从Activity更改为DroidGap；它位于类定义中extends一词的后面：

publicclassHelloGapActivityextendsDroidGap{

用从您此前创建的本地assets/www/index.html文件加载PhoneGap界面的引用替换setContentView()调用函数（参见图9）。

super.loadUrl("file:///android_asset/www/index.html");

注意：在PhoneGap项目中，您可以引用位于URL引用为file:///android_asset的assets目录中的文件，然后引用该文件的路径名称。file:///android_assetURI将会映射到assets目录。

图9.主Activity类更新。

配置项目元数据

现在，您已经将Android项目内的文件配置为使用PhoneGap。最后一步是配置项目元数据，以使PhoneGap运行。

首先，在您的项目根中打开AndroidManifest.xml文件。使用Eclipse文本编辑器，方法是右键单击AndroidManifest.xml文件，然后选择OpenWith>TextEditor（参见图10）。

图10.打开AndroidManifest.xml。

在AndroidManifest.xml中，添加以下supports-screenXML节点作为manifest根节点的子节点

<supports-screensandroid:largeScreens="true"android:normalScreens="true"android:smallScreens="true"android:resizeable="true"android:anyDensity="true"/>

supports-screen节点可识别您应用程序支持的屏幕大小。您可以通过更改此条目的内容来调整屏幕和外观设置支持。要阅读有关<supports-screens>,的更多信息，请访问Android开发人员主题–支持屏幕元素。

接下来，您需要为PhoneGap应用程序配置权限。

复制以下<uses-permission>XML节点，并粘贴它们作为AndroidManifest.xml文件<manifest>根节点的子节点：

<uses-permissionandroid:name="android.permission.CAMERA"/><uses-permissionandroid:name="android.permission.VIBRATE"/><uses-permissionandroid:name="android.permission.ACCESS_COARSE_LOCATION"/><uses-permissionandroid:name="android.permission.ACCESS_FINE_LOCATION"/><uses-permissionandroid:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/><uses-permissionandroid:name="android.permission.READ_PHONE_STATE"/><uses-permissionandroid:name="android.permission.INTERNET"/><uses-permissionandroid:name="android.permission.RECEIVE_SMS"/><uses-permissionandroid:name="android.permission.RECORD_AUDIO"/><uses-permissionandroid:name="android.permission.MODIFY_AUDIO_SETTINGS"/><uses-permissionandroid:name="android.permission.READ_CONTACTS"/><uses-permissionandroid:name="android.permission.WRITE_CONTACTS"/><uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/><uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"/><uses-permissionandroid:name="android.permission.GET_ACCOUNTS"/><uses-permissionandroid:name="android.permission.BROADCAST_STICKY"/>

<uses-permission>XML值可识别您要为应用程序启用的功能。上述代码行可启用PhoneGap所有功能正常运行所需的全部权限。构建完应用程序后，您可能希望删除不会实际用到的所有权限；这将会删除应用程序安装过程中出现的安全警告。要阅读有关Android权限和<uses-permission>元素的更多信息，请访问Android开发人员主题–用户权限元素。

应用程序权限配置完毕后，您需要修改现有的<activity>代码。

找到<activity>节点，它是<application>XML节点的子节点。将下面的属性添加到该<activity>节点：

configChanges="orientation|keyboardHidden"

接下来，您需要再为org.apache.cordova.DroidGap类创建一个<activity>节点。添加下面的<activity>节点作为现有<activity>XML节点的同级节点。

<activityandroid:name="org.apache.cordova.DroidGap"android:label="@string/app_name"android:configChanges="orientation|keyboardHidden"><intent-filter></intent-filter></activity>

此时，已将您的项目配置为作为AndroidPhoneGap项目运行。如果您遇到任何问题，请根据AndroidPhoneGap入门网站提供的示例验证您的配置。

运行应用程序

要在Android模拟器中启动您的PhoneGap应用程序，请右键单击项目根目录，然后选择RunAs>AndroidApplication（参见图11）。

图11.启动Android应用程序。

如果您尚未设置任何Android虚拟设备，那么系统将提示您配置一台Android虚拟设备。要了解有关配置Android模拟器虚拟设备的更多信息，请访问Android开发人员设备指南。

Eclipse将自动启动Android模拟器实例（如果尚未运行的话），为该模拟器部署您的应用程序，然后启动该应用程序（参见图12）。

图12.Android模拟器中的应用程序。

当在Android模拟器中运行应用程序后，您可能会希望在物理设备上对其进行测试。强烈建议您始终先在物理设备上测试您的应用程序，然后再将该应用程序部署到生产环境中。物理设备的计算能力和外观设置往往与模拟器不同，设备测试能够揭露模拟器环境中可能无法检测到的问题。

请按照以下步骤在物理Android设备上启动您的应用程序：

确保该设备已通过USB连接到您的计算机。
选择Run>RunConfigurations（参见图13）。

图13.更新运行配置。

在RunConfigurations对话框左侧的AndroidApplication下选择您的应用程序。
单击Target选项卡，然后选择Manual作为DeploymentTargetSelectionMode。
当您准备好启动应用程序后，单击Run（参见图14）。

图14.准备在设备上运行应用程序。

在AndroidDeviceChooser对话框中，您可以选择模拟器，也可以选择连接的Android设备。连接的所有Android设备均将显示在此列表中。

图15.选择Android设备。

选择您要使用的设备（参见图15），然后单击OK。

此时将会在该设备上安装并启动您的PhoneGap应用程序。

下一步阅读方向

如果您已经坚持学习完本部分，则可以开始使用PhoneGap构建真正的Android应用程序。接下来你可以阅读使用面向iOS的本机插件扩展PhoneGap。

请记住，需使用HTML、CSS和JavaScript为用户界面构建PhoneGap应用程序。这样，您就可以使用传统的Web开发技术轻松创建外观卓越的应用程序。要了解有关PhoneGap的更多信息，请查阅PhoneGapwiki，加入PhoneGapGoogleGroup或深入学习PhoneGap文档。