PhoneGap3+版本的安装、配置和使用
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失败,可以再尝试下载几次。如果依然失败,考虑开启科学上网模式。
PhoneGap 的详细介绍:请点这里
PhoneGap 的下载地址:请点这里