Repository Public
1<!--2SP Chat iOS3File: docs/SHARE_EXTENSION.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Extension de partage — conception, en attente d'approbation du propriétaire89**É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.10Ce document dit pourquoi, compare les conceptions possibles et donne les étapes exactes de celle qui est recommandée.1112## Le but1314Depuis une autre app (Safari, Photos, Fichiers, Notes…) : « Partager → SP Chat » ouvre un **nouveau brouillon** contenant15le texte, l'URL, les images ou les fichiers partagés. Rien n'est envoyé à un modèle sans le propriétaire.1617## La contrainte1819L'identifiant d'app `ai.spboucher.spchat` est **partagé avec l'app macOS** (profil Developer ID « SP Chat Developer ID »).20Toute capacité ajoutée ou retirée sur cet identifiant invalide ce profil et le profil App Store iOS (c'est arrivé le212026-11-17 avec Data Protection). La consigne de la 2.0 : ne pas toucher aux capacités de l'identifiant principal.2223Une extension de partage est un **processus distinct**, avec son propre bac à sable. Pour remettre un contenu à l'app,24il lui faut soit un stockage commun, soit le jeton de session (pour téléverser elle-même), soit un canal de passage.2526## Les conceptions sans nouvelle capacité sur l'identifiant principal — évaluation honnête2728| # | Conception | Texte / URL | Images / fichiers | Verdict |29|---|---|---|---|---|30| 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 |31| 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é |32| 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 |33| 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** |34| 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 |3536Conclusion : **aucune conception correcte ne tient sans capacité nouvelle.** A et B « marcheraient » en démonstration,37pas 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 le38compositeur (iPad, Split View), collage d'image, Fichiers / Photos / appareil photo depuis le compositeur, raccourci39« Demander à SP Chat » (Raccourcis / Siri, texte) et lien `spchat://new?text=`.4041## Conception recommandée (D) — App Group + file d'import4243```44App hôte ──Partager──▶ SPChatShare.appex ──écrit──▶ conteneur App Group ──lu par──▶ SP Chat (au premier plan)45 (aucun réseau, aucun jeton) group.ai.spboucher.spchat téléverse, crée le brouillon46```4748- L'extension **ne parle jamais au réseau et ne voit jamais le jeton de session**. Elle copie les éléments partagés dans49 `…/Shared/inbox/<uuid>/` (fichiers + `manifest.json` : texte, URL, noms, types UTI, date) avec la protection50 `completeUnlessOpen`, puis affiche « Ajouté à SP Chat » et se ferme.51- L'app, à chaque passage au premier plan (`scenePhase == .active`) et connectée, lit `inbox/`, ouvre un nouveau52 brouillon (`AppEnvironment.startNewConversation(text:)`), y ajoute les fichiers par le chemin existant53 (`ChatSession.addAttachment` → `POST /api/attachments`, mêmes limites : 10 fichiers, réduction des photos), puis54 **efface le dossier importé**. Un import est donc traité une seule fois ; hors ligne, il attend dans `inbox/`.55- Effacement : `AppEnvironment.wipeLocalData()` (déconnexion, session révoquée) vide aussi `inbox/`. L'extension refuse56 d'écrire si le marqueur `signed-in` (fichier vide posé par l'app à la connexion, retiré à la déconnexion) est absent,57 et affiche « Connecte-toi d'abord dans SP Chat ».58- Limites affichées par l'extension : 10 éléments, 50 Mo par fichier (limite du serveur `limits.maxUploadMb`), types59 acceptés = ceux de `AttachmentIntake.importTypes`. Un élément refusé est nommé, pas ignoré en silence.60- Pas de vue web, pas de dépendance : SwiftUI dans un `UIHostingController`, comme le reste de l'app.6162### Ce que cela change côté Apple (à approuver)6364| Élément | Changement | Effet sur le Mac |65|---|---|---|66| Nouvel identifiant `ai.spboucher.spchat.share` (extension) | création | **aucun** : un identifiant distinct ne modifie pas le principal |67| Nouveau groupe `group.ai.spboucher.spchat` | création | aucun |68| 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 |6970C'est ce troisième point qui demande l'accord du propriétaire, à coordonner avec la session du projet macOS.7172### Étapes exactes, une fois approuvé73741. **Portail développeur** (ou `Scripts/asc.py`) :75 - `POST /v1/bundleIds` : `identifier = ai.spboucher.spchat.share`, `platform = IOS`, nom « SP Chat Share » ;76 - créer le groupe `group.ai.spboucher.spchat` (Certificates, IDs & Profiles → Identifiers → App Groups ; l'API77 publique ne crée pas les groupes) ;78 - activer **App Groups** sur `ai.spboucher.spchat` **et** sur `ai.spboucher.spchat.share`, en y cochant ce groupe ;79 - activer **Data Protection** (`PROTECTED_UNLESS_OPEN`) sur `ai.spboucher.spchat.share`, comme sur l'app.802. **Prévenir le projet macOS** : `cd ~/Desktop/Cluster/apple/SPChat && Scripts/provision.py` (régénère le profil81 Developer ID), puis vérifier une archive notarisée.823. **`project.yml`** — ajouter la cible et l'embarquer :83 ```yaml84 targets:85 SPChatShare:86 type: app-extension87 platform: iOS88 sources: [{ path: SPChatShare }]89 settings:90 base:91 PRODUCT_BUNDLE_IDENTIFIER: ai.spboucher.spchat.share92 INFOPLIST_FILE: SPChatShare/Info.plist93 CODE_SIGN_ENTITLEMENTS: SPChatShare/SPChatShare.entitlements94 GENERATE_INFOPLIST_FILE: NO95 SKIP_INSTALL: YES96 SPChat:97 dependencies:98 - package: SwiftMath99 - target: SPChatShare # embarquée dans SPChat.app/PlugIns100 ```1014. **Droits** :102 - `SPChat-iOS/Resources/SPChat.entitlements` : ajouter103 `com.apple.security.application-groups = [group.ai.spboucher.spchat]` ;104 - `SPChatShare/SPChatShare.entitlements` : le même groupe +105 `com.apple.developer.default-data-protection = NSFileProtectionCompleteUnlessOpen`.1065. **`SPChatShare/Info.plist`** : `NSExtensionPointIdentifier = com.apple.share-services`,107 `NSExtensionPrincipalClass = $(PRODUCT_MODULE_NAME).ShareViewController`, et une règle d'activation explicite108 (pas `TRUEPREDICATE`, refusé en revue) :109 `NSExtensionActivationSupportsText = true`, `…SupportsWebURLWithMaxCount = 1`,110 `…SupportsImageWithMaxCount = 10`, `…SupportsFileWithMaxCount = 10`.1116. **Code** (≈ 300 lignes) :112 - `SPChatShare/ShareViewController.swift` : lit `extensionContext.inputItems` (`NSItemProvider` :113 `public.plain-text`, `public.url`, `public.image`, `public.file-url`), copie dans `inbox/<uuid>/`, écrit114 `manifest.json`, appelle `completeRequest` ;115 - `SPChat-iOS/Core/Persistence/SharedInbox.swift` (compilé dans les deux cibles) : chemins du conteneur116 (`FileManager.containerURL(forSecurityApplicationGroupIdentifier:)`), format du manifeste, marqueur `signed-in`,117 lecture / effacement ;118 - `AppEnvironment` : `importSharedInbox()` appelé dans `synchronize()` ; pose / retrait du marqueur dans119 `didSignIn()` / `wipeLocalData()`.1207. **`PrivacyInfo.xcprivacy`** de l'extension (aucune collecte ; `NSPrivacyAccessedAPICategoryFileTimestamp` si les121 dates de fichiers sont lues) et **`ExportOptions.plist`** : rien à changer en signature automatique (Xcode crée le122 profil de l'extension) ; en signature manuelle, ajouter son profil dans `provisioningProfiles`.1238. **Tests** : unitaires sur `SharedInbox` (manifeste, import unique, effacement à la déconnexion, refus sans marqueur) ;124 test d'interface qui dépose un manifeste dans le conteneur puis vérifie le brouillon ; essai réel sur appareil depuis125 Safari, Photos et Fichiers (le simulateur ne présente pas fidèlement la feuille de partage d'apps tierces).1269. `Scripts/build.sh generate`, `Scripts/test-live.sh test && Scripts/test-live.sh uitest`, puis `Scripts/release.sh`.127128### Variante si App Groups est refusé129130Livrer seulement le **texte et les URL** par une *Action Extension* qui ne fait qu'afficher un bouton « Ouvrir dans131SP Chat » : c'est la conception A, avec ses défauts (API non prise en charge, pas de fichiers). Elle n'est pas132recommandée ; le raccourci « Demander à SP Chat » de l'app Raccourcis couvre déjà ce cas sans rien contourner133(il apparaît dans la feuille de partage quand le propriétaire l'y ajoute : Raccourcis → détails → « Afficher dans la134feuille de partage »).135