Creare obiettivi per iOS, Mac Catalyst, macOS e tvOS

Le destinazioni di compilazione seguenti sono definite nei progetti .NET per iOS, Mac Catalyst, macOS e tvOS.

Build (impostazione predefinita)

Compila il codice sorgente all'interno di un progetto e di tutte le dipendenze.

Pulito

Rimuove tutti i file generati dal processo di compilazione.

CalcolareDispositiviDisponibili

Esegue query e restituisce un elenco di dispositivi iOS o tvOS disponibili e simulatori che possono essere usati con dotnet run.

Questa destinazione viene chiamata automaticamente dal comando di .NET SDK per supportare la selezione dei dotnet run dispositivi tramite l'opzione --device . Restituisce un @(Devices) gruppo di elementi in cui ogni dispositivo ha i metadati seguenti:

• Descrizione: nome del dispositivo (ad esempio, "iPhone 16 - iOS 26.0" per simulatori, "My iPhone 16" per i dispositivi fisici)
• Tipo: "Dispositivo" o "Simulatore"
• OSVersion: versione del sistema operativo del dispositivo
• UDID: UDID del dispositivo
• RuntimeIdentifier: l'identificatore del runtime del dispositivo

Ad esempio, per elencare tutti i dispositivi disponibili:

$ dotnet build -t:ComputeAvailableDevices

Questa destinazione fa parte della specifica di selezione del dispositivo .NET SDK e abilita comandi come:

$ dotnet run --device UDID

Aggiunta in .NET 11.

GetApplicationArtifacts

Compila il progetto e restituisce il @(ApplicationArtifact) gruppo di elementi. Questa destinazione viene sempre eseguita per prima Build in modo che gli artefatti della piattaforma .app, .ipa, .pkg e .xcarchive vengano prodotti e raccolti prima dell'esecuzione di qualsiasi destinazione personalizzata dell'estensione dei metadati. La Publish destinazione restituisce lo stesso gruppo di elementi per gli artefatti che crea.

Il gruppo di elementi restituiti riflette gli artefatti che la chiamata corrente è configurata per la compilazione; non analizza i .ipafile, .pkgfile o .xcarchivefile lasciati su disco da una build precedente. Il .app bundle viene sempre raccolto per un progetto di applicazione (ad eccezione dell'estensione dell'app e dei progetti di app per Apple Watch), mentre gli output .ipa, .pkg e .xcarchive vengono raccolti solo quando BuildIpa, CreatePackage o ArchiveOnBuild (rispettivamente) sono abilitati nella stessa chiamata. Il target Publish abilita BuildIpa (dispositivi mobili) o CreatePackage (desktop) per impostazione predefinita.

$ dotnet build MyApp.csproj -t:GetApplicationArtifacts -getItem:ApplicationArtifact
$ dotnet build MyApp.csproj -t:Publish -getItem:ApplicationArtifact

Vedere ApplicationArtifact per i metadati supportati.

I target che devono aggiungere o aggiornare i metadati @(ApplicationArtifact) prima che GetApplicationArtifacts o Publish restituiscano possono essere accodati a GetApplicationArtifactsDependsOn.

Correre

Compila il codice sorgente all'interno di un progetto e tutte le dipendenze, quindi lo distribuisce ed esegue in un simulatore/dispositivo predefinito. È possibile impostare una destinazione di distribuzione specifica usando la proprietà $(Device).

dotnet build -t:Run project.csproj -p:Device=<udid>