javadoc 한글 깨짐 문제 해결

문제 현상

./gradlew javadoc

위 명령어로 javadoc 빌드를 했을 때, 아래와 같은 에러가 난다.

error: unmappable character (0xEC) for encoding x-windows-949

해결 방법

Javadoc 빌드 시 인코딩을 추가해주면 된다. Gradle 기준으로 gradle.build 에 아래의 내용을 추가하자.

javadoc {
    options.addStringOption("locale","ko_KR");
    options.addStringOption("encoding","UTF-8");
    options.addStringOption("charset","UTF-8");
    options.addStringOption("docencoding","UTF-8");
}

이제 다시 javadoc 빌드를 해보면, 정상적으로 진행되는 것을 확인할 수 있다.