xcsync è uno strumento .NET che consente agli sviluppatori di sfruttare Xcode per la gestione di file specifici di Apple con progetti .NET. Lo strumento genera un progetto Xcode temporaneo da un progetto .NET e sincronizza le modifiche apportate ai file Xcode al progetto .NET.
Alcuni tipi di file supportati sono:
Catalogo asset
Plist
Storyboard
Xib
Lo strumento include due comandi: generate e sync. Usare generate per creare un progetto Xcode da un progetto .NET e sync per riportare le modifiche nel progetto Xcode al progetto .NET.
Nota
Questo strumento è disponibile solo per macOS a causa delle interazioni con Xcode.
Installare .NET xcsync a livello globale con il comando seguente:
dotnet tool install -g dotnet-xcsync
Utilizzo
L'estensione .NET MAUI fornisce il supporto per xcsync. Verificare di avere l'ultima versione. I xcsync comandi nell'estensione .NET MAUI sono disponibili solo quando si usa Visual Studio Code in macOS.
Aprire il riquadro comandi (Cmd + MAIUSC + P) e cercare i .NET MAUI: xcsync - Generate an Xcode project comandi e .NET MAUI: xcsync - Sync from an Xcode project .
Risoluzione dei problemi
Per visualizzare i dettagli sugli errori correlati a xcsync, passare alla finestra Output (CMD + MAIUSC + u ) e selezionare .NET MAUI - xcsync nell'elenco a discesa. In caso di problemi, segnalare un problema.
Inviare commenti
Verificare i problemi noti esistenti prima di inviare un nuovo problema o un suggerimento.
Installazione
Installare .NET xcsync a livello globale con il comando seguente:
File di progetto da compilare. I tipi di progetto supportati sono progetti MAUI .NET o qualsiasi progetto .NET destinato a una piattaforma supportata (iOS, tvOS, macOS, MacCatalyst).
-tfm|--target-framework-moniker <FRAMEWORK>
Richiamare lo strumento per un framework specifico. Il framework deve essere definito nel file di progetto. Esempi: net9.0-ios, net9.0-maccatalyst. Obbligatorio se il progetto .NET supporta più framework di destinazione, ad esempio un progetto .NET MAUI multi-destinazione. Se un singolo progetto di piattaforma, il valore predefinito sarà il singolo framework di destinazione specificato nel file di progetto.
-t|--target <TARGET_XCODE_DIRECTORY>
Directory in cui inserire il progetto Xcode generato. Il valore predefinito è (*_$(IntermediateOutputPath)_/xcsync*).
-f|--force
Forza la sovrascrittura di un progetto Xcode esistente. Il valore predefinito è False.
-o|--open
Apre il progetto generato in Xcode. Il valore predefinito è False.
-v|--verbosity <LEVEL>
Imposta il livello di dettaglio del comando. I valori consentiti sono Detailed, Diagnostic, Minimal, Normal, . Quiet Il valore predefinito è Normal.
-d|--dotnet-path <PATH>
Percorso di .NET SDK. Il valore predefinito è il percorso del processo padre se è dotnet, in caso contrario esegue il fallback a dotnet su PATH.
-h|--help
Mostra informazioni sulla Guida e sull'utilizzo
Esempi
Generare e aprire un progetto Xcode per un progetto MAUI .NET che usa il file di progetto nella directory corrente, che supporta tfm net9.0-ios:
xcsync generate -tfm net9.0-ios
Generare e aprire un progetto Xcode per un progetto MAUI .NET che supporta TFM net9.0-ios:
Sincronizzare le modifiche da un progetto Xcode generato nel percorso predefinito ($(IntermediateOutputPath)/xcsync) a un progetto MAUI .NET che supporta tfm net9.0-ios:
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.