Android SDK and API levels in Android Kotlin

Introduction

The Android SDK and API levels help your app work on different Android devices and versions.

When you want your app to run on many Android phones with different Android versions.

When you need to use new Android features that only work on newer versions.

When you want to make sure your app does not crash on older devices.

When you are testing your app on different Android versions.

When you update your app to support the latest Android features.

Syntax

Android Kotlin

android {
    compileSdk = 33
    defaultConfig {
        minSdk = 21
        targetSdk = 33
    }
}

compileSdk is the Android version your app is built against.

minSdk is the oldest Android version your app supports.

targetSdk is the Android version your app is tested for and optimized to run on.

Examples

This setup means the app supports Android 5.0 (API 21) and above, and is built for Android 13 (API 33).

Android Kotlin

android {
    compileSdk = 33
    defaultConfig {
        minSdk = 21
        targetSdk = 33
    }
}

This setup supports older devices from Android 4.1 (API 16) but targets Android 11 (API 30).

Android Kotlin

android {
    compileSdk = 30
    defaultConfig {
        minSdk = 16
        targetSdk = 30
    }
}

This means the app only runs on Android 13 (API 33) and above.

Android Kotlin

android {
    compileSdk = 33
    defaultConfig {
        minSdk = 33
        targetSdk = 33
    }
}

Sample App

This is a simple Android app setup in Kotlin that supports devices with Android 5.0 (API 21) and newer.

Android Kotlin

plugins {
    id("com.android.application")
    kotlin("android")
}

android {
    compileSdk = 33

    defaultConfig {
        applicationId = "com.example.sdkapilevel"
        minSdk = 21
        targetSdk = 33
        versionCode = 1
        versionName = "1.0"
    }
}

fun main() {
    println("App supports Android API 21 and above.")
}

Important Notes

Always test your app on devices or emulators with different API levels to catch compatibility issues.

Using a higher compileSdk lets you use new Android features but does not affect which devices can install your app.

Setting minSdk too high limits your app to fewer devices, but setting it too low may require extra work to support old versions.

Summary

The Android SDK and API levels control which Android versions your app supports and uses.

compileSdk is the version you build against, minSdk is the oldest supported version, and targetSdk is the version your app is optimized for.

Choosing the right API levels helps your app reach more users and use new features safely.

Practice

1. What does the minSdk version specify in an Android app?

easy

A. The latest Android version available

B. The Android version you compile your app against

C. The Android version your app is optimized for

D. The oldest Android version your app can run on

Solution

1. Step 1: Understand minSdk meaning

   minSdk defines the minimum Android version that can run the app.

2. Step 2: Differentiate from other SDK versions

   compileSdk is for building, targetSdk is optimization, but minSdk is the oldest supported version.

3. Final Answer:

   The oldest Android version your app can run on -> Option D

4. Quick Check:

   minSdk = oldest supported version [OK]

Hint: minSdk means minimum Android version supported [OK]

Common Mistakes:

• Confusing minSdk with compileSdk
• Thinking minSdk is the target optimization version
• Assuming minSdk is the latest Android version

2. Which of the following is the correct way to set the compileSdk version to 33 in a Kotlin DSL Gradle file?

easy

A. compileSdkVersion 33

B. compileSdkVersion = 33

C. compileSdk = 33

D. compileSdk(33)

Solution

1. Step 1: Identify Kotlin DSL syntax for compileSdk

   In Kotlin DSL, compileSdk is assigned directly with =.

2. Step 2: Compare options

   compileSdkVersion 33 is Groovy syntax without assignment, compileSdkVersion = 33 uses the wrong property name, and compileSdk(33) is invalid function call syntax. Only compileSdk = 33 is correct.

3. Final Answer:

   compileSdk = 33 -> Option C

4. Quick Check:

   Kotlin DSL uses compileSdk = 33 [OK]

Hint: Kotlin DSL uses equals sign for assignments [OK]

Common Mistakes:

• Using Groovy syntax in Kotlin DSL
• Omitting equals sign
• Using method call syntax incorrectly

3. Given this Gradle configuration snippet:

android {
  compileSdk = 31
  minSdk = 21
  targetSdk = 30
}

What is the highest Android version your app is optimized for?

medium

A. 30

B. 21

C. 31

D. Cannot determine from this

Solution

1. Step 1: Identify meaning of targetSdk

   targetSdk is the Android version the app is optimized for and tested against.

2. Step 2: Check given values

   Here, targetSdk is 30, so the app is optimized for Android 30.

3. Final Answer:

   30 -> Option A

4. Quick Check:

   targetSdk = 30 means optimized for Android 30 [OK]

Hint: targetSdk shows optimization version, not compileSdk [OK]

Common Mistakes:

• Confusing compileSdk with targetSdk
• Thinking minSdk is optimization version
• Choosing compileSdk as optimization version

4. You set minSdk = 30 but want your app to run on Android 21 devices. What is the problem in this Gradle config?

android {
  compileSdk = 33
  minSdk = 30
  targetSdk = 33
}

medium

A. compileSdk must be lower than minSdk

B. minSdk is too high, app won't run on Android 21

C. targetSdk must be equal to minSdk

D. No problem, app runs on all versions

Solution

1. Step 1: Understand minSdk role

   minSdk sets the lowest Android version the app supports.

2. Step 2: Check compatibility with Android 21

   Since minSdk is 30, devices with Android 21 cannot run the app.

3. Final Answer:

   minSdk is too high, app won't run on Android 21 -> Option B

4. Quick Check:

   minSdk = 30 excludes Android 21 devices [OK]

Hint: minSdk must be ≤ lowest Android version supported [OK]

Common Mistakes:

• Thinking compileSdk affects device compatibility
• Assuming targetSdk limits device support
• Believing app runs on all versions regardless of minSdk

5. You want to use a new Android feature introduced in API level 31 but still support devices running API level 21. How should you configure your Gradle file to safely use this feature?

hard

A. Set minSdk = 21, targetSdk = 31, and use runtime checks for API 31 features

B. Set minSdk = 21 and targetSdk = 21

C. Set minSdk = 31 and targetSdk = 31

D. Set compileSdk = 21 and minSdk = 31

Solution

1. Step 1: Understand minSdk and targetSdk roles

   minSdk is the oldest supported version; targetSdk is the optimized version.

2. Step 2: Use runtime checks for new features

   To support API 21 devices but use API 31 features, keep minSdk = 21, set targetSdk = 31, and check API level at runtime before using new features.

3. Step 3: Evaluate options

   Set minSdk = 21, targetSdk = 31, and use runtime checks for API 31 features correctly sets minSdk and targetSdk and mentions runtime checks. Others either restrict support or use wrong compileSdk.

4. Final Answer:

   Set minSdk = 21, targetSdk = 31, and use runtime checks for API 31 features -> Option A

5. Quick Check:

   minSdk low + targetSdk high + runtime checks = safe feature use [OK]

Hint: Use runtime API checks to support older devices safely [OK]

Common Mistakes:

• Raising minSdk and losing older device support
• Not using runtime checks for new APIs
• Setting compileSdk lower than targetSdk