AppCenterDistribute@3 - App Center-taak v3 distribueren

Gebruik deze taak om app-builds te distribueren naar testers en gebruikers 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.

Invoerwaarden

serverEndpoint - App Center-serviceverbinding
string. Vereist.

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

De app-slug heeft de indeling .{username}/{app_identifier} Als u en {app_identifier} wilt zoeken {username} naar een app, klikt u op de naam in App Center. De resulterende URL heeft de indeling 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. Vereist.

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 binaire bestand dat wordt geüpload die 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.

symbolsPath - Pad naar symbolen
string. Optioneel. Gebruik wanneer symbolsType == AndroidNative || symbolsType = Windows.

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

appxsymPath - Symbolenpad (*.appxsym)
string. Optioneel. Gebruik wanneer symbolsType = UWP.

Het relatieve pad naar het bestand APPXSYM-symbolen. Pad kan jokertekens bevatten.

symbolsDsymFiles - dSYM-pad
Invoeralias: dsymPath. string. Optioneel. Gebruik wanneer symbolsType = Apple.

Het relatieve pad van de hoofdmap van de opslagplaats naar de map dSYM. Pad kan jokertekens bevatten.

symbolsMappingTxtFile - Toewijzingsbestand
Invoeralias: mappingTxtPath. string. Optioneel. Gebruik wanneer symbolsType = Android.

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

nativeLibrariesPath - Bestandspad voor systeemeigen bibliotheek
string. Optioneel. Gebruik 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 in de bovenliggende map opnemen
Invoeralias: packParentFolder. boolean. Optioneel. Gebruik wanneer symbolsType = Apple.

Uploadt het geselecteerde symbolenbestand of de geselecteerde map en alle andere items in dezelfde bovenliggende map. Dit is vereist voor React Native apps.

releaseNotesOption - Opmerkingen bij de release maken
Invoeralias: releaseNotesSelection. string. Vereist. Toegestane waarden: input (Opmerkingen bij de release invoeren), file (selecteer Bestand met opmerkingen bij release). Standaardwaarde: input.

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

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

De releaseopmerkingen voor deze versie.

releaseNotesFile - Bestand met opmerkingen bij de release
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 release
boolean. Standaardwaarde: false.

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

destinationType - Releasebestemming
string. Vereist. Toegestane waarden: groups, store. Standaardwaarde: groups.

Elke release wordt gedistribueerd naar groepen of een winkel.

distributionGroupId - Doel-id's
Invoeralias: destinationGroupIds. string. Optioneel. Gebruik wanneer destinationType = groups.

De id's van de distributiegroepen die de buildrelease ontvangen. Laat deze leeg om de standaardgroep te gebruiken en gebruik komma's of puntkomma's om meerdere id's van elkaar te scheiden.

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

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

isSilent - Stel testers niet op de hoogte. Release is nog steeds beschikbaar om te installeren.
boolean. Optioneel. Gebruik wanneer destinationType = groups.

Testers ontvangen geen e-mail voor nieuwe releases.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor 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 App Center-documentatieartikel Azure DevOps-builds implementeren met App Center voor meer informatie over het gebruik van deze taak.

Voorbeelden

In deze voorbeeldpijplijn wordt een Android-app gemaakt, tests uitgevoerd en de app gepubliceerd met 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

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.206.1 of hoger
Taakcategorie	Implementeren