AppCenterDistribute@3 – App Center distribuerar v3-uppgift

Använd den här uppgiften för att distribuera appversioner till testare och användare via Visual Studio App Center.

Syntax

# 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.

Ingångar

serverEndpoint - App Center-tjänstanslutning
string. Obligatoriskt.

Väljer tjänstanslutningen för Visual Studio App Center. Om du vill skapa en klickar du på länken Manage och skapar en ny tjänstanslutning.

appSlug -
string. Obligatoriskt.

Appsnigeln är i formatet {username}/{app_identifier}. Om du vill hitta {username} och {app_identifier} för en app klickar du på namnet från App Centeroch den resulterande URL:en är i formatet https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Om du använder organisationer är appsnigeln av formatet {orgname}/{app_identifier}.

appFile - binär filsökväg
Indataalias: app. string. Obligatoriskt.

Den relativa sökvägen från lagringsplatsens rot till den APK/AAB- eller IPA-fil som du vill publicera.

buildVersion - Build version
string.

Versionsversionen av uppladdningsbinärfilen som måste anges för .zip och .msi. Det här värdet ignoreras om inte plattformen är WPF eller WinForms.

symbolsOption - Symboltyp
Indataalias: symbolsType. string. Tillåtna värden: Apple, Android, UWP. Standardvärde: Apple.

Innehåller symbolfiler för att ta emot symboliska stackspårningar i App Center Diagnostics.

sökväg symbolsPath - symboler
string. Valfritt. Använd när symbolsType == AndroidNative || symbolsType = Windows.

Den relativa sökvägen från lagringsplatsens rot till symbolmappen.

sökvägen appxsymPath - symboler (*.appxsym)
string. Valfritt. Använd när symbolsType = UWP.

Den relativa sökvägen till APPXSYM-symbolfilen. Sökvägen kan innehålla jokertecken.

symbolsDsymFiles - dSYM-sökväg
Indataalias: dsymPath. string. Valfritt. Använd när symbolsType = Apple.

Den relativa sökvägen från lagringsplatsens rot till mappen dSYM. Sökvägen kan innehålla jokertecken.

symbolsMappingTxtFile - mappningsfil
Indataalias: mappingTxtPath. string. Valfritt. Använd när symbolsType = Android.

Den relativa sökvägen från lagringsplatsens rot till Androids mapping.txt-fil.

nativeLibrariesPath - filsökväg för inbyggt bibliotek
string. Valfritt. Använd när symbolsType == Android.

Den relativa sökvägen från lagringsplatsens rot till de ytterligare interna bibliotek som du vill publicera (t.ex. .so-filer).

symbolsIncludeParentDirectory - Inkludera alla objekt i den överordnade mappen
Indataalias: packParentFolder. boolean. Valfritt. Använd när symbolsType = Apple.

Laddar upp den markerade symbolfilen eller mappen och alla andra objekt i samma överordnade mapp. Detta krävs för React Native-appar.

releaseNotesOption - Skapa viktig information
Indataalias: releaseNotesSelection. string. Obligatoriskt. Tillåtna värden: input (Ange viktig information), file (Välj viktig anteckningsfil). Standardvärde: input.

Viktig information kommer att bifogas till versionen och visas för testare på installationssidan.

releaseNotesInput - Viktig information
string. Krävs när releaseNotesSelection = input.

Viktig information för den här versionen.

releaseNotesFile - Viktig anteckningsfil
string. Krävs när releaseNotesSelection = file.

Väljer en UTF-8-kodad textfil som innehåller viktig information för den här versionen.

isMandatory - Kräv att användarna uppdaterar till den här versionen
boolean. Standardvärde: false.

App Center Distribuera SDK som krävs för att kräva en uppdatering. Testare uppmanas automatiskt att uppdatera.

destinationType - Release destination
string. Obligatoriskt. Tillåtna värden: groups, store. Standardvärde: groups.

Varje version distribueras till antingen grupper eller ett arkiv.

distributionGroupId - mål-ID:t
Indataalias: destinationGroupIds. string. Valfritt. Använd när destinationType = groups.

ID:t för de distributionsgrupper som ska ta emot versionsversionen. Lämna den tom om du vill använda standardgruppen och använd kommatecken eller semikolon för att separera flera ID:n.

destinationStoreId - mål-ID
string. Krävs när destinationType = store.

ID:t för distributionsarkivet som ska ta emot versionsversionen.

isSilent - Meddela inte testare. Versionen kommer fortfarande att vara tillgänglig för installation.
boolean. Valfritt. Använd när destinationType = groups.

Testare får inget e-postmeddelande för nya versioner.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften för att distribuera appversioner till testare och användare via App Center.

• Registrera dig med App Center först.
• Mer information om hur du använder den här uppgiften finns i appcentrets dokumentationsartikel Distribuera Azure DevOps-versioner med App Center.

Exempel

Den här exempelpipelinen skapar en Android-app, kör tester och publicerar appen med App Center Distribute.

# Android
# Build your Android project with Gradle.
# Add steps that test, sign, and distribute the APK, save build artifacts, and more:
# https://learn.microsoft.com/azure/devops/pipelines/ecosystems/android

pool:
  vmImage: 'macOS-latest'
steps:

- script: sudo npm install -g appcenter-cli
- script: appcenter login --token {YOUR_TOKEN}

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

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

- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(build.artifactStagingDirectory)'
    artifactName: 'outputs'
    artifactType: 'container'

# Run tests using the App Center CLI
- script: appcenter test run espresso --app "{APP_CENTER_SLUG}" --devices "{DEVICE}" --app-path {APP_FILE} --test-series "master" --locale "en_US" --build-dir {PAT_ESPRESSO} --debug

# Distribute the app
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: 'AppCenter'
    appSlug: '$(APP_CENTER_SLUG)'
    appFile: '$(APP_FILE)' # Relative path from the repo root to the APK or IPA file you want to publish
    symbolsOption: 'Android'
    releaseNotesOption: 'input'
    releaseNotesInput: 'Here are the release notes for this version.'
    destinationType: 'groups'

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	2.206.1 eller senare
Aktivitetskategori	Gruppera