Deux chemins d'envoi · matrice d'accès · triage · acceptation vingt minutes
Les équipes qui louent un Mac Apple Silicon à l'heure atteignent App Store Connect par l'une de deux portes : Xcode Organizer après un Archive sur le même nœud, ou Transporter quand une pipeline a déjà produit un .ipa signé. L'erreur coûteuse est de traiter les deux comme un simple « envoi de fichier » et de supposer que le débit SSH équivaut à une livraison prête. L'envoi est le point où sessions Apple ID, déverrouillage du Trousseau, choix d'équipe et HTTPS longue durée se heurtent au compteur horaire. Ce guide nomme les deux chemins, fournit une matrice SSH vs VNC, décrit des runbooks Organizer et Transporter avec signaux d'échec pour les tickets, liste quatre faits citables pour le change control et se termine par une checklist VNC vingt minutes sous le même utilisateur. Liens : checklist premier test TestFlight externe, runbook Plan B Xcode Cloud, matrice Fastlane Match SSH/VNC et checklist première utilisation trente minutes.
Chemin A — Organizer : vous archivez dans Xcode sur le Mac loué, ouvrez Fenêtre → Organizer, puis Validate ou Distribute vers App Store Connect. Archive, identités de signature et client d'envoi partagent une pile GUI — idéal pour déboguer le provisionnement sur le même hôte.
Chemin B — Transporter : vous livrez un export signé (souvent CI ou lane) et utilisez Transporter — ou une automatisation sur les mêmes API — sans rouvrir tout le projet Xcode. Surface plus petite, mais authentification et contexte d'équipe restent dans l'état utilisateur macOS, pas seulement dans l'IPA.
Sur Mac cloud à l'heure, la douleur se mesure en temps réel, pas en erreurs de compilateur mystérieuses :
Getrennte Benutzer: SSH-Jobs laufen als ci, VNC-Debugging als admin — Organizer sieht Zertifikate, die der Terminal-Benutzer nie importiert hat.
Dette GUI cachée : les envois restent sur « Preparing » ou « Uploading 0% » car le Trousseau ou la 2FA attendent une session sans bureau.
Boîtes réseau intermédiaires : les VPN d'entreprise ou proxies agressifs coupent les uploads TLS longs ; symptômes ressemblant à une panne Apple.
Mauvais artefact : la CI livre un export ad-hoc ou development alors qu'Organizer attend une archive signée App Store avec version et numéro de build cohérents.
Décommissionnement trop tôt : la barre locale atteint 100 % mais App Store Connect traite encore ; le nœud est détruit avant de capturer l'ID de build.
Si vous avez déjà signé avec Fastlane Match sur le même hôte, l'envoi est la porte suivante — pas un sujet à part. Match versionne les actifs ; Organizer et Transporter exigent toujours une session Apple ID cohérente et la bonne méthode d'export.
Beaucoup d'équipes sans Mac de bureau développent sur Windows ou Linux et valident sur un nœud loué à l'étranger. La question n'est pas « quel outil est plus rapide », mais quel utilisateur macOS détient les entrées du Trousseau qu'Apple vérifie à l'envoi. Documentez nom d'utilisateur, Team ID et horodatage UTC dans chaque ticket — pas seulement « build vert dans Jenkins ».
Cartographiez les tâches avant d'ouvrir une session. Étiquetez ssh-ok, vnc-une-fois ou vnc-obligatoire pour éviter une heure de bail en retries headless.
| Tâche | Accès recommandé | Signal d'échec typique | Mauvaise lecture |
|---|---|---|---|
| Archive + Organizer Validate | VNC (même utilisateur que Archive) | Lignes de provisionnement rouges dans Organizer | Accuser les miroirs CocoaPods |
| Première connexion Apple ID sur le nœud | VNC | Boucle 2FA ou « impossible de vérifier le compte » | Ajuster le MTU du routeur |
| Premier couplage Transporter | VNC | Feuille de connexion derrière SSH | Re-télécharger l'IPA |
| Envoi répété (session en cache) | SSH acceptable si même utilisateur + logs | 403 intermittents sur les API altool | Supposer uniquement une panne Apple |
| Upload via xcrun altool | SSH après Trousseau amorcé en VNC | « Impossible d'envoyer le paquet » sans détail | Monter Xcode au hasard |
| Métadonnées ASC dans Safari | VNC | Traitement bloqué vs retenue conformité | Renvoyer un build identique |
| Nettoyage disque avant Archive | SSH | Archive échoue : stockage insuffisant | Acheter un palier plus grand sans supprimer DerivedData |
Libellez « VNC une fois » avant la fenêtre de release. Les invites d'envoi coûtent moins à 10h qu'à 23h45 quand le compteur de bail hurle.
Quand Xcode Cloud est votre builder principal, les envois atterrissent souvent sur un Mac loué en Plan B — voir notre runbook file d'attente et Plan B pour basculer des logs Cloud vers un nœud physique avec Organizer.
Organizer est le défaut quand le Mac loué est votre source de vérité pour la signature. Travaillez en VNC comme l'utilisateur qui possédera les envois pendant le bail. Vérifiez Xcode → Réglages → Comptes : bonne équipe, pas d'avertissements jaunes avant d'archiver.
Hygiène du scheme : Configuration Release, Any iOS Device (ou appareil connecté si entitlements spécifiques), incrémentez CFBundleVersion délibérément — jamais « automatique » sans vérifier ASC.
Archive: Produit → Archiver ; attendez la liste dans Organizer. Si Archiver est grisé, corrigez la signature dans l'éditeur de projet en VNC pour cliquer les invites.
Validate: attrape beaucoup de rejets ASC tôt (icônes, entitlements, conformité manquante). Sauvegardez le PDF de log dans le ticket.
Distribute → App Store Connect: choisissez upload, symboles si demandé, questions de conformité d'export — répondez comme le questionnaire confidentialité.
Nachweise: capturez le succès Organizer, horodatage UTC, ouvrez ASC → TestFlight pour confirmer le traitement — pas seulement la barre locale.
# Même utilisateur macOS que le bureau VNC — contrôle avant envoi Organizer whoami xcodebuild -version security find-identity -v -p codesigning | head -n 15 /usr/sbin/systemsetup -getusingnetworktime
Note : Avec Match sur cet hôte, lancez un sync readonly avant Archive pour aligner Organizer et CLI — détails dans l'article matrice Match.
Transporter brille quand la ferme de compilation est ailleurs mais Apple exige toujours un client d'envoi Mac avec compte vendeur connecté. Flux typique : télécharger l'IPA signé sur le Mac loué (rsync SSH ok), ouvrir Transporter en VNC, glisser le paquet, livrer, vérifier dans ASC.
Vérifier la méthode d'export : L'IPA doit être éligible App Store ou TestFlight ; exports enterprise ou ad-hoc échouent avec des ITMS opaques.
Contrôle de collision de version : CFBundleShortVersionString und CFBundleVersion comparez au dernier build live dans ASC — renvoyer les mêmes numéros gaspille la file.
Connectez-vous une fois en VNC : complétez Apple ID et mots de passe spécifiques ; confirmez que le nom du fournisseur correspond à l'entité juridique.
Livrer : surveillez le volet d'activité Transporter ; exportez le journal de livraison si le support demande.
Passage à TestFlight : nach Processing die guide premier envoi TestFlight für externe Tester-Gates.
Les équipes d'automatisation enveloppent parfois Transporter avec iTMSTransporter ou Fastlane upload_to_app_store. Cela peut être piloté en SSH après qu'un humain ait déverrouillé le Trousseau en session graphique. « Envoi headless le jour un » est un stade de maturité, pas le défaut du bail.
Astuce : Gardez les sommes de contrôle IPA dans le manifeste CI. Si Transporter rejette, vous prouvez si les bits ont changé en transit ou si le rejet est côté politique.
Exécutez cette grille avant de déclarer le nœud de release terminé. Joignez des captures au ticket de changement.
| Contrôle | Action | Critère de réussite |
|---|---|---|
| Parité utilisateur | Compte barre de menus = whoami en SSH. | Pas d'envois multi-utilisateurs. |
| Xcode Accounts | Équipe sélectionnée ; pas d'avertissements jaunes. | Team ID attendu visible. |
| Archiv oder IPA | Organizer montre le build du jour ou somme IPA Transporter loguée. | Version/build monotone vs ASC. |
| Validate / essai à sec | Organizer Validate oder Transporter-Verifizierung. | Pas d'erreurs bloquantes dans le log exporté. |
| Envoi terminé | Organizer/Transporter-Erfolgs-UI. | Horodatage UTC enregistré. |
| Traitement ASC | Safari: TestFlight-Build erscheint (kann noch verarbeiten). | Numéro de build = artefact. |
| Marge disque | df -h auf Systemvolume. | ≥15 % libre avant prochain Archive. |
Nouveau chez le fournisseur ? Lancez la checklist première utilisation une fois par image, puis cette grille courte orientée envoi à chaque release.
Après traitement — groupes de testeurs et conformité.
Lire →Quand les files Cloud échouent et vous basculez sur un Mac loué.
Lire →Actifs de signature avant d'ouvrir Organizer.
Lire →Organizer, wenn Sie auf dem Knoten archivieren und Validate plus Distribute in einem Fluss wollen. Transporter, wenn CI bereits ein signiertes IPA liefert — mit VNC für die Erstanmeldung.
Parfois, après mise en cache pour le même utilisateur. Première Apple ID, Trousseau et couplage Transporter exigent encore la VNC — voir section deux.
Proxies, dérive d'horloge, session Xcode expirée, mauvaise équipe ou invite GUI derrière SSH. Capturez des preuves réseau avant de renvoyer le même IPA.
Prévoyez vingt minutes de VNC pour parité, fin d'envoi et visibilité ASC — plus long si conformité d'export ou questionnaires chiffrement.
Organizer et Transporter ne sont pas des raccourcis interchangeables — pipelines différents, mais tous deux exigent une session utilisateur macOS saine sur la machine facturée. SSH seul cache les invites jusqu'à la fin du bail ; posséder un Mac supprime le stress horaire mais ajoute matériel au repos, politiques de veille et place au bureau entre les livraisons.
Traitez la VNC comme infrastructure d'envoi : même utilisateur qu'à l'Archive, preuves dans ASC, puis détruisez le nœud.
Brauchen Sie einen dedizierten Apple-Silicon-Host mit vollem Desktop für Organizer oder Transporter, stellt VNCMac Remote-Macs für Livraison iOS bereit — nutzen Sie die Deploy-Karte unten oder die page d'achat et accueil produit, um diese Checkliste beim nächsten Build abzubilden.