AppCenterDistribute@1 - Tâche de distribution v1 d’App Center

Utilisez cette tâche pour distribuer des builds d’application aux testeurs et aux utilisateurs via App Center et Visual Studio App Center.

Important

Cette tâche est déconseillée et sera retirée le 31 janvier 2024. Utilisez AppCenterDistribute@3.

Syntax

# App Center distribute v1
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@1
  inputs:
    serverEndpoint: # string. Required. App Center service connection. 
    appSlug: # string. Required. App slug. 
    appFile: # string. Alias: app. Required. Binary file path. 
    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.
    #distributionGroupId: # string. Alias: destinationId. Destination ID. 
  # Symbols
    #symbolsOption: 'Apple' # 'Apple'. Alias: symbolsType. Symbols type. Default: Apple.
    #symbolsPath: # string. Optional. Use when symbolsType == AndroidNative || symbolsType = Windows. Symbols path. 
    #symbolsPdbFiles: '**/*.pdb' # string. Alias: pdbPath. Optional. Use when symbolsType = UWP. Symbols path (*.pdb). Default: **/*.pdb.
    #symbolsDsymFiles: # string. Alias: dsymPath. Optional. Use when symbolsType = Apple. dSYM path. 
    #symbolsMappingTxtFile: # string. Alias: mappingTxtPath. Optional. Use when symbolsType = AndroidJava. Mapping file. 
    #symbolsIncludeParentDirectory: # boolean. Alias: packParentFolder. Include all items in parent folder.

Entrées

serverEndpoint - Connexion au service App Center
string. Obligatoire.

Sélectionne la connexion de service pour Visual Studio App Center. Pour en créer un, cliquez sur le Manage lien et créez une connexion de service.

appSlug - Limace d’application
string. Obligatoire.

La limace d’application est au format de {username}/{app_identifier}. Pour localiser {username} et {app_identifier} pour une application, cliquez sur son nom à partir d’App Center. L’URL résultante est au format .https://appcenter.ms/users/**{username}**/apps/**{app_identifier}** Si vous utilisez des organisations, l’application slug est au format {orgname}/{app_identifier}.

appFile - Chemin d’accès au fichier binaire
Alias d’entrée : app. string. Obligatoire.

Chemin relatif de la racine du référentiel vers le fichier APK ou IPA que vous souhaitez publier.

symbolsOption - Type de symboles
Alias d’entrée : symbolsType. string. Valeurs autorisées : Apple. Valeur par défaut : Apple.

Inclut des fichiers de symboles pour recevoir des traces de pile symboliques dans les diagnostics App Center.

symbolsPath - Chemin des symboles
string. facultatif. Utilisez quand symbolsType == AndroidNative || symbolsType = Windows.

Chemin d’accès relatif de la racine du référentiel au dossier symboles.

symbolsPdbFiles - Chemin des symboles (*.pdb)
Alias d’entrée : pdbPath. string. facultatif. Utilisez quand symbolsType = UWP. Valeur par défaut : **/*.pdb.

Chemin d’accès relatif de la racine du référentiel aux .pdb fichiers de symboles. Le chemin d’accès peut contenir des caractères génériques.

symbolsDsymFiles - Chemin d’accès dSYM
Alias d’entrée : dsymPath. string. facultatif. Utilisez quand symbolsType = Apple.

Chemin d’accès relatif de la racine du référentiel au dossier dSYM. Le chemin d’accès peut contenir des caractères génériques.

symbolsMappingTxtFile - Fichier de mappage
Alias d’entrée : mappingTxtPath. string. facultatif. Utilisez quand symbolsType = AndroidJava.

Chemin d’accès relatif de la racine du référentiel au fichier Android mapping.txt .

symbolsIncludeParentDirectory - Inclure tous les éléments dans le dossier parent
Alias d’entrée : packParentFolder. boolean.

Charge le fichier ou dossier de symboles sélectionnés et tous les autres éléments à l’intérieur du même dossier parent. Cela est nécessaire pour les applications React Native.

releaseNotesOption - Créer des notes de publication
Alias d’entrée : releaseNotesSelection. string. Obligatoire. Valeurs autorisées : input (Entrez les notes de publication), file (sélectionnez Fichier de notes de publication). Valeur par défaut : input.

Les notes de publication sont jointes à la version et affichées aux testeurs sur la page d’installation.

releaseNotesInput - Notes de publication
string. Nécessaire lorsque releaseNotesSelection = input.

Notes de publication de cette version.

releaseNotesFile - Fichier de notes de publication
string. Nécessaire lorsque releaseNotesSelection = file.

Sélectionne un fichier texte encodé UTF-8 qui contient les notes de publication de cette version.

isMandatory - Exiger que les utilisateurs mettent à jour vers cette version
boolean. Valeur par défaut : false.

Le Kit de développement logiciel (SDK) De distribution App Center est requis pour imposer une mise à jour. Les testeurs sont automatiquement invités à mettre à jour.

distributionGroupId - Destination ID
Alias d’entrée : destinationId. string.

ID des magasins ou groupes de distribution qui recevront la version de build. Laissez-le vide pour utiliser le groupe par défaut.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Cette tâche est dépréciée. Utilisez AppCenterDistribute@3.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	2.144.0 ou version ultérieure
Catégorie de la tâche	Déployer