Kotlin版Javadoc(Kdoc)を生成できる「dokka」の導入手順
Kotlin版Javadoc(Kdoc)のドキュメントを作れるdokkaというライブラリがあります。
その導入手順を紹介します。
環境
- Mac OSX 10.13.4
- Android Studio 3.1
- dokka 0.9.17
dokkaの導入手順
今回はAndroid Studioを使った導入手順なので、gradleを使用します。
app/build.gradleに以下を追加します。
apply plugin: 'kotlin-android'
apply plugin: 'org.jetbrains.dokka-android'
dokka {
outputFormat = 'javadoc'
sourceDirs = files('src/main')
outputDirectory = "$buildDir/javadoc"
}
'org.jetbrains.dokka-android'
は'kotlin-android'
より後に入れます。
outputFormat
にはjavadocのほかhtmlやmarkdownなども選択できます。
また、sourceDirs
にはソースコードのあるディレクトリの場所を指定します。これは適宜変えてください。
続いて、ルート直下のbuild.gradleに以下を追加します。
buildscript {
ext.dokka_version = '0.9.17'
repositories {
jcenter()
}
dependencies {
classpath "org.jetbrains.dokka:dokka-android-gradle-plugin:${dokka_version}"
}
}
ここまでできたら、Android Studioのターミナルから
./gradlew dokka
を実行するとjavadocが生成できますが・・・
プロジェクトで使用している外部ライブラリによっては失敗することがあります。
失敗した場合
ターミナルでjava -version
を実行してjavaのバージョンをチェックし、JDK9以上を使用している場合はJDK8を使うように変更します。これで成功するはずです。
kdoc-generator
kdoc-generatorはAndroidStudioで使用できる、Kdocを自動で生成してくれるプラグインです。
(https://plugins.jetbrains.com/plugin/10389-kdoc-generator より引用)
おわりに
https://github.com/Kotlin/dokka
dokkaについてさらに詳しく知りたい人はここを参照しましょう。
Author And Source
この問題について(Kotlin版Javadoc(Kdoc)を生成できる「dokka」の導入手順), 我々は、より多くの情報をここで見つけました https://qiita.com/kanatano_mirai/items/351832a0ef166f052141著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .