首页 > 代码库 > PhoneGap:3+版本的安装、配置和使用[图]

PhoneGap:3+版本的安装、配置和使用[图]

如若转载,请注明博文地址及原作者(RisingWonderland)。


PhoneGap2+版本最高为2.9.1,从3+版本开始,PhoneGap官方不再提供下载安装包,需要在联网状态下,通过Node.js工具下载安装。官方提供的安装说明堪称精简楷模:


直接操作可能很多地方不明不白,本文提供3+版本的安装、配置和使用的基本方法以及注意事项。

下载安装Ant

安装3+版本的PhoneGap需要Ant,Ant是一款基于Java的打包工具。该工具在Apache官方网站提供下载。

Windows环境的安装方法:

1、从Apache下载Ant。

2、将Ant解压缩至硬盘某目录,如C盘根目录:


3、将位于bin文件夹内的ant.bat文件所在路径加入系统Path环境变量(“C:\Ant\bin”)。

下载安装Node.js

安装3+版本的PhoneGap需要Node.js。在官方网站下载安装后,打开命令行,运行npm命令查看输出结果或运行node命令进入node命令行模式。如果成功,可以确认安装成功。

下载安装PhoneGap

打开命令行,输入“npm install –g phonegap”,开始下载安装PhoneGap最新版:


由于之前已经下载成功,所以上图中的http状态码是304,意为服务器提供的版本与当前已安装版本内容无异,不返回新内容。

如果是首次安装,http状态码应该是200。

PhoneGap安装成功后,重启命令行工具,运行“phonegap”命令,可得到输出结果(部分):


如果运行“phonegap”命令得到的结果是“不是内部或外部的命令”,关闭命令行,尝试关闭或重启可能施加影响的程序,或者重新启动计算机。

在C盘的“node_modules”文件夹下会看到名为“phonegap”的文件夹,这里是我们下载的PhoneGap文件。

配置

为了能够使用PhoneGap创建并运行Android程序,需要进行一些配置。

安装并配置JDK1.6+版本。

安装Eclipse和Eclipse的Android环境。

更新Android的SDK至最新版。

为系统Path环境变量增加Andropid的SDK信息。假设AndroidSDK文件夹位于D盘根目录,将“D:\sdk\tools”和“D:\sdk\platform-tools”加入Path环境变量。

为系统Path环境变量增加Eclipse的Android插件信息:假设装有Android环境变量的Eclipse软件位于D盘根目录,将“D:\eclipse\ plugins\org.apache.ant_1.8.2.v20120109-1030\bin”加入Path环境变量。

使用

打开命令行,将路径切换至要创建PhoneGap应用的目录下,如C盘根目录。

执行命令“phonegapcreate hello”可以创建一个项目文件夹名为“hello”的PhoneGap程序。创建成功后,可以在C盘根目录看到“hello”文件夹。

还可以使用更详细的命令“phonegap create hello com.demo.hello HelloGP”创建一个项目文件夹名为“hello”、项目包名为“com.demo.hello”、程序名为“HelloGP”的PhoneGap程序。


目前创建的还不是真正的Android程序,但是这些信息会写入config.xml文件中。


执行命令“cdhello”,切换至hello目录下。

之后,执行不同的命令可进行指定的操作:

“phonegapbuild android”命令用于创建Android项目,创建成功后,可以在“C:\hello\platforms”文件夹内看到Android工程文件;

“phonegapinstall android”命令用于在Android设备上运行项目;

“phonegap-e install android”命令用于在Android虚拟设备上运行项目;

“phonegaprun android”命令用于一步创建Android项目并在Android设备上运行项目;

“phoengap–e run android”命令用于一步创建Android项目并在Android虚拟设备上运行项目。

执行命令后,开始编译运行Android程序。如果当前电脑并没有连入可供测试的Android设备,PhoneGap会尝试运行Android虚拟设备(avd)。如果用户之前并没有创建Android虚拟设备,命令行会给出提示,程序终止:


如果当前电脑连接有可供测试的Android设备,我们创建的Android程序可通过此设备进行安装测试:


基础PhoneGap应用运行在手机上的截图:


导入Eclipse

为了便于开发,我们需要将Android项目导入Eclipse。在导入的过程中发现有些地方容易出现问题。

在导入的过程中,选择了项目文件中的Android工程后,会遇到这一步:


从上图中可以看出,项目文件中含有两个工程。上面的工程是我们创建的HelloGP程序,下面的工程是PhoneGap提供的类库文件,相当于3+版本之前的cordova.jar。我们要进行编辑的是上面的程序,但是两个工程都要导入,而且“Copy projects into workspace”选项不能勾选,否则会出现缺失类文件错误。所以在创建项目时,为了便于管理,不要创建在临时工作区间。

导入工程后,项目工程与3+之前版本有所不同。assets不在www文件夹内,“res/xml”目录下没有config.xml文件,Activity中的super.loadUrl方法内接收的参数不是直接的html地址字符串。

 

更多信息

更新PhoneGap至最新版的命令:npm update –g phonegap

查看PhoneGap版本信息的命令:phonegap version或phonegap –v

查看PhoneGap详细信息的命令:npm info phonegap


安装指定PhoneGap版本的命令:npm install –g phonegap@[具体版本号]

注意事项

有时在命令行编译Android项目失败,会有build-tools版本过低的提示,所以请打开SDK Manager,确保当前已经更新至最新版。

如果在确认配置正确的情况下,下载PhoneGap失败,可以再尝试下载几次。如果依然失败,考虑开启科学上网模式。


如若转载,请注明博文地址及原作者(RisingWonderland)。