AppCenterDistribute@3 - App Center v3-taak distribueren

Gebruik deze taak om app-builds te distribueren naar testers en gebruikers via Visual Studio App Center.

Syntaxis

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

Invoer

serverEndpoint - App Center-serviceverbinding
string. Verplicht.

Selecteert de serviceverbinding voor Visual Studio App Center. Als u er een wilt maken, klikt u op de Manage koppeling en maakt u een nieuwe serviceverbinding.

appSlug - app-slug
string. Verplicht.

De app-slug heeft de indeling van {username}/{app_identifier}. Als u {username} en {app_identifier} voor een app wilt zoeken, klikt u op de naam van App Center-en heeft de resulterende URL de indeling van https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Als u orgs gebruikt, heeft de app-slug de indeling {orgname}/{app_identifier}.

appFile - binair bestandspad
Invoeralias: app. string. Verplicht.

Het relatieve pad van de hoofdmap van de opslagplaats naar het APK/AAB- of IPA-bestand dat u wilt publiceren.

buildVersion - buildversie
string.

De buildversie van het uploadende binaire bestand dat moet worden opgegeven voor .zip en .msi. Deze waarde wordt genegeerd, tenzij het platform WPF of WinForms is.

symbolsOption - symbolentype
Invoeralias: symbolsType. string. Toegestane waarden: Apple, Android, UWP. Standaardwaarde: Apple.

Bevat symboolbestanden voor het ontvangen van symbolische stacktraceringen in App Center Diagnostics.

pad symbolsPath - symbolen
string. Facultatief. Gebruiken wanneer symbolsType == AndroidNative || symbolsType = Windows.

Het relatieve pad van de hoofdmap van de opslagplaats naar de map symbolen.

appxsymPath - pad symbolen (*.appxsym)
string. Facultatief. Gebruiken wanneer symbolsType = UWP.

Het relatieve pad naar het bestand APPXSYM-symbolen. Het pad kan jokertekensbevatten.

symbolsDsymFiles - dSYM-pad
Invoeralias: dsymPath. string. Facultatief. Gebruiken wanneer symbolsType = Apple.

Het relatieve pad van de hoofdmap van de opslagplaats naar de dSYM-map. Het pad kan jokertekensbevatten.

symbolsMappingTxtFile - toewijzingsbestand
Invoeralias: mappingTxtPath. string. Facultatief. Gebruiken wanneer symbolsType = Android.

Het relatieve pad van de hoofdmap van de opslagplaats naar het mapping.txt-bestand van Android.

nativeLibrariesPath - systeemeigen bibliotheekbestandspad
string. Facultatief. Gebruiken wanneer symbolsType == Android.

Het relatieve pad van de hoofdmap van de opslagplaats naar de aanvullende systeemeigen bibliotheken die u wilt publiceren (bijvoorbeeld .so-bestanden).

symbolsIncludeParentDirectory - Alle items opnemen in de bovenliggende map
Invoeralias: packParentFolder. boolean. Facultatief. Gebruiken wanneer symbolsType = Apple.

Hiermee worden het geselecteerde symbolenbestand of de geselecteerde map en alle andere items in dezelfde bovenliggende map geüpload. Dit is vereist voor React Native-apps.

releaseNotesOption - releaseopmerkingen maken
Invoeralias: releaseNotesSelection. string. Verplicht. Toegestane waarden: input (Releaseopmerkingen invoeren), file (selecteer Releaseopmerkingenbestand). Standaardwaarde: input.

De releaseopmerkingen worden toegevoegd aan de release en weergegeven voor testers op de installatiepagina.

opmerkingen bij de release releaseNotesInput -
string. Vereist wanneer releaseNotesSelection = input.

De releaseopmerkingen voor deze versie.

releaseNotesFile - bestand met releaseopmerkingen
string. Vereist wanneer releaseNotesSelection = file.

Selecteert een met UTF-8 gecodeerd tekstbestand dat de releaseopmerkingen voor deze versie bevat.

isMandatory - Vereisen dat gebruikers bijwerken naar deze versie
boolean. Standaardwaarde: false.

De App Center Distribueer SDK die is vereist om een update te verplichten. Testers worden automatisch gevraagd om bij te werken.

destinationType - releasebestemming
string. Verplicht. Toegestane waarden: groups, store. Standaardwaarde: groups.

Elke release wordt gedistribueerd naar groepen of een winkel.

distributionGroupId - doel-id's
Invoeralias: destinationGroupIds. string. Facultatief. Gebruiken wanneer destinationType = groups.

De id's van de distributiegroepen die de build-release ontvangen. Laat het leeg om de standaardgroep te gebruiken en gebruik komma's of puntkomma's om meerdere id's te scheiden.

destinationStoreId - doel-id
string. Vereist wanneer destinationType = store.

De id's van het distributiearchief die de buildrelease ontvangen.

isSilent - Geen testers op de hoogte stellen. Release is nog steeds beschikbaar om te installeren.
boolean. Facultatief. Gebruiken wanneer destinationType = groups.

Testers ontvangen geen e-mail voor nieuwe releases.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om app-builds te distribueren naar testers en gebruikers via App Center.

• meld u eerst aan bij App Center.
• Zie het documentatieartikel over App Center Azure DevOps-builds implementeren met App Centervoor meer informatie over het gebruik van deze taak.

Voorbeelden

Met deze voorbeeldpijplijn wordt een Android-app gebouwd, tests uitgevoerd en de app gepubliceerd met behulp van 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'

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	2.206.1 of hoger
Taakcategorie	Implementeren