环境参数

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平台构建

cordova-requirements

需要安装并配置 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

android-sdk.png

解压zip包 进入到android-sdk-macoxs下的tools文件夹，双击Android文件。即可启动Android SDK Manager。

android-sdk-manager.png

根据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的构建环境基础已经配置好了

cordova-android-requirements

构建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版本，因为没有翻墙工具，所以导致下载失败引起的报错提示：

cordova_build_android_gradle_download_error.png

手动下载目标文件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