环境参数
MacOS Catalina 10.15.7
Cordova版本：10.0.0
NodeJS版本: 12.18.2
Java SDK: 1.8.0
Android Target: 7.1
Android Gradle: 4.1
一、安装NodeJS
建议安装NodeJS版本管理工具，例如nvm(window)，n(macOS)
二、全局安装Cordova
cnpm i -g cordova
三、创建APP项目
cordova create [根目录文件夹] [包名] [App名称]
进入项目根目录
cd [根目录文件夹]
四、Android APP开发环境搭建
添加Android平台
# 建议指定版本 @
cordova platform add android@7.1.1 --save
检测本机是否满足Android平台构建
需要安装并配置 Java SDK(本机已安装)、Android SDK、Android target、Gradle
安装JDK
下载JDK,可到以下oracle官网下载:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
配置JAVA_HOME环境变量
修改HOME目录下的.bash_profile文件,如下:
......
export JAVA_HOME="xxx/xxx" #根据实际情况修改
export PATH="$JAVA_HOME/bin:$PATH"
如果没有
.bash_profile,touch新建一个。写入之后执行命令:source .bash_profile配置生效或者重新打开terminal，然后查看java和javac命令是否执行成功,执行java -version;javac -version;
下载配置Android SDK
地址：http://www.androiddevtools.cn/
Mac OS X android-sdk_r24.4.macosx.zip 98 MB
解压zip包 进入到android-sdk-macoxs下的tools文件夹，双击Android文件。即可启动Android SDK Manager。
根据Cordova文档要求，勾选☑️
- Android SDK Platform-tools
- Android SDK Build-tools (Cordova官方文档要求版本在19.1.0或以上，建议选择最新一个版本)
- 目标Android版本的Android Platform SDK (例如我想基于Android 7.1开发，就找到对应的Platform SDK进行安装)
- Android Support Repository (在Extras查找)
配置ANDROID_SDK_ROOT环境变量
同样是修改HOME目录下的.bash_profile文件,如下:
......
# 在文件最下方添加以下内容：
export ANDROID_SDK_ROOT="/Users/xxx/Android/android-sdk-macosx" #根据实际情况修改
ANDROID_TOOLS="$ANDROID_SDK_ROOT/tools"
ANDROID_PLATFORM_TOOLS="$ANDROID_SDK_ROOT/platform-tools"
ANDROID_BUILD_TOOLS="$ANDROID_SDK_ROOT/build-tools"
export PATH="$PATH:$ANDROID_TOOLS:$ANDROID_PLATFORM_TOOLS:$ANDROID_BUILD_TOOLS"
写入之后执行命令:
source .bash_profile配置生效或者重新打开terminal。执行android -v验证配置是否生效。
安装配置Gradle
按照自己的实际情况下载对应的Gradle版本：Android gradle 各种版本下载
修改HOME目录下的.bash_profile文件,如下:
......
# 在文件最下方添加以下内容：
ANDROID_GRADLE="/Users/xxx/Android/gradle-4.1/bin" #根据实际情况修改
export PATH="$PATH:$ANDROID_GRADLE"
写入之后执行命令:
source .bash_profile配置生效或者重新打开terminal。执行cradle -v验证配置是否生效。
此时在APP项目根目录运行cordova requirements，如无意外，Android的构建环境基础已经配置好了
构建APP
构建之前，先修改3个build.gradle文件里的maven url，否则会因为翻墙问题导致在build过程中无法下载相关资源文件
- [项目根目录]/platforms/android/build.gradle
- [项目根目录]/platforms/android/app/build.gradle
- [项目根目录]/platforms/android/CordovaLib/build.gradle
在文件中定位到buildscript节点，修改节点里的maven url，将https://maven.google.com 修改为https://dl.google.com/dl/android/maven2/
也可以修改为阿里云云效Maven上的镜像路径
https://maven.aliyun.com/repository/google
......
buildscript {
repositories {
mavenCentral()
maven {
url "https://dl.google.com/dl/android/maven2/"
}
jcenter()
}
......
}
开始构建：
cordova build android
如果初次构建，很可能在Gradle环节会出现报错，这个报错是因为要在官网下载对应的Gradle版本，因为没有翻墙工具，所以导致下载失败引起的报错提示：
手动下载目标文件gradle-4.1-all.zip，并将其放置在目标路径/User/<用户名>/.gradle/wrapper/dists/gradle-x.x-all/[24位标识码]/，例如我的放置路径为：
/Users/luzhihua/.gradle/wrapper/dists/gradle-4.1-all/bzyivzo6n839fup2jbap0tjew/
重新开始构建，成功输出apk包
BUILD SUCCESSFUL in 1s
46 actionable tasks: 1 executed, 45 up-to-date
Built the following apk(s):
/Users/luzhihua/cordovaProject/helloworld/platforms/android/app/build/outputs/apk/debug/app-debug.apk
