项目升级Kotlin所遇到的Hilt升级问题

在升级Kotlin版本为2.0+之后，将会遇到各种各样的问题，特收录主要问题。

问题1 ：Unsupported metadata version. Check that your Kotlin version is >= 1.0

问题描述

org.gradle.api.tasks.TaskExecutionException: Execution failed for task ':common:compileDebugKotlin

具体信息如下：

Caused by: java.lang.IllegalStateException: Unsupported metadata version. Check that your Kotlin version is >= 1.0
        at dagger.internal.codegen.kotlin.KotlinMetadata.metadataOf(KotlinMetadata.java:187)
        at dagger.internal.codegen.kotlin.KotlinMetadata.from(KotlinMetadata.java:165)
        at dagger.internal.codegen.kotlin.KotlinMetadataFactory.create(KotlinMetadataFactory.java:55)
        at dagger.internal.codegen.kotlin.KotlinMetadataUtil.isMissingSyntheticPropertyForAnnotations(KotlinMetadataUtil.java:75)
        at dagger.internal.codegen.validation.DependencyRequestValidator.missingQualifierMetadata(DependencyRequestValidator.java:104)
        at dagger.internal.codegen.validation.DependencyRequestValidator.validateDependencyRequest(DependencyRequestValidator.java:81)
        at dagger.internal.codegen.validation.InjectValidator.validateDependencyRequest(InjectValidator.java:350)
        at dagger.internal.codegen.validation.InjectValidator.validateField(InjectValidator.java:301)
        at dagger.internal.codegen.validation.InjectValidator.validateForMembersInjectionInternalUncached(InjectValidator.java:374)
        at dagger.internal.codegen.base.Util.reentrantComputeIfAbsent(Util.java:33)
        at dagger.internal.codegen.validation.InjectValidator.validateForMembersInjectionInternal(InjectValidator.java:361)
        at dagger.internal.codegen.validation.InjectValidator.validateUncached(InjectValidator.java:142)
        at dagger.internal.codegen.base.Util.reentrantComputeIfAbsent(Util.java:33)
        at dagger.internal.codegen.validation.InjectValidator.validate(InjectValidator.java:137)
        at dagger.internal.codegen.validation.InjectValidator.validateForMembersInjection(InjectValidator.java:356)
 

看到关键字dagger 很容易联想到Hilt相关内容。

问题原因

Hilt 与 Kotlin版本不兼容。

解决方案

经过查阅资料，需要升级HIit版本，适配Kotlin版本，当前决定升级版本为：2.51.1
PS：建议阅读英文版API文档，中英文版本差异过大。

参考链接

• Dependency injection with Hilt
• Hilt dependencies
• Hilt Unsupported metadata version in Kotlin
• Unsupported metadata version when using Hilt 2.42 with Kotlin 1.7.10
• Hilt incompatible with Kotlin to 1.9

---

问题2: java.lang.RuntimeException: ARouter::Compiler >>> No module name

问题描述

Task :app:hiltJavaCompileDebug FAILED

错误: ARouter::Compiler An exception is encountered, [These no module name, at 'build.gradle', like :
  android {
      defaultConfig {
          ...
          javaCompileOptions {
              annotationProcessorOptions {
                  arguments = [AROUTER_MODULE_NAME: project.getName()]
              }
          }
      }
  }
  ]
1 个错误


Caused by: java.lang.RuntimeException: ARouter::Compiler >>> No module name, for more information, look at gradle log.
        at com.alibaba.android.arouter.compiler.processor.BaseProcessor.init(BaseProcessor.java:62)
        at com.alibaba.android.arouter.compiler.processor.AutowiredProcessor.init(AutowiredProcessor

问题原因

该问题由Hilt 2.46引入，即凡是Hilt版本大于2.46都会出现该问题。

解决方案

经过查阅资料，需要在app模块build.gradle文件中，添加hilt配置，具体如下所示：

 // build.gradle文件
 
 android {
     ...
     
     hilt {
        enableExperimentalClasspathAggregation = true // 此行不加会遇到下面的新问题
        enableAggregatingTask = false
    }
    
     ...
 }

参数说明：

enableExperimentalClasspathAggregation = true // To enable classpath aggregation
enableAggregatingTask = true // To enable the aggregating task

参考链接

1. 升级 compiler sdk 导致 [No module name, for more information, look at gradle log.] · Issue #475
2. 同时使用arouter 和 hilt报错 · Issue #1051

具体内容可以参考：Hilt —— Gradle Build Setup

遇到新问题

* What went wrong:
Execution failed for task ':app:kaptDebugKotlin'.
> A failure occurred while executing org.jetbrains.kotlin.gradle.internal.KaptWithoutKotlincTask$KaptExecutionWorkAction
   > java.lang.reflect.InvocationTargetException (no error message)