如果你在Android项目中遇到了以下异常:
Caused by: org.gradle.api.internal.plugins.PluginApplicationException: Failed to apply plugin 'com.android.internal.application'.
并且在查看详细错误信息时发现:
Caused by: org.gradle.api.tasks.StopExecutionException: Your project path contains non-ASCII characters. This will most likely cause the build to fail on Windows. Please move your project to a different directory. See http://b.android.com/95744 for details. This warning can be disabled by adding the line 'android.overridePathCheck=true' to gradle.properties file in the project directory.
问题背景
这个异常的根本原因是你的Android项目路径中包含非ASCII字符
,而这在Windows上的构建中会引发问题。
Gradle在构建过程中需要 处理文件路径 ,而非ASCII字符可能导致构建失败。因此,Gradle会在检测到这种情况时引发异常,以防止构建失败。
解决方案
要解决这个问题,你可以采取以下步骤:
-
移动项目到不包含非ASCII字符的路径:最简单的解决方案是将你的Android项目移动到一个
不包含非ASCII字符
的路径下。这可以通过将项目文件夹复制到新的路径,然后从新的路径打开项目来完成。 -
使用 ‘android.overridePathCheck’ 属性:如果你无法或不想移动项目到不包含非ASCII字符的路径,你可以在项目的
gradle.properties
文件中添加以下行:android.overridePathCheck=true
这将告诉Gradle忽略路径中的非ASCII字符,允许你在包含这些字符的路径上构建项目。但请注意,这可能会在Windows上引发其他问题,因为非ASCII字符可能导致一些不兼容性问题。
步骤
下面是解决这个问题的具体步骤:
-
打开你的Android项目的根目录。
-
查找
gradle.properties
文件。如果没有这个文件,你可以在根目录下创建一个。
-
在
gradle.properties
文件中添加以下行:android.overridePathCheck=true
修改后,可直接点击
Try Again
-
保存并关闭文件。
-
重新构建你的Android项目。
现在,Gradle将忽略项目路径中的非ASCII字符,允许你在包含这些字符的路径上构建项目。
编译成功