Android 版本配置详解

369 阅读2分钟

Android 版本配置详解

在 Android 项目中,以下三个配置项决定了应用的兼容性和行为:

compileSdkVersion = xx
targetSdkVersion = xx
minSdkVersion = xx

1. compileSdkVersion

  • 作用:指定 Gradle 使用哪个 API 级别来编译你的应用。
  • 影响:仅与编译阶段有关,不影响运行时行为。
  • 使用:设置为最新的 API 级别可以帮助你在编译时检查代码错误和警告,并准备使用最新的 API。例如,如果你想使用 Android 10 中新增的API,只需将 compileSdkVersion 设置为 29。
compileSdkVersion = 29
  • 注意compileSdkVersion 只决定编译时检查,不影响应用在不同 Android 系统上的运行表现。应用的运行行为由 targetSdkVersion 决定。

2. minSdkVersion

  • 作用:指定应用可以运行的最低 Android 设备 API 级别。
  • 影响:低于此版本的设备将无法安装该应用。如果应用尝试在低于 minSdkVersion 的设备上运行,会因访问不可用的 API 而崩溃。
minSdkVersion = 19
  • 使用:设置为你希望支持的最低 Android 版本。随着时间推移,可以根据需求向后调整,以支持更多新设备。

3. targetSdkVersion

  • 作用:指定应用在目标设备上的运行行为应遵循的 API 级别。
  • 影响:决定 Android 运行时的行为和展示效果。例如,在 Android 6.0 及以上版本中,使用 Runtime 权限模型,如果 targetSdkVersion >= 23,就必须处理动态权限请求。
targetSdkVersion = 29
  • 注意:设置为较高的版本可以确保应用在新系统上遵循最新的框架和行为模式,但需要仔细测试和处理不兼容的变化。

总结

  • compileSdkVersion:仅影响编译时,不影响运行时行为。建议设置为最新的 API 级别。
  • minSdkVersion:指定支持的最低 API 级别,设备低于此版本无法安装和运行应用。
  • targetSdkVersion:决定应用的运行时行为和功能特性,应该设置为应用经过全面测试的最高版本。

通过合理设置这三个版本配置项,可以确保应用在不同 Android 系统版本上的兼容性和最佳运行效果。