Android:compileSdkVersion、buildToolsVersion、minSdkVersion与targetSdkVersion

Android开发常用的几种 Version

  • compileSdkVersion
  • buildToolsVersion
  • minSdkVersion
  • targetSdkVersion

下面一一详细介绍这些 Version 所代表的意义

compileSdkVersion

顾名思义,就是用来编译源代码所使用的 API 版本。也就是说在写代码的时候,所引入的 android.jar 的版本。这个只是编译期间使用,并不是真实设备上运行 APK 的 API Version。真实设备运行的永远是烤制的 ROM 的版本。

那么什么是编译期间使用的 API 版本呢,我举个例子说明:

假如 API 19 有一个这样的方法:

public void print(String message) {
    Log.d("xxx", message);
}

然后 API 20 对这个方法进行的改进

public void print(String message, int option) {
    if (option & 1 == 1){
        Log.d("xxx", message);
    }
}

那么当你写代码调用这个 print(message) 的方法的时候,如果 compileSdkVersion 指定的是 19,那么编译就不会出现问题;而如果 compileSdkVersion 指定的是20,那么就会编译不过,并且 AndroidStudio 会给一个错误的提示。

当然了,事实上 Google 是不会这样暴力的直接将一个方法进行修改或删除,通常是会在原方法标记一个 @Deprecated 用来警告开发者这个方法被废弃了,当前 API Version 是可以正常调用的,但是也许将来的某个版本会直接删除。然后再指向一个新增的用于替代的方法。此时虽然我们还能继续使用该方法,但是 AndroidStudio 会给一个警告。

至于为什么 compileSdkVersion 并不会影响真实运行的 API Version 呢,因为 android.jar 只是为了让我们写的代码能够成功生成 class 文件,真实运行的其实是设备上 的 ROM 包,我们可以看到 android.jar 有很多类其实就只是一个空方法,并没有具体的实现。比如 BaseDexClassLoader 类。

buildToolsVersion

顾名思义,就是构建工具的版本。所谓的构建工具其实就是指我们 sdk 下面的 build-tools 目录。我的 build-tools 目录就有以下的版本

23.0.3 25.0.0 25.0.2 26.0.2 27.0.3 28.0.2

这个 build-tools 里面包含了我们打包构建所需要的一些工具,比如:

  • aapt: Android Asset Packaging Tool,也就是资源打包工具,将资源文件打包成 R.java 以及 .arsc资源文件
  • aidl: 将 aidl 文件 编译为 java 接口类
  • dx: 将 class 文件打包成 dex 文件
  • apksigner: 将 打包成的 apk 文件进行签名
  • zipalign: 将 签名后的 apk 文件进行 zip 对齐,加快访问速度

buildToolsVersion 就是指定这些构建工具的版本

minSdkVersion

顾名思义,就是最小支持的 API 版本,这个值直接决定了你的 APK 是否能够安装在设备上。

比如说,minSdkVersion 指定为 19,而设备的 API Version 为16,那么安装此 APK 文件就会失败。

在编写代码的时候,如果 minSdkVersion 指定为 19,而要引入的一个方法是 API 20 才新增的,此时你把 compileSdkVersion 设置为 20,代码能够正常编译,但是 AndroidStudio 会给一个警告。

这是因为,minSdkVersion 指定为 19,也就会有 API 19 的设备安装此 APK,但是运行到那个 API 20 才引入的方法时,因为 API 19 是没有这个方法的,就会产生 MethodNotFoundException 异常而崩溃。

这个情况只能我们手动的进行差异化处理了:

if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.KITKAT_WATCH) {
    // 大于 20,直接调用方法
    invokeMethodWhenAPIGreatThan20();
} else {
    // 小于 20,只有自己手动实现或者调用其他方法
    invokeMethodCustom();
}

通常来讲,如果你把 minSdkVersion 设置得足够低,那么你的 APK 就能尽量地覆盖市场上大部分的设备,但是因为低版本的 API 缺少很多高版本新增的高效工具、或者存在很多在低版本存在的缺陷却在高版本解决了的,那么你就需要自己去实现这些高效工具或者自己去想办法解决这些缺陷。如果你想用高版本的方法,把 compileSdkVersion 设置得足够高,那么你的代码中就会大量充满上面的处理兼容性的代码。

这里我们也可以得出一个结论,就是 minSdkVersion 一定比 compileSdkVersion 小。想想也就明白了,minSdkVersion 都指定了最小可安装的版本了,如果 compileSdkVersion 还比 minSdkVersion 小了,那么编译出来的 APK,谁还能用啊?

targetSdkVersion

这里面所有的版本,也许就是 targetSdkVersion 最难理解了。用官方的描述来讲的话:

targetSdkVersion is the main way Android provides forward compatibility

什么意思呢? targetSdkVersion 是 Android 系统提供前向兼容的主要手段。随着 Android 系统的升级,某个系统的 API 或者模块的行为可能会发生改变,但是为了保证老 APK 的行为还是和以前兼容。只要 APK 的 targetSdkVersion 不变,即使这个 APK 安装在新 Android 系统上,其行为还是保持老的系统上的行为,这样就保证了系统对老应用的前向兼容性。

回到最开始的例子,假如 API 19 有一个这样的方法:

public void print(String message) {
    Log.d("xxx", message);
}

在 API 20 的时候,如果 google 想改变这个方法的行为,除了上面所说的方式:给这个方法加一个 @Deprecated,然后指向一个新增的方法外。还可以用另外一种方式来做

public void print(String message) {
    final int targetSdkVersion = ctx.getApplicationInfo().targetSdkVersion;
    if (targetSdkVersion >= android.os.Build.VERSION_CODES.KITKAT_WATCH) {
        MyLog.d("xxx", message);
    } else {
        Log.d("xxx", message);
    }
}

首先获取我们配置的 targetSdkVersion,如果大于等于 20,就调用新的打印方法,否则就用旧的打印方式。

这样的话,即使我们设备的 API Version 是 20,但是只要设置的 targetSdkVersion 指定的是 19,那么还是会使用旧的方式而非新的方式。这就是前向兼容性。也可以说 targetSdkVersion 指定了我们希望的 API 所呈现的版本形式,但是只能向前。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,948评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,371评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,490评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,521评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,627评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,842评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,997评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,741评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,203评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,534评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,673评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,339评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,955评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,770评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,000评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,394评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,562评论 2 349

推荐阅读更多精彩内容