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

你可能感兴趣的