Flutter 报错整合【持续更新】

1,821 阅读2分钟

前言

使用flutter开发过程中避免不了会报各种各样的错误,本文会持续更新错误信息与解决方法

001报错: uses-sdk:minSdkVersion 16 cannot be smaller than version 19 declared in library

当引入一个library时报uses-sdk:minSdkVersion 16 cannot be smaller than version 19 declared in library报这个错误。

err01

报错原因:

这是因为build.gradle文件中声明的minSdkVersion与build文件夹中AndroidManifest.xml文件生成的版本不同

build.gradle 文件

defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId "com.example.fushikang_flutter"
        minSdkVersion 16
        targetSdkVersion 28
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }

AndroidManifest.xml 文件

<uses-sdk
        android:minSdkVersion="19"
        android:targetSdkVersion="28" />
解决办法:

minSdkVersion改为 19 就好了, minSdkVersionandroid目录下app > main > build.gradle文件中

defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId "com.example.fushikang_flutter"
        minSdkVersion 19
        targetSdkVersion 28
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }

gradle 版本错误

gradle错误1

err2 这个错误是版本过低的问题,我们打开android/gradle/gradle-wrapper.properties文件。

错误1解决办法:

把最后一行的gradle-4.10.2-all.zip改为gradle-5.6.2-all.zip后,在把build目录和android目录下的.gradle目录删除重新编译。
注意:是.gradle不是gradle

#Fri Jun 23 08:50:38 CEST 2017
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-5.6.2-all.zip

除了以上的原因外,还有其他原因也会导致这个错误出现。例如:项目的应用图标大小与对应的图标目录不一致,在打包时也会出现这个问题,推荐使用插件自动生成应用图标。 flutter_launcher_icons

gradle错误2(2023-06-28)

image.png

错误2解决办法:

打开Android项目下的build.gradle文件,将插件版本设置为满足兼容要求的版本:

// 修改前 
classpath 'com.android.tools.build:gradle:4.1.3' 
// 修改后 
classpath 'com.android.tools.build:gradle:7.2.0'

具体原因可参考:blog.csdn.net/crasowas/ar…

Kotlin 错误(2023-06-28)

在维护项目的时候,我们可能会将旧的项目导入编译器中,没有错误提示。但是当我们编译运行到手机上的时候,可能会出现以下的问题: image.png 这个编译错误是表示ext.kotlin_version需要更新,这个项目里面的Kotlin没有办法适配,一般情况下,我们用最新的kotlin版本就好了

解决办法:

<app>/android/build.gradle文件中把 ext.kotlin_version 改为最新版本。kotlinlang.org/docs/releas… 查看kotlin最新版本

网络问题导致无法运行

问题1(2023-06-28)

这是因为网络问题导致有些包无法下载,最好的解决办法是 设置VPN代理(翻墙) image.png

启动页图片问题报错

 failed to read PNG signature: file does not start with PNG signature.

这个问题真是我不小心踩的坑,本来我的启动页图片是jpg文件,但是我把它改成了png图片。
项目开发过程中倒是没出什么问题,但是打包就出现以下的问题了 err4

解决办法:

把图片格式改回原来的格式就可以正常打包了