SPB Git

Repository Public

RELEASE.md 8.0 KB

# Publication — SP Browser

# État au 2026-11-18 — version 2.0.0 (2)

# macOS

Élément État
dist/SPBrowser.app 2.0.0 (2), universel arm64 + x86_64 Signé Developer ID Application: Simon-Pierre Boucher (3YM54G49SN) avec le profil « SP Browser Developer ID » (droit com.apple.developer.associated-domains = webcredentials:browser.spboucher.ai), Hardened Runtime, App Sandbox, horodatage sécurisé
Notarisation de l'application Acceptée — soumission 41d03724-68d8-4988-8671-69a9d4efb1c2, ticket agrafé
dist/SPBrowser.dmg (4,8 Mo) Signé, notarisation acceptée — soumission 8fc3af07-27fb-4dcd-a1e0-53553a13ec26, ticket agrafé
Gatekeeper spctl --assess : « Notarized Developer ID » pour l'application et l'image disque
SHA-256 du DMG 2b6ae7fc9247191e2308cd765c9077e09bda020edbe2a4439ccdec33da227d3f
Installation Installée depuis l'image disque dans /Applications/SP Browser.app sur le poste de développement (la 1.0.0 est archivée dans dist/previous/). Lancement vérifié avec les données existantes de la 1.0.0.
Clés d'accès Depuis l'app installée, « Se connecter avec une clé d'accès » ouvre la feuille système au nom de SP Browser (défi fourni par le serveur de production, association de domaine reconnue). La cérémonie complète avec Touch ID n'a pas été exécutée : elle demande le propriétaire.
Publication sur spbgit Non faite pour la 2.0.0 (ni git push, ni dépôt du DMG) : en attente d'une demande explicite.

# iOS / iPadOS

Élément État
Identifiant ai.spboucher.spbrowser (le même que l'app macOS), domaines associés activés
Fiche App Store Connect « SP Browser », id 6836530354, SKU spbrowser-ios-001, langue principale fr-CA — créée par la session Safari du propriétaire, à sa demande
Archive scripts/ios-release.sh all → 2.0.0 (2), signature automatique App Store Connect, droit webcredentials:browser.spboucher.ai présent dans l'archive
Envoi scripts/ios-release.sh upload → UPLOAD SUCCEEDED (Delivery UUID 1bfcfbcf-5db1-441a-be9c-2fc15a4b9e3e)
TestFlight Groupe interne « Interne » (accès à tous les builds), titulaire du compte comme testeur

Les apps iOS ne sont pas notarisées : la distribution passe par App Store Connect / TestFlight. Aucune soumission à la revue de l'App Store n'a été faite.

# Procédure 2.0

bash
scripts/provision.py            # identifiant d'app, capacité Associated Domains, profil Developer ID (idempotent ; à relancer si une capacité change)
scripts/build-release.sh        # archive Release signée avec le profil → dist/SPBrowser.app
scripts/notarize.sh             # notarisation + agrafage de l'app, puis de l'image disque
scripts/verify-release.sh
scripts/ios-release.sh all      # archive iOS + IPA (augmenter CURRENT_PROJECT_VERSION avant chaque envoi)
scripts/ios-release.sh upload   # TestFlight

Un build Debug macOS porte l'identifiant ai.spboucher.spbrowser.debug : il cohabite avec l'app installée sans perturber son association de domaine.

# État au 2026-11-17 — version 1.0.0 (1)

Élément État
dist/SPBrowser.app 1.0.0 (1), universel arm64 + x86_64 Signé Developer ID Application: Simon-Pierre Boucher (3YM54G49SN), Hardened Runtime, App Sandbox, horodatage sécurisé
Notarisation de l'application Acceptée par Apple — soumission 474aabb2-5d6a-439f-baff-32d13a2eae92, ticket agrafé
dist/SPBrowser.dmg (3,6 Mo) Signé, notarisation acceptée — soumission 5660fa26-bd42-4a9f-a258-f6cd5691b529, ticket agrafé
Gatekeeper spctl --assess accepte l'application et l'image disque
SHA-256 du DMG 641bf0a0c900a1c218a3c5e3459b126dc440195d917e9228a2318186d559058d

Les deux premières tentatives de notarisation ont échoué avec HTTP 403 — A required agreement is missing or has expired ; elles ont réussi après la signature de l'accord par le titulaire du compte. Publié le 2026-11-17 sur la forge personnelle spbgit, à la demande du propriétaire :

Le dépôt et le binaire y sont publics. Le fichier a été déposé par SSH dans ~/srv/spbgit/data/releases/sp-browser/v1.0.0/ avec son fichier .sha256, faute de jeton d'API sur ce poste (spbgit release upload sp-browser v1.0.0 dist/SPBrowser.dmg fait la même chose avec un jeton).

# Procédure

bash
scripts/test.sh all            # 82 tests du cœur + 29 tests d'intégration
scripts/build-release.sh       # archive Release, signature Developer ID → dist/SPBrowser.app
scripts/verify-release.sh      # signature, entitlements, runtime (code 3 = signé mais non notarisé)
scripts/notarize.sh            # notarise l'app, agrafe, construit/signe/notarise/agrafe le DMG
scripts/verify-release.sh      # doit finir par « RELEASE VERIFIED: signed, notarized, stapled »

Variables : SIGN_IDENTITY (par défaut la première identité « Developer ID Application » du trousseau), TEAM_ID, NOTARY_PROFILE (par défaut MacLustr-Notarize). Les scripts n'affichent que le nom de l'identité ; ils ne créent, ne lisent ni ne modifient aucun identifiant.

# Ce que font les scripts

  • build-release.sh : régénère le projet (xcodegen), xcodebuild archive en Release avec signature manuelle Developer ID, --timestamp --options=runtime, sans entitlement de débogage ; copie l'application dans dist/ et vérifie la signature. Refuse de continuer sans identité Developer ID (une identité Development ou Mac App Store ne convient pas à la distribution directe).
  • notarize.sh : compresse l'application avec ditto, notarytool submit --wait, n'annonce « notarized » que si le statut renvoyé est Accepted, agrafe et valide ; construit ensuite le DMG à partir de l'application agrafée, le signe, le soumet, l'agrafe. En cas de refus, récupère le journal Apple dans build/ et sort avec un code d'erreur.
  • verify-release.sh : codesign --verify --deep --strict, autorité de signature, runtime, horodatage, entitlements (présence du bac à sable, absence de get-task-allow et d'exceptions), stapler validate, spctl --assess.

# Versionnement

MARKETING_VERSION et CURRENT_PROJECT_VERSION sont dans project.yml. Incrémenter le numéro de build à chaque soumission.

# Identifiant de bundle

ai.spboucher.spbrowser, défini dans project.yml (PRODUCT_BUNDLE_IDENTIFIER). Il suit la convention des autres applications de ce poste ; le changer suffit à cet endroit. Changer d'identifiant change aussi le conteneur de données de l'application.

# Avant une diffusion publique

  • Tester le DMG sur un autre Mac (idéalement macOS 14 et un Mac Intel) : seul ce poste a été testé.
  • Mener les vérifications manuelles listées « Non vérifié » dans TEST_REPORT.md.
  • Décider d'un canal de mise à jour : il n'y en a aucun (pas de Sparkle ni équivalent), par cohérence avec « aucune connexion non sollicitée ».
  • Mac App Store : non visé. Il faudrait une identité et un profil de distribution distincts.

# 3.0.0 (3) — 2026-11-19

  • macOS : scripts/build-release.sh → scripts/notarize.sh → scripts/verify-release.sh (RELEASE VERIFIED). DMG publié sur spbgit : releases/sp-browser/v3.0.0/SPBrowser.dmg, SHA-256 75e727d836c58a212059e162ade43aab0ad9976b97e227ecc1a7c28742c14a12. Étiquette git v3.0.0.
  • iOS / iPadOS : scripts/ios-release.sh all puis scripts/ios-release.sh upload ; build 3 VALID, test interne TestFlight.
  • La 2.0 est conservée dans dist/previous/. La 3.0 n'a pas été installée dans /Applications : cela reste un geste du propriétaire.
  • Outils ajoutés : scripts/aura-shot.sh (captures par PID, sans toucher une instance en cours), scripts/add-translations.py, scripts/perf.sh (ne tue plus que l'instance qu'il lance).
Files main
Menu

Theme