xcsync est un outil .NET qui permet aux développeurs de tirer parti de Xcode pour gérer des fichiers spécifiques à Apple avec des projets .NET. L’outil génère un projet Xcode temporaire à partir d’un projet .NET et synchronise les modifications apportées aux fichiers Xcode avec le projet .NET.
Les types de fichier pris en charge incluent :
Catalogue de ressources
Fichier PLIST
Storyboard
Fichier XIB
L’outil dispose de deux commandes : generate et sync. Utilisez generate pour créer un projet Xcode à partir d’un projet .NET et sync pour répercuter les modifications apportées au projet Xcode sur le projet .NET.
Remarque
Cet outil est disponible uniquement pour macOS en raison des interactions avec Xcode.
Installez .NET xcsync globalement avec la commande suivante :
dotnet tool install -g dotnet-xcsync
Utilisation
L’extension .NET MAUI prend en charge xcsync. Vérifiez que vous avez la version la plus récente. Les xcsync commandes de l’extension .NET MAUI sont disponibles uniquement lors de l’utilisation de Visual Studio Code sur macOS.
Ouvrez la palette de commandes (Cmd + Maj + P) et recherchez les .NET MAUI: xcsync - Generate an Xcode project commandes et .NET MAUI: xcsync - Sync from an Xcode project les commandes.
Dépannage
Pour afficher des détails sur les erreurs liées à xcsync, accédez à la fenêtre Sortie (CMD + Maj + u ) et sélectionnez .NET MAUI - xcsync dans la liste déroulante. Si vous rencontrez des problèmes, signalez un problème.
Fournir des commentaires
Vérifiez les problèmes connus existants avant de déposer un nouveau problème ou suggestion.
Installation
Installez .NET xcsync globalement avec la commande suivante :
Fichier projet à générer. Sont pris en charge les projets .NET MAUI ou tout projet .NET qui cible une plateforme prise en charge (iOS, tvOS, macOS, Mac Catalyst).
-tfm|--target-framework-moniker <FRAMEWORK>
Appelle l’outil pour un framework spécifique. Le framework doit être défini dans le fichier projet. Exemples : net9.0-ios, net9.0-maccatalyst. Obligatoire si le projet .NET prend en charge plusieurs frameworks cibles (par exemple, un projet .NET MAUI multi-ciblé). En cas de projet ciblant une plateforme unique, la valeur par défaut est le framework cible unique spécifié dans le fichier projet.
-t|--target <TARGET_XCODE_DIRECTORY>
Répertoire dans lequel placer le projet Xcode généré. La valeur par défaut est (*_$(IntermediateOutputPath)_/xcsync*).
-f|--force
Force le remplacement d’un projet Xcode existant. La valeur par défaut est False.
-o|--open
Ouvre le projet généré dans Xcode. La valeur par défaut est False.
-v|--verbosity <LEVEL>
Définit le niveau de détail de la commande. Les valeurs autorisées sont Detailed, Diagnostic, Minimal, Normal, Quiet. La valeur par défaut est Normal.
-d|--dotnet-path <PATH>
Chemin d’accès au Kit de développement logiciel (SDK) .NET. La valeur par défaut est le chemin d’accès du processus parent si c’est dotnetle cas , sinon revient à dotnet path.
-h|--help
Affiche les informations d’aide et d’utilisation
Exemples
Générez et ouvrez un projet Xcode pour un projet .NET MAUI qui utilise le fichier projet dans le répertoire actif, qui prend en charge le TFMnet9.0-ios :
xcsync generate -tfm net9.0-ios
Générez et ouvrez un projet Xcode pour un projet .NET MAUI qui prend en charge le TFMnet9.0-ios :
Synchronisez les modifications d’un projet Xcode généré à l’emplacement par défaut ($(IntermediateOutputPath)/xcsync) vers un projet MAUI .NET qui prend en charge le net9.0-iosTFM :
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
