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
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 protectioncompleteUnlessOpen, puis affiche « Ajouté à SP Chat » et se ferme. - L'app, à chaque passage au premier plan (
scenePhase == .active) et connectée, litinbox/, 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 dansinbox/. - Effacement :
AppEnvironment.wipeLocalData()(déconnexion, session révoquée) vide aussiinbox/. L'extension refuse d'écrire si le marqueursigned-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 deAttachmentIntake.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é
- 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.spchatet surai.spboucher.spchat.share, en y cochant ce groupe ; - activer Data Protection (
PROTECTED_UNLESS_OPEN) surai.spboucher.spchat.share, comme sur l'app.
- 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. project.yml— ajouter la cible et l'embarquer :yamltargets: 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- Droits :
SPChat-iOS/Resources/SPChat.entitlements: ajoutercom.apple.security.application-groups = [group.ai.spboucher.spchat];SPChatShare/SPChatShare.entitlements: le même groupe +com.apple.developer.default-data-protection = NSFileProtectionCompleteUnlessOpen.
SPChatShare/Info.plist:NSExtensionPointIdentifier = com.apple.share-services,NSExtensionPrincipalClass = $(PRODUCT_MODULE_NAME).ShareViewController, et une règle d'activation explicite (pasTRUEPREDICATE, refusé en revue) :NSExtensionActivationSupportsText = true,…SupportsWebURLWithMaxCount = 1,…SupportsImageWithMaxCount = 10,…SupportsFileWithMaxCount = 10.- Code (≈ 300 lignes) :
SPChatShare/ShareViewController.swift: litextensionContext.inputItems(NSItemProvider:public.plain-text,public.url,public.image,public.file-url), copie dansinbox/<uuid>/, écritmanifest.json, appellecompleteRequest;SPChat-iOS/Core/Persistence/SharedInbox.swift(compilé dans les deux cibles) : chemins du conteneur (FileManager.containerURL(forSecurityApplicationGroupIdentifier:)), format du manifeste, marqueursigned-in, lecture / effacement ;AppEnvironment:importSharedInbox()appelé danssynchronize(); pose / retrait du marqueur dansdidSignIn()/wipeLocalData().
PrivacyInfo.xcprivacyde l'extension (aucune collecte ;NSPrivacyAccessedAPICategoryFileTimestampsi les dates de fichiers sont lues) etExportOptions.plist: rien à changer en signature automatique (Xcode crée le profil de l'extension) ; en signature manuelle, ajouter son profil dansprovisioningProfiles.- 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). Scripts/build.sh generate,Scripts/test-live.sh test && Scripts/test-live.sh uitest, puisScripts/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 »).