什么是.kotlin_builtins文件,我可以从我的uberjars中省略它们吗?

时间:2016-12-09 04:00:42

标签: gradle jar proguard kotlin shadowjar

我正在努力将proguard集成到我的gradle构建中,以便用Kotlin编写的应用程序。我发现proguard正在剥离Kotlin标准库(就像我在简单的Hello World程序中那样),但它在我的jar中留下了一堆文件扩展名为.kotlin_builtins的文件。当我配置我的gradle任务以排除这些文件时,程序仍然可以正常工作。这些文件是什么,必须与我的可执行文件uberjar一起发货?

这是我的build.gradle文件的内容供参考:

buildscript {
   ext.kotlin_version = '1.0.5'
   ext.shadow_version = '1.2.4'

   repositories {
    mavenCentral()
    maven {
        url "https://plugins.gradle.org/m2/"
    }
    flatDir dirs: "gradle/proguard"
   }

   dependencies {
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    classpath "com.github.jengelman.gradle.plugins:shadow:$shadow_version"
    classpath ":proguard:"
   }
}

apply plugin: 'kotlin'
apply plugin: 'application'
apply plugin: 'com.github.johnrengelman.shadow'

mainClassName = 'namespace.MainKt'

defaultTasks 'run'

repositories {
    mavenCentral()
}

dependencies {
    compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
    testCompile "junit:junit:4.12"
    testCompile "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version"
}

shadowJar {
    exclude 'kotlin/**/*.kotlin_builtins'
    exclude '.keep'
}

task minify(type: proguard.gradle.ProGuardTask, dependsOn: 'shadowJar') {
    libraryjars "${System.getProperty('java.home')}/lib/rt.jar"

    injars  'build/libs/artful-all.jar'
    outjars 'build/libs/artful-all.out.jar'

    printmapping 'build/libs/out.map'

    keepclasseswithmembers 'public class * { \
        public static void main(java.lang.String[]); \
    }'

    assumenosideeffects 'class kotlin.jvm.internal.Intrinsics { \
        static void checkParameterIsNotNull(java.lang.Object, java.lang.String); \
    }'
}

2 个答案:

答案 0 :(得分:9)

这些文件包含标准("内置")Kotlin类的声明数据,这些类未编译为.class文件,而是映射到平台上的现有类型(在这种情况,JVM)。例如,kotlin/kotlin.kotlin_builtins包含包kotlin中非物理类的信息:IntStringEnumAnnotation,{{ 1}}等等。

使用这些文件时有两种主要方案:

1)编译器在类路径上从Collection查找它们,以确定哪些内置声明可用。

2)反射库(kotlin-runtime)将这些文件作为资源加载,以提供内置声明的反射功能。例如,kotlin-reflect完全以与Kotlin编译器看到这些成员相同的方式返回类String::class.members的所有成员(尽管事实上没有kotlin.String文件及其& #39;在字节码中删除为kotlin/String.class

第一点显然不适用于您的情况。如果您不对内置类使用反射,我认为将java.lang.String文件完全排除在生成的jar中是安全的。

答案 1 :(得分:0)

您可以从您的JAR / APK中优化/省略这些:

  packagingOptions {
    exclude "/META-INF/*.kotlin_module"
    exclude "**/kotlin/**"
  }

更好:

  packagingOptions {
    exclude "/META-INF/*.kotlin_module"
    exclude "**/kotlin/**"
    exclude "**/*.txt"
    exclude "**/*.xml"
    exclude "**/*.properties"
  }

来源:https://github.com/jaredsburrows/android-gif-example/blob/master/build.gradle#L144