理解 Android 版本号与 API 版本号的区别

在 Android 开发中，了解 Android 版本号和 API 版本号的区别是非常重要的，尤其对于刚入行的小白来说。本文将系统性地向你解释这两个概念的异同，并提供实现的具体步骤和代码示例。

版本号与 API 版本号的概念

  • Android 版本号（如：Android 10, Android 11）：这指的是 Android 操作系统的发布版本，每个版本通常会有一个对应的代号，比如 Android 10 代号为 “Q”。

  • API 版本号：这是一个数字，表示 Android SDK 的版本号，通常与 Android 版本号相对应。例如，Android 10 的 API 级别是 29，Android 11 的 API 级别是 30。

二者关系

理解这两者的关系非常重要，一般情况下，API 级别会随着 Android 版本的发布而提升。开发者在应用中可以通过 API 版本号来判断代码段的可用性。

实现步骤概览

步骤描述
步骤1创建一个新的 Android 项目
步骤2在项目中找到 build.gradle 文件
步骤3获取版本号与 API 版本号
步骤4在需要的地方使用版本号与 API 版本号
步骤5运行并测试应用

步骤详解

步骤1：创建一个新的 Android 项目

在 Android Studio 中，打开 IDE，选择 “Start a new Android Studio project”，并根据提示选择适合的模板。完成项目的创建。

步骤2：在项目中找到 build.gradle 文件

找到并打开项目根目录下的 build.gradle 文件。在这里你可以找到与版本号和 API 版本相关的设置。

android {
    compileSdkVersion 30 // 设置编译时使用的 SDK 版本，这里使用 API 30

    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 21 // 设置最低支持的 API 版本
        targetSdkVersion 30 // 设置应用针对的 API 版本
        versionCode 1 // 应用的版本号
        versionName "1.0" // 应用的版本名称
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.

代码解释：

  • compileSdkVersion：编译时使用的 API 版本。
  • minSdkVersion：应用支持的最低 API 版本。
  • targetSdkVersion：应用针对的目标 API 版本。
  • versionCode 和 versionName：分别表示应用的版本代码和版本名称。
步骤3：获取版本号与 API 版本号

接下来，在你的 Activity 文件中，我们将获取当前设备的 Android 版本号和 API 版本号。你可以在 MainActivity.java 中添加以下代码：

import android.os.Build;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 获取 Android 版本号
        String androidVersion = Build.VERSION.RELEASE; // 获取 Android 的版本号
        int apiVersion = Build.VERSION.SDK_INT; // 获取当前的 API 版本号

        // 显示版本号信息
        TextView textView = findViewById(R.id.versionText);
        textView.setText("Android Version: " + androidVersion + "\nAPI Level: " + apiVersion);
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.

代码解释：

  • Build.VERSION.RELEASE：获取当前设备的 Android 版本号。
  • Build.VERSION.SDK_INT：获取当前设备的 API 版本号。
  • 使用 TextView 将版本号显示在应用界面上。
步骤4：在需要的地方使用版本号与 API 版本号

如果有条件判断需要在特定的 API 版本下执行不同的代码，可以使用以下示例：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    // Android 10 及以上版本的代码
    // 执行某些新特性
} else {
    // 低于 Android 10 的代码
    // 执行相应的兼容性处理
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

代码解释：

  • Build.VERSION_CODES.Q：代表 Android 10 的 API 级别。
  • 使用 if 语句来判断当前设备的 API 版本，并执行相应的代码。
步骤5：运行并测试应用

在完成以上步骤后，点击 Android Studio 的 Run 按钮，选择一个设备或模拟器来运行你的应用。在应用界面上，你将看到显示的 Android 版本号和 API 版本号。

总结

本文详细介绍了 Android 版本号与 API 版本号的区别，并通过具体的步骤展示了如何在你的 Android 应用中实现版本号的获取和应用。希望通过这篇文章，你能更好地理解这两个概念，并在开发中灵活运用。实践是最好的老师，鼓励你去尝试更多的功能！