Compartilhar via

Destinos de build

  • Artigo

Os destinos de build a seguir são definidos em projetos do .NET para Android.

Compilação

Cria o código-fonte em um projeto e em todas as dependências.

Esse destino não cria um pacote Android (.apk arquivo). Para criar um pacote do Android, use o destino SignAndroidPackage ou defina a propriedade '$(AndroidBuildApplicationPackage) como True ao criar:

msbuild /p:AndroidBuildApplicationPackage=True App.sln

Criação de perfil BuildAndStartAot

Cria o aplicativo com um criador de perfil AOT inserido, define a porta TCP do criador de perfil como $(AndroidAotProfilerPort)e inicia a atividade padrão.

A porta TCP padrão é 9999.

Adicionado no Xamarin.Android 10.2.

Clean

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

FinishAotProfiling

Deve ser chamado após o destino BuildAndStartAotProfiling .

Coleta os dados do criador de perfil AOT do dispositivo ou emulador por meio da porta TCP $(AndroidAotProfilerPort) e os escreve para $(AndroidAotCustomProfilePath).

Os valores padrão para porta e perfil personalizado são 9999 e custom.aprof.

Para passar opções adicionais para aprofutil, defina-as na Propriedade $(AProfUtilExtraOptions).

Isso é o mesmo que:

aprofutil $(AProfUtilExtraOptions) -s -v -f -p $(AndroidAotProfilerPort) -o "$(AndroidAotCustomProfilePath)"

Adicionado no Xamarin.Android 10.2.

GetAndroidDependencies

Cria o @(AndroidDependency) grupo de itens, que é usado pelo InstallAndroidDependencies destino para determinar quais pacotes do SDK do Android instalar.

Instalar

Cria, assina e instala o pacote Android no dispositivo padrão ou no dispositivo virtual.

A $(AdbTarget) propriedade especifica o dispositivo de destino Android no qual o pacote Android pode ser instalado ou removido.

# Install package onto emulator via -e
# Use `/Library/Frameworks/Mono.framework/Commands/msbuild` on OS X
MSBuild /t:Install ProjectName.csproj /p:AdbTarget=-e

InstallAndroidDependencies

Chama o GetAndroidDependencies destino e instala os pacotes do SDK do Android especificados no @(AndroidDependency) grupo de itens.

dotnet build -t:InstallAndroidDependencies -f net8.0-android "-p:AndroidSdkDirectory=<path to sdk>" "-p:JavaSdkDirectory=<path to java sdk>"

O -f net8.0-android é necessário, pois esse destino é um destino específico do .NET para Android. Se você omitir esse argumento, receberá o seguinte erro:

error MSB4057: The target "InstallAndroidDependencies" does not exist in the project.

As AndroidSdkDirectory propriedades e JavaSdkDirectory são necessárias, pois precisamos saber onde instalar os componentes necessários. Esses diretórios podem estar vazios ou existentes. Os componentes do SDK serão instalados na parte superior de uma instalação do SDK existente.

A $(AndroidManifestType) propriedade MSBuild controla qual repositório do Gerenciador de SDK do Visual Studio é usado para detecção de nome e versão do pacote e URLs a serem baixadas.

RunWithLogging

Executa o aplicativo com o log adicional habilitado. Útil ao relatar ou investigar um problema com o aplicativo ou o tempo de execução. Se for bem-sucedido, as mensagens impressas na tela mostrarão a localização do arquivo logcat com as mensagens registradas.

Propriedades que afetam o funcionamento do destino:

  • /p:RunLogVerbose=true permite um registro ainda mais detalhado do MonoVM
  • /p:RunLogDelayInMS=X onde X deve ser substituído por tempo em milissegundos para aguardar antes de gravar a saída do log no arquivo. Assume o padrão de 1000.

Pacote SignAndroid

Cria e assina o arquivo do pacote Android (.apk).

Use com /p:Configuration=Release para gerar pacotes de "Versão" independentes.

IniciarAndroidAtividade

Inicia a atividade padrão no dispositivo ou no emulador em execução.

Para iniciar uma atividade diferente, defina o $(AndroidLaunchActivity) ao nome da atividade.

Isso é o mesmo que:

adb shell am start -S -n @PACKAGE_NAME@/$(AndroidLaunchActivity)

Adicionado no Xamarin.Android 10.2.

Pacote StopAndroidPackage

Interrompe completamente o pacote de aplicativos no dispositivo ou no emulador em execução.

Isso é o mesmo que:

adb shell am force-stop @PACKAGE_NAME@

Adicionado no Xamarin.Android 10.2.

Desinstalar

Desinstala o pacote Android do dispositivo padrão ou do dispositivo virtual.

A $(AdbTarget) propriedade especifica o dispositivo de destino Android no qual o pacote Android pode ser instalado ou removido.

AtualizarAndroidRecursos

Atualiza o arquivo Resource.designer.cs.

Esse destino geralmente é chamado pelo IDE quando novos recursos são adicionados ao projeto.