android studio kotlin接口文档导出
  oHo4xnCa6cuT 2023年11月28日 24 0



kotlin编写doc文档并导出


以前我们用java编写接口文档,编写后直接使用as自带的功能直接导出接口文档

android studio kotlin接口文档导出_android


android studio kotlin接口文档导出_接口文档_02


这样直接会在目的地导出接口文档,但是当使用kotlin定义接口后,直接使用会报错:

android studio kotlin接口文档导出_ci_03


于是我们采用另一种办法

使用官方推荐的dokka插件

如何使用呢
首先接入依赖在app gradle里集成就好

buildscript {
  ...
    dependencies {
       ...
        classpath("org.jetbrains.dokka:dokka-gradle-plugin:1.7.20")
    }
}

plugins {
   ...
    id("org.jetbrains.dokka") version "1.7.20"
}

...

dependencies {
   ...
    dokkaHtmlPlugin("org.jetbrains.dokka:kotlin-as-java-plugin:1.7.20")
}
// 配置导出信息
tasks.dokkaJavadoc.configure {
    // 导出的文档目录路径
    outputDirectory.set(new File(rootDir, "doc"))
//    dokkaSourceSets {
//        named("main") {
//            noAndroidSdkLink.set(true)
//            noStdlibLink.set(true)
//            noJdkLink.set(true)
//        }
//        configureEach {
//            // 包的定义
//            includes.from("packages.md")
//        }
//    }
}

就这么简单配置就好,然后直接在右侧的gradle里点击dcumentation下面的task dokkaJavaDoc 执行后就会在项目的本地根目录生成一份接口文档

android studio kotlin接口文档导出_接口文档_04


打开里面的index.html就能查看接口文档


【版权声明】本文内容来自摩杜云社区用户原创、第三方投稿、转载,内容版权归原作者所有。本网站的目的在于传递更多信息,不拥有版权,亦不承担相应法律责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@moduyun.com

  1. 分享:
最后一次编辑于 2023年11月28日 0

暂无评论

推荐阅读
oHo4xnCa6cuT