Empacotamento de Apps macOS com SwiftPM (Sem Xcode)

Visão Geral

Inicialize uma pasta completa de app SwiftPM para macOS, depois compile, empacote e execute sem o Xcode. Use assets/templates/bootstrap/ para o layout inicial e references/packaging.md + references/release.md para detalhes de empacotamento e lançamento.

Quando Usar

• Quando o usuário precisa de um app macOS baseado em SwiftPM sem depender de um projeto Xcode.
• Quando você precisa de orientação sobre empacotamento, assinatura, notarização ou appcast para um app SwiftPM.

Fluxo de Trabalho em Duas Etapas

1. Inicialize a pasta do projeto

   • Copie assets/templates/bootstrap/ para um novo repositório.
   • Renomeie MyApp em Package.swift, Sources/MyApp/ e version.env.
   • Personalize APP_NAME, BUNDLE_ID e as versões.

2. Compile, empacote e execute o app inicializado

   • Copie os scripts de assets/templates/ para o seu repositório (por exemplo, Scripts/).
   • Compilação/testes: swift build e swift test.
   • Empacotamento: Scripts/package_app.sh.
   • Execução: Scripts/compile_and_run.sh (preferencial) ou Scripts/launch.sh.
   • Lançamento (opcional): Scripts/sign-and-notarize.sh e Scripts/make_appcast.sh.
   • Tag + lançamento no GitHub (opcional): crie uma tag git, faça upload do zip/appcast para o lançamento do GitHub e publique.

Exemplo Mínimo de Ponta a Ponta

Caminho mais curto da inicialização a um app em execução:

# 1. Copy and rename the skeleton
cp -R assets/templates/bootstrap/ ~/Projects/MyApp
cd ~/Projects/MyApp
sed -i '' 's/MyApp/HelloApp/g' Package.swift version.env

# 2. Copy scripts
cp assets/templates/package_app.sh Scripts/
cp assets/templates/compile_and_run.sh Scripts/
chmod +x Scripts/*.sh

# 3. Build and launch
swift build
Scripts/compile_and_run.sh

Pontos de Verificação de Validação

Execute estes após etapas importantes para capturar falhas precocemente antes de prosseguir para o próximo estágio.

Após o empacotamento (Scripts/package_app.sh):

# Confirm .app bundle structure is intact
ls -R build/HelloApp.app/Contents

# Check that the binary is present and executable
file build/HelloApp.app/Contents/MacOS/HelloApp

Após a assinatura (Scripts/sign-and-notarize.sh ou assinatura de desenvolvimento ad-hoc):

# Inspect signature and entitlements
codesign -dv --verbose=4 build/HelloApp.app

# Verify the bundle passes Gatekeeper checks locally
spctl --assess --type execute --verbose build/HelloApp.app

Após notarização e stapling:

# Confirm the staple ticket is attached
stapler validate build/HelloApp.app

# Re-run Gatekeeper to confirm notarization is recognised
spctl --assess --type execute --verbose build/HelloApp.app

Falhas Comuns de Notarização

Modelos

• assets/templates/package_app.sh: Compila binários, cria o bundle .app, copia recursos, assina.
• assets/templates/compile_and_run.sh: Loop de desenvolvimento para matar o app em execução, empacotar, iniciar.
• assets/templates/build_icon.sh: Gera .icns a partir de um arquivo Icon Composer (requer instalação do Xcode).
• assets/templates/sign-and-notarize.sh: Notariza, stapla e comprime uma compilação de lançamento.
• assets/templates/make_appcast.sh: Gera entradas de appcast Sparkle para atualizações.
• assets/templates/setup_dev_signing.sh: Cria uma identidade de assinatura de código de desenvolvimento estável.
• assets/templates/launch.sh: Launcher simples para um .app empacotado.
• assets/templates/version.env: Arquivo de versão de exemplo consumido por scripts de empacotamento.
• assets/templates/bootstrap/: Esqueleto mínimo de app macOS SwiftPM (Package.swift, Sources/, version.env).

Notas

• Mantenha os entitlements e a configuração de assinatura explícitos; edite os scripts do modelo em vez de reimplementar.

…