SPB Git

Repository Public

SHARE_EXTENSION.md 10.5 KB

# Extension de partage — conception, en attente d'approbation du propriétaire

État : non implémentée dans la 2.0.0 (2). Aucune cible n'a été ajoutée, aucune capacité n'a été modifiée. Ce document dit pourquoi, compare les conceptions possibles et donne les étapes exactes de celle qui est recommandée.

# Le but

Depuis une autre app (Safari, Photos, Fichiers, Notes…) : « Partager → SP Chat » ouvre un nouveau brouillon contenant le texte, l'URL, les images ou les fichiers partagés. Rien n'est envoyé à un modèle sans le propriétaire.

# La contrainte

L'identifiant d'app ai.spboucher.spchat est partagé avec l'app macOS (profil Developer ID « SP Chat Developer ID »). Toute capacité ajoutée ou retirée sur cet identifiant invalide ce profil et le profil App Store iOS (c'est arrivé le 2026-11-17 avec Data Protection). La consigne de la 2.0 : ne pas toucher aux capacités de l'identifiant principal.

Une extension de partage est un processus distinct, avec son propre bac à sable. Pour remettre un contenu à l'app, il lui faut soit un stockage commun, soit le jeton de session (pour téléverser elle-même), soit un canal de passage.

# Les conceptions sans nouvelle capacité sur l'identifiant principal — évaluation honnête

# Conception Texte / URL Images / fichiers Verdict
A L'extension ouvre spchat://new?text=… possible en théorie non (une URL ne transporte pas un fichier ; limite pratique de quelques kilo-octets) Rejetée. NSExtensionContext.open(_:) n'est autorisé que pour les extensions « Today » ; depuis une extension de partage il faut remonter la chaîne de répondeurs jusqu'à UIApplication et appeler openURL: par sélecteur. C'est une API non prise en charge : elle a cessé de fonctionner plusieurs fois selon les versions d'iOS, ne fonctionne pas depuis toutes les apps hôtes et expose à un refus en revue App Store. Présenter cela comme une fonction fiable serait faux
B Presse-papiers : l'extension copie le contenu, l'app le lit au lancement oui images seulement, une à la fois Rejetée. Écrase le presse-papiers du propriétaire, affiche la bannière « SP Chat a collé depuis… », ne lance pas l'app (il faut l'ouvrir à la main), et le presse-papiers est lisible par les autres apps (et par le Presse-papiers universel) : inadapté à un contenu privé
C L'extension téléverse elle-même vers /api/attachments puis crée le brouillon serveur (PUT /api/drafts) oui oui Impossible sans capacité. Il lui faut le jeton de session : il vit dans le Trousseau de l'app, groupe d'accès 3YM54G49SN.ai.spboucher.spchat. Une extension ne lit ce groupe que si l'app et l'extension déclarent keychain-access-groups (capacité Keychain Sharing) — donc une capacité sur l'identifiant principal
D Dossier commun (App Group) : l'extension y dépose le contenu, l'app l'importe oui oui La bonne conception, mais elle exige App Groups sur l'identifiant principal
E Second passkey dans l'extension (session propre) — — Rejetée. Les domaines associés (webcredentials) de l'extension demandent la capacité Associated Domains sur son identifiant (possible) et l'ajout de 3YM54G49SN.ai.spboucher.spchat.share dans webcredentials.apps du backend ; l'interface d'une extension de partage est trop contrainte (mémoire ~120 Mo, durée de vie courte) pour une cérémonie d'authentification ; et une session de plus à chaque partage n'est pas souhaitable

Conclusion : aucune conception correcte ne tient sans capacité nouvelle. A et B « marcheraient » en démonstration, pas en usage réel. La fonction n'est donc pas livrée ; ce qui existe déjà dans l'app reste : glisser-déposer vers le compositeur (iPad, Split View), collage d'image, Fichiers / Photos / appareil photo depuis le compositeur, raccourci « Demander à SP Chat » (Raccourcis / Siri, texte) et lien spchat://new?text=.

# Conception recommandée (D) — App Group + file d'import

text
App hôte ──Partager──▶ SPChatShare.appex ──écrit──▶ conteneur App Group ──lu par──▶ SP Chat (au premier plan)
                       (aucun réseau, aucun jeton)   group.ai.spboucher.spchat      téléverse, crée le brouillon
  • L'extension ne parle jamais au réseau et ne voit jamais le jeton de session. Elle copie les éléments partagés dans …/Shared/inbox/<uuid>/ (fichiers + manifest.json : texte, URL, noms, types UTI, date) avec la protection completeUnlessOpen, puis affiche « Ajouté à SP Chat » et se ferme.
  • L'app, à chaque passage au premier plan (scenePhase == .active) et connectée, lit inbox/, ouvre un nouveau brouillon (AppEnvironment.startNewConversation(text:)), y ajoute les fichiers par le chemin existant (ChatSession.addAttachment → POST /api/attachments, mêmes limites : 10 fichiers, réduction des photos), puis efface le dossier importé. Un import est donc traité une seule fois ; hors ligne, il attend dans inbox/.
  • Effacement : AppEnvironment.wipeLocalData() (déconnexion, session révoquée) vide aussi inbox/. L'extension refuse d'écrire si le marqueur signed-in (fichier vide posé par l'app à la connexion, retiré à la déconnexion) est absent, et affiche « Connecte-toi d'abord dans SP Chat ».
  • Limites affichées par l'extension : 10 éléments, 50 Mo par fichier (limite du serveur limits.maxUploadMb), types acceptés = ceux de AttachmentIntake.importTypes. Un élément refusé est nommé, pas ignoré en silence.
  • Pas de vue web, pas de dépendance : SwiftUI dans un UIHostingController, comme le reste de l'app.

# Ce que cela change côté Apple (à approuver)

Élément Changement Effet sur le Mac
Nouvel identifiant ai.spboucher.spchat.share (extension) création aucun : un identifiant distinct ne modifie pas le principal
Nouveau groupe group.ai.spboucher.spchat création aucun
Capacité App Groups sur ai.spboucher.spchat ajout d'une capacité sur l'identifiant partagé invalide le profil « SP Chat Developer ID » (et le profil App Store iOS, régénéré par Xcode) → relancer Scripts/provision.py dans ~/Desktop/Cluster/apple/SPChat avant la prochaine version du Mac

C'est ce troisième point qui demande l'accord du propriétaire, à coordonner avec la session du projet macOS.

# Étapes exactes, une fois approuvé

  1. Portail développeur (ou Scripts/asc.py) :
    • POST /v1/bundleIds : identifier = ai.spboucher.spchat.share, platform = IOS, nom « SP Chat Share » ;
    • créer le groupe group.ai.spboucher.spchat (Certificates, IDs & Profiles → Identifiers → App Groups ; l'API publique ne crée pas les groupes) ;
    • activer App Groups sur ai.spboucher.spchat et sur ai.spboucher.spchat.share, en y cochant ce groupe ;
    • activer Data Protection (PROTECTED_UNLESS_OPEN) sur ai.spboucher.spchat.share, comme sur l'app.
  2. Prévenir le projet macOS : cd ~/Desktop/Cluster/apple/SPChat && Scripts/provision.py (régénère le profil Developer ID), puis vérifier une archive notarisée.
  3. project.yml — ajouter la cible et l'embarquer :
    yaml
    targets:
      SPChatShare:
        type: app-extension
        platform: iOS
        sources: [{ path: SPChatShare }]
        settings:
          base:
            PRODUCT_BUNDLE_IDENTIFIER: ai.spboucher.spchat.share
            INFOPLIST_FILE: SPChatShare/Info.plist
            CODE_SIGN_ENTITLEMENTS: SPChatShare/SPChatShare.entitlements
            GENERATE_INFOPLIST_FILE: NO
            SKIP_INSTALL: YES
      SPChat:
        dependencies:
          - package: SwiftMath
          - target: SPChatShare        # embarquée dans SPChat.app/PlugIns
  4. Droits :
    • SPChat-iOS/Resources/SPChat.entitlements : ajouter com.apple.security.application-groups = [group.ai.spboucher.spchat] ;
    • SPChatShare/SPChatShare.entitlements : le même groupe + com.apple.developer.default-data-protection = NSFileProtectionCompleteUnlessOpen.
  5. SPChatShare/Info.plist : NSExtensionPointIdentifier = com.apple.share-services, NSExtensionPrincipalClass = $(PRODUCT_MODULE_NAME).ShareViewController, et une règle d'activation explicite (pas TRUEPREDICATE, refusé en revue) : NSExtensionActivationSupportsText = true, …SupportsWebURLWithMaxCount = 1, …SupportsImageWithMaxCount = 10, …SupportsFileWithMaxCount = 10.
  6. Code (≈ 300 lignes) :
    • SPChatShare/ShareViewController.swift : lit extensionContext.inputItems (NSItemProvider : public.plain-text, public.url, public.image, public.file-url), copie dans inbox/<uuid>/, écrit manifest.json, appelle completeRequest ;
    • SPChat-iOS/Core/Persistence/SharedInbox.swift (compilé dans les deux cibles) : chemins du conteneur (FileManager.containerURL(forSecurityApplicationGroupIdentifier:)), format du manifeste, marqueur signed-in, lecture / effacement ;
    • AppEnvironment : importSharedInbox() appelé dans synchronize() ; pose / retrait du marqueur dans didSignIn() / wipeLocalData().
  7. PrivacyInfo.xcprivacy de l'extension (aucune collecte ; NSPrivacyAccessedAPICategoryFileTimestamp si les dates de fichiers sont lues) et ExportOptions.plist : rien à changer en signature automatique (Xcode crée le profil de l'extension) ; en signature manuelle, ajouter son profil dans provisioningProfiles.
  8. Tests : unitaires sur SharedInbox (manifeste, import unique, effacement à la déconnexion, refus sans marqueur) ; test d'interface qui dépose un manifeste dans le conteneur puis vérifie le brouillon ; essai réel sur appareil depuis Safari, Photos et Fichiers (le simulateur ne présente pas fidèlement la feuille de partage d'apps tierces).
  9. Scripts/build.sh generate, Scripts/test-live.sh test && Scripts/test-live.sh uitest, puis Scripts/release.sh.

# Variante si App Groups est refusé

Livrer seulement le texte et les URL par une Action Extension qui ne fait qu'afficher un bouton « Ouvrir dans SP Chat » : c'est la conception A, avec ses défauts (API non prise en charge, pas de fichiers). Elle n'est pas recommandée ; le raccourci « Demander à SP Chat » de l'app Raccourcis couvre déjà ce cas sans rien contourner (il apparaît dans la feuille de partage quand le propriétaire l'y ajoute : Raccourcis → détails → « Afficher dans la feuille de partage »).

Files main
Menu

Theme