自作processingライブラリのハマり所2023

Processingのライブラリ自作するために便利なこのプロジェクト。
今どきのEclipseでビルドするともりもりエラーが出ます。

ここからバッドノウハウ集

javacで（UTF-8のソースが）コンパイルできない。

build.xmlのtarget name="compile"のjavacタグに、encode="UTF-8"属性を追加します。

<target name="compile">
    <javac srcdir="${project.tmp}/${project.name}/src" destdir="${project.bin}" source="${java.target.version}" target="${java.target.version}" includeantruntime="false" encoding="UTF-8">

JavadocがClassNotfoundで止まる。

このIssueですね。
github.com

StackOverflowに回答がありました。@exampleを処理するための拡張機能が参照しているパッケージが、新しいJDKに存在しないことが原因です。

build.xmlのtarget name="generate.javadoc"の次の行を削除するといけます。

<taglet name="ExampleTaglet" path="resources/code" />

processing-library-template/build.xml at bd6560a60ddffea53aaa24423d569ef0017a5c1e · processing/processing-library-template · GitHub

javadocで日本語が化けてエラーメッセージが読めない。

Eclipseの使用するJarをJava11にします。

javadocの出力が化ける。ソースの文字コードがおかしい。

build.xmlのtarget name="generate.javadoc"に属性を追加します。

<javadoc bottom="Processing Library ${project.name} by ${author.name}. ${library.copyright}" 
    encoding="UTF-8"
    docencoding="UTF-8"
    charset="UTF-8"
    :

javadocが外部ライブラリを認識しない。

build.xmlのtarget name="generate.javadoc"のclasspath属性に追記します。区切り文字は;です。

classpath="${classpath.local.location}/core.jar;{project.bin};./maylib.jar"

バッドノウハウである理由

processing-library-template/build.xml at bd6560a60ddffea53aaa24423d569ef0017a5c1e · processing/processing-library-template · GitHub

<!--	
		Properties for your project should be set and modified in the  
		build.properties file (located in the same folder as this build.xml file).
		
		THIS FILE SHOULD NOT BE EDITED, unless you know what you are doing.
		If you have recommendations for improvements, please let Elie know 
		at prisonerjohn@gmail.com
-->

申し訳ございません。