Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

macos-vm-testing

/macos-vm-testing

Testuje cel macOS projektu, czyli .app, DMG lub instalator, w jednorazowych maszynach wirtualnych Tart na Apple Silicon.

Repozytorium
automac ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Testuje cel macOS projektu, czyli .app, DMG lub instalator, w jednorazowych maszynach wirtualnych Tart na Apple Silicon.

Oryginalny opis (EN)

Test a project's macOS target (.app, DMG, installer, or untrusted build) in disposable Tart VMs on Apple Silicon. Use when adding or debugging VM-based smoke tests, first-launch / Gatekeeper / notarization release tests, upgrade-path tests, or contained builds; when writing code that drives `tart`; or when the user mentions tart, tart.run, macOS VMs, golden images, or testing a Mac app on a clean machine.

Jak działa

  1. Workflow
  2. Non-negotiables
  3. When things go wrong
Sekcje z nagłówków SKILL.md, w oryginale · 57 linii, 508 słów
Podgląd SKILL.md
---
name: macos-vm-testing
description: Test a project's macOS target (.app, DMG, installer, or untrusted build) in disposable Tart VMs on Apple Silicon. Use when adding or debugging VM-based smoke tests, first-launch / Gatekeeper / notarization release tests, upgrade-path tests, or contained builds; when writing code that drives `tart`; or when the user mentions tart, tart.run, macOS VMs, golden images, or testing a Mac app on a clean machine.
---

# Testing macOS targets in Tart VMs

The reference material lives in the automac repository this skill came from. Resolve
`AUTOMAC` to that checkout (the directory two levels above this file, following
symlinks) and read files from there as needed:

| Need | Read |
| --- | --- |
| Mental model, limits (Apple Silicon, 2 VMs, macOS 27 provisioning) | `$AUTOMAC/docs/concepts.md` |
| Build a sealed image from an IPSW | `$AUTOMAC/docs/images.md`, `$AUTOMAC/examples/guest/provision.sh` |
| SSH options, quoting, file transfer | `$AUTOMAC/docs/guest-access.md` |
| Which test to write and how | `$AUTOMAC/docs/test-recipes.md` |
| Boundary checks | `$AUTOMAC/docs/isolation.md` |
| Something hangs or behaves oddly | `$AUTOMAC/docs/gotchas.md` (read this before debugging) |
| CI / self-hosted runner | `$AUTOMAC/docs/ci.md` |
| Testing the harness with fakes | `$AUTOMAC/docs/testing-the-harness.md` |
| Working code to copy | `$AUTOMAC/examples/zsh/tartvm` (standalone script), `$AUTOMAC/examples/python/tartvm/` (library), `$AUTOMAC/tests/` (fakes) |

## Workflow

1. **Decide the shape.** Most projects: build on the host, test in a clone of a *clean*
   image (`examples/zsh/tartvm test App.app`). Build in the VM only when build scripts
   are untrusted. Add the release test once there is a notarized DMG.
2. **Pick an implementation.** Small project or shell-based tooling: copy
   `examples/zsh/tartvm` into `scripts/` and adapt. Python tooling: copy the modules
   from `examples/python/tartvm/` you need. Either way copy the matching tests and fakes.
3. **Pin inputs** (Tart release + hash + Team ID, IPSW + Apple's SHA-1, guest packages)
   in a lock file and name images by a hash of their inputs.
4. **Write the harness tests first**, against fakes, including failure paths: boundary
   check fails, app exits, crash report present, transfer corrupted, guest never powers
   off. They must run in Docker / CI without a VM.
5. **Run once for real** on the user's Mac (`tartvm doctor`, `tartvm image --ipsw …`,
   `tartvm test …`) and read the JSON report. Ask before building an image: it downloads
   ~20 GB and takes a while.

## Non-negotiables

- Never pass `--dir`, `--disk`, or `--net-bridged` to `tart run`; assert it in code.
- Project-private `TART_HOME`, `TART_NO_AUTO_PRUNE=1`, and a name prefix checked before
  every mutating `tart` call. Never touch VMs outside the prefix.
- SSH with `-F /dev/null`, no agent, a VM-only key, pinned `HostKeyAlias=<image>`, `-n`
  unless stdin is deliberate. Remote commands built from argument lists and quoted.
- Seal images by shutting down from inside the guest; a guest that does not power
  itself off is a failure. Verify the seal in a fresh clone.
- Every check fails closed. Empty or unparsed output is a failure. A skipped test fails
  the run. Clones are deleted on every exit path unless `--keep` was requested.
- Passwords only in `0600` files, delivered via `SSH_ASKPASS` or `sudo -S` stdin; never
  in logged argv.
- Gatekeeper passes only with `accepted` **and** `source=Notarized Developer ID`.

## When things go wrong

Check `docs/gotchas.md` first; most failures there have been seen before. Then look at
the `tart run` log in the state directory's `logs/`, re-run with `--keep`, and SSH into
the kept clone with the same options the harness uses.

Wersje

W bazie nie ma innych skilli o nazwie macos-vm-testing.

Migawka bazy z 13.11.2026 · wersja paczki c3ee22b36d7a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100tart-xcode-runner
    Uruchamia dowolne polecenie, build lub test w jednorazowej maszynie wirtualnej macOS Tart, zwłaszcza testy UI i XCUITest.
  • 93tart-ci
    Buduje szybki, odizolowany pas CI dla macOS na Tart: złote obrazy VM, jednorazowe runnery i cache.
  • 100project-health-macos
    Przeprowadza głęboki audyt projektu na Macach z Apple Silicon, z realnymi buildami i listą problemów P0 do P3 z lokalizacjami dowodów.
  • 100macos-app-distribution-dmg
    Prowadzi przez dystrybucję aplikacji macOS poza App Store: podpis Developer ID z hardened runtime, notaryzacja notarytool, stapling, budowa obrazu DMG i sprawdzenie uruchomienia na obcym Macu.
  • 90mac-app
    Buduje, pakuje, podpisuje i wydaje aplikację macOS przez SwiftPM i narzędzia wiersza poleceń, bez projektu Xcode.
  • 100test-mac-app
    Testuje aplikację macOS na trzech poziomach: testy Swift Testing, autotest w aplikacji i mostek debugowy, z klikami przez komputer.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.