Android H5混合开发(1):构建Cordova 项目

Cordova是什么

Apache Cordova是一个开源的移动开发框架。允许你用标准的web技术-HTML5,CSS3和JavaScript做跨平台开发。


以移动平台为例,安卓、IOS平台设备的常用功能,被Apache封装成一个个插件,如摄像头、传感器、网络、数据等。H5端通过调用插件,即可使用设备的这些功能。而项目具体的业务功能,也可封装成自定义的插件,供H5端调用,如:App端分享功能、支付功能、扫码、定位、自定义键盘等。

Cordova提供了完整的机制,使得H5、安卓、IOS等平台混合开发不再复杂。

Cordova的项目可包含多个平台,各平台操作自己的代码即可,与H5端通过插件通信:
   www:H5的工作目录
   /platforms/android/:安卓项目的工作目录
   /platforms/ios/:IOS项目的工作目录
   ....

更多信息,请参考官网:
https://cordova.apache.org/docs/en/latest/

Cordova环境

1.平台环境

用Cordova构建和运行App,需要安装每个你需要平台的SDK,以安卓为例:

1.1 Java开发工具包(JDK)

安装[Java Development Kit (JDK) 7]或者最新的版本

1.2 Android SDK

安装[Android Stand-alone SDK]或者[Android Studio]

1.3 设置环境变量 JAVA_HOME 和 ANDROID_HOME
为了使功能正常使用Cordova的CLI工具,需要设置一些环境变量。
以Mac平台为例:

1.3.1 打开终端Terminal
1.3.2 输入创建命令(如果不存在):touch .bash_profile
1.3.3 打开文件命令:open .bash_profile
Android H5混合开发(1):构建Cordova 项目_第1张图片
打开bash_profile文件,配置环境变量.png

打开.bash_profile,配置环境变量(根据自己的目录,修改即可),如下图:


Android H5混合开发(1):构建Cordova 项目_第2张图片
配置环境变量.png

2.Cordova环境

安装cordova命令行工具:
2.1 下载和安装Node.js (地址:https://nodejs.org/en/download/)。
安装完成后你可以在命令行中使用nodenpm

node.js是javascript的一种运行环境,是一个服务器端的javascript的解释器。
npm其实是Node.js的包管理工具(package manager)。
nodejs中包含npm,安装完成nodejs,npm也就安装好了。

通过命令node --version  可查看nodejs版本;
通过命令npm --version  可查看npm版本;

2.2 安装cordova 模块使用Nodejs的npm工具。
cordova模块会被npm工具自动下载。

2.2.1 打开终端

2.2.2 执行命令安装cordova:
sudo npm install -g cordova

2.2.3 执行命令安装插件管理器:
sudo npm install -g plugman

注释:
sudo OS X和Linux上的命令,可以被安装在权限受限的目录中(windows平台上去掉sudo即可)
-g 标志是告诉 npm 我们全局安装 cordova;
为避免安装时出现权限相关问题,也可先启用超级用户,命令:sudo -s ,这样就可直接通过 npm install -g cordova进行安装。

2.3 cordova环境验证
打开终端,输入以下命令,检查cordova环境版本,如下图:


Android H5混合开发(1):构建Cordova 项目_第3张图片
cordova环境版本.png

更多环境配置信息,请参考官网:
https://cordova.apache.org/docs/en/latest/guide/platforms/android/index.html
https://cordova.apache.org/docs/en/latest/guide/cli/index.html

plugman工具用于管理插件,如查看插件列表、新增插件、删除插件、添加到指定平台等。

plugman create --name ....
cordova plugin remove....
cordova plugin list
plugman platform add --platform_name android

创建Cordova项目

接下来,我们使用Cordova开始搭建一个Cordova项目

  1. 新建准备存放Cordova项目的目录,我的本地目录名:TestCordova
  2. 打开终端,进入TestCordova目录
  3. 输入创建项目的命令:
cordova create myapp com.qxc.app MyApp

-- myapp 目录名称
-- com.qxc.app 包名/工程id
-- MyApp 项目名称

项目创建成功,如下图:


Android H5混合开发(1):构建Cordova 项目_第4张图片
image.png
  1. 添加Android平台
    通过上图,我们可以看到平台目录中(plantforms)是空的,因为我们还没有添加任何平台。
    输入进入项目目录命令:
cd myapp

输入添加android平台命令:

cordova platform add android --save

-- ios平台类似:cordova platform add ios --save
Android H5混合开发(1):构建Cordova 项目_第5张图片
添加Android平台命令.png

添加Android平台成功后,项目目录如下图:


Android H5混合开发(1):构建Cordova 项目_第6张图片
项目目录.png

至此,项目创建完成。
安卓端开发,使用/platforms/android目录;
IOS端开发,使用/plantforms/ios目录;(当前示例demo没有添加)
H5端开发,使用www目录;

具体安卓与H5端如何通信,我们后续再介绍。

测试Android项目

  1. 启动AndroidStudio,打开项目/platforms/android。
  2. 根据本地Gradle版本(我的是3.3和3.5),修改项目的Gradle。
    打开项目的/gradle/wrapper/gradle-wrapper.properties文件,修改gradle版本:


    Android H5混合开发(1):构建Cordova 项目_第7张图片
    修改gradle版本.png
  3. 编译项目(如果编译有问题,一般是Gradle版本的问题,请根据本地gradle进行调整)
  4. 运行到手机


    Android H5混合开发(1):构建Cordova 项目_第8张图片
    运行效果.jpg

第一篇:Android H5混合开发(1):构建Cordova 项目

https://www.jianshu.com/p/058a0dd7f809

第二篇:Android H5混合开发(2):自定义Cordova插件

https://www.jianshu.com/p/8fcbf06a4c3a

第三篇:Android H5混合开发(3):原生Android项目里嵌入Cordova

https://www.jianshu.com/p/e306ae0f1f03

第四篇:Android H5混合开发(4):构建Cordova Jar包

https://www.jianshu.com/p/447d41a1299d

第五篇:Android H5混合开发(5):封装Cordova View

https://www.jianshu.com/p/13a0fbaa3227

你可能感兴趣的:(Android H5混合开发(1):构建Cordova 项目)