La plupart des problèmes d’utilisation se diagnostiquent en suivant deux pistes : le bureau à distance dans le navigateur et SSH. Utilisez le bureau pour les tâches graphiques et le terminal pour examiner les sorties de compilation. Vérifiez d’abord la connexion, puis les outils, la signature et les fichiers.
Votre machine est déjà prête ? Connectez-vous et récupérez les informations de connexion dans les détails de l’instance. Cet article ne fournit ni adresse d’hôte ni mot de passe génériques.
Le bureau dans le navigateur ne nécessite aucun client de bureau à distance. Sous Windows, SSH constitue un autre point d’accès : si l’affichage du bureau pose problème, vérifiez ainsi si la machine reste joignable. Dans les deux cas, utilisez l’adresse, le port et le compte affichés dans la console.
Connectez-vous à la console et retrouvez votre commande et votre instance. Vérifiez le modèle, le nœud, la date d’expiration et l’état actuel. Si le paiement est confirmé mais que l’activation est toujours en cours, consultez les informations affichées avant de commander à nouveau la même configuration.
Dans les détails de l’instance, ouvrez l’accès au bureau à distance. Attendez l’affichage de macOS avant de cliquer dans le bureau. Ne communiquez à personne l’adresse de la page de connexion, le mot de passe ni les informations sensibles visibles sur une capture d’écran.
Testez successivement les clics de souris, la saisie de texte en anglais et le changement de fenêtre. Ouvrez le Finder pour vérifier que les fichiers sont visibles, puis le Terminal pour contrôler les outils. Si la saisie en chinois ne fonctionne pas, vérifiez séparément la méthode de saisie locale et la source de saisie distante, sans réinstaller le système.
Dans Windows PowerShell, exécutez la commande ci-dessous et renseignez le nom d’utilisateur, l’hôte et le port indiqués dans les détails de l’instance. Lors de la première connexion, vérifiez l’empreinte de l’hôte. Il est normal que le mot de passe ne s’affiche pas pendant la saisie.
Dans Windows PowerShell, renseignez les paramètres de connexion un par un. Les variables ci-dessous proviennent de vos propres réponses : elles ne constituent pas des identifiants utilisables tels quels.
$MacUser = Read-Host "Saisissez le nom utilisateur de l’instance"
$MacHost = Read-Host "Saisissez l’hôte de l’instance"
$MacPort = Read-Host "Saisissez le port SSH"
ssh -p $MacPort "$MacUser@$MacHost"En cas de délai d’attente dépassé, vérifiez le réseau, l’hôte et le port. En cas d’échec d’authentification, vérifiez le nom d’utilisateur et la méthode d’authentification. Si l’empreinte de l’hôte a changé, vérifiez d’abord si le système a été réinstallé ; ne supprimez pas l’ancienne entrée sans contrôle.
Une connexion SSH ne signifie pas que le projet est configuré. Vérifiez d’abord le chemin et la version d’Xcode, puis archivez le projet. Le téléversement dépend d’une lane fastlane déjà configurée, des éléments de signature et des autorisations de distribution.
Le workflow à droite est donné à titre d’exemple : il ne s’agit pas d’un test de performances et il ne fonctionnera pas forcément tel quel pour tous les projets. Le nom d’hôte est fictif. Pour vous connecter, utilisez la commande interactive de la section précédente.
App est un exemple de scheme. Remplacez les paramètres correspondants par le workspace, le project et le scheme de votre projet avant de lancer l’archivage. Si des dépendances ne sont pas installées, corrigez d’abord les erreurs correspondantes.
fastlane beta ne s’applique beta qu’aux projets disposant déjà d’une lane beta. Une fois l’archivage réussi, vérifiez le traitement effectif par le service de distribution : le lancement de la commande ne signifie pas que le téléversement est terminé.
$ ssh developer@your-mac-host
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ xcodebuild -version
$ cd ~/Projects/App
$ xcodebuild -scheme App archive
** ARCHIVE SUCCEEDED **
$ fastlane beta
Successfully uploaded package to TestFlightConservez la commande complète, la première erreur et le résumé de la dernière erreur. Un simple extrait indiquant « échec de la compilation » ne suffit généralement pas à identifier le problème.
L’interface graphique de macOS et la ligne de commande sont toutes deux disponibles. À la première ouverture du projet, vérifiez les outils avant de configurer la signature. Fiez-vous aux résultats obtenus sur l’instance pour connaître les versions d’Xcode installées et celle qui est sélectionnée.
Exécutez xcodebuild -version et xcode-select -p. Dans les réglages d’Xcode, vérifiez la sélection des outils en ligne de commande, puis confirmez le SDK requis par le projet et les versions du système cible.
Si le projet utilise CocoaPods, Swift Package Manager ou un autre gestionnaire de dépendances, réinstallez d’abord les dépendances en suivant les instructions du projet. Après une erreur, évitez de mettre à jour tous les outils en même temps.
Transférez les certificats vers l’instance par un moyen sécurisé, puis importez les certificats et les clés privées nécessaires dans Trousseaux d’accès. Si un fichier est protégé par un mot de passe, transmettez celui-ci par un autre canal.
Sans la clé privée associée au certificat, vous ne pourrez pas signer avec cette identité. Ne mettez jamais de clé privée ni de mot de passe de certificat dans un dépôt, l’historique des commandes ou une pièce jointe accessible d’un ticket.
Importez le profil de provisionnement requis par le projet. Vérifiez que l’identifiant de bundle, l’identifiant d’équipe, la période de validité et le type de distribution correspondent à votre cible, puis contrôlez les réglages de signature de chaque target.
Pour votre premier essai, effectuez un archivage reproductible dans l’interface graphique. Une fois la configuration vérifiée, reprenez les mêmes paramètres dans un script ou une CI pour limiter les écarts entre l’interface et la ligne de commande.
| Erreur ou symptôme | À vérifier en priorité | Étape suivante |
|---|---|---|
| No signing certificate | Vérifiez que le trousseau actuel contient l’identité de signature requise et la clé privée associée au certificat. | Contrôlez à nouveau les éléments importés et leur période de validité. Évitez de télécharger plusieurs fois le même certificat sans vérifier. |
| No profiles for… | Vérifiez que l’identifiant d’application, l’équipe et le type de distribution du profil correspondent au target actuel. | Importez le profil de provisionnement correspondant et vérifiez les paramètres de signature du projet. |
| User interaction is not allowed | Vérifiez l’utilisateur qui exécute la compilation, l’état de verrouillage du trousseau et les autorisations d’accès de l’outil de signature. | Dans le bureau, vérifiez que le trousseau est déverrouillé et que les autorisations d’accès sont accordées, puis réessayez avec le même utilisateur. |
| SDK ou version cible incompatible | Vérifiez le chemin d’Xcode sélectionné, les SDK installés et la cible de déploiement du projet. | Choisissez une chaîne d’outils compatible. Avant toute mise à niveau, vérifiez les dépendances du projet et évitez de remplacer l’environnement à l’aveugle. |
Stockez séparément le code source, les éléments de signature et les artefacts de compilation. Créez d’abord un répertoire de projet distant, puis transférez les fichiers. Après avoir récupéré l’IPA, vérifiez sa taille et son empreinte : le nom du fichier ne suffit pas à confirmer la fin du transfert.
Si le projet est déjà dans un dépôt, récupérez-le depuis l’instance avec la méthode d’authentification de votre équipe. N’inscrivez pas de jeton d’accès dans un script partagé. Pour un dossier local, utilisez Windows OpenSSH et scpou un outil compatible SFTP pour téléverser les fichiers.
Dans le terminal distant, exécutez d’abord mkdir -p ~/Projects. La commande PowerShell ci-dessous réutilise les trois variables renseignées lors de la première connexion et vous demande le chemin du projet local.
$ProjectPath = Read-Host "Saisissez le dossier local du projet"
scp -P $MacPort -r "$ProjectPath" "${MacUser}@${MacHost}:~/Projects/"Attention :ssh utilise un -pminuscule pour indiquer le port, tandis quescp utilise un -Pmajuscule. Avant le téléversement, vérifiez le répertoire de destination pour ne pas mélanger les anciennes dépendances et le nouveau projet.
L’archive et l’IPA exportée sont deux fichiers différents. Terminez d’abord le processus d’exportation requis par le projet, puis utilisez ls -lh dans le terminal macOS pour vérifier le chemin réel de l’IPA.
Dans la commande ci-dessous, indiquez le chemin absolu de l’IPA distante et un dossier de destination déjà présent sur votre machine. Si le chemin contient des espaces, gardez les guillemets et vérifiez le fichier une fois le téléchargement terminé.
$IpaPath = Read-Host "Saisissez le chemin absolu du fichier IPA distant"
$SavePath = Read-Host "Saisissez le dossier local de destination"
scp -P $MacPort "${MacUser}@${MacHost}:$IpaPath" "$SavePath"Pour vérifier l’intégrité, exécutez sur Mac shasum -a 256et, sur Windows, Get-FileHash -Algorithm SHA256puis comparez les résultats obtenus pour le même fichier.
Notez d’abord ce que vous faisiez au moment du problème, puis essayez des actions réversibles. Un écran noir, un décalage du clavier ou un manque d’espace ne justifient pas à eux seuls une réinstallation : celle-ci affecte l’environnement existant et ne doit pas être la première étape du diagnostic.
Vérifiez d’abord que l’instance est joignable, puis fermez l’ancien onglet de connexion et rouvrez le bureau depuis les détails de l’instance. Vérifiez si votre réseau local bloque les connexions longue durée ; essayez un autre réseau ou une autre session de navigateur pour comparer.
Si SSH fonctionne, notez que seul le bureau est en panne et que la ligne de commande reste accessible. Enregistrez les tâches en cours et évitez de redémarrer plusieurs fois de suite. Si les deux accès échouent, joignez à votre ticket l’état de l’instance, le message d’erreur et l’heure du problème.
Cliquez d’abord dans une zone de saisie distante, passez à la disposition anglaise et testez les lettres, les chiffres et la ponctuation. Vérifiez les sources de saisie macOS et la disposition du clavier Windows : distinguez un blocage par la méthode de saisie locale d’une erreur de disposition à distance.
Les touches de modification ne fonctionnent pas de la même façon sous Windows et macOS, et le navigateur local peut intercepter certaines combinaisons. Effectuez d’abord la même opération depuis le menu de l’application, puis vérifiez le mappage des touches. Ne saisissez pas de mot de passe sans être certain que le bon champ est actif.
Dans le terminal macOS, exécutez df -hpour identifier le volume qui manque d’espace. Vérifiez les anciennes archives, les fichiers exportés, les données de simulateur et le cache du projet. Avant de supprimer quoi que ce soit, assurez-vous que cela ne vous est plus utile : ne supprimez pas un certificat, le code source ou votre seule sauvegarde en les prenant pour un cache.
Si vous avez réellement besoin de plus d’espace, consultez les options SSD supplémentaires de +1TB ou +2TB. Après l’opération, vérifiez que l’extension est montée, où elle l’est et si le projet utilise bien le nouvel emplacement. Ne supposez pas que le volume actuel a augmenté simplement parce que l’option a été ajoutée à la commande.
Vérifiez un à un le nom d’utilisateur de l’instance, le port et la méthode d’authentification, en vous assurant qu’aucun espace supplémentaire n’a été copié. Si vous utilisez une clé, vérifiez le fichier de clé privée indiqué et ses permissions. Ne collez pas la clé privée dans le corps d’un ticket.
Après une réinstallation, les informations de connexion peuvent changer : consultez à nouveau les détails de l’instance. Conservez le message d’erreur d’origine. Un échec d’authentification et un délai d’attente dépassé sont deux problèmes différents ; ne vous contentez pas d’écrire « SSH ne fonctionne pas » dans votre ticket.
Les nœuds fonctionnent 365 jours par an, mais la durée de location reste celle indiquée dans votre commande. Avant de lancer une tâche longue, vérifiez la date d’expiration affichée dans la console. N’attendez pas le début de la dernière compilation pour penser au renouvellement.
Connectez-vous à la console et vérifiez la durée de location actuelle et la date d’expiration dans les détails de la commande ou de l’instance. Si vous travaillez sur plusieurs fuseaux horaires, fiez-vous à l’heure et au fuseau indiqués sur la page ; ne confondez pas l’heure de réception du paiement et la date d’expiration.
Sauvegardez séparément le code source, les éléments de signature, la configuration de l’environnement et les artefacts. Ne comptez pas sur la machine après l’expiration comme sur un espace de stockage permanent.
Voir mes commandesQuatre périodes de facturation sont proposées : jour, semaine, mois et trimestre. Les paiements sont en dollars américains. Vérifiez dans la console les options de renouvellement et le tarif de votre commande avant de choisir en fonction de la durée du projet.
Les seuls moyens de paiement acceptés sont USDT-TRC20 et Visa / Mastercard / Amex (via Stripe). Les moyens disponibles sont ceux renvoyés par l’interface de paiement.
Consulter tous les tarifsUne réinstallation prépare un nouvel environnement ; elle ne répare pas le système en conservant les fichiers existants. Arrêtez d’abord les compilations, récupérez le projet, les certificats et les artefacts, puis notez les versions des outils, les dépendances et les scripts de démarrage.
Vérifiez les opérations système disponibles dans les détails de l’instance. Confirmez l’instance cible et les avertissements de risque avant de continuer. Une fois l’opération terminée, vérifiez à nouveau les informations de connexion et la chaîne d’outils.
Gérer mes instancesPour un problème technique concernant une commande existante, connectez-vous à la console et ouvrez un ticket afin de l’associer à la bonne instance. Pour une question avant achat, de facturation ou liée à l’impossibilité de vous connecter, écrivez à support@osxmesh.com. N’envoyez ni mot de passe, ni clé privée, ni numéro de carte complet, ni mot de passe de certificat.
Ajoutez le numéro de commande ou l’identifiant de l’instance, le modèle et le nœud. Les nœuds disponibles sont Singapour, Tokyo, Séoul et Hong Kong ; les modèles sont Mesh M4 et Mesh M4 Pro. Ne vous contentez pas d’écrire « mon Mac ».
Indiquez la date et l’heure avec le fuseau horaire, le résultat attendu, le résultat obtenu et la dernière opération qui a fonctionné. Ajoutez les étapes les plus courtes pour reproduire le problème et précisez s’il est systématique ou intermittent.
Pour un problème de connexion, indiquez le navigateur et la version du système, joignez une capture d’écran de l’erreur et précisez si SSH fonctionne. Pour un problème de compilation, ajoutez les versions des outils, la commande exécutée et la première erreur. Masquez les informations sensibles avant de joindre des captures ou des journaux.
Rassemblez dans un même ticket l’instance, le symptôme et les étapes déjà essayées. La page de contact précise les informations à préparer pour les questions avant achat, de facturation et d’assistance technique.