Crie destinos para iOS, Mac Catalyst, macOS e tvOS

Os destinos de compilação a seguir são definidos no .NET para projetos iOS, Mac Catalyst, macOS e tvOS.

Compilação (padrão)

Compila o código-fonte de um projeto e todas as dependências.

Limpeza

Remove todos os arquivos gerados pelo processo de compilação.

CalcularDispositivosDisponíveis

Consulta e retorna uma lista de dispositivos e simuladores iOS ou tvOS disponíveis que podem ser usados com dotnet run.

Este destino é chamado automaticamente pelo comando do dotnet run SDK .NET para suportar a seleção de dispositivos através da --device opção. Devolve um @(Devices) grupo de itens onde cada dispositivo tem os seguintes metadados:

  • Descrição: O nome do dispositivo (por exemplo, "iPhone 16 - iOS 26.0" para simuladores, "My iPhone 16" para dispositivos físicos)
  • Tipo: Ou "Dispositivo" ou "Simulador"
  • OSVersion: A versão do sistema operativo do dispositivo
  • UDID: O UDID do dispositivo
  • RuntimeIdentifier: O RuntimeIdentifier do dispositivo

Por exemplo, listar todos os dispositivos disponíveis:

$ dotnet build -t:ComputeAvailableDevices

Este destino faz parte da especificação de seleção de dispositivo do SDK .NET e permite comandos como:

$ dotnet run --device UDID

Adicionado no .NET 11.

GetApplicationArtifacts

Constrói o projeto e devolve o @(ApplicationArtifact) grupo de itens. Este destino executa Build sempre primeiro, pelo que os artefactos da plataforma .app, .ipa, .pkg e .xcarchive são produzidos e recolhidos antes de quaisquer alvos personalizados de extensão de metadados serem executados. O Publish destino devolve o mesmo grupo de itens para artefactos que cria.

O grupo de itens devolvidos reflete os artefactos que a invocação atual está configurada para construir; não procura ficheiros .ipa, .pkg ou .xcarchive deixados no disco por uma build anterior. O .app bundle é sempre recolhido para um projeto de aplicação (excluindo projetos de extensão de aplicação e watch), enquanto os .iparesultados , .pkg, e .xcarchive resultados só são recolhidos quando BuildIpa, CreatePackage ou ArchiveOnBuild (respetivamente) estão ativados na mesma invocação. O Publish destino ativa BuildIpa (móvel) ou CreatePackage (desktop) por defeito.

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

Consulte ApplicationArtifact para metadados suportados.

Os alvos que precisam de adicionar ou atualizar metadados de @(ApplicationArtifact) antes de GetApplicationArtifacts ou Publish retornarem podem ser acrescentados a GetApplicationArtifactsDependsOn.

Executar

Cria o código-fonte dentro de um projeto e todas as dependências e, em seguida, implanta e executa-o em um simulador/dispositivo padrão. Um destino de implantação específico pode ser definido usando a propriedade $(Device).

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