2 min read

Adding external packages to your app can make things easier for you and allows you to focus on the mission-critical feature of your app. But sometimes when you add the packages, you may face an issue that asks you to increase the Android minSdkVersion. This happens because the plugin requires a higher android sdk version for projects that were created before and after Flutter 2.8 update. So in this tutorial, we’ll see how to change Android minSdkVersion (flutter.minsdkversion) in Flutter.

Here’s what we’ll cover:

Ways to Change Android minSdkVersion (flutter.minsdkversion) in Flutter

There are two ways you can change Android minSdkVersion. The first one is for the projects that are created before Flutter 2.8 update and the second one is for the projects created after the Flutter 2.8 update.

For the Project Created Before Flutter 2.8 Update

Here are the steps to change minSdkVersion in Flutter for the project created before 2.8 update:

  1. Locate the build.gradle file under the project_folder/android/app/build.gradle 
  2. Find the defaultConfig section update the minSdkVersion to the new version.
  3. Inside the terminal, run the flutter clean command.
  4. Re-run your app.

Code Example: 

defaultConfig {
    applicationId "com.example.common_project"
    minSdkVersion 21 // <-- SEE HERE
    targetSdkVersion 30
    versionCode flutterVersionCode.toInteger()
    versionName flutterVersionName
}

Screenshot:

change android minsdkversion for projects before flutter 2.8. update

For the Projects Created After Flutter 2.8 Update

To change Android minSdkVersion in Flutter for the project created after the 2.8 update, you have to make changes in the local.properties file and then reference the new variable from the local.properties file inside the build.gradle file.

Here are the steps:

  1. Locate the local.properties file under the project_folder/android/local.properties
  2. Inside the local.properties file, add the line as flutter.minSdkVersion=21
  3. Now, open the build.gradle file under the project_folder/android/app/build.gradle
  4. Find the defaultConfig section update the minSdkVersion to the localProperties.getProperty(‘flutter.minSdkVersion’).toInteger().
  5. Inside the terminal, run the flutter clean command.
  6. Re-run your app.

Code Example: 

Under local.properties file
sdk.dir=/Users/pinkeshdarji/Library/Android/sdk
flutter.sdk=/Users/pinkeshdarji/Data/Development/flutter
flutter.buildMode=debug
flutter.versionName=1.0.0
flutter.versionCode=1
flutter.minSdkVersion=20 #new
-----------------------------
Under build.gradle file
defaultConfig {
    // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
    applicationId "com.example.sample_project"
    minSdkVersion localProperties.getProperty('flutter.minSdkVersion').toInteger()
    targetSdkVersion flutter.targetSdkVersion
    versionCode flutterVersionCode.toInteger()
    versionName flutterVersionName
}

Screenshot:

change android minsdkversion for projects after flutter 2.8. update

If you’re facing issues with Dart SDK configuration in your Flutter project, we’ve got you covered. Check out our blog post on ‘Dart SDK is not Configured in Flutter‘ to learn how to configure it properly.

Conclusion

In this tutorial, we saw how to change Android minSdkVersion (flutter.minsdkversion) in Flutter with practical examples. We explored both ways to change the SDK version in Android for the projects created before and after Flutter 2.8 update.

Would you like to check other interesting Flutter tutorials?

3 Ways to Create Multiline TextField in Flutter [2023 Code]
Remove Back Button on Appbar in Flutter – Right Way [2023]