Android H5混合开发（4）：构建Cordova Jar包

前言

上一节，介绍了原生项目如何嵌入Cordova，我们对Cordova的依赖使用的是CordovaLib Module，这也是安卓项目常用的方式。
但是，也有项目希望以Jar包的方式依赖Cordova，原因很多：怕暴露的源码被程序员误改、源码不便于公司内部私服仓库管理、替换版本麻烦、或其他。

分析

Cordova官方从2.3.0版本后已不再提供Jar包，而是直接提供源码。
那么，针对原生项目嵌入Cordova，官方提供了哪些指导文档呢？
https://cordova.apache.org/docs/en/latest/guide/platforms/android/webview.html

如图第1~3项，告知了我们：请下载最新版的Cordova-Android源码，再通过ant打包工具将源码打成Jar包，然后通过Jar包进行依赖。

那么，我们按照官方描述的方式尝试一下吧。

下载源码Cordova-Android

在页面 “Embed Cordova in native apps” 的底部，选择【More Resources 】-- 【Source Code】

进入源码下载页面：

下载源码【cordova-android】到本地（建议下载官方正式发布的版本，即release版）。

配置ant打包环境

因需要使用ant进行打包，所以，安装ant并配置环境变量

1.下载ant

ant下载地址：http://ant.apache.org/bindownload.cgi

我本地下载的是第一项：apache-ant-1.10.5-bin-zip，下载完成后解压缩即可。

2.配置环境变量

配置环境变量（此次演示以mac为例，如果是windows的电脑，请网上查找一下，资料很多）：
通过终端执行命令：

vim .bash_profile

根据解压缩路径配置ANT_HOME和PATH，如下图：

注释：vim 常用操作命令：i 指输入，:wq 指保存并退出，更多操作请自行查资料。
使刚配置的环境变量生效，执行命令：

source .bash_profile

3.查看ant版本

执行命令：

ant -version

生成Jar包

1.源码/cordova-android-master/framework中增加local.properties文件

增加local.properties文件内容，请根据自己电脑的Android SDK地址配置（也可从自己电脑上已有的androidstudio项目中拷贝），我的project的local.properties文件内容如下（仅供参考）：

ndk.dir=/Users/qixingchao/Documents/Jobs/androidsoft/SDK/android-sdk-macosx/ndk-bundle
sdk.dir=/Users/qixingchao/Documents/Jobs/androidsoft/SDK/android-sdk-macosx

2.通过终端命令进入目录：/cordova-android-master/framework

framework是存放cordova源码的目录
执行命令：

ant jar

Last login: Thu Jan 17 16:10:33 on ttys000
qixingcaodeiMac:~ qixingchao$ cd /Users/qixingchao/Desktop/cordova-android-master/framework 
qixingcaodeiMac:framework qixingchao$ ant jar
Buildfile: /Users/qixingchao/Desktop/cordova-android-master/framework/build.xml

-pre-build:

-check-env:
 [checkenv] Android SDK Tools Revision 25.2.5
 [checkenv] Installed at /Users/qixingchao/Documents/Jobs/androidsoft/SDK/android-sdk-macosx

-setup:
     [echo] Project Name: Cordova
  [gettype] Project Type: Android Library

-build-setup:
[getbuildtools] Using latest Build Tools: 28.0.3
     [echo] Resolving Build Target for Cordova...
[gettarget] Project Target:   Android 8.1.0
[gettarget] API level:        27
     [echo] ----------
     [echo] Creating output directories if needed...
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/res
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/libs
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/bin
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/bin/res
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/bin/rsObj
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/bin/rsLibs
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/gen
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/bin/classes
    [mkdir] Created dir: /Users/qixingchao/Desktop/cordova-android-master/framework/bin/dexedLibs
     [echo] ----------
     [echo] Resolving Dependencies for Cordova...
[dependency] Library dependencies:
[dependency] No Libraries
[dependency] 
[dependency] ------------------
     [echo] ----------
     [echo] Building Libraries with '${build.target}'...
   [subant] No sub-builds to iterate on

-code-gen:
[mergemanifest] Merging AndroidManifest files into one.
[mergemanifest] Manifest merger disabled. Using project manifest only.
     [echo] Handling aidl files...
     [aidl] No AIDL files to compile.
     [echo] ----------
     [echo] Handling RenderScript files...
     [echo] ----------
     [echo] Handling Resources...
     [aapt] Generating resource IDs...
     [echo] ----------
     [echo] Handling BuildConfig class...
[buildconfig] Generating BuildConfig class.

-pre-compile:

-compile:
    [javac] Compiling 40 source files to /Users/qixingchao/Desktop/cordova-android-master/framework/bin/classes
    [javac] 警告: [options] 源值1.5已过时, 将在未来所有发行版中删除
    [javac] 警告: [options] 目标值1.5已过时, 将在未来所有发行版中删除
    [javac] 警告: [options] 要隐藏有关已过时选项的警告, 请使用 -Xlint:-options。
    [javac] 注: /Users/qixingchao/Desktop/cordova-android-master/framework/src/org/apache/cordova/engine/SystemCookieManager.java使用或覆盖了已过时的 API。
    [javac] 注: 有关详细信息, 请使用 -Xlint:deprecation 重新编译。
    [javac] 3 个警告
     [echo] Creating library output jar file...
      [jar] Building jar: /Users/qixingchao/Desktop/cordova-android-master/framework/bin/classes.jar

jar:
      [jar] Building jar: /Users/qixingchao/Desktop/cordova-android-master/framework/cordova-8.0.0-dev.jar

BUILD SUCCESSFUL
Total time: 3 seconds
qixingcaodeiMac:framework qixingchao$ 

3.生成成功

Jar包使用

1.将cordova-8.0.0-dev.jar拷贝到原生项目的libs下，配置依赖。
2.参考Android H5混合开发（3），导入测试插件信息。
3.编译运行原生项目：

总结

项目依赖Cordova，无论是使用Module还是Jar包，都是可行的。
具体开发项目时，应根据项目需要合理选择。

如有不明白的地方，请多参考官方文档 https://cordova.apache.org/docs/en/latest/

---

Android H5混合开发（1）：构建Cordova 项目
https://www.cnblogs.com/qixingchao/p/11654454.html

Android H5混合开发（2）：自定义Cordova插件
https://www.cnblogs.com/qixingchao/p/11652418.html

Android H5混合开发（3）：原生Android项目里嵌入Cordova
https://www.cnblogs.com/qixingchao/p/11652424.html

Android H5混合开发（4）：构建Cordova Jar包
https://www.cnblogs.com/qixingchao/p/11652431.html

Android H5混合开发（5）：封装Cordova View, 让Fragment、弹框、Activity自由使用Cordova
https://www.cnblogs.com/qixingchao/p/11652438.html