Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

mac-app

/mac-app

Buduje, pakuje, podpisuje i wydaje aplikację macOS przez SwiftPM i narzędzia wiersza poleceń, bez projektu Xcode.

Repozytorium
mac-app-skill ↗
Licencja
MIT
Ostatnia zmiana repozytorium
02.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
10
Skrypty
5
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 02.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 sprawdzić przed instalacją
  • 5 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/bundle.sh, scripts/make-dmg.sh, scripts/verify-app.mjs, templates/menubar/Package.swift, templates/menubar/Sources/App/main.swift

Co robi i kiedy

Buduje, pakuje, podpisuje i wydaje aplikację macOS przez SwiftPM i narzędzia wiersza poleceń, bez projektu Xcode.

Oryginalny opis (EN)

Build, bundle, sign and ship a macOS app with SwiftPM and the Command Line Tools only, no Xcode project. Use when creating a menu bar or desktop Mac app from the terminal, turning a Swift package into a .app, fixing macOS permission (TCC) prompts that never appear or keep resetting, adding a login item, or preparing a DMG, notarized build or Homebrew release.

Jak działa

  1. Workflow
  2. Rules
  3. Files
Sekcje z nagłówków SKILL.md, w oryginale · 34 linii, 354 słów
Podgląd SKILL.md
---
name: mac-app
description: Build, bundle, sign and ship a macOS app with SwiftPM and the Command Line Tools only, no Xcode project. Use when creating a menu bar or desktop Mac app from the terminal, turning a Swift package into a .app, fixing macOS permission (TCC) prompts that never appear or keep resetting, adding a login item, or preparing a DMG, notarized build or Homebrew release.
---

# mac-app

Ship a real `.app` from a Swift package without opening Xcode. The Command Line Tools include `swift`, `codesign`, `notarytool`, `stapler`, `hdiutil` and `iconutil`, which is everything this needs.

## Workflow

1. **Scaffold** a package and the app shell. Read [SCAFFOLD.md](SCAFFOLD.md). Start from `templates/menubar/` for a menu bar app.
2. **Before writing SwiftUI**, read [PITFALLS.md](PITFALLS.md) section 1. Without Xcode, `@State`, `@Observable`, `@Entry` and `#Preview` do not compile.
3. **Bundle** with `scripts/bundle.sh`. It builds in release mode, writes `Info.plist`, copies the binary and signs the bundle.
4. **Permissions:** for every protected API the app calls, add its usage string and know its TCC service. Read [PERMISSIONS.md](PERMISSIONS.md).
5. **Verify** with `node scripts/verify-app.mjs <App.app>`. Fix every `error` before going further. Read the `warn` lines; each one says why it matters.
6. **Release** as a DMG, optionally notarized, optionally through a Homebrew tap. Read [RELEASE.md](RELEASE.md).

## Rules

- Never claim a permission flow works without running the bundled app (`open App.app`), not the bare binary. TCC attributes a binary started from a terminal to the terminal, so prompts and grants differ.
- Every protected API needs its usage string in `Info.plist` before the first call. A missing string ends the process at the request, with no dialog.
- Prefer a stable signing identity during development (PITFALLS.md section 3). Ad-hoc signatures change on every build and TCC may treat each build as a new app.
- Keep the app's own state in `ObservableObject` classes and pass `Binding(get:set:)` to controls.
- Run `verify-app.mjs` after every change to `Info.plist`, entitlements or signing.

## Files

| File | Read when |
|---|---|
| [SCAFFOLD.md](SCAFFOLD.md) | Starting a new app, or turning a package into a bundle |
| [PITFALLS.md](PITFALLS.md) | Something compiles in Xcode but not here; a window, panel or event monitor behaves oddly |
| [PERMISSIONS.md](PERMISSIONS.md) | Adding camera, mic, speech, contacts, calendars, Apple Events, accessibility, screen recording or folder access |
| [RELEASE.md](RELEASE.md) | Making a DMG, notarizing, publishing a GitHub release or Homebrew cask |
| `scripts/bundle.sh` | Building the `.app` |
| `scripts/verify-app.mjs` | Checking a built `.app` |
| `scripts/make-dmg.sh` | Packaging for download |
Pliki w paczce (10)
  • PERMISSIONS.md 3 KB
  • PITFALLS.md 8 KB
  • RELEASE.md 2 KB
  • SCAFFOLD.md 2 KB
  • SKILL.md 3 KB
  • scripts/bundle.sh 3 KB
  • scripts/make-dmg.sh 1 KB
  • scripts/verify-app.mjs 8 KB
  • templates/menubar/Package.swift 1 KB
  • templates/menubar/Sources/App/main.swift 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · onder007/mac-app-skill90MIT
workflowsdiy/bama-light100MIT
ciro-maciel/ccm-stack85MIT

Migawka bazy z 13.11.2026 · wersja paczki 7c0678afd901 (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

  • 90macos-swiftpm
    Buduje, uruchamia i testuje pakiety SwiftPM i pliki wykonywalne dla macOS, gdy repozytorium nie ma projektu Xcode.
  • 100guide-macos-spm-packaging
    Tworzy, buduje i pakuje aplikacje macOS oparte na SwiftPM bez projektu Xcode, z własnym skryptem składania bundla .app i notaryzacją.
  • 95macos-spm-app-packaging
    Tworzy szkielet, buduje i pakuje aplikacje macOS oparte na SwiftPM bez projektu Xcode, w tym skrypt składający pakiet .app, podpisywanie, notaryzację i appcast.
  • 100macos-apps
    Buduje natywne aplikacje macOS w Swift ze SwiftUI i AppKit, obejmując budowanie, debugowanie, testy, optymalizację i wydanie, wyłącznie z wiersza poleceń bez Xcode.
  • 100macos-spm-app-packaging
    Zamienia plik wykonywalny Swift Package Manager w pełnoprawną aplikację .app bez projektu Xcode: buduje bundle i Info.plist, podpisuje, notaryzuje, pakuje do zip lub obrazu dysku i obsługuje kanały Sparkle.
  • 100new-mac-app
    Tworzy natywną aplikację macOS w SwiftUI z gotowego szablonu, z SwiftData, skryptem budowania i git, bez graficznego Xcode.

Uwagi i zgłoszenia

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