AppCenterDistribute@1 — Usługa App Center dystrybuuje zadanie w wersji 1

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

Ważne

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

Składnia

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

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 jest w formacie {username}/{app_identifier}. Aby zlokalizować {username} aplikację i {app_identifier} ją znaleźć, kliknij jej nazwę w Centrum aplikacji. Wynikowy adres URL jest w formacie https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Jeśli używasz organizacji, ślimak 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 .pdb plików symboli. Ś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 wybrany 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łączone 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 centrum aplikacji wymagany do mandatu aktualizacji. Testerzy są automatycznie monitowani o aktualizację.

distributionGroupId - Identyfikator docelowy
Alias wejściowy: 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, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	2.144.0 lub nowsza
Kategoria zadania	Wdróż