Android Studio中ArrayMap.getOrDefault跳转Kotlin方法的原因及API适配疑问

为什么会出现这些现象？ #

1. 跳转至Kotlin扩展函数的原因 #

kotlin.collections.Map.getOrDefault()是Kotlin标准库为Map接口提供的扩展函数，而android.util.ArrayMap实现了java.util.Map接口。在Kotlin代码中调用该方法时：

• 如果变量声明为Map类型，编译器会优先匹配Kotlin的扩展函数，而非ArrayMap自身的成员方法；
• 即便变量是ArrayMap类型，IDE的索引逻辑也可能默认指向Kotlin扩展函数，而非ArrayMap在API24才新增的成员方法。

2. 无API级别警告的原因 #

• Java代码场景：android.util.ArrayMap的getOrDefault()是API24才新增的方法，但如果项目未开启Lint的NewApi检查，或者IDE未正确识别该方法的API限制，就不会弹出警告。此外，若通过Map接口调用该方法，Java编译器会认为是调用Java 8的Map默认方法，而Android要到API24才支持这套实现，低版本设备会直接抛出NoSuchMethodError。
• Kotlin代码场景：如果调用的是Kotlin扩展函数，它本身是全版本兼容的（内部通过get(key)和containsKey(key)实现逻辑），不会引发崩溃；但如果强制调用ArrayMap的原生方法（比如强转后调用），IDE未给出警告可能是因为编译SDK版本高于24且未开启低版本兼容性检查，或是IDE对Android原生类的API标记存在遗漏。

怎么解决？ #

1. 跳转到ArrayMap#getOrDefault()的正确定义 #

• 在Kotlin代码中将变量显式声明为ArrayMap类型（而非Map），再按住Ctrl（Windows）/Cmd（Mac）点击方法，IDE会优先跳转至android.util.ArrayMap的成员方法；
• 如果仍跳转错误，使用快捷键Ctrl+Alt+B（Windows）/Cmd+Option+B（Mac）打开「Go to Implementation」，手动选择android.util.ArrayMap的实现。

2. 调用时收到API级别警告 #

• 开启Lint的NewApi检查：在Module级别的build.gradle中配置：

  android {
      lintOptions {
          enable 'NewApi'
          // 可选：设置为true会在检测到问题时终止编译，false仅提示
          abortOnError false
      }
      defaultConfig {
          minSdkVersion 你的最低API版本
          targetSdkVersion 你的目标API版本
      }
  }
  

• 手动添加注解：如果是自定义的ArrayMap#getOrDefault()调用代码，给方法添加@RequiresApi(Build.VERSION_CODES.N)（N对应API24）注解，IDE会自动提示低版本兼容性问题；
• 优先使用Kotlin扩展函数：如果不需要依赖ArrayMap的原生实现，直接使用Kotlin标准库的getOrDefault()，它在所有API级别都能正常工作，不会触发崩溃；
• 低版本兼容实现：若要兼容API24以下设备，可自行实现兼容逻辑：

  fun <K, V> ArrayMap<K, V>.safeGetOrDefault(key: K, defaultValue: V): V {
      return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
          getOrDefault(key, defaultValue)
      } else {
          val value = get(key)
          if (value != null || containsKey(key)) value else defaultValue
      }
  }
  

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