https://hepokon365.hatenablog.com/entry/2021/04/30/230958

前回の続き。

JavadocからTSDoc変換をできるようにしたが、運用しているとJavadoc出力時にエラーが出る場合があったのでメモ。

Windowsでエラーが発生する

特定の端末で「docletクラスcom.github.markusbernhardt.xmldoclet.XmlDocletが見つかりません」が発生し、Javadoc出力に失敗した。

いずれもWindows端末で、Gradleキャッシュへのパスに全角文字が含まれていた(Windowsのユーザー名が全角だった)。

javadoc.options はUTF-8で出力されるが、 javadoc コマンドではデフォルトエンコーディングであるWindows-31Jで読み込まれるため、パスが文字化けしてしまいJARの読み込みに失敗していた模様。

javadocコマンドでファイル指定する際には文字コード指定ができないようで、GradleのJavadocタスクでもオプションファイルのエンコーディング指定はなさそう。 options.encoding は指定できるが、出力されるXMLファイルのエンコーディング指定だった。

また、ファイル内にはJavaファイルへのパスも出力されるため、ソースファイルのパスに全角文字が含まれる場合も失敗すると思われる。

プロジェクト保存先に全角文字が含まれないようにし、またJARは以下のように build ディレクトリ配下にコピーするよう変更して対応した。

configurations {
  xmlDoclet
}

dependencies {
  xmlDoclet 'com.github.markusbernhardt:xml-doclet:1.0.5'
}

final def tsOutputDir = 'build/typescript-generator'
final def tsXmlDocletDir = "${tsOutputDir}/xml-doclet"

task xmlDoclet(type: Javadoc) {
  // JARファイルをコピー
  def copyDir = "${tsOutputDir}/jar/doclet"
  (copyDir as File).mkdirs()

  def docletPaths = configurations.xmlDoclet.files.collect {
      def jarFile = new File("${copyDir}/${it.name}")
      jarFile << it.readBytes()
      return jarFile
  }

  source = sourceSets.main.allJava
  destinationDir = (tsXmlDocletDir as File).absoluteFile
  title = null
  options.noTimestamp = false
  options.encoding = 'UTF-8'
  options.showAll()
  options.doclet = 'com.github.markusbernhardt.xmldoclet.XmlDoclet'
  options.docletpath = docletPaths // コピー後のJARを指定
}

振り返り

Windowsのユーザー名に全角文字はやめておいたほうがいいね...