AppCenterDistribute@2 — zadanie dystrybucji w wersji 2 w usłudze App Center

To zadanie służy do dystrybuowania kompilacji aplikacji do testerów i użytkowników za pośrednictwem programu Visual Studio App Center.

Ważne

To zadanie jest przestarzałe i zostanie wycofane 31 stycznia 2024 r. Użyj AppCenterDistribute@3.

Składnia

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

Dane wejściowe

serverEndpoint - Połączenie usługi App Center
string. Wymagane.

Wybiera połączenie usługi dla programu Visual Studio App Center. Aby go utworzyć, kliknij Manage link i utwórz nowe połączenie z usługą.

appSlug - Slug aplikacji
string. Wymagane.

Slug aplikacji ma format {username}/{app_identifier}. Aby zlokalizować {username} i {app_identifier} dla aplikacji, kliknij jej nazwę w Centrum aplikacji, a wynikowy adres URL ma format https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Jeśli używasz organizacji, slug aplikacji ma format {orgname}/{app_identifier}.

appFile - Ścieżka pliku binarnego
Alias wejściowy: app. string. Wymagane.

Ścieżka względna z katalogu głównego repozytorium do pliku APK lub IPA, który chcesz opublikować.

symbolsOption - Typ symboli
Alias wejściowy: symbolsType. string. Dozwolone wartości: Apple. Wartość domyślna: Apple.

Zawiera pliki symboli do odbierania symbolicznych śladów stosu w diagnostyce centrum aplikacji.

symbolsPath - Ścieżka symboli
string. Opcjonalny. Użyj polecenia , gdy symbolsType == AndroidNative || symbolsType = Windows.

Ścieżka względna z katalogu głównego repozytorium do folderu symboli.

symbolsPdbFiles - Ścieżka symboli (*.pdb)
Alias wejściowy: pdbPath. string. Opcjonalny. Użyj polecenia , gdy symbolsType = UWP. Wartość domyślna: **/*.pdb.

Ścieżka względna z katalogu głównego repozytorium do plików symboli PDB. Ścieżka może zawierać symbole wieloznaczne.

symbolsDsymFiles - ścieżka dSYM
Alias wejściowy: dsymPath. string. Opcjonalny. Użyj polecenia , gdy symbolsType = Apple.

Ścieżka względna z katalogu głównego repozytorium do folderu dSYM. Ścieżka może zawierać symbole wieloznaczne.

symbolsMappingTxtFile - Plik mapowania
Alias wejściowy: mappingTxtPath. string. Opcjonalny. Użyj polecenia , gdy symbolsType = AndroidJava.

Ścieżka względna z katalogu głównego repozytorium do pliku systemu Android mapping.txt .

symbolsIncludeParentDirectory - Uwzględnij wszystkie elementy w folderze nadrzędnym
Alias wejściowy: packParentFolder. boolean.

Przekazuje zaznaczony plik lub folder symboli oraz wszystkie inne elementy w tym samym folderze nadrzędnym. Jest to wymagane w przypadku aplikacji React Native.

releaseNotesOption - Tworzenie informacji o wersji
Alias wejściowy: releaseNotesSelection. string. Wymagane. Dozwolone wartości: input (wprowadź informacje o wersji) file (wybierz pozycję Plik informacji o wersji). Wartość domyślna: input.

Informacje o wersji są dołączane do wersji i wyświetlane testerom na stronie instalacji.

releaseNotesInput - Wersji
string. Wymagane, gdy releaseNotesSelection = input.

Informacje o wersji dla tej wersji.

releaseNotesFile - Plik informacji o wersji
string. Wymagane, gdy releaseNotesSelection = file.

Wybiera zakodowany w formacie UTF-8 plik tekstowy zawierający informacje o wersji dla tej wersji.

isMandatory - Wymagaj od użytkowników aktualizacji do tej wersji
boolean. Wartość domyślna: false.

Zestaw SDK dystrybucji usługi App Center wymagany do mandatu aktualizacji. Testerzy są automatycznie monitowani o aktualizację.

distributionGroupId - Identyfikatory miejsc docelowych
Alias wejściowy: destinationIds | destinationId. string.

Identyfikatory magazynów dystrybucji lub grup, które otrzymają wydanie kompilacji. Pozostaw ją pustą, aby użyć grupy domyślnej.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

To zadanie jest przestarzałe. Użyj AppCenterDistribute@3.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa w	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	2.144.0 lub nowsza
Kategoria zadania	Wdróż