android运行项目环境及版本报错与解决

? 当运行一个新的项目时，我们经常会遇到gradle相关的报错，常见为can't download或是can't get sourcexx导致项目无法编译，所以本文对刚开始编写安卓项目时遇到的环境问题作整理以及解决。

问题背景：当学习他人的项目或者为了和项目合作者在相同运行环境导入外部项目

1.项目导入编译时

• Could not install Gradle distribution from 'https://services.gradle.org/distributions/gradle-5.4.1-all.zip'.

  • 问题描述：无法下载5.4.1版本的gradle

  • 可能原因：

    • 网络问题，gradle服务器或是代理仓库在国外，导致下载不下来
    • gradle与gradle plugin版本不匹配

  • 解决方案：

    • 将依赖换成国内的镜像源；

      • 下列为我搜索多个博客获得的多个依赖地址，具体网址已经找不到

      在build.gradle(项目名)文件夹下的buildscript

    1. 与项目合作者相同环境的情况，一般会使用一些常用框架

       repositories {
           maven { url 'https://maven.aliyun.com/repository/public' }
           maven { url 'https://developer.huawei.com/repo/' }
           google()
               mavenCentral()
       }
       

    2. 采用国内镜像

       repositories {
           maven { url 'https://maven.aliyun.com/repository/google' }
           maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }
           maven { url 'https://gitee.com/liuchaoya/libcommon/raw/master/repository/' }
           maven { url "https://www.jitpack.io" }
           jcenter()
       }
       

    3. 阿里云代替goodle、jcenter

       repositories {
           maven {url 'https://maven.aliyun.com/repository/jcenter'}
           maven {url 'https://maven.aliyun.com/repository/google'}
           maven {url 'http://maven.aliyun.com/nexus/content/repositories/jcenter'}
       }
       

    • 查看gradle与gradle plugin版本是否匹配

      详细可参考网址：彻底解决gradle与gradle plugin匹配关系以及gradle下载缓慢的问题_gradle下载慢-CSDN博客

      • gradle版本的定义在gradle.wrapper.gradle-wrapper.properties

    

    • gradle插件版本的定义在build.gradle（项目名）文件里
      

    • 注：如果报错提示没有说明gradle plugin等的字眼，则该匹配关系大概率没有错

  • 如果上诉方案都没有起作用，可能是下载的android studio有问题，则可以手动将gradle文件下载导入对应的配置文件夹，或者修改为文件夹中已有的gradle版本

    • 自行下载文件导入对应配置文件夹下，默认目录是C:\Users\user\.gradle\wrapper\dists

    • 项目运行的时候，也会遇到一些找不到某文件等的错误
      如Can‘t determine type for tag ‘＜macro name=“m3_comp_bottom_app_bar_container_color“>
      原因则是导入的第三方依赖库版本太高了，不匹配，需要修改版本

• 说明：

  上述问题仅是某一问题的案例，常见的还有无法下载某网址或者HttpRequestException网络异常等报错，如下：

  • org.gradle.internal.resource.transport.http.HttpRequestException：Could not GET ‘xxx.jar’
  • Could not get source 'https://..'、Could not HEAD 'https://...等

  涉及以上相关的，都是因为网络问题导致某些资源文件下载不下来，修改上方解决方案的依赖仓库则可以解决大部分问题。

• 一般直接修改仓库地址就可以解决问题，但刚接触的时候搜不到最根本影响的，可能根据搜到的乱修改产生其他的问题，如gradle版本升级等。

  这个时候就要根据产生的错误提示来对症找解决方法。

  • 如，要是根据android studio的提示升级了gradle版本，则可能会造成plugin版本不对应，错误提示类似：
    • ``Could not resolve all artifacts for configuration ‘:classpath’. …gradle-bintray-plugin:1.8.0`
    • Cause: unable to find valid certification path to requested target
      • 参考链接：关于AndroidStudio Cause: unable to find valid certification path to requested target 报错的解决方法-CSDN博客

2.项目运行的时候

1.导入的第三方依赖库版本过高

• resource android:color/system_neutral1_1000 not found.

• Can‘t determine type for tag ‘＜macro name=“m3_comp_bottom_app_bar_container_color“

  • 原因分析：导入的第三方框架版本太高，与项目中的配置不匹配

  • 解决：降低版本，与appcompat、material版本匹配

    • 解决方法参考：https://blog.csdn.net/weixin_44440669/article/details/127753568

    在build.gradle(:app)的dependencies

    dependencies {
    	//appcompat等的版本
        implementation 'androidx.appcompat:appcompat:1.3.0'
        implementation 'com.google.android.material:material:1.4.0'
        //导入的第三方框架的版本
        implementation 'com.squareup.retrofit2:retrofit:2.5.0'
        implementation 'com.squareup.retrofit2:converter-gson:2.0.2'
    }
    

2.新建项目时sdk版本太高

• Installed Build Tools revision 31.0.0 is corrupted.
• Manifest merger failed : Apps targeting Android 12 and higher are required to specify an explicit
  • 原因分析：可能sdk版本太高，和其他依赖库版本不匹配，所以降低版本即可
  • 参考链接：resource android:color/system_neutral1_1000 not found._aapt: error: resource android:color/system_neutral-CSDN博客

3. 低版本可运行环境

build.gradle(:app)

android {
    compileSdkVersion 29
    buildToolsVersion "29.0.3"
    defaultConfig {

        applicationId "com.example.booktest"
        minSdkVersion 26
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
        ...
    }
    ...
}
//dependencies版本降低
dependencies {

    implementation 'androidx.appcompat:appcompat:1.3.0'
    implementation 'com.google.android.material:material:1.4.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.2'
}

3.导入版本较久远的低版本项目

• 例如：https://github.com/HouBin506/SocketPushClient

1. 在vscode修改gradle版本和sdk版本，
2. 修改为androidx：
   1. pro中添加运行解决：This project uses AndroidX dependencies, but the ‘android.useAndroidX’ property is not enabled.-CSDN博客
   2. build中修改Configuration ‘androidTestCompile’ is obsolete and has been replaced with 'androidTestImplementation-CSDN博客
   3. import修改Android Studio 3.4升级后的运行问题解决办法_解决android studio 升级过后support.v4以及support.v7爆红不能使用-CSDN博客
   4. 总的步骤总结：
      https://blog.csdn.net/u011041494/article/details/93849730