当我们写完 ionic 项目准备打包成 apk 时（比如执行 ionic cordova platform add android 或者 ionic cordova build android 等命令），经常会出现一些莫名其妙的问题，特别是对原生开发并不太熟悉的人，往往就是一脸懵逼啊。
因此，很有必要将这些经常出现的问题及对应解决方案做一个汇总，方便查阅。
问题1
BUILD FAILED
Total time: 29.304 secs
Error: cmd: Command failed with exit code 1 Error output:
ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:font
ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:fontStyle
ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:fontVariationSettings
ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:fontWeight
ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:ttcIndex
FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':processArmv7ReleaseResources'.
> com.android.ide.common.process.ProcessException: Failed to execute aapt
产生原因
主要原因是 cordova-plugin-compat 插件升级引起的，该插件已经包含在 cordova-android 6.3.0 中。如果你的应用使用了地理定位、文件操作或者其它依赖 cordova-plugin-compat 插件的插件的话，而 cordova-plugin-compat 这个插件已经包含在 cordova-android 6.3.0，如果你的 cordova-android 版本小于 6.3.0，则会出现这个问题。
解决方法
- 升级
cordova-android@6.3.0以上 - 升级
android-sdk/platforms到 android-26 以上 - 删除
cordova-plugin-compat插件，删除plugins/android.json和plugins/fetch.json中有关该插件的信息，并升级依赖该插件的其它所有插件
参考资料
问题2
Error: Could not find an installed version of Gradle either in Android Studio,
or on your system to install the gradle wrapper. Please include gradle
in your path, or install Android Studio
产生原因
window 开发环境下没有将 gradle 配置到环境变量 path 中。
解决方法
- 去 https://services.gradle.org/distributions/ 下载对应版本的 gradle，如
gradle-3.3-bin.zip - 将
gradle-3.3-bin.zip解压之后放置到某个目录下，如D:Program Filesgradle-3.3 - 在环境变量 path 中添加
D:Program Filesgradle-3.3in - 打开 cmd 输入 gradle -v，验证是否配置成功
参考资料
https://blog.csdn.net/capmiachael/article/details/73289478
问题3
下载 gradle-xxx-all.zip 太慢或失败
BUILD SUCCESSFUL
Total time: 6.591 secs
Subproject Path: CordovaLib
Downloading https://services.gradle.org/distributions/gradle-3.3-all.zip
...
产生原因
下载 gradle 是直接在 http://services.gradle.org/distributions/ 上下载的，由于国内网络的限制，而 gradle-x.x-all.zip 文件比较大（60M以上），因此下载的过程会比较漫长，有时候会下载失败（当然如果有梯子，这个问题应该就不存在了，但是下载应该也不会太快）。
解决方法
- 去 https://services.gradle.org/distributions/ 下载对应版本的 gradle，如
gradle-3.3-all.zip - 无需下载，放在项目下的
platforms/android/gradle目录下 - 找到项目下的
platforms/android/cordova/lib/builders/GradleBuilder.js，然后修改其中的var distributionUrl = process.env['CORDOVA_ANDROID_GRADLE_DISTRIBUTION_URL'] || 'http\://services.gradle.org/distributions/gradle-2.14.1-all.zip';为var distributionUrl = process.env['CORDOVA_ANDROID_GRADLE_DISTRIBUTION_URL'] || '../gradle-3.3-all.zip';
参考资料
https://www.cnblogs.com/macq/p/6494798.html
问题4
gradle 构建时下载 maven 太慢
产生原因
依然是网络的原因。
解决方法
- 使用国内阿里云的服务，修改项目下的
platformsandroiduild.gradle为：
buildscript {
repositories {
maven{ url 'http://maven.aliyun.com/nexus/content/groups/public/'}
}
}
allprojects {
repositories {
maven{ url 'http://maven.aliyun.com/nexus/content/groups/public/'}
}
}
参考资料
https://www.cnblogs.com/Ave-Maria/p/6274621.html
问题5
Execution failed for task ':app:processDebugResources'. > Failed to execute aapt
产生原因
暂时不清楚。
解决方法
在 /platforms/android 中新建 build-extras.gradle 文件，并添加如下内容：
configurations.all {
resolutionStrategy {
force 'com.android.support:support-v4:27.1.0'
}
}
如果是 cordova-android 7.0.0，则也要在 /platforms/android/app 中新建 build-extras.gradle 文件。
参考资料
问题6
Error: cmd: Command failed with exit code 1 Error output:
Exception in thread "main" java.lang.RuntimeException: Timeout of 120000 reached waiting for exclusive access to file: C:Userslaixiangran.gradlewrapperdistsgradle-3.3-all55gk2rcmfc6p2dg9u9ohc3hw9gradle-3.3-all.zip
at org.gradle.wrapper.ExclusiveFileAccessManager.access(ExclusiveFileAccessManager.java:65)
at org.gradle.wrapper.Install.createDist(Install.java:48)
at org.gradle.wrapper.WrapperExecutor.execute(WrapperExecutor.java:107)
at org.gradle.wrapper.GradleWrapperMain.main(GradleWrapperMain.java:61)
产生原因
主要还是网络原因，导致无法在 C:Users你的用户名.gradlewrapperdistsgradle-3.3-all55gk2rcmfc6p2dg9u9ohc3hw9 中解压 gradle-3.3-all.zip
解决方法
- 去 https://services.gradle.org/distributions/ 下载对应版本的 gradle，如
gradle-3.3-all.zip - -然后在
C:Users你的用户名.gradlewrapperdistsgradle-3.3-all55gk2rcmfc6p2dg9u9ohc3hw9中解压
问题7
Error:Could not find common.jar (android.arch.core:common:1.1.0).
Searched in the following locations:
https://jcenter.bintray.com/android/arch/core/common/1.1.0/common-1.1.0.jar
产生原因
在 platformsandroiduild.gradle 中有这样的几行代码：
allprojects {
repositories {
jcenter()
maven { url "https://maven.google.com" }
}
}
报错的信息表明在 jcenter() 对应的仓库中无法找到 common.jar，导致 gradle 在编译时就直接报错，而不会再往下执行，但其实执行到 maven { url "https://maven.google.com" } 时就可以找到 common.jar。
解决方法
将 jcenter() 放在最后面，修改之后的代码：
allprojects {
repositories {
maven { url "https://maven.google.com" }
jcenter()
}
}