Criar, testar, implantar aplicativos Android

Artigo
01/10/2024

Serviços de DevOps do Azure

Você pode configurar pipelines para criar, testar e implantar aplicativos Android automaticamente.

Pré-requisitos

Você deve ter os seguintes itens:

Conta do GitHub. Se você não tiver uma conta no GitHub, crie uma agora.
Projeto Azure DevOps. Se você não tem um projeto, crie um agora.

Configurar pipeline

Faça as tarefas a seguir para configurar um pipeline para um aplicativo Android de exemplo.

Fork o seguinte repositório para sua conta GitHub para obter o código para um aplicativo Android simples.
```
https://github.com/MicrosoftDocs/pipelines-android
```
Entre na sua organização do Azure DevOps e vá para o seu projeto.
Selecione Pipelines>Criar pipeline ou Novo pipeline.
Selecione GitHub como o local do seu código-fonte.

Poderá ser redirecionado para o GitHub para iniciar sessão. Em caso afirmativo, insira suas credenciais do GitHub.
Selecione o repositório -android que você bifurcou anteriormente.
Selecione Aprovar e instalar na tela a seguir.

O Azure Pipelines gera um arquivo YAML para seu pipeline.
Selecione Executar.
Comprometa diretamente com a ramificação principal e escolha Executar novamente.
Aguarde a conclusão da execução.

Você tem um arquivoazure-pipelines.yml YAML () em funcionamento em seu repositório que está pronto para personalizar.

Gorjeta

Para fazer alterações no arquivo YAML, selecione o pipeline na página Pipelines e edite o azure-pipelines.yml arquivo.

Construa com a Gradle

Gradle é uma ferramenta de construção comum usada para construir projetos Android. Para obter mais informações sobre suas opções, consulte a tarefa Gradle .

# https://learn.microsoft.com/azure/devops/pipelines/ecosystems/android
pool:
  vmImage: 'macOS-latest'

steps:
- task: Gradle@2
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    gradleOptions: '-Xmx3072m'
    publishJUnitResults: false
    testResultsFiles: '**/TEST-*.xml'
    tasks: 'assembleDebug'

Ajustar o caminho de compilação

Ajuste o valor workingDirectory se o gradlew arquivo não estiver na raiz do repositório. O valor do diretório deve ser semelhante à raiz do repositório, como AndroidApps/MyApp ou $(system.defaultWorkingDirectory)/AndroidApps/MyApp.
Ajuste o valor gradleWrapperFile se gradlew o arquivo não estiver na raiz do repositório. O valor do caminho do arquivo deve ser semelhante à raiz do repositório, como AndroidApps/MyApp/gradlew ou $(system.defaultWorkingDirectory)/AndroidApps/MyApp/gradlew.

Ajustar tarefas do Gradle

Ajuste o valor das tarefas para a variante de compilação de sua preferência, como assembleDebug ou assembleRelease. Para obter mais informações, consulte a seguinte documentação de desenvolvimento do Google Android:

Construa um APK de depuração e
Configure variantes de compilação.

Assinar e alinhar um pacote Android (APK)

Se a sua compilação ainda não assinar e zipalinhar o APK, adicione a tarefa de assinatura do Android ao YAML. Um APK deve ser assinado para ser executado em um dispositivo em vez de um emulador. O zipaligning reduz a RAM consumida pelo aplicativo.

Importante

Recomendamos armazenar cada uma das seguintes senhas em uma variável secreta.

- task: AndroidSigning@2
  inputs:
    apkFiles: '**/*.apk'
    jarsign: true
    jarsignerKeystoreFile: 'pathToYourKeystoreFile'
    jarsignerKeystorePassword: '$(jarsignerKeystorePassword)'
    jarsignerKeystoreAlias: 'yourKeystoreAlias'
    jarsignerKeyPassword: '$(jarsignerKeyPassword)'
    zipalign: true

Teste

Teste no emulador Android

Crie a tarefa Bash e copie e cole o código abaixo para instalar e executar o emulador. Não se esqueça de organizar os parâmetros do emulador para se adequar ao seu ambiente de teste. O emulador começa como um processo em segundo plano e está disponível em tarefas posteriores.

#!/usr/bin/env bash

# Install AVD files
echo "y" | $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --install 'system-images;android-27;google_apis;x86'

# Create emulator
echo "no" | $ANDROID_HOME/tools/bin/avdmanager create avd -n xamarin_android_emulator -k 'system-images;android-27;google_apis;x86' --force

$ANDROID_HOME/emulator/emulator -list-avds

echo "Starting emulator"

# Start emulator in background
nohup $ANDROID_HOME/emulator/emulator -avd xamarin_android_emulator -no-snapshot > /dev/null 2>&1 &
$ANDROID_HOME/platform-tools/adb wait-for-device shell 'while [[ -z $(getprop sys.boot_completed | tr -d '\r') ]]; do sleep 1; done; input keyevent 82'

$ANDROID_HOME/platform-tools/adb devices

echo "Emulator started"

Teste em dispositivos hospedados pelo Azure

Adicione a tarefa Teste do App Center para testar o aplicativo em um laboratório hospedado de dispositivos iOS e Android. É necessária uma avaliação gratuita do App Center , que deve ser convertida posteriormente em paga.

Registe-se primeiro com o App Center .

# App Center test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
  inputs:
    appFile: # string. Alias: app. Required. Binary application file path. 
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
  # Prepare Tests
    #prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
    frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when enablePrepare = true && framework = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when enablePrepare = true && framework = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when enablePrepare = true && framework = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when enablePrepare = true && framework = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. App Center username. 
    #password: # string. Required when enableRun = true && credsType = inputs. App Center password. 
    appSlug: # string. Required when enableRun = true. App slug. 
    devices: # string. Required when enableRun = true. Devices. 
    #series: 'master' # string. Optional. Use when enableRun = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory. 
    localeOption: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Alias: locale. Required when enableRun = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliFile: # string. Alias: cliLocationOverride. App Center CLI location. 
    #showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.

Manter artefatos com o registro de compilação

Adicione as tarefas Copiar arquivos e Publicar artefatos de compilação. Seu APK é armazenado com o registro de compilação ou teste e é implantado em pipelines posteriores. Para obter mais informações, consulte Artefatos.

- task: CopyFiles@2
  inputs:
    contents: '**/*.apk'
    targetFolder: '$(build.artifactStagingDirectory)'
- task: PublishBuildArtifacts@1

Implementar

Adicionar App Center

Adicione a tarefa Distribuir do App Center para distribuir um aplicativo a um grupo de testadores ou usuários beta ou promova o aplicativo para o Intune ou o Google Play. É necessária uma conta gratuita no App Center (não é necessário pagamento).

# App Center distribute v3
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: # string. Required. App Center service connection. 
    appSlug: # string. Required. App slug. 
    appFile: # string. Alias: app. Required. Binary file path. 
    #buildVersion: # string. Build version. 
    releaseNotesOption: 'input' # 'input' | 'file'. Alias: releaseNotesSelection. Required. Create release notes. Default: input.
    releaseNotesInput: # string. Required when releaseNotesSelection = input. Release notes. 
    #releaseNotesFile: # string. Required when releaseNotesSelection = file. Release notes file. 
    #isMandatory: false # boolean. Require users to update to this release. Default: false.
    destinationType: 'groups' # 'groups' | 'store'. Required. Release destination. Default: groups.
    #distributionGroupId: # string. Alias: destinationGroupIds. Optional. Use when destinationType = groups. Destination IDs. 
    #destinationStoreId: # string. Required when destinationType = store. Destination ID. 
    #isSilent: # boolean. Optional. Use when destinationType = groups. Do not notify testers. Release will still be available to install. 
  # Symbols
    #symbolsOption: 'Apple' # 'Apple' | 'Android' | 'UWP'. Alias: symbolsType. Symbols type. Default: Apple.
    #symbolsPath: # string. Optional. Use when symbolsType == AndroidNative || symbolsType = Windows. Symbols path. 
    #appxsymPath: # string. Optional. Use when symbolsType = UWP. Symbols path (*.appxsym). 
    #symbolsDsymFiles: # string. Alias: dsymPath. Optional. Use when symbolsType = Apple. dSYM path. 
    #symbolsMappingTxtFile: # string. Alias: mappingTxtPath. Optional. Use when symbolsType = Android. Mapping file. 
    #nativeLibrariesPath: # string. Optional. Use when symbolsType == Android. Native Library File Path. 
    #symbolsIncludeParentDirectory: # boolean. Alias: packParentFolder. Optional. Use when symbolsType = Apple. Include all items in parent folder.

Instalar o Google Play

Instale a extensão do Google Play e use as seguintes tarefas para automatizar a interação com o Google Play. Por padrão, essas tarefas são autenticadas no Google Play usando uma conexão de serviço configurada por você.

Versão

Adicione a tarefa Lançamento do Google Play para lançar uma nova versão do aplicativo Android na Google Play Store.

- task: GooglePlayRelease@4
  inputs:
    apkFile: '**/*.apk'
    serviceEndpoint: 'yourGooglePlayServiceConnectionName'
    track: 'internal'

Promover

Adicione a tarefa Promover do Google Play para promover uma atualização de aplicativo Android lançada anteriormente de uma faixa para outra, como alpha → beta.

- task: GooglePlayPromote@3
  inputs:
    packageName: 'com.yourCompany.appPackageName'
    serviceEndpoint: 'yourGooglePlayServiceConnectionName'
    sourceTrack: 'internal'
    destinationTrack: 'alpha'

Aumentar a implementação

Adicione a tarefa Aumentar distribuição do Google Play para aumentar a porcentagem de distribuição de um aplicativo que foi lançado anteriormente na rollout faixa.

- task: GooglePlayIncreaseRollout@2
  inputs:
    packageName: 'com.yourCompany.appPackageName'
    serviceEndpoint: 'yourGooglePlayServiceConnectionName'
    userFraction: '0.5' # 0.0 to 1.0 (0% to 100%)

Atualização de status

Adicione a tarefa Atualização de status do Google Play para atualizar o status de distribuição do aplicativo que foi lançado anteriormente para a rollout faixa.

  - task: GooglePlayStatusUpdate@2
    inputs:
      authType: ServiceEndpoint
      packageName: 'com.yourCompany.appPackageName'
      serviceEndpoint: 'yourGooglePlayServiceConnectionName'
      status: 'inProgress' # draft | inProgress | halted | completed

Segurança codificada (Segurança codificada)
Google Play (Microsoft)
Tarefas de aplicativos móveis para iOS e Android (James Montemagno)
Laboratório de testes móveis (Perfecto Mobile)
React Native (Microsoft)

FAQ

P: Como faço para criar pacotes de aplicativos?

R: Você pode criar e assinar seu pacote de aplicativos com um script embutido e um arquivo seguro. Para fazer isso, primeiro baixe seu keystore e armazene-o como um arquivo seguro na Biblioteca. Em seguida, crie variáveis para keystore.password, key.aliase key.password em um grupo de variáveis.

Em seguida, use as tarefas Baixar Arquivo Seguro e Bash para baixar seu keystore e criar e assinar seu pacote de aplicativos.

Neste arquivo YAML, baixe um arquivo seguro e use um script bash para gerar um app.keystore pacote de aplicativos. Em seguida, use Copiar arquivos para copiar o pacote do aplicativo. A partir daí, crie e salve um artefato com o Publish Build Artifact ou use a extensão do Google Play para publicar.

- task: DownloadSecureFile@1
  name: keyStore
  displayName: "Download keystore from secure files"
  inputs:
    secureFile: app.keystore

- task: Bash@3
  displayName: "Build and sign App Bundle"
  inputs:
    targetType: "inline"
    script: |
      msbuild -restore $(Build.SourcesDirectory)/myAndroidApp/*.csproj -t:SignAndroidPackage -p:AndroidPackageFormat=aab -p:Configuration=$(buildConfiguration) -p:AndroidKeyStore=True -p:AndroidSigningKeyStore=$(keyStore.secureFilePath) -p:AndroidSigningStorePass=$(keystore.password) -p:AndroidSigningKeyAlias=$(key.alias) -p:AndroidSigningKeyPass=$(key.password)

- task: CopyFiles@2
  displayName: 'Copy deliverables'
  inputs:
    SourceFolder: '$(Build.SourcesDirectory)/myAndroidApp/bin/$(buildConfiguration)'
    Contents: '*.aab'
    TargetFolder: 'drop'

Criar, testar, implantar aplicativos Android

Pré-requisitos

Configurar pipeline

Construa com a Gradle

Ajustar o caminho de compilação

Ajustar tarefas do Gradle

Assinar e alinhar um pacote Android (APK)

Teste

Teste no emulador Android

Teste em dispositivos hospedados pelo Azure

Manter artefatos com o registro de compilação

Implementar

Adicionar App Center

Instalar o Google Play

Versão

Promover

Aumentar a implementação

Atualização de status

FAQ

P: Como faço para criar pacotes de aplicativos?

Comentários

Comentários

Recursos adicionais

Criar, testar, implantar aplicativos Android

Pré-requisitos

Configurar pipeline

Construa com a Gradle

Ajustar o caminho de compilação

Ajustar tarefas do Gradle

Assinar e alinhar um pacote Android (APK)

Teste

Teste no emulador Android

Teste em dispositivos hospedados pelo Azure

Manter artefatos com o registro de compilação

Implementar

Adicionar App Center

Instalar o Google Play

Versão

Promover

Aumentar a implementação

Atualização de status

Extensões relacionadas

FAQ

P: Como faço para criar pacotes de aplicativos?

Comentários

Comentários

Recursos adicionais