为何将minSdkVersion设为21时Android Launcher Shortcuts代码仍可编译？

你观测到的“将minSdkVersion从25改为21后应用仍可编译运行”的现象，是多个Android构建、运行机制叠加导致的，和应用本身是否满足API兼容要求没有直接关系，具体原因分三点：

• Android Gradle插件的编译期API检查不是强制硬拦截
  正常情况下，当代码中调用了高于当前minSdkVersion的系统API时，lint工具会标记NewApi类型的兼容性告警，但默认配置下这类告警不会触发编译失败。你修改minSdkVersion为21后，编译流程不会因为代码里引用了API25新增的ShortcutManager等类就直接报错，只要没有手动开启“将API检查告警设置为编译阻断级别”的配置，整个编译流程就会正常走完。
• 官方示例本身内置了运行时版本防护逻辑
  你使用的AppShortcuts示例代码，在所有涉及Launcher Shortcuts API的调用位置，都提前加了Build.VERSION.SDK_INT >= Build.VERSION_CODES.N_MR1（即API25）的判断分支。这段逻辑的作用是：当应用运行在低于API25的系统上时，直接跳过所有Shortcuts相关的类加载和方法调用，走普通降级流程，不会直接触发高版本API的访问。
• 类加载的懒加载机制避免了启动阶段的直接崩溃
  Android的类加载采用懒加载模式：只有当代码实际运行到需要加载某个类的逻辑时，系统才会去加载对应的类文件。哪怕代码里import了API25才新增的Shortcut相关类，只要运行时被版本判断逻辑拦截、没有实际执行到这段代码，系统就不会触发类加载流程，应用的主启动流程完全可以正常跑通，不会一打开就崩溃。

这里存在两个常见的认知盲区：

1. 你测试时使用的设备/模拟器大概率是API25及以上版本，自然不会感知到低版本系统的兼容性问题；
2. 编译通过不代表应用对minSdk声明范围内的所有设备都合规。如果把修改后的应用装到API21~24的设备上，只要代码里某一处漏写了版本判断、触发了Shortcuts API的实际调用，就会直接抛出NoClassDefFoundError/NoSuchMethodError类的运行时崩溃。

官方项目将minSdkVersion设为25，本质是从安装环节做拦截：避免API25以下的设备用户下载安装该应用，从根源上杜绝这类兼容性崩溃的可能。将minSdk改为21后，应用会开放给所有API21以上的设备下载安装，但其中API21~24的设备根本不具备Launcher Shortcuts的运行能力，这也是官方不会刻意降低minSdkVersion的核心原因。

内容的提问来源于stack exchange，提问作者HelloCW