技术交流群:233513714css
Cordova 环境搭建html
工具文件夹中:jdk目录java
1)下载地址:http://www.oracle.com/technetwork/java/javase/downloads/index.htmlnode
设置环境变量:android
JAVA_HOME= C:\Program Files\Java\jdk1.6.0_45ios
JRE_HOME=C:\Program Files\Java\jdk1.6.0_45\jregit
CLASSPATH=.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jargithub
Path=%ANT_HOME%\bin;%MAVEN_HOME%\bin;%JAVA_HOME%\bin;%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\;C:\Program Files\MySQL\MySQL Server 5.5\bin;D:\Program Files\TortoiseSVN\bin;%ANDROID_HOME%\tools;%ANDROID_HOME%\platform-tools;C:\Program Files\nodejs\apache
工具文件夹中:apache-ant-1.9.4-bin.zipnpm
下载地址:http://apache.fayea.com/apache-mirror/ant/binaries/
设置环境变量:
新建ANT_HOME=E:\ant\apache-ant-1.9.4
Path中添加:%ANT_HOME%\bin;
工具文件夹中:android-环境-64x.zip
运行命令行工具以前,你应该确保你已经安装了目标平台所需的SDK。以Android为例,咱们能够到如下网址下载一个安装套件:
http://developer.android.com/sdk/index.html
点击页面右侧的“Download the SDK ADT Bundle for Windows”下载安装。
固然你也能够逐个下载和配置,不过针对初学者我推荐下载上面的安装套件,省时省力。
其余平台的SDK,请参照官方文档:
http://cordova.apache.org/docs/en/3.4.0/guide_platforms_index.md.html#Platform%20Guides
注意:
请把SDK的路径添加到系统环境变量Path中去,总共两个。好比d:\adt-bundle\sdk\tools和d:\adt-bundle\sdk\platform-tools
工具文件夹中:nodejs.zip
下载地址:http://nodejs.org/download/
安装完成后,运行Node.js command prompt
出现:Your environment has been set up for using Node.js 0.10.36 (x64) and npm.为正在配置环境变量
运行:node -v 查看node.js的版本号
在Node.js command prompt中,运行npm install -g cordova
直接运行npm install -g cordova 安装的cordova版本为当前的最高版本
下载指定cordova版本,运行npm install -g cordova@4.2.0,安装的即为4.2.0版本
自定义一个工做空间
进入工做空间并建立应用工程
运行:cordova create hello com.example.hello HelloWorld -d
第一个参数hello,指定目录名称。
第二个参数com.example.hello相似C#的命名空间,或Java的包名。(不太肯定,读者自行鉴别,原文写的是a reversedomain-style identifier)
第三个参数指定了应用程序的显示标题。
完成后能够查看Hello目录及其子目录结构
注意,如下全部命令都要在项目根目录下运行(用cd命令进入)。
首先,你须要添加你所须要支持的平台,好比:
cordova platform add android
cordova platform add ios
注:貌似ios开发只能在Mac机器上进行,因此上面的add ios不会出如今Windows机器上。
完成后运行如下命令查看:
cordova platfrom list
若是之后须要移除Android平台支持,能够运行:
cordova platform rm android
运行platform add或platform rm命令会影响项目目录下的内容。每个被添加的平台会在项目根目录下的platform下产生一个对应平台的子目录。你能够看到各个平台下也存在www目录,好比platforms\android\assets\www。由于CLI会不断的复制项目根目录下的www中的内容,因此你应确保不要对平台下的www目录中的内容进行修改。若是你实在有这个需求,请参照本章末尾的“Merges目录”。
警告:
若是你使用CLI管理你的项目,请尽可能不要更改platforms目录下的任何内容,除非你有明确的把握知道你在作什么。这是由于该目录下的内容会在一些条件下被覆盖。
若是你但愿此时能经过针对特定平台的SDK(好比Eclipse)来进行开发,你应该打开那些位于platforms子目录下的内容。这是由于平台相关的一些配置信息是存储在platforms特定子目录下的
将生成的android工程导入eclipse中:
打开Eclipse,右击选择import
默认状况下,cordova create脚本将建立一个很是简单的基于Web的应用程序。
运行如下命令编译应用程序:
cordova build 或 cordova build android //只针对Andorid平台编译
若是最终提示:BUILD SUCCESSFUL,则编译成功。
实际上build命令对应于如下两个命令:
cordova prepare android
cordova compile android
这意味着你能够仅执行prepare命令,而后用SDK开发环境去另外编译。
打开Eclipse,选择菜单New->Project->Android->AndroidProject From Existing Code,选择项目根目录为hello\platforms\android,并确保hello和hello-CordoraLib两个项目均被选中。(须要选中hello-CorodoraLib项目是由于这个项目将取代传统的.jar文件)
若是项目名上有红色的叉叉,则表明有未解决的问题。此时能够尝试:
1) 项目名上点击右键,选择Properties。
2) 选中左侧导航栏中的Android。
3) 在右侧选中对应的目标平台。好比Android4.4。
4) 点击OK。
稍后,在Eclipse中启动Android SDK Manager。以下图:
打开Manger后,点击菜单Tools->Manage AVDs…,而后点击Device definitions栏,以下图:
选择一个你想要的仿真器,而后点击Create AVD,接受默认设置便可。完成后你将在列表中看到新建的仿真器。
在列表中选中仿真器,点击窗体右侧的“Start”按钮启动仿真器(启动提示窗口中点击Launch便可)。
项目名称上点击右键,选择Run As->Android Application,而后耐心等待仿真器加载。
若是你的CPU支持虚拟化技术,你能够参照相关文档进行设置以提升仿真器运行效率。
加载后你就能够经过操做仿真器看到你的第一个Android程序,以下:
或者你也能够在命令行中运行如下命令启动仿真器:
cordova emulate android
如以上咱们看到的,Cordova默认提供的程序界面和功能很是简单。固然你能够根据你的须要,运行标准Web开发技术对页面进行设计。可是当你须要和不一样的设备进行通信交互时,你就须要借助于一些插件,以便可以访问Cordova提供的核心API。
通常来讲,你添加一个插件的目的是为了利用Cordova的API访问设备。详细的可用插件列表你能够在社区中看到(http://plugins.cordova.io/)。固然你也能够自定义本身的插件。
你能够用CLI搜索可用的插件,好比:
cordova plugin search bar code
你能够经过如下命令安装插件,好比:
cordova plugin add org.apache.cordova.device //设备API
cordova plugin add org.apache.cordova.network-information //网络(事件)
cordova plugin add org.apache.cordova.battery-status //电池(事件)
cordova plugin add org.apache.cordova.device-motion //加速器
cordova plugin add org.apache.cordova.device-orientation //罗盘
cordova plugin add org.apache.cordova.geolocation //定位
cordova plugin add org.apache.cordova.camera //摄像头
cordova plugin add org.apache.cordova.media-capture //媒体文件处理
cordova plugin add org.apache.cordova.media //媒体文件处理
cordova plugin add org.apache.cordova.file //文件访问
cordova plugin add org.apache.cordova.file-transfer //文件传输
cordova plugin add org.apache.cordova.dialogs //对话框
cordova plugin add org.apache.cordova.vibration //震动
cordova plugin add org.apache.cordova.contacts //联系人
cordova plugin add org.apache.cordova.globalization //全球化
cordova plugin add org.apache.cordova.splashscreen //闪屏
cordova plugin add org.apache.cordova.inappbrowser //打开新的浏览器窗口
cordova plugin add org.apache.cordova.console //调试控制台
你能够用如下命令查看全部已经安装的插件
cordova plugin ls
使用如下命令删除插件:
cordova plugin rm org.apache.cordova.console
Plugin add高级选项
上面的安装方式是从registry.cordova.io库中按照id获取插件,这是一个很是通用的作法。你能够在安装时指定版本,好比:
cordova plugin addorg.apache.cordova.console@latest
cordova plugin addorg.apache.cordova.console@0.2.1
其中的latest表示获取最新版本。中间用@分隔。
若是插件不是在默认库中,而是在其余地方,则你能够指定URL:
cordova plugin addhttps://github.com/apache/cordova-plugin-console.git
固然你须要先安装git。
前面提到,通常状况下最好不要修改各自平台下的www目录下的文件。可是若是你确实须要为某个平台定制一些内容,又该怎么办呢?
项目根目录下有一个merges目录。咱们以一个实例来说解:
1) 修改www\css目录下的index.css文件,设置event.received的样式为红色: background-color:#FF0000;
2) 修改platforms\android\assets\www\css中的index.css文件,设置.event.received的样式为蓝色:background-color:#0000FF;
3) 在merges\android目录下新建一个css目录。
复制www\css中的index.css文件到该目录下。
修改该目录下的index.css文件中的.event.received的样式为绿色:background-color:# 00FF00;
仿真器中运行,你会发现最终呈现的结果为绿色。由此咱们可知:
1) Merges目录中没有对应文件时,platform下的文件会被跟目录(www)下的文件覆盖。(即:若是Merges目录中不存在index.css文件,最终颜色将为红色)
2) Merges目录中存在对应文件时,platform下的文件会被merges下的文件覆盖。可见Merges目录主要用于为平台定制功能。
经过如下命令查看帮助信息:
cordova help
更新命令
如下语句更新cordova:
npm update -g cordova
cordova更新完成后,你还须要更新项目:
cordova platform update android
注意:
由于各版本之间差别较大,执行更新时请事先仔细阅读官方文档,以避免发生数据丢失或错误