compileSdkVersion
- compileSdkVersion 告诉 Gradle 使用哪个 Android SDK 版本编译你的应用,也就是你引入的 android.jar 的版本。
- 如果你在项目要使用某一个版本的 Android SDK 新添加了的 API,compileSdkVersion 必须大于等于这个版本号,否则会报错,因为这个 API 只有更新版本的 android.jar 里才有。
compileSdkVersion 属性只在编译时起作用,而不会影响应用运行时的行为。 - 如果使用 Support Library ,那么使用最新发布的 Support Library 就需要使用最新的 SDK 编译。例如,要使用 23.1.1 版本的 Support Library ,compileSdkVersion 就必需至少是 23 (大版本号要一致!)。通常,新版的 Support Library 随着新的系统版本而发布,它为系统新增加的 API 和新特性提供兼容性支持。
targetSdkVersion
- targetSdkVersion 表示的你的应用能够适配的系统版本。比如你把 targetSdkVersion 设置为 23 或以上,表示你已经针对 Android 6.0 的运行时权限机制进行了适配。
- 如果系统的 API Level 高于你的应用程序中的 targetSdkVersion ,系统会开启兼容行为来确保你的应用程序继续以期望的形式来运行。
minSdkVersion
- minSdkVersion 指定应用运行所需的最低 API level。
如果系统的 API level 低于 minSdkVersion 设定的值,那么 Android 系统会阻止用户安装这个应用。 - 在开发时如果你使用了高于 minSdkVersion 的 API 时 lint 会警告你,帮你避免调用不存在的 API 的运行时问题。如果只在较高版本的系统上才使用某些 API,通常使用运行时检查系统版本的方式解决。
总结
minSdkVersion 决定应用能安装的最低 API level,同时在调用高于 minSdkVersion 版本的 API 时会给出警告。
compileSdkVersion 在应用编译的时候起作用,决定你是否能使用某一个版本的新 API。
targetSdkVersion 在应用运行时期起作用,系统根据这个属性决定要不要以兼容模式运行这个应用。
三个值应符合以下关系:
minSdkVersion <= targetSdkVersion <= compileSdkVersion
如果要适配 Android 6.0 的运行时权限机制, 则设置 compileSdkVersion >= 23(使项目能使用 requestPermissions() 等新 API), targetSdkVersion >= 23(告诉系统该应用已经适配 Android 6.0,请放心使用运行时权限机制)。