Conclusion rapide : deux étapes, puis une vérification
La documentation Unity décrit deux opérations distinctes pour construire une application iOS : générer un projet Xcode, puis le compiler avec Xcode. Vous pouvez préparer le projet avec Unity et le synchroniser, mais la compilation finale, la signature et l’archivage doivent être réalisés dans un environnement macOS avec la chaîne Xcode adaptée au projet. Cette semaine, vérifiez d’abord les réglages et dépendances de votre export, puis utilisez un Mac distant pour produire et contrôler l’archive : une archive réussie ne prouve pas que le téléversement ou la validation par Apple a abouti. Unity décrit séparément la génération du projet et sa construction avec Xcode.
Ce parcours est destiné aux développeurs qui utilisent Unity 6.6 sous Windows ou Linux et doivent préparer une version iOS.
Il convient aussi aux équipes qui ont déjà exporté un projet Xcode et cherchent un environnement macOS pour le signer et l’archiver.
Si votre besoin se limite à choisir entre plusieurs modes de construction, cet article se concentre plutôt sur l’exécution et les vérifications.
Avant l’export, fixez les paramètres du projet iOS
Dans Unity, ne lancez pas l’export avant d’avoir identifié la cible de publication et les composants qui devront survivre au transfert. Le projet Xcode généré n’est pas le jeu complet au sens du flux de développement Unity : il constitue une étape intermédiaire, qui doit ensuite être ouverte et construite avec Xcode. Vérifiez cette séparation dans le processus officiel de construction et de distribution iOS de Unity.
Commencez par relever, dans votre projet :
- la valeur prévue pour le Bundle Identifier, qui doit correspondre à l’application concernée dans votre compte développeur ;
- la configuration de construction destinée à l’appareil ou au mode de test visé ;
- les plug-ins natifs, bibliothèques, ressources et scripts personnalisés requis ;
- les réglages de version et de build que vous souhaitez utiliser pour cette livraison.
La référence Unity 6.6 aux réglages de construction iOS est le point de contrôle pour les options disponibles dans cette version. Vérifiez-y les intitulés et le comportement attendu plutôt que de transposer une procédure issue d’une autre version : les réglages du projet, les extensions natives et les scripts peuvent modifier le résultat.
Il faut également confirmer ce que votre projet produit exactement. La documentation Unity sur la structure du projet Xcode généré permet d’identifier les éléments constitutifs de l’export. Cette vérification évite de traiter un fichier de projet isolé comme s’il contenait les ressources, le code natif et les dépendances nécessaires à la compilation.
Après l’export, comment transférer le projet sur le Mac distant ?
Transférez une copie de travail cohérente du projet, et non uniquement le fichier .xcodeproj. Le contenu exact dépend de l’export Unity et des dépendances de votre jeu : incluez les fichiers et ressources réellement nécessaires, ainsi que les composants natifs attendus par le projet. Si vous utilisez un espace de travail généré par un gestionnaire de dépendances, vérifiez également que la procédure de génération de cet espace de travail sera reproductible sur le Mac.
Pour une équipe, le dépôt de versions constitue généralement un moyen clair de retrouver le contenu correspondant à une révision donnée. Pour un projet volumineux ou un transfert ponctuel, vous pouvez utiliser un canal de transfert sécurisé, puis vérifier le contenu reçu avant d’ouvrir Xcode. Dans les deux cas, distinguez les fichiers de projet ordinaires des secrets de signature : ne déposez pas de clé privée de certificat dans le dépôt.
| Mode de transfert | À privilégier lorsque… | Vérification à effectuer sur le Mac |
|---|---|---|
| Dépôt de versions | Vous devez retrouver précisément la révision du jeu et ses changements | Confirmer la révision reçue et l’état des fichiers suivis |
| Transfert de fichiers sécurisé | Vous envoyez une copie de travail ou des éléments non suivis | Comparer la structure et vérifier que les ressources attendues sont présentes |
| Copie du seul fichier de projet Xcode | À éviter comme méthode de transfert complète | Récupérer les dépendances et fichiers associés avant toute construction |
Sur le Mac, consignez la révision utilisée et vérifiez si des modifications locales ou des fichiers manquants risquent de rendre la construction impossible. Par exemple, dans un dépôt :
git rev-parse --short HEAD
git status --short
Ces commandes servent à repérer la révision présente et les changements locaux ; elles ne certifient ni la complétude de l’export, ni la validité de la signature. Pour préparer un accès distant et vérifier les modalités de prise en main, vous pouvez consulter les informations de démarrage sur Mac distant.
À la première ouverture, contrôlez Xcode et les dépendances
Avant de lancer une archive, ouvrez le projet ou l’espace de travail sur le Mac et confirmez que l’environnement utilisé correspond bien aux exigences documentées de votre projet. Ne déduisez pas la compatibilité d’un plug-in de la seule présence d’un projet Xcode : consultez la documentation de la version du plug-in et vérifiez ce que le projet demande à Xcode et au SDK cible. La documentation Unity sur la configuration de l’environnement iOS est utile pour examiner la chaîne de développement côté Unity.
Relevez la version de Xcode utilisée et la révision du projet avant d’ouvrir l’archive. Cette trace facilite le diagnostic si une construction ultérieure donne un résultat différent.
xcodebuild -version
Si le projet a besoin d’un espace de travail, ouvrez celui-ci plutôt que le projet seul. Pour examiner les cibles et schémas reconnus par Xcode, adaptez la commande au fichier réellement exporté :
xcodebuild -list -project /chemin/vers/Unity-iPhone.xcodeproj
Lorsque l’export utilise un espace de travail, remplacez l’option -project par -workspace et indiquez le chemin correspondant. Le nom et le chemin réels varient selon l’export ; utilisez ceux de votre copie, sans supposer qu’un autre projet Unity aura la même arborescence.
Si des dépendances doivent être résolues ou des fichiers générés, suivez les consignes associées au projet et à chaque plug-in. Après une première résolution, notez ce qui a été exécuté et contrôlez que les fichiers requis sont disponibles sur le Mac. Une compilation qui ne fonctionne qu’après une action manuelle non documentée n’est pas encore un processus reproductible.
Avant la construction, alignez les réglages de signature
La signature dépend de plusieurs éléments qui doivent désigner la même application et la même équipe. Vérifiez le Bundle Identifier, l’équipe sélectionnée dans Xcode, l’identité de signature utilisée, le profil d’approvisionnement correspondant et les droits demandés par l’application. Les paramètres Unity déterminent une partie de l’export ; les réglages de cible Xcode et les ressources du compte développeur interviennent ensuite. Un réglage valide à une étape ne garantit donc pas que les autres soient alignés.
Les informations Apple sur les certificats expliquent le rôle des identités et la protection des certificats. Un profil d’approvisionnement n’est pas un substitut à la clé privée : contrôlez qu’il convient au contexte de signature et à l’application. Apple décrit la création d’un profil d’approvisionnement de développement ; les besoins d’une archive destinée à la distribution doivent être vérifiés dans le flux correspondant, au lieu de réutiliser automatiquement un profil de développement.
Le contrôle pratique consiste à comparer les paramètres de chaque étape :
- le Bundle Identifier défini pour l’application et celui configuré dans la cible Xcode ;
- l’équipe associée au projet et l’équipe liée aux ressources de signature disponibles ;
- les droits requis par l’application et ceux couverts par la configuration de signature ;
- le type de construction recherché et le profil approprié à ce type de distribution.
Une clé d’API utilisée pour autoriser un service n’est pas une identité de signature de code. Ne partagez pas de certificat privé, de mot de passe ni de secret de compte dans un exemple, un journal public ou un dépôt.
Si vous utilisez un Mac distant, vérifiez aussi où sont importés les éléments sensibles, qui peut accéder à la session et comment ils seront supprimés ou conservés après le travail. Les informations de VPSOmni sur la confidentialité des données peuvent vous aider à examiner ce volet avant d’y transférer des éléments liés au projet. Elles ne remplacent pas votre propre politique de gestion des secrets.
Pendant la construction, isolez chaque étape en cas d’échec
Ne réessayez pas une archive complète à l’aveugle. Construisez d’abord le projet pour la cible prévue et observez à quelle étape l’erreur apparaît : export Unity, résolution d’une dépendance, compilation Xcode, signature ou création de l’archive. Cette séparation évite de modifier des profils de signature pour corriger un fichier natif absent, ou de retoucher le projet Unity alors que le problème vient d’un réglage de cible Xcode.
Pour chaque tentative, gardez ensemble les éléments suivants :
- la révision du projet et la configuration de construction utilisée ;
- la version de Xcode relevée sur le Mac ;
- le texte de l’erreur et l’étape à laquelle elle apparaît ;
- les changements apportés depuis la tentative précédente.
Ne concluez pas à partir d’un message générique de fin de tâche. Recherchez l’erreur initiale dans le journal et identifiez le fichier, la cible ou le réglage mentionné. Si l’échec concerne une dépendance native, reprenez sa procédure de résolution ; si Xcode indique un problème de signature, revenez aux identifiants, à l’équipe et aux ressources d’approvisionnement. En cas d’échec au moment de l’archive, vérifiez d’abord que le schéma et la destination choisis correspondent à une archive de distribution, plutôt qu’à une construction destinée uniquement à l’exécution locale.
Pour conserver une trace lisible, utilisez un modèle sans y inscrire de secrets :
Révision du projet :
Version de Xcode :
Cible ou schéma :
Étape en échec :
Message pertinent :
Action corrective :
Résultat de la nouvelle tentative :
Cette fiche n’est pas un rapport de réussite tant que les champs ne sont pas remplis à partir de la tentative réelle. Elle vous permet toutefois de comparer les essais et de transmettre un diagnostic exploitable à un autre membre de l’équipe.
Comment créer l’archive et vérifier qu’elle est prête à être envoyée ?
Une fois la construction représentative réussie et les réglages alignés, utilisez le flux d’archivage de Xcode pour produire une archive inspectable. Apple décrit les réglages de projet à contrôler dans ses instructions de préparation à la distribution, puis le parcours de distribution d’une application pour les tests et les versions.
Dans Xcode, sélectionnez le schéma et la destination de construction adaptés à l’archive, puis lancez l’action d’archivage. À l’issue du traitement, ouvrez l’archive dans Organizer et vérifiez que son application, son identifiant, sa version, son numéro de build et ses informations de signature correspondent à la livraison prévue. Ne confondez pas la présence d’une archive avec la validation de tous les contrôles de distribution : suivez les résultats affichés par Xcode et corrigez les avertissements ou erreurs pertinents avant de poursuivre.
Votre choix de suite dépend du résultat recherché :
- Si l’archive correspond à la bonne application, que la signature et les métadonnées sont cohérentes et que les contrôles de Xcode ne signalent pas de blocage, alors poursuivez vers l’envoi prévu.
- Si l’identifiant, l’équipe, les droits ou le profil ne correspondent pas, alors arrêtez-vous et corrigez la configuration avant de téléverser.
- Si l’archive n’apparaît pas ou ne passe pas la validation attendue, alors revenez au journal de construction et traitez l’étape en échec plutôt que de supposer que l’envoi la réglera.
- Si le projet ne peut pas être reconstruit sans intervention manuelle imprévue, alors documentez cette dépendance et rendez l’environnement reproductible avant de confier la livraison à un autre membre de l’équipe.
Après le téléversement, vérifiez séparément l’état du build dans App Store Connect. Apple indique comment consulter les builds et leurs métadonnées. Un envoi lancé depuis Xcode n’équivaut ni à un traitement terminé, ni à une version prête à être distribuée, ni à une approbation de l’application.
Choisir l’environnement adapté à la suite du travail
Si vous travaillez déjà sous Windows ou Linux, vous pouvez garder Unity sur votre poste et réserver le Mac à la génération finale, à la signature et à l’archive. Cette organisation évite d’acheter un ordinateur uniquement pour une opération ponctuelle, mais elle impose de synchroniser le bon état du projet, de vérifier les dépendances sur la machine distante et de protéger soigneusement les secrets de signature. Pour une comparaison de ces usages, les options Mac de VPSOmni peuvent être évaluées en fonction de vos besoins de construction et de la durée d’utilisation.
À l’inverse, si vos jeux nécessitent des constructions iOS quotidiennes, des tests matériels récurrents ou des périphériques physiques disponibles localement, un Mac que vous contrôlez en permanence peut être plus approprié. Un environnement distant ne supprime pas le travail de diagnostic des plug-ins, ne corrige pas une signature incohérente et ne garantit pas l’acceptation d’une livraison.
Si votre poste actuel ne peut pas exécuter Xcode, une machine distante évite de faire transiter tout le travail vers un nouvel ordinateur local ; elle demande néanmoins une transmission fiable du projet et une gestion explicite des certificats. Pour un besoin limité à une livraison ou à une phase de test, louer un Mac auprès de VPSOmni permet d’effectuer ces étapes sans transformer l’achat d’un ordinateur en préalable. Avant de commencer, comparez l’environnement disponible avec les exigences de votre export Unity 6.6 et confirmez que vous pourrez contrôler l’archive ainsi que l’état du build après l’envoi.
Pour aller plus loin
Signez et archivez votre projet iOS sur un Mac distant
Avec VPSOmni, accédez à un Mac mini physique dédié pour préparer votre environnement et créer votre archive iOS.
Louer un Mac à distance