mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-11-10 22:07:03 +01:00
Krzysztof kuhy Rudnicki
27f44cad4b
Every Flutter app still shipped the stock Flutter "beach" launcher icon, and none had an adaptive-icon descriptor at all. Rather than hand-drawing five one-off icons, define the family once and let each app contribute only an accent colour and a glyph. The family: a charcoal #1B1D21 field carrying one glyph in that app's own theme seed colour, at a single stroke weight. Glyphs are optically centred automatically - render.centre_offset rasterises a glyph alone, measures its ink box, and translates (never scales) the fragment, so a row of icons lines up while every icon keeps the exact family stroke weight. safe_box_overflow warns when a glyph exceeds the 560px adaptive-icon safe box; it caught three real overflows that a launcher mask would have clipped. The registry points dufs_client at ~/dufs-cloud/app: ~/dufs_client was a stale, remote-less checkout with an identical package name, since deleted. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
103 lines
3.3 KiB
Python
103 lines
3.3 KiB
Python
"""Write an app's icon assets and drive flutter_launcher_icons.
|
|
|
|
Three layers are produced per app:
|
|
|
|
``icon``
|
|
Charcoal field plus accent glyph. Used as the legacy square launcher icon,
|
|
as the Linux desktop icon, and as the master for previews.
|
|
``icon_foreground``
|
|
Glyph only, transparent. The adaptive-icon foreground layer; the background
|
|
layer is the flat charcoal declared in pubspec.yaml.
|
|
``icon_monochrome``
|
|
Glyph only in white. Android 13+ recolours this for themed icons.
|
|
|
|
Both the SVG source and a 1024px PNG are written for each layer so a build never
|
|
needs rsvg-convert installed.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import subprocess
|
|
from typing import TYPE_CHECKING, Final
|
|
|
|
from python_pkg.app_icons import glyphs, render, style
|
|
|
|
if TYPE_CHECKING:
|
|
from pathlib import Path
|
|
|
|
from python_pkg.app_icons.apps import AppIcon
|
|
|
|
# (filename stem, draw the charcoal field, colour override)
|
|
_LAYERS: Final[tuple[tuple[str, bool, str | None], ...]] = (
|
|
("icon", True, None),
|
|
("icon_foreground", False, None),
|
|
("icon_monochrome", False, style.MONOCHROME),
|
|
)
|
|
|
|
|
|
def write_assets(app: AppIcon) -> list[Path]:
|
|
"""Write every icon layer for one app as SVG plus 1024px PNG.
|
|
|
|
Parameters:
|
|
app (AppIcon): App to generate assets for.
|
|
|
|
Returns:
|
|
list[Path]: Every file written, in creation order.
|
|
"""
|
|
glyph = glyphs.get_glyph(app.glyph)
|
|
offset = render.centre_offset(glyph, app.accent)
|
|
written: list[Path] = []
|
|
for stem, with_background, colour in _LAYERS:
|
|
svg_text = render.build_svg(
|
|
glyph,
|
|
colour or app.accent,
|
|
with_background=with_background,
|
|
offset=offset,
|
|
)
|
|
svg_path = app.asset_dir / f"{stem}.svg"
|
|
svg_path.parent.mkdir(parents=True, exist_ok=True)
|
|
svg_path.write_text(svg_text, encoding="utf-8")
|
|
png_path = app.asset_dir / f"{stem}.png"
|
|
render.rasterise(svg_text, png_path, style.CANVAS)
|
|
written.extend((svg_path, png_path))
|
|
return written
|
|
|
|
|
|
def write_linux_icons(app: AppIcon, destination: Path) -> list[Path]:
|
|
"""Render the hicolor icon-theme PNGs for a Linux desktop target.
|
|
|
|
Parameters:
|
|
app (AppIcon): App to generate icons for; must have ``linux`` set.
|
|
destination (Path): Directory to write ``<size>/<icon_name>.png`` into.
|
|
|
|
Returns:
|
|
list[Path]: Every PNG written.
|
|
"""
|
|
glyph = glyphs.get_glyph(app.glyph)
|
|
offset = render.centre_offset(glyph, app.accent)
|
|
svg_text = render.build_svg(glyph, app.accent, with_background=True, offset=offset)
|
|
written: list[Path] = []
|
|
for size in style.LINUX_ICON_SIZES:
|
|
png_path = destination / str(size) / f"{app.icon_name}.png"
|
|
render.rasterise(svg_text, png_path, size)
|
|
written.append(png_path)
|
|
return written
|
|
|
|
|
|
def run_flutter_launcher_icons(app: AppIcon) -> None:
|
|
"""Generate the Android mipmap set from the written assets.
|
|
|
|
flutter_launcher_icons owns the error-prone part: five density buckets, the
|
|
round variant, and the ``mipmap-anydpi-v26/ic_launcher.xml`` adaptive
|
|
descriptor that none of these repos had before.
|
|
|
|
Parameters:
|
|
app (AppIcon): App whose Flutter project should be processed.
|
|
"""
|
|
subprocess.run(
|
|
[render.resolve_tool("dart"), "run", "flutter_launcher_icons"],
|
|
cwd=app.repo,
|
|
check=True,
|
|
capture_output=True,
|
|
)
|