@KotlinScript 注解的类,这些类未完全设置好,无法用作 Kotlin 脚本定义。
带有 @KotlinScript 注解的类描述了一个脚本模板 — 与其模式匹配的文件(例如 *.my.kts)应使用其编译配置和依赖项。
有两件事可以使定义完全可用,而此检查会报告以下任意一项是否缺失:
.kts 文件识别为此定义的脚本。 快速修复在 Kotlin 脚本设置中注册定义会将 FQN(以及所属模块的类路径)填充到设置中。
META-INF/kotlin/script/templates/<fqn>.classname 的标记文件,被打包进生成的 JAR 中。
基于库的发现 (ScriptDefinitionsProvider) 会扫描依赖关系 JAR,查找这个空的标记文件以发现可用模板;如果没有这个文件,您的库的使用者将不会自动发现此定义。
创建标记文件以便下游自动发现快速修复会在模块的第一个资源根下创建该文件。
应用任何相关的快速修复 – 既适用于典型的库作者流程,也适用于仅在本地使用模板且从未发布模板时进行注册。