AppCenterDistribute@3 - App Center v3'i dağıtma görevi

Visual Studio App Center aracılığıyla test edicilere ve kullanıcılara uygulama derlemelerini dağıtmak için bu görevi kullanın.

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.

Girişler

serverEndpoint - App Center hizmet bağlantısı
string. Gereklidir.

Visual Studio App Center için hizmet bağlantısını seçer. Bir bağlantı oluşturmak için bağlantıya tıklayın Manage ve yeni bir hizmet bağlantısı oluşturun.

appSlug - Uygulama sümüklüböcek
string. Gereklidir.

Uygulama sümüklüböcek, biçimindedir {username}/{app_identifier}. Bir uygulamayı bulmak {username} ve {app_identifier} için App Center'dan adına tıklayın ve sonuçta elde edilen URL biçimindedir https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Kuruluş kullanıyorsanız, uygulama sümüklü bilgi biçimindedir {orgname}/{app_identifier}.

appFile - İkili dosya yolu
Giriş diğer adı: app. string. Gereklidir.

Yayımlamak istediğiniz depo kökünden APK/AAB veya IPA dosyasına göreli yol.

buildVersion - Derleme sürümü
string.

ve .msiiçin .zip belirtilmesi gereken karşıya yükleme ikili dosyasının derleme sürümü. Platform WPF veya WinForms olmadığı sürece bu değer yoksayılır.

symbolsOption - Sembol türü
Giriş diğer adı: symbolsType. string. İzin verilen değerler: Apple, Android, UWP. Varsayılan değer: Apple.

App Center Tanılama'da sembolik yığın izlemelerini almak için sembol dosyalarını içerir.

symbolsPath - Simgeler yolu
string. İsteğe bağlı. when symbolsType == AndroidNative || symbolsType = Windowskullanın.

Depo kökünden simgeler klasörüne göreli yol.

appxsymPath - Simgeler yolu (*.appxsym)
string. İsteğe bağlı. when symbolsType = UWPkullanın.

APPXSYM sembolleri dosyasının göreli yolu. Yol joker karakterler içerebilir.

symbolsDsymFiles - dSYM yolu
Giriş diğer adı: dsymPath. string. İsteğe bağlı. when symbolsType = Applekullanın.

Depo kökünden dSYM klasörüne göreli yol. Yol joker karakterler içerebilir.

symbolsMappingTxtFile - Eşleme dosyası
Giriş diğer adı: mappingTxtPath. string. İsteğe bağlı. when symbolsType = Androidkullanın.

Depo kökünden Android'in mapping.txt dosyasına göreli yol.

nativeLibrariesPath - Yerel Kitaplık Dosya Yolu
string. İsteğe bağlı. when symbolsType == Androidkullanın.

Yayımlamak istediğiniz ek yerel kitaplıklara (örn. .so dosyaları) depo kökünden göreli yol.

symbolsIncludeParentDirectory - Tüm öğeleri üst klasöre ekle
Giriş diğer adı: packParentFolder. boolean. İsteğe bağlı. when symbolsType = Applekullanın.

Seçili semboller dosyasını veya klasörünü ve diğer tüm öğeleri aynı üst klasöre yükler. Bu, React Native uygulamalar için gereklidir.

releaseNotesOption - Sürüm notları oluşturma
Giriş diğer adı: releaseNotesSelection. string. Gereklidir. İzin verilen değerler: input (Sürüm Notları girin), file (Sürüm Notları Dosyasını Seçin). Varsayılan değer: input.

Sürüm notları yayına eklenir ve yükleme sayfasında test edenlere gösterilir.

releaseNotesInput - Sürüm notları
string. olduğunda releaseNotesSelection = inputgereklidir.

Bu sürüm için sürüm notları.

releaseNotesFile - Sürüm notları dosyası
string. olduğunda releaseNotesSelection = filegereklidir.

Bu sürümün sürüm notlarını içeren UTF-8 kodlanmış bir metin dosyası seçer.

isMandatory - Kullanıcıların bu sürüme güncelleştirmesini iste
boolean. Varsayılan değer: false.

Bir güncelleştirmeyi zorunlu kılması için App Center Distribute SDK'sı gereklidir. Test edenlerden otomatik olarak güncelleştirmeleri istenir.

destinationType - Yayın hedefi
string. Gereklidir. İzin verilen değerler: groups, store. Varsayılan değer: groups.

Her sürüm gruplara veya bir mağazaya dağıtılır.

distributionGroupId - Hedef Kimlikler
Giriş diğer adı: destinationGroupIds. string. İsteğe bağlı. when destinationType = groupskullanın.

Derleme sürümünü alacak dağıtım gruplarının kimlikleri. Varsayılan grubu kullanmak için boş bırakın ve birden çok kimliği ayırmak için virgül veya noktalı virgül kullanın.

destinationStoreId - Hedef Kimliği
string. olduğunda destinationType = storegereklidir.

Derleme sürümünü alacak dağıtım deposunun kimlikleri.

isSilent - Test edenleri bilgilendirmeyin. Sürüm hala yüklenebilir.
boolean. İsteğe bağlı. when destinationType = groupskullanın.

Test eden kişiler yeni sürümler için e-posta almaz.

Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Uygulama derlemelerini App Center aracılığıyla test edenlere ve kullanıcılara dağıtmak için bu görevi kullanın.

• Önce App Center'a kaydolun.
• Bu görevi kullanma hakkında ayrıntılı bilgi için, App Center ile Azure DevOps Derlemelerini Dağıtma App Center belgeleri makalesine bakın.

Örnekler

Bu örnek işlem hattı bir Android uygulaması oluşturur, testleri çalıştırır ve App Center Distribute kullanarak uygulamayı yayımlar.

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

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	2.206.1 veya üzeri
Görev kategorisi	Dağıtma