Criar propriedades para iOS, Mac Catalyst, macOS e tvOS

As propriedades do MSBuild controlam o comportamento dos alvos. Eles são especificados no arquivo de projeto, por exemplo , MyApp.csproj, em um Grupo de Propriedades do MSBuild.

AltoolPath

O caminho completo para a ferramenta altool.

O comportamento padrão é usar xcrun altool.

AppBundleResourcePrefix

O diretório em que os recursos são armazenados (esse prefixo será removido ao copiar recursos para o pacote de aplicativos).

Se não for definida explicitamente, essa propriedade herdará seu valor das propriedades de prefixo de recurso específicas da plataforma (IPhoneResourcePrefix, MonoMacResourcePrefix ou XamMacResourcePrefix , dependendo da plataforma).

Padrão: "Recursos"

AppBundleDir

O local do pacote de aplicativos construído.

AppBundleExtraOptions

Argumentos adicionais avançados para a criação do pacote de aplicativos.

O conjunto válido de argumentos depende da plataforma.

Normalmente, eles não devem ser usados, a menos que especificados por um engenheiro da Microsoft.

Ícone do Aplicativo

O AppIcon grupo de itens pode ser usado para especificar um ícone de aplicativo para o aplicativo.

O valor da propriedade deve apontar para o nome do arquivo de um recurso de imagem .appiconset (para iOS, macOS e Mac Catalyst) ou .brandassets (para tvOS) dentro de um catálogo de ativos.

Exemplo:

<PropertyGroup>
    <!-- The value to put in here for the "Resources/MyImages.xcassets/MyAppIcon.appiconset" resource would be "MyAppIcon" -->
    <AppIcon>MyAppIcon</AppIcon>
</PropertyGroup>

Veja também:

• O grupo de itens AlternateAppIcon .
• A propriedade IncludeAllAppIcons.

Versão de Exibição do Aplicativo

Se definido, especifica o CFBundleShortVersionString valor no manifesto do aplicativo (Info.plist).

Essa é uma propriedade que dá suporte ao "Projeto Único" do .NET.

Consulte OneDotNetSingleProject para obter mais informações.

ApplicationId

Se definido, especifica o CFBundleIdentifier valor no manifesto do aplicativo (Info.plist).

Essa é uma propriedade que dá suporte ao "Projeto Único" do .NET.

Consulte OneDotNetSingleProject para obter mais informações.

Título do Aplicativo

Se definido, especifica o CFBundleDisplayName manifesto no aplicativo (Info.plist).

Essa é uma propriedade que dá suporte ao "Projeto Único" do .NET.

Consulte OneDotNetSingleProject para obter mais informações.

Versão do Aplicativo

Se definido, especifica o CFBundleVersion manifesto no aplicativo (Info.plist).

Essa é uma propriedade que dá suporte ao "Projeto Único" do .NET.

Consulte OneDotNetSingleProject para obter mais informações.

ArchiveBasePath

O local onde os arquivos são armazenados no Windows para um build remoto.

O padrão é: %LocalAppData%\Xamarin\iOS\Archives

Aplicável somente a projetos do iOS (já que somente projetos do iOS podem ser criados remotamente a partir do Windows).

ArchiveOnBuild

Se um arquivo Xcode deve ser criado no final do build.

BGenEmitDebugInformation

Se a ferramenta bgen (o gerador de associação) deve ou não incluir informações de depuração.

O comportamento padrão é true quando a Debug propriedade é definida como true.

BGenExtraArgs

Quaisquer argumentos extras para a bgen ferramenta (o gerador de associação).

BGenToolExe

O nome do bgen executável (uma ferramenta usada por projetos de vinculação para gerar vinculações).

O comportamento padrão é usar a bgen ferramenta enviada com nossa carga de trabalho.

BGenToolPath

O diretório onde o bgen (BGenToolExe) está localizado.

O comportamento padrão é usar a bgen ferramenta enviada com nossa carga de trabalho.

BuildIpa

Se um pacote (.ipa) deve ser criado para o pacote de app ao final do processo de construção.

Aplicável somente a projetos iOS e tvOS.

Consulte CreatePackage para projetos macOS e Mac Catalyst.

BundleCreateDump

O CoreCLR tem um utilitário de linha de comando chamado createdump para criar despejos de núcleo se o processo falhar. O macOS criará automaticamente relatórios de falha para qualquer aplicativo da App Store e os disponibilizará para o desenvolvedor do aplicativo, portanto, a createdump ferramenta não é útil para muitos aplicativos macOS e, como tal, não está incluída em aplicativos por padrão.

Isso pode ser substituído definindo a BundleCreateDump propriedade:

<PropertyGroup>
  <BundleCreateDump>true</BundleCreateDump>
</PropertyGroup>

Observação: atualmente, a createdump ferramenta não funciona para aplicativos em área restrita (nº 18961);

Aplicável somente a projetos que usam o runtime do CoreCLR (que, no momento desta gravação, é apenas projetos macOS).

PacoteRecursosOriginais

Essa propriedade determina se os recursos são compilados antes de serem inseridos em projetos de biblioteca ou se a versão original (não compilada) está inserida.

Historicamente, os recursos foram compilados antes de serem inseridos em projetos de biblioteca, mas isso requer ter o Xcode disponível, que tem algumas desvantagens:

• Ele reduz a velocidade dos builds remotos no Windows.
• Ele não funcionará ao criar localmente no Windows e nem em nenhuma outra plataforma, exceto no macOS.
• Os recursos são compilados usando o Xcode disponível atual, que pode não ter os mesmos recursos que um Xcode potencialmente mais recente disponível quando a biblioteca em questão é consumida.
• Isso torna impossível ter uma exibição de todo o programa de todos os recursos ao criar um aplicativo, o que é necessário para detectar recursos conflitantes.

Dessa forma, adicionamos suporte para inserir os recursos originais em bibliotecas. Isso será opt-in no .NET 9, mas terá a opção de desativação a partir do .NET 10.

O valor padrão dessa propriedade false no .NET 9 e true no .NET 10+.

CodesignAllocate

O caminho para a codesign_allocate ferramenta.

Por padrão, esse valor é detectado automaticamente.

CodesignConfigureDependsOn

Este é um ponto de extensão para o build: um desenvolvedor pode adicionar quaisquer destinos a essa propriedade para executar esses destinos antes que o build analise qualquer uma das propriedades de codificação.

Isso pode, por exemplo, ser usado para desabilitar a assinatura de código para builds de simulador:

<PropertyGroup>
  <CodesignConfigureDependsOn>$(CodesignConfigureDependsOn);DisableCodesignInSimulator</CodesignConfigureDependsOn>
</PropertyGroup>
<Target Name="DisableCodesignInSimulator" Condition="'$(SdkIsSimulator)' == 'true'">
  <PropertyGroup>
    <EnableCodeSigning>false</EnableCodeSigning>
  </PropertyGroup>
</Target>

Dependências de Processamento Conjunto

Esse é um ponto de extensão para o build: um desenvolvedor pode adicionar qualquer alvo a essa propriedade para executar esses alvos antes que o pacote do aplicativo seja assinado.

Exemplo:

<PropertyGroup>
  <CodesignDependsOn>$(CodesignDependsOn);DoThisBeforeCodesign</CodesignDependsOn>
</PropertyGroup>
<Target Name="DoThisBeforeCodesign">
  <Exec Command="echo This is executed right before the app is signed." />
</Target>

CodesignEntitlements

O caminho para o arquivo de direitos que especifica os direitos exigidos pelo aplicativo.

Normalmente, "Entitlements.plist".

Definiremos isso automaticamente como "Entitlements.plist" se esse arquivo existir no diretório raiz do projeto.

Isso pode ser evitado definindo a propriedade EnableDefaultCodesignEntitlements como false.

CodesignExtraArgs

Argumentos extras passados para a ferramenta 'codesign' ao assinar o pacote do aplicativo.

CodesignKey

Especifica a chave de assinatura de código a ser usada ao assinar o pacote do aplicativo.

CodesignKeychain

O conjunto de chaves a ser usado durante a assinatura de código.

CodeSigningKey

Especifica a chave de assinatura de código a ser usada ao assinar o pacote do aplicativo.

Aplicável somente aos aplicativos macOS e Mac Catalyst, mas é recomendável usar a propriedade CodesignKey em vez disso (que funciona em todas as plataformas).

CodesignProvision

Especifica o perfil de provisionamento a ser usado ao assinar o pacote do aplicativo.

CodesignResourceRules

O caminho para o ResourceRules.plist a ser copiado para o pacote do aplicativo.

RequerimentoDePerfilDeProvisionamentoParaAssinaturaDeCódigo

Especifica se um perfil de provisionamento é necessário ao assinar o pacote do aplicativo.

Por padrão, exigiremos um perfil de provisionamento se:

• macOS, Mac Catalyst: um perfil de provisionamento foi especificado (com a propriedade CodesignProvision ).
• iOS, tvOS: a criação de um dispositivo ou um arquivo de direitos foi especificada (com a propriedade CodesignEntitlements).

Definir essa propriedade como true ou false substituirá a lógica padrão.

PacoteDeRecursosDeCompressãoDeVinculação

As referências nativas em um projeto de associação são copiadas para o diretório de saída durante o processo de build, ao lado do assembly de associação (em algo que chamamos de "pacote de recursos de associação").

Essas referências nativas podem ser armazenadas compactadas dentro de um arquivo zip (chamado $(AssemblyName).resources.zip, ou as-is, dentro de um diretório chamado $(AssemblyName).resources.

A CompressBindingResourcePackage propriedade especifica se um arquivo zip ou um diretório deve ser criado.

Os valores possíveis são:

• auto: decida automaticamente a melhor opção (atualmente, um arquivo zip é sempre criado, mas uma vez que o Visual Studio dá suporte a caminhos longos no Windows, isso pode mudar para apenas pacotes de recursos de associação zip com symlinks).
• true: criar um arquivo zip
• false: criar um diretório

O padrão é auto.

Isso também se aplica à forma como as referências nativas são armazenadas dentro do NuGets.

CopySceneKitAssetsPath

O caminho completo para a ferramenta copySceneKitAssets.

O comportamento padrão é usar xcrun copySceneKitAssets.

CoreMLCompilerPath

O caminho completo para a ferramenta coremlc.

O comportamento padrão é usar xcrun coremlc.

CreateAppBundleDependsOn

Esse é um ponto de extensão para o build: um desenvolvedor pode adicionar quaisquer destinos a essa propriedade para executar esses destinos ao criar o pacote de aplicativos.

Exemplo:

<PropertyGroup>
  <CreateAppBundleDependsOn>$(CreateAppBundleDependsOn);DoThisBeforeCreatingAppBundle</CreateAppBundleDependsOn>
</PropertyGroup>
<Target Name="DoThisBeforeCreatingAppBundle">
  <Exec Command="echo This is executed before the app bundle is created." />
</Target>

CreateIpaDependsOn

Este é um ponto de extensão para a compilação: um desenvolvedor pode adicionar quaisquer alvos a esta propriedade para executar esses alvos ao criar um IPA.

Aplicável a todas as plataformas que criam arquivos IPA (atualmente iOS e tvOS).

Exemplo:

<PropertyGroup>
  <CreateIpaDependsOn>$(CreateIpaDependsOn);DoThisBeforeCreatingIPA</CreateIpaDependsOn>
</PropertyGroup>
<Target Name="DoThisBeforeCreatingIPA">
  <Exec Command="echo This is executed before the IPA is created." />
</Target>

CreatePackage

Se um pacote (.pkg) deve ser criado para o conjunto de aplicativos no final da compilação.

Aplicável somente a projetos macOS e Mac Catalyst.

Consulte BuildIpa para projetos iOS e tvOS.

DeviceSpecificBuild

Se o build deve ser específico para o dispositivo selecionado.

Aplicável a todas as plataformas que dão suporte a builds específicos do dispositivo (atualmente iOS e tvOS).

CaminhoIntermediárioDeSaídaEspecíficoDoDispositivo

O caminho intermediário de saída a ser utilizado quando builds específicos para o dispositivo estiverem habilitados.

Aplicável a todas as plataformas que dão suporte a builds específicos do dispositivo (atualmente iOS e tvOS).

CaminhoDeSaídaEspecíficoDoDispositivo

O caminho de saída a ser usado quando compilações específicas para o dispositivo estiverem habilitadas.

Aplicável a todas as plataformas que dão suporte a builds específicos do dispositivo (atualmente iOS e tvOS).

EndereçoDiagnóstico

O endereço IP em que dotnet-dsrouter está sendo executado. Isso é tipicamente 127.0.0.1 durante o perfilamento no simulador e o endereço IP da máquina dotnet-dsrouter quando o perfilamento está em um dispositivo.

Esse é o componente de endereço IP de DiagnosticConfiguration'.

Define implicitamente EnableDiagnostics como true.

Usa 127.0.0.1 como padrão.

Configuração de diagnóstico

Um valor fornecido por dotnet-dsrouter, para DOTNET_DiagnosticPorts, tais como:

• 127.0.0.1:9000,suspend,connect
• 127.0.0.1:9000,nosuspend,connect

Observe que o caractere , precisará ser escapado com %2c se passado na linha de comando para dotnet build:

dotnet build -c Release -p:DiagnosticConfiguration=127.0.0.1:9000%2csuspend%2cconnect

Isso definirá automaticamente a DOTNET_DiagnosticPorts variável de ambiente empacotada dentro do aplicativo, de modo que a variável de ambiente seja definida quando o aplicativo for iniciado.

Define implicitamente EnableDiagnostics como true.

O comportamento padrão é calcular esse valor das outras propriedades de diagnóstico (DiagnosticAddress, DiagnosticPort, DiagnosticListenMode e DiagnosticSuspend).

Se definido, qualquer uma das outras propriedades de diagnóstico será ignorada.

DiagnosticListenMode

Um valor fornecido por dotnet-dsrouter , como connect ou listen, o componente de modo de escuta de DiagnosticConfiguration'.

Define implicitamente EnableDiagnostics como true.

Usa listen como padrão.

DiagnosticPort

Um valor fornecido por dotnet-dsrouter, como 9000 o componente de porta de DiagnosticConfiguration.

Define implicitamente EnableDiagnostics como true.

Usa 9000 como padrão.

DiagnosticSuspend

Um valor que especifica o comportamento de inicialização ao executar o perfilamento de um aplicativo.

Defina para true suspender o aplicativo na inicialização (aguardando que o servidor de diagnóstico se conecte ao aplicativo) ou false inicie o aplicativo como de costume (e conecte o servidor de diagnóstico ao aplicativo mais tarde).

Isso corresponde ao valor suspend/nosuspend em DiagnosticConfiguration`.

Define implicitamente EnableDiagnostics como true.

Usa false como padrão.

DittoPath

O caminho completo para o executável ditto.

O comportamento padrão é usar /usr/bin/ditto.

EmbedOnDemandResources

Se os recursos sob demanda devem ser inseridos no pacote do aplicativo.

Padrão: verdadeiro.

HabilitarAssinaturaDeCódigo

Se a assinatura de código estiver habilitada.

A assinatura de código é habilitada por padrão para todas as plataformas; isso pode ser substituído por essa propriedade.

EnableDefaultCodesignEntitlements

Consulte CodesignEntitlements.

HabilitarRecursosSobDemanda

Se os recursos sob demanda estiverem habilitados.

Padrão: false para macOS, true para todas as outras plataformas.

HabilitarAssinaturaDePacote

Se o .pkg que foi criado (se CreatePackage estiver habilitado) deve ser assinado.

Aplicável somente ao macOS e ao Mac Catalyst.

AtivarDiagnóstico

Habilite os componentes necessários para que o diagnóstico (como criação de perfil) funcione.

É habilitado por padrão para builds de depuração (quando MtouchDebug ou MmpDebug estiver habilitado), mas precisa ser habilitado manualmente antes da construção de perfil de builds de liberação:

<PropertyGroup>
  <EnableDiagnostics>true</EnableDiagnostics>
</PropertyGroup>

Isso aumentará ligeiramente o tamanho do aplicativo.

Aplicável somente ao usar o runtime mono (o CoreCLR sempre dá suporte a diagnósticos, enquanto NativeAOT nunca o faz).

EnableSGenConc

Habilita o modo simultâneo para o coletor de lixo SGen.

Aplicável somente ao iOS, tvOS e Mac Catalyst (quando não estiver usando NativeAOT).

EventSourceSupport

Quando definido como false, desabilita o suporte do EventSource do .NET em aplicativos reduzidos. Desabilitar esse recurso impediria que ferramentas de diagnóstico do .NET, como dotnet-counters, funcionassem, mas proporcionaria a vantagem de reduzir o tamanho do aplicativo.

Padrão: definido como false quando Optimize é configurado para true (que é o padrão para builds de Release), exceto se $(EnableDiagnostics) estiver habilitado.

GerarManifestoDeAplicativo

Caso um manifesto do aplicativo (Info.plist) deva ser gerado.

Padrão: verdadeiro.

GeneratedSourcesDir

Onde as fontes geradas pelo gerador são salvas.

IncluirTodosOsÍconesDeAplicativos

Defina a IncludeAllAppIcons propriedade como true para incluir automaticamente todos os ícones de aplicativo de todos os catálogos de ativos no aplicativo.

Exemplo:

<PropertyGroup>
    <IncludeAllAppIcons>true</IncludeAllAppIcons>
</PropertyGroup>

Veja também:

• O grupo de itens AlternateAppIcon .
• A propriedade AppIcon.

VersãoMínimaDoIOS

Especifica a versão mínima do iOS em que o aplicativo pode ser executado.

Aplicável ao iOS; definir esse valor definirá SupportedOSPlatformVersion para projetos iOS (somente).

IPhoneResourcePrefix

O diretório em que os recursos são armazenados (esse prefixo será removido ao copiar recursos para o pacote de aplicativos).

Aplicável a projetos iOS, tvOS e Mac Catalyst.

Em vez disso, considere usar a propriedade unificada AppBundleResourcePrefix .

Consulte também MonoMacResourcePrefix e XamMacResourcePrefix.

IpaIncludeArtwork

Se a arte deve ser incluída no IPA.

Aplicável somente a projetos iOS e tvOS.

IpaPackageName

Especifica o nome do arquivo .ipa resultante (sem o caminho) ao criar um pacote IPA (consulte BuildIpa). IpaPackagePath substituirá esse valor.

Aplicável somente a projetos iOS e tvOS.

IpaPackageDir

Especifica o diretório do arquivo .ipa resultante ao criar um pacote IPA (consulte BuildIpa). IpaPackagePath substituirá esse valor.

Aplicável somente a projetos iOS e tvOS.

IpaPackagePath

Especifica o caminho para o arquivo .ipa resultante ao criar um pacote IPA (consulte BuildIpa).

Aplicável somente a projetos iOS e tvOS.

IsAppExtension

Se um projeto for uma extensão de aplicativo.

IsBindingProject

Se um projeto for um projeto vinculante.

IsXPCService

Se uma extensão macOS for um serviço XPC.

Aplicável somente a projetos macOS.

Modo de Ligação

Especifica o modo de link para o projeto (NoneSdkOnlyouFull).

Aplicável a projetos macOS, mas essa propriedade está obsoleta, use TrimMode em vez disso.

Consulte também MtouchLink.

LinkWithSwiftSystemLibraries

Se definido como true, o build informará ao vinculador nativo onde encontrar as bibliotecas do sistema do Swift.

Isso é útil quando uma biblioteca nativa usa Swift de alguma forma, nesse caso, o vinculador nativo precisa saber onde encontrar as bibliotecas do sistema do Swift.

No momento, isso significa que esses argumentos serão passados para o vinculador nativo:

• -L/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/[platform]
• -L/Applications/Xcode.app/Contents/Developer/Platforms/[platform].platform/Developer/SDKs/[platform].sdk/usr/lib/swift

O conjunto exato de argumentos pode mudar no futuro.

MacCatalystMinimumVersion

Especifica a versão mínima do Mac Catalyst (iOS) na qual o aplicativo pode ser executado.

Aplicável ao Mac Catalyst; definir esse valor definirá SupportedOSPlatformVersion para projetos Mac Catalyst (somente).

MaciOSPrepareForBuildDependsOn

Uma propriedade delimitada por ponto e vírgula que pode ser usada para estender o processo de construção. Os destinos do MSBuild adicionados a essa propriedade serão executados no início do build para projetos do tipo aplicativo e biblioteca. Essa propriedade está vazia por padrão.

Exemplo:

<PropertyGroup>
  <MaciOSPrepareForBuildDependsOn>$(MaciOSPrepareForBuildDependsOn);MyCustomTarget</MaciOSPrepareForBuildDependsOn>
</PropertyGroup>

<Target Name="MyCustomTarget" >
  <Message Text="Running target: 'MyCustomTarget'" Importance="high"  />
</Target>

Essa propriedade foi introduzida no .NET 9.

VersãoMínimaDoMacOS

Especifica a versão mínima do macOS em que o aplicativo pode ser executado.

Aplicável ao macOS; definir esse valor definirá SupportedOSPlatformVersion para projetos macOS (somente).

MacOSXSdkVersion

A versão do SDK do macOS a ser usada para o build.

Padrão: detectado automaticamente de acordo com a versão padrão enviada com o Xcode selecionado.

Consulte também MtouchSdkVersion.

ModoDeExceçãoGerenciadaDeMarshal

Defina como as exceções gerenciadas são tratadas ao encontrar uma estrutura nativa no desenrolar da pilha durante o processamento da exceção gerenciada.

Valores válidos:

• default: atualmente, isso é throwobjectivecexception.
• unwindnativecode: isso não está disponível ao usar o runtime do CoreCLR.
• throwobjectivecexception: Capturar a exceção gerenciada e convertê-la em uma exceção do tipo Objective-C.
• abort: anulação do processo.
• disable: desabilite a interceptação de quaisquer exceções gerenciadas. Para MonoVM, isso é equivalente a unwindnativecode, para CoreCLR, isso é equivalente a abort.

Para obter mais informações, consulte Marshaling de exceções e MarshalObjectiveCExceptionMode.

MarshalObjectiveCExceptionMode

Escolha como as exceções de Objective-C são tratadas quando um quadro gerenciado é encontrado durante o desenrolamento da pilha e o processamento da exceção Objective-C.

Valores válidos:

• default: atualmente, isso é throwmanagedexception.
• unwindmanagedcode: isso não está disponível ao usar o runtime do CoreCLR.
• throwmanagedexception: capturar a exceção de Objective-C e convertê-la em uma exceção gerenciada.
• abort: anulação do processo.
• disable: Desabilite a interceptação de qualquer exceção Objective-C.

Para obter mais informações, consulte Marshaling de exceções e MarshalManagedExceptionMode.

MdimportPath

O caminho completo para a ferramenta mdimport.

O comportamento padrão é usar xcrun mdimport.

MetalLibPath

O caminho completo para a ferramenta metallib (o Vinculador de Metal).

O comportamento padrão é usar xcrun metallib.

MetalPath

O caminho completo para o compilador Metal.

O comportamento padrão é usar xcrun metal.

MetricsSupport

Quando definido como false, desabilita o suporte de Métricas do .NET em aplicativos otimizados. Desabilitar esse recurso impediria que APIs, como, por System.Diagnostics.Metrics exemplo, funcionassem, mas em benefício da redução do tamanho do aplicativo.

Padrão: definido como false quando Optimize é configurado para true (que é o padrão para builds de Release), exceto se $(EnableDiagnostics) estiver habilitado.

MmpDebug

Habilita o modo de depuração para a criação do pacote de aplicativos.

Aplicável somente a projetos macOS.

Consulte também MtouchDebug.

AjusteAgressivoDeAtributosMóveis

Essa propriedade determina se vários atributos que raramente são necessários no runtime devem ser cortados.

Isso é habilitado por padrão.

Observe que, embora os atributos removidos raramente sejam usados, é tecnicamente possível que a remoção possa alterar o comportamento do runtime.

Por exemplo, System.Xml.Serialization se comportará de forma diferente se um construtor tiver o [Obsolete] atributo (que é um dos atributos removidos). Esse é um risco baixo o suficiente para justificar a remoção desses atributos por padrão devido à economia de tamanho.

A lista de atributos removidos pode mudar no futuro, mas no momento desta gravação (para .NET 10), estes são os atributos:

• Microsoft.CodeAnalysis.EmbeddedAttribute
• System.CLSCompliantAttribute
• System.CodeDom.Compiler.GeneratedCodeAttribute
• System.ComponentModel.EditorBrowsableAttribute
• System.Diagnostics.CodeAnalysis.DoesNotReturnAttribute
• System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute
• System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembersAttribute
• System.Diagnostics.CodeAnalysis.ExcludeFromCodeCoverageAttribute
• System.Diagnostics.CodeAnalysis.ExperimentalAttribute
• System.Diagnostics.CodeAnalysis.FeatureGuardAttribute
• System.Diagnostics.CodeAnalysis.FeatureSwitchDefinitionAttribute
• System.Diagnostics.CodeAnalysis.MemberNotNullAttribute
• System.Diagnostics.CodeAnalysis.MemberNotNullWhenAttribute
• System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute (Atributo: Não Nulo Se Não Nulo)
• System.Diagnostics.CodeAnalysis.NotNullWhenAttribute
• System.Diagnostics.CodeAnalysis.RequiresAssemblyFilesAttribute
• System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute
• System.Diagnostics.CodeAnalysis.RequiresUnreferencedCodeAttribute
• System.Diagnostics.CodeAnalysis.StringSyntaxAttribute
• System.Diagnostics.CodeAnalysis.SuppressMessageAttribute
• System.Diagnostics.CodeAnalysis.IncondicionalSuppressMessageAttribute
• System.Diagnostics.CodeAnalysis.UnscopedRefAttribute
• System.ObsoleteAttribute
• System.Reflection.AssemblyCompanyAttribute
• System.Reflection.AssemblyConfigurationAttribute
• System.Reflection.AssemblyCopyrightAttribute
• System.Reflection.AssemblyDefaultAliasAttribute
• System.Reflection.AssemblyDescriptionAttribute
• System.Reflection.AssemblyMetadataAttribute
• System.Reflection.AssemblyProductAttribute
• System.Reflection.AssemblyTitleAttribute
• System.Runtime.CompilerServices.AsyncMethodBuilderAttribute
• System.Runtime.CompilerServices.CallerArgumentExpressionAttribute
• System.Runtime.CompilerServices.CallerFilePathAttribute
• System.Runtime.CompilerServices.CallerLineNumberAttribute
• System.Runtime.CompilerServices.CallerMemberNameAttribute
• System.Runtime.CompilerServices.CompilerFeatureRequiredAttribute
• System.Runtime.CompilerServices.CompilerGlobalScopeAttribute
• System.Runtime.CompilerServices.EnumeratorCancellationAttribute
• System.Runtime.CompilerServices.ExtensionAttribute
• System.Runtime.CompilerServices.InterpolatedStringHandlerArgumentAttribute
• System.Runtime.CompilerServices.InterpolatedStringHandlerAttribute
• System.Runtime.CompilerServices.IntrinsicAttribute
• System.Runtime.CompilerServices.IsReadOnlyAttribute
• System.Runtime.CompilerServices.IsUnmanagedAttribute
• System.Runtime.CompilerServices.NativeIntegerAttribute
• System.Runtime.CompilerServices.RefSafetyRulesAttribute
• System.Runtime.CompilerServices.ScopedRefAttribute
• System.Runtime.CompilerServices.SkipLocalsInitAttribute
• System.Runtime.CompilerServices.TupleElementNamesAttribute
• System.Runtime.InteropServices.LibraryImportAttribute
• System.Runtime.InteropServices.Marshalling.ContiguousCollectionMarshallerAttribute
• System.Runtime.InteropServices.Marshalling.CustomMarshallerAttribute
• System.Runtime.InteropServices.Marshalling.MarshalUsingAttribute
• System.Runtime.InteropServices.Marshalling.NativeMarshallingAttribute
• System.Runtime.Versioning.NonVersionableAttribute
• System.Runtime.Versioning.ObsoletedOSPlatformAttribute
• System.Runtime.Versioning.RequiresPreviewFeaturesAttribute
• System.Runtime.Versioning.SupportedOSPlatformAttribute
• System.Runtime.Versioning.SupportedOSPlatformGuardAttribute
• System.Runtime.Versioning.TargetPlatformAttribute
• System.Runtime.Versioning.UnsupportedOSPlatformAttribute
• System.Runtime.Versioning.UnsupportedOSPlatformGuardAttribute

Essa propriedade foi introduzida no .NET 10.

MonoBundlingExtraArgs

Argumentos adicionais que especificam como criar o pacote de aplicativos.

Aplicável somente a projetos macOS.

Essa propriedade está obsoleta, use AppBundleExtraOptions.

MonoMacResourcePrefix

O diretório em que os recursos são armazenados (esse prefixo será removido ao copiar recursos para o pacote de aplicativos).

Aplicável somente a projetos macOS.

Em vez disso, considere usar a propriedade unificada AppBundleResourcePrefix .

Consulte também IPhoneResourcePrefix e XamMacResourcePrefix.

UsoDeBitmapComprimidoParaInterfaceMono

Isso orienta o runtime mono a usar uma versão compactada de bitmaps de interface (bitmaps de interface são usados para determinar se determinados tipos implementam uma determinada interface).

Esses bitmaps podem usar uma quantidade significativa de memória em runtime, em particular para aplicativos que têm uma quantidade substancial de interfaces.

Essa configuração é desabilitada por padrão, mas pode ser habilitada assim, o que diminuirá a quantidade de memória usada em runtime:

<PropertyGroup>
    <MonoUseCompressedInterfaceBitmap>true</MonoUseCompressedInterfaceBitmap>
</PropertyGroup>

A desvantagem é que as verificações de tipo (obj is SomeInterface) serão mais lentas.

Aplicável somente ao usar o runtime mono.

MtouchDebug

Habilita o modo de depuração para a criação do pacote de aplicativos.

Aplicável a projetos iOS, tvOS e Mac Catalyst.

Consulte também MmpDebug.

MtouchEnableSGenConc

Habilita o modo simultâneo para o coletor de lixo SGen.

Aplicável somente ao iOS, tvOS e Mac Catalyst quando não estiver usando NativeAOT.

Essa propriedade está obsoleta, use EnableSGenConc.

MtouchExtraArgs

Argumentos adicionais que especificam como criar o pacote de aplicativos.

Aplicável somente a projetos iOS, tvOS e Mac Catalyst.

Essa propriedade está obsoleta, use AppBundleExtraOptions.

MtouchInterpreter

Habilita o interpretador e, opcionalmente, usa uma lista separada por vírgulas de assemblies para interpretar (se prefixado com um sinal de menos, o assembly será compilado por AOT). 'all' pode ser usado para especificar todos os assemblies. Esse argumento pode ser especificado várias vezes.

Exemplo:

<PropertyGroup>
  <!-- interpret all assemblies -->
  <MtouchInterpreter>all</MtouchInterpreter>

  <!-- AOT-compile all assemblies, except System.dll, which will be interpreted. -->
  <MtouchInterpreter>System</MtouchInterpreter>

  <!-- interpret all assemblies, except System.Core.dll, which will be AOT-compiled. -->
  <MtouchInterpreter>all,-System.Core</MtouchInterpreter>
</PropertyGroup>

Uma abreviação para o MtouchInterpreter é definir UseInterpreter=true, o que é equivalente a MtouchInterpreter=all.

Se tanto UseInterpreter quanto MtouchInterpreter estiverem definidos, então MtouchInterpreter terá precedência.

Aplicável aos aplicativos iOS, tvOS e Mac Catalyst (quando não estiver usando NativeAOT).

O comportamento padrão é não habilitar o interpretador.

MtouchLink

Especifica o modo de link para o projeto (None, , SdkOnly). Full

Aplicável a projetos iOS, tvOS e Mac Catalyst, mas esta propriedade está deprecada, use TrimMode em vez disso.

Consulte também LinkMode.

MtouchSdkVersion

A versão do SDK do iOS ou tvOS a ser usada para o build.

Padrão: detectado automaticamente de acordo com a versão padrão enviada com o Xcode selecionado.

Consulte também MacOSXSdkVersion.

MtouchUseLlvm

Uma propriedade booliana que especifica se a compilação AOT deve ser feita usando LLVM.

Aplicável a projetos iOS, tvOS e Mac Catalyst.

Padrão:

• No iOS e no tvOS: habilitado para build de versão (em que Configuration="Release").
• No Mac Catalyst: nunca habilitado por padrão.

NoBindingEmbedding

Uma propriedade booliana que especifica se as bibliotecas nativas em projetos de associação devem ser inseridas no assembly gerenciado ou colocadas em um .resources diretório ao lado do assembly gerenciado.

O valor padrão é true (o que significa que as bibliotecas nativas não serão inseridas no assembly gerenciado).

NoDSymUtil

Uma propriedade booliana que especifica se a geração .dSYM deve ser desabilitada.

Padrão:

• true para iOS e tvOS quando se compila para o simulador.
• true para macOS e Mac Catalyst, a menos que seja criado um arquivo (ArchiveOnBuild=true)

Isso significa que o arquivo .dSYM será gerado nos seguintes casos (por padrão):

• No iOS e tvOS ao compilar para o dispositivo.
• No macOS e no Mac Catalyst ao criar um arquivo (ArchiveOnBuild=true).

NoSymbolStrip

Uma propriedade booliana que especifica se os símbolos de depuração são removidos do aplicativo no momento da compilação.

O comportamento padrão é manter símbolos de depuração para:

• builds Debug para plataformas de desktop.
• Builds de simulador para plataformas móveis.

Exemplo para manter símbolos de depuração:

<PropertyGroup>
  <NoSymbolStrip>true</NoSymbolStrip>
</PropertyGroup>

OnDemandResourcesInitialInstallTags

Uma propriedade textual que especifica as etiquetas de instalação iniciais para recursos sob demanda.

OnDemandResourcesPrefetchOrder

Uma propriedade de cadeia de texto que determina a ordem de pré-busca para recursos sob demanda.

OnDemandResourcesUrl

Uma propriedade de cadeia de caracteres que especifica a URL do recurso para recursos sob demanda.

OptimizePNGs - ferramenta para otimizar arquivos PNG

Uma propriedade booliana que especifica se as imagens png devem ser otimizadas.

OptimizePngImagesDependeDe

Esse é um ponto de extensão para o build: um desenvolvedor pode adicionar quaisquer alvos a esta propriedade para executar esses alvos antes que quaisquer imagens PNG sejam otimizadas.

Exemplo:

<PropertyGroup>
  <OptimizePngImagesDependsOn>$(OptimizePngImagesDependsOn);MyCustomTarget</OptimizePngImagesDependsOn>
</PropertyGroup>

<Target Name="MyCustomTarget" >
  <Message Text="Running target: 'MyCustomTarget'" Importance="high"  />
</Target>

OptimizePropertyLists

Uma propriedade booliana que especifica se as listas de propriedades (plists) devem ser otimizadas.

OptimizePropertyListsDependsOn

Esse é um ponto de extensão para a construção: um desenvolvedor pode adicionar qualquer alvo a esta propriedade para executar esses alvos antes de as listas de propriedades (plists) serem otimizadas.

Exemplo:

<PropertyGroup>
  <OptimizePropertyListsDependsOn>$(OptimizePropertyListsDependsOn);MyCustomTarget</OptimizePropertyListsDependsOn>
</PropertyGroup>

<Target Name="MyCustomTarget" >
  <Message Text="Running target: 'MyCustomTarget'" Importance="high"  />
</Target>

ChaveDeAssinaturaDePacote

Especifica a chave de assinatura de código para assinar o pacote ao criar .pkg para um projeto macOS e Mac Catalyst.

Aplicável somente aos aplicativos macOS e Mac Catalyst.

PackagingExtraArgs

Especifica os argumentos extras a serem passados para a ferramenta 'productbuild' ao criar .pkg para um projeto macOS e Mac Catalyst.

Aplicável somente aos aplicativos macOS e Mac Catalyst.

PkgPackagePath

Especifica o caminho para o arquivo de .pkg resultante ao criar um pacote (consulte CreatePackage).

Aplicável somente aos aplicativos macOS e Mac Catalyst.

PlutilPath

O caminho completo para a plutil ferramenta de linha de comando.

O comportamento padrão é usar xcrun plutil.

PngCrushPath

O caminho completo para a pngcrush ferramenta de linha de comando.

O comportamento padrão é usar xcrun pngcrush.

ProcessEnums

Uma propriedade booleana que especifica se as enumerações devem ser processadas como uma definição de API em projetos de vinculação.

ProductBuildPath

O caminho completo para a ferramenta productbuild.

O comportamento padrão é usar xcrun productbuild.

Definição do Produto

O modelo de definição de produto (.plist) a ser usado ao criar a definição do produto para passar para a ferramenta de build do produto ao criar pacotes (.pkg).

Aplicável somente aos aplicativos macOS e Mac Catalyst.

ReferênciaSímboloNativo

O grupo ReferenceNativeSymbol de itens pode ser usado para especificar como devemos lidar com um determinado símbolo nativo: ignore-o ou peça ao vinculador nativo para mantê-lo (passando o símbolo como -u ... ou em um arquivo de símbolo para o vinculador nativo).

Há dois tipos de metadados com suporte:

• SymbolType: ou ObjectiveCClass, Function ou Field. Usado para calcular o nome nativo completo de um símbolo (por exemplo, o símbolo nativo da classe MyClass Objective-C é _OBJC_CLASS_$_MyClass, enquanto para uma função MyFunction é apenas _MyFunction.
• SymbolMode: ou Ignore ou não configurado. Ignore significa não passar o símbolo fornecido para o vinculador nativo, o padrão é fazê-lo.

SymbolType é necessário, embora SymbolMode não seja.

Símbolo de exemplo a ser mantido:

<ItemGroup>
    <ReferenceNativeSymbol Include="MyClass" SymbolType="ObjectiveCClass" />
</ItemGroup>

Símbolo de exemplo a ser ignorado:

<ItemGroup>
    <ReferenceNativeSymbol Include="MyClass" SymbolType="ObjectiveCClass" SymbolMode="Ignore" />
</ItemGroup>

ExigirLinkComAtributoParaObjectiveCClassSearch

Vamos escanear automaticamente todas as bibliotecas para classes gerenciadas que correspondem a classes Objective-C existentes e, em seguida, criaremos uma referência nativa durante a compilação para essas classes Objective-C.

Dessa forma, o vinculador nativo não removerá essas classes Objective-C, pensando que elas não são usadas.

No entanto, isso poderá causar um problema se uma classe gerenciada fizer referência a uma classe Objective-C que não existe. A correção adequada para isso é remover essas classes gerenciadas do build, mas isso pode ser complicado, em particular se a classe gerenciada vem de uma referência binária (como o NuGet).

Nesses casos, é possível definir a propriedade RequireLinkWithAttributeForObjectiveCClassSearch para true de modo que apenas examinemos bibliotecas com o atributo [LinkWith] para classes Objective-C:

<PropertyGroup>
  <RequireLinkWithAttributeForObjectiveCClassSearch>true</RequireLinkWithAttributeForObjectiveCClassSearch>
</PropertyGroup>

RunWithOpen

Essa propriedade determina se os aplicativos são iniciados usando o open comando no macOS ou se o executável do aplicativo é executado diretamente.

Isso só se aplica aos aplicativos macOS e Mac Catalyst.

O valor padrão é true. Nesse modo, o aplicativo será iniciado pelo macOS como qualquer outro aplicativo de interface do usuário, qualquer saída stdout/stderr será engolida pelo macOS e o dotnet run comando será concluído assim que o aplicativo for iniciado.

Se definido como false, qualquer saída stdout/stderr será impressa no terminal atual e o dotnet run comando não será concluído até que o aplicativo seja encerrado.

As propriedades a seguir podem ser usadas para configurar o comportamento quando definido como true (ou seja, usando o open comando):

AbrirNovaInstância

Se uma nova instância será aberta se o aplicativo já estiver em execução (o padrão será false).

Isso passará -n para open se definido como true.

Exemplo:

$ dotnet run -p:OpenNewInstance=false

OpenWaitForExit

Se 'dotnet run' deve aguardar a saída do aplicativo (o padrão é false).

Isso passará -W para open se definido como true.

Exemplo:

$ dotnet run -p:OpenWaitForExit=true

OpenArguments

Essa propriedade pode ser usada para passar argumentos adicionais para o open comando.

Exemplo (para definir variáveis de ambiente):

$ dotnet run -p:OpenArguments="--env VARIABLE1=VALUE1 --env VARIABLE2=value2"

Exemplo (para redirecionar stdout e stderr para um arquivo):

$ dotnet run -p:OpenArguments="--stdout /tmp/stdout.txt --stderr /tmp/stderr.txt"

Execute man open para ver uma lista de todas as opções open aceitas.

StandardOutputPath

Essa propriedade pode ser usada para redirecionar a saída stdout do aplicativo para um arquivo.

Exemplo de gravação em um arquivo:

$ dotnet run -p:StandardOutputPath=stdout.txt

Exemplo de escrita no terminal atual:

$ dotnet run -p:StandardOutputPath=$(tty)
[... Console.WriteLine output from app ...]

Observação: isso também pode ser feito passando a propriedade --stdout ...OpenArguments.

StandardErrorPath

Essa propriedade pode ser usada para redirecionar a saída stderr do aplicativo para um arquivo.

Exemplo de gravação em um arquivo:

$ dotnet run -p:StandardErrorPath=stderr.txt

Exemplo de escrita no terminal atual:

$ dotnet run -p:StandardErrorPath=$(tty)
[... Console.Error.WriteLine output from app ...]

Observação: isso também pode ser feito passando a propriedade --stderr ...OpenArguments.

StandardInputPath

Para redirecionar a entrada padrão (stdin) para o aplicativo a partir de um arquivo, essa propriedade pode ser usada.

Exemplo:

$ dotnet run -p:StandardInputPath=stdin.txt

Observação: isso também pode ser feito passando a propriedade --stdin ...OpenArguments.

SdkIsSimulator

Essa propriedade é somente leitura (configurá-la não terá efeito) e especifica se estamos compilando para um simulador ou não.

Ele só é definido após importações e propriedades terem sido avaliadas. Isso significa que a propriedade não está definida ao avaliar as propriedades no arquivo de projeto, portanto, isso não funcionará:

<PropertyGroup>
  <EnableCodeSigning Condition="'$(SdkIsSimulator)' == 'true'">false</EnableCodeSigning>
</PropertyGroup>

No entanto, qualquer uma das seguintes opções funciona:

<ItemGroup>
  <!-- item groups (and their conditions) are evaluated after properties have been evaluated -->
  <CustomEntitlements Condition="'$(SdkIsSimulator)' == 'true'" Include="com.apple.simulator-entitlement" Type="Boolean" Value="true" />
  <CodesignConfigureDependsOn>$(CodesignConfigureDependsOn);ConfigureSimulatorSigning</CodesignConfigureDependsOn>
</ItemGroup>
<!-- targets are executed after properties have been evaluated -->
<Target Name="ConfigureSimulatorSigning">
  <PropertyGroup>
    <EnableCodeSigning Condition="'$(SdkIsSimulator) == 'true'">false</EnableCodeSigning>
  </PropertyGroup>
</Target>

Observação: essa propriedade sempre estará false no macOS e no Mac Catalyst.

StripPath

O caminho completo para a strip ferramenta de linha de comando.

O comportamento padrão é usar xcrun strip.

VersãoDePlataformaOSSuportada

Especifica a versão mínima do sistema operacional na qual o aplicativo pode ser executado.

Também é possível usar uma propriedade específica da plataforma:

• iOSMinimumVersion
• Versão Mínima do tvOS
• VersãoMínimadoMacOS
• MacCatalystMinimumVersion

TrimMode

Especifica a granularidade de corte.

As opções válidas são:

• full: corte cada conjunto.
• partial: aparar assemblies que optaram por cortar.
• copy: Não cortar conjuntos.

Consulte TrimMode para obter um pouco mais de informações sobre a TrimMode propriedade.

A TrimMode propriedade é equivalente às propriedades MtouchLink (para iOS, tvOS e Mac Catalyst) e LinkMode (para macOS), mas os valores de propriedades válidas são diferentes (embora a semântica seja a mesma):

Daqui para frente, as propriedades MtouchLink e LinkMode serão descontinuadas, por favor, use TrimMode em vez disso.

O modo de corte padrão depende de vários fatores e também pode mudar no futuro.

Os valores padrão atuais (a partir do .NET 9) são:

• iOS e iOS: partial ao compilar para o dispositivo, copy ao compilar para o simulador.
• macOS: sempre copy.
• Mac Catalyst: partial ao criar para a configuração específica "Release", copy em outros casos.

Exceções:

• O valor padrão é sempre full ao compilar com NativeAOT.
• O MAUI altera o valor padrão para copy ao criar para a Debug configuração e o interpretador é habilitado usando UseInterpreter (que o MAUI também habilita por padrão ao usar a "Debug" configuração).

Versão mínima do tvOS

Especifica a versão mínima do tvOS na qual o aplicativo pode ser executado.

Aplicável ao tvOS; ao definir esse valor, será definido SupportedOSPlatformVersion para projetos exclusivamente de tvOS.

UseFloatingTargetPlatformVersion

Uma propriedade booliana que controla se os projetos de biblioteca devem usar uma versão de plataforma de destino flutuante ou a versão mais antiga da plataforma disponível.

Por padrão (começando no .NET 10), projetos de biblioteca sem um explícito TargetPlatformVersion usarão os assemblies de referência mais antigos disponíveis para a versão atual do .NET. Isso garante a compatibilidade máxima e permite que o código de biblioteca seja compilado na superfície mínima da API disponível para a estrutura de destino.

No entanto, esse comportamento padrão significa que os projetos de biblioteca são criados de forma diferente dos projetos executáveis (que usam a versão mais recente da plataforma). O código que funciona em um projeto executável pode não ser compilado quando movido para um projeto de biblioteca se ele usa APIs disponíveis apenas em versões de plataforma mais recentes.

Definir essa propriedade para true desabilitar a seleção automática da versão mais antiga da plataforma, permitindo que o projeto de biblioteca use a versão da plataforma padrão (mais recente), como os projetos executáveis usam.

Exemplo:

<PropertyGroup>
  <!-- Use the latest platform version instead of the oldest -->
  <UseFloatingTargetPlatformVersion>true</UseFloatingTargetPlatformVersion>
</PropertyGroup>

Padrão: false (use a versão de plataforma mais antiga para projetos de biblioteca no .NET 10+).

Essa propriedade só se aplica a projetos de biblioteca (OutputType=Library) que não são extensões de aplicativo e não especificaram uma versão explícita da plataforma de destino (a versão da plataforma de destino é o número de versão opcional no final da TargetFramework propriedade, por exemplo, para o TargetFramework net10.0-ios26.0 , a versão da plataforma de destino é explicitamente 26.0).

Essa propriedade foi introduzida no .NET 10.

Usar Tempo de Execução Endurecido

Uma propriedade booliana que especifica se um runtime protegido está habilitado.

Aplicável a projetos macOS e Mac Catalyst.

UseInterpreter

Habilita o interpretador (para todos os assemblies).

Isso é equivalente à configuração MtouchInterpreter=all.

Aplicável aos aplicativos iOS, tvOS e Mac Catalyst (quando não estiver usando NativeAOT).

O comportamento padrão é não habilitar o interpretador.

Consulte MtouchInterpreter para obter mais informações.

UseNativeHttpHandler

Se o manipulador http nativo deve ser o manipulador http padrão ou não.

Padrão: verdadeiro para todas as plataformas, exceto macOS.

ValidarDireitos

Escolha se as autorizações solicitadas pelo aplicativo precisam ser validadas.

Valores válidos para esta propriedade:

• disable: a validação está desabilitada.
• warn: quaisquer falhas de validação são mostradas como avisos.
• error: todas as falhas de validação são mostradas como erros. Esse é o padrão.

O processo de validação pode não validar todos os benefícios, nem é garantido que não seja excessivamente zeloso.

Se a validação falhar para os direitos que realmente funcionam, registre um novo problema.

ValidateXcodeVersion

Escolha se a versão atual do Xcode deve ser validada.

O valor padrão é validar; defina para false para desabilitar.

XamMacResourcePrefix

O diretório em que os recursos são armazenados (esse prefixo será removido ao copiar recursos para o pacote de aplicativos).

Aplicável a projetos macOS.

Em vez disso, considere usar a propriedade unificada AppBundleResourcePrefix .

Consulte também IPhoneResourcePrefix e MonoMacResourcePrefix.

ZipPath

O caminho completo para a zip ferramenta de linha de comando.

O comportamento padrão é usar xcrun zip.