feat: рантайм без fontconfig — глиф-движок GlyphFont (fontbox) вместо java.awt.Font
PR checks / java (pull_request) Successful in 2m11s
PR checks / web (pull_request) Successful in 1m8s

На OpenJDK/Linux любое обращение к java.awt.Font требует fontconfig-нативки
(Fontconfig head is null на хосте без libfontconfig). java.awt.Font убран из
всего рантайм-пути: текст chart-движка (DrawMlText) и проверка покрытия глифов
(GlyphCoverageNormalizer) переведены на GlyphFont — чистый Java-парсер TTF
org.apache.pdfbox:fontbox 3.0.8 (compile; commons-logging исключён,
единственный провайдер jcl-over-slf4j). Метрики совпадают с AWT до 4-го знака,
кернинг-дрейф 0.0000 (DejaVu Sans, Carlito). AWT остаётся только как геометрия
(Graphics2D/Path2D), которая fontconfig не требует.

- GlyphFont: of/canDisplay/advance/ascent/descent/leading/draw; TTF читается
  напрямую из classpath, не зависит от BundledFonts.init(); битый бандл падает
  IllegalStateException, отсутствующее семейство/начертание -> null
- DrawMlText.fontFor: цепочка фолбэка family/variant -> family/regular ->
  fallback/variant -> fallback/regular (bold у Noto остаётся своим regular)
- BundledFonts: awtFont/AWT_FONTS удалены (чистый cutover), CLASSPATH_DIR ->
  package-private
- ChartRenderer.measureLegend: убран неиспользуемый после cutover параметр g (PMD)
- GlyphFontTest (6 юнитов) без единого java.awt.Font — обязан проходить на хосте
  без fontconfig; Containerfile/AGENTS.md: fontconfig рантайму не нужен

Проверено: mvn clean verify локально (153 теста, PMD); приёмочный стенд —
контейнер без libfontconfig.so и /etc/fonts: mvn verify BUILD SUCCESS и
java -jar + конвертация charts-smartart.docx -> PDF 466 КБ с 4 растрами
(деградации нет).
This commit is contained in:
Pjandro
2026-10-21 19:06:28 +00:00
parent 13b7c2f39b
commit c09a3f5adf
13 changed files with 405 additions and 99 deletions
+4 -3
View File
@@ -10,9 +10,10 @@ COPY . .
RUN mvn -B -q -DskipTests package
FROM docker.io/library/eclipse-temurin:21-jre
# curl — только для HEALTHCHECK; runtime полный jre (не alpine-slim): Java2D
# chart-движка нужны AWT и fontconfig-нативки; бандл-шрифты лежат в jar,
# системные шрифты не нужны. Тесты в образе не гоняем — гейт mvn clean verify.
# curl — только для HEALTHCHECK; runtime полный jre (не alpine-slim): chart-движку
# нужен модуль java.desktop (Graphics2D); fontconfig и системные шрифты рантайму
# не нужны — текст рисуется глифами fontbox, см. fonts/GlyphFont. Тесты в образе
# не гоняем — гейт mvn clean verify.
# Прокси-переменные хоста (HTTP_PROXY/HTTPS_PROXY/http_proxy/https_proxy)
# podman/buildah подмешивает в шелл RUN/HEALTHCHECK и ломает curl
# (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на команде.