如何在Kotlin类中导入依赖Jar包内的顶层内联函数？

我之前也碰到过一模一样的情况——Jar里的Kotlin顶层内联函数在Java里能正常静态导入调用，但到了Kotlin代码里怎么导都识别不了，折腾了好久才搞明白原因。

为啥会出现这种差异？ #

Kotlin的顶层函数编译后会被自动打包到一个和文件名同名的类里（比如你的KotlinClass），Java只认字节码层面的静态方法，所以不管元数据有没有问题都能调用。但Kotlin编译器需要读取Kotlin专属的元数据才能识别这是个顶层内联函数，一旦依赖Jar打包时没保留这些元数据，或者用了有bug的旧版Kotlin编译器编译，Kotlin就认不出这个函数了。

而你自己本地创建的Kotlin文件，编译器会自动生成并保留完整的元数据，所以导入完全正常，这就是本地和Jar依赖的核心区别。

具体解决办法 #

1. 绕过导入直接调用（最快见效） #

如果暂时没法修改依赖Jar，直接用字节码层面的类名调用就行，和Java的逻辑一致：

io.pack.KotlinClass.every<String>()

这种方式不需要导入，直接通过生成的包装类访问静态方法，百分百能生效。

2. 修复依赖Jar的编译配置（如果你能控制Jar的构建） #

要是这个Jar是你自己维护的，那只要调整编译配置，确保Kotlin元数据被正确保留：

• 首先把Kotlin编译器版本升级到1.3及以上（更早版本的内联函数元数据处理有已知bug）
• 然后在Gradle配置里添加参数，强制生成完整的JVM类型注解：

  // Gradle Kotlin DSL
  kotlin {
      jvm {
          compilations.all {
              kotlinOptions {
                  freeCompilerArgs += "-Xemit-jvm-type-annotations"
              }
          }
      }
  }
  

  要是用Groovy DSL的话：

  // Gradle Groovy DSL
  kotlin {
      jvm {
          compilations.all {
              kotlinOptions {
                  freeCompilerArgs += '-Xemit-jvm-type-annotations'
              }
          }
      }
  }
  

  重新打包Jar后，其他Kotlin项目就能正常导入io.pack.every或者io.pack.KotlinClass.every了。

3. 尝试显式导入包装类的静态方法 #

如果是第三方Jar，没法修改的话，可以再试一次显式导入包装类的方法（有时候是IDE缓存的问题）：

import io.pack.KotlinClass.every

要是还是不行，就直接用方案1的全限定调用方式，这是最稳妥的。

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