Partager via


AppCenterDistribute@2 - Tâche de distribution app Center v2

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

Important

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

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

Cette tâche est déconseillée ; utilisez AppCenterDistribute@3.

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

Syntax

# App Center distribute v2
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@2
  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: destinationIds | destinationId. Destination IDs. 
  # 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 - Slug d’application
string. Obligatoire.

Le slug d’application est au format de {username}/{app_identifier}. Pour rechercher {username} et {app_identifier} pour une application, cliquez sur son nom à partir d’App Center, et 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 d’accès relatif de la racine du dépôt au 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 entre la racine du dépôt et le dossier des 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 dépôt aux fichiers de symboles PDB. 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 dépôt 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 entre la racine du dépôt et le fichier d’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 pour cette version.


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

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


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

Le Kit de développement logiciel (SDK) App Center Distribute requis pour exiger la mise à jour. Les testeurs sont automatiquement invités à mettre à jour.


distributionGroupId - ID de destination
Alias d’entrée : destinationIds | 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 commande Quelconque
Variables paramétrables Quelconque
Version de l’agent 2.144.0 ou version ultérieure
Catégorie de la tâche Déployer
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 Toutes les versions d’agent prises en charge.
Catégorie de la tâche Déployer