使用 Eclipse PhoneGap 构建 Android

来源：互联网发布：博明软件编辑：程序博客网时间：2024/05/17 22:04

配置项目以使用 PhoneGap

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

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

图 5. 新项目目录。

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

图 6. PhoneGap lib/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 代码作为用户界面开发的起点：

         <!DOCTYPE HTML><html> <head>  <title>PhoneGap</title>  <script type="text/javascript" charset="utf-8" src="cordova-1.5.0.js"></script> </head> <body>    <h1>Hello PhoneGap</h1> </body></html>

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

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

更新 Activity 类

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

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

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

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

import org.apache.cordova.DroidGap;

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

public class HelloGapActivity extends DroidGap {

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

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

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

图 9. 主 Activity 类更新。

配置项目元数据

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

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

图 10. 打开 AndroidManifest.xml。

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

         <supports-screens    android: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-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" /> <uses-permission android:name="android.permission.GET_ACCOUNTS" /><uses-permission android:name="android.permission.BROADCAST_STICKY" />

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

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

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

android:configChanges="orientation|keyboardHidden"

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

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

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

运行应用程序

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

图 11. 启动 Android 应用程序。

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

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

0 0