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

2021-11-01 15:58:21

前言

上一节，介绍了原生项目如何嵌入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

码农公寓

前言

分析