mirror of
https://github.com/storytold/vectorcraft.git
synced 2026-10-14 19:26:56 -04:00
bflatasticandClaude Opus 5.5
83ad194819
`hdiutil makehybrid -hfs` gave every file in the image a com.apple.FinderInfo, which `codesign --verify --strict` rejects as "Finder information, or similar detritus" on the app in the DMG and on copies installed from it, so compliance and MDM checks reported the notarized app as damaged. As PdfCraft did (storytold/pdfcraft#823, shipped in PdfCraft 0.6.0), the DMG is now made with `hdiutil create -srcfolder -fs HFS+ -format UDZO`, retried when a CI runner's device is busy, and the app mounted from the finished DMG must pass `codesign --verify --strict --deep` before the release goes on. Co-Authored-By: Claude Opus 5.5 <[email protected]>
38 lines
2.2 KiB
Markdown
38 lines
2.2 KiB
Markdown
# macOS DMG window
|
||
|
||
What Finder shows when the DMG opens: a 660 × 400 pt background with the app icon and the
|
||
`Applications` link side by side. `package.sh` copies these files into the image; nothing here is
|
||
generated at build time, so the DMG builds with a plain `hdiutil create -srcfolder` (no Finder
|
||
scripting on CI, nothing extra installed in the signing job).
|
||
|
||
| File | What |
|
||
|---|---|
|
||
| `background.svg` | Source of the background: the app icon (`assets/app-icon/vectorcraft-small.svg`, linked, not copied) cropped as a cover on the VectorCraft colour field (`#e8573f`), Ink and Paper, Inter and JetBrains Mono (from `assets/fonts`, not embedded). |
|
||
| `background.tiff` | The background at 1x (660 × 400 px, 72 dpi) and 2x (1320 × 800 px, 144 dpi) in one HiDPI TIFF (Deflate, sRGB). Goes to `.background/background.tiff`. |
|
||
| `DS_Store` | Finder's view settings for the volume: window size, icon size 128, VectorCraft.app at (326, 205), `Applications` at (574, 205), and the background. Goes to `.DS_Store`. |
|
||
| `generate.py` | Writes `background.tiff` and `DS_Store` from the SVG and the layout above. |
|
||
|
||
## Rules
|
||
|
||
- **The volume name has no version** (`VectorCraft`, not `VectorCraft <version>`). `.DS_Store` points at the
|
||
background through an alias that includes the volume name, so a versioned name loses the
|
||
background. The DMG file name still carries the version.
|
||
- **Finder draws the icon labels in black in light and dark mode** when a window has a background,
|
||
so the area under both icons stays light (Paper).
|
||
- **Nothing goes inside the icon boxes:** artwork keeps 10 pt clear of each 128 pt icon box and of
|
||
the label strip under it.
|
||
|
||
## Regenerate
|
||
|
||
Edit `background.svg` (or the layout constants in `generate.py`), then run, on any OS:
|
||
|
||
```sh
|
||
pip install 'pillow>=12' ds_store==1.3.3 mac_alias==2.2.3
|
||
python3 packaging/macos/dmg/generate.py # needs resvg on PATH, as packaging/icons.sh
|
||
```
|
||
|
||
It renders the SVG with resvg using only the fonts in `assets/fonts`, so the pixels are the same
|
||
on every machine, and writes `DS_Store` from scratch: the background alias holds the volume name
|
||
and `/.background/background.tiff`, nothing from the machine that ran it. The window is 660 × 432
|
||
with Finder's 32 pt title bar; the content area is 660 × 400.
|