Odniesienie do manifestu rozszerzenia

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Każde rozszerzenie ma plik manifestu JSON, który definiuje podstawowe informacje o rozszerzeniu. Plik definiuje również sposób rozszerzania i ulepszania doświadczenia. W tym artykule pokazano, jak utworzyć manifest dla rozszerzenia usługi Azure DevOps.

Utwórz plik o nazwie vss-extension.json w katalogu głównym folderu rozszerzenia. Ten plik zawiera wymagane atrybuty, takie jak identyfikator rozszerzenia i jego obiekty docelowe instalacji, w których można go uruchomić. Określa także wkład wnoszony przez rozszerzenie.

Zobacz następujący przykład typowego manifestu:

{
    "manifestVersion": 1,
    "id": "tools",
    "version": "0.1.0",
    "name": "Fabrikam Tools",
    "publisher": "fabrikam",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ],
    "icons": {
        "default": "images/fabrikam-logo.png"
    },
    "scopes": [
        "vso.work",
        "vso.code_write",
        "vso.build_execute"
    ],
    "categories": [
        "Azure Boards"
    ],
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    },
    "content": {
        "details": {
            "path": "readme.md"
        },
        "license": {
            "path": "eula.md"
        }
    },
    "links": {
        "getstarted": {
            "uri": "https://www.fabrikam-fiber-inc.com/help/getstarted"
        },
        "support": {
            "uri": "https://www.fabrikam-fiber-inc.com/support"
        }
    },
    "repository": {
        "type": "git",
        "uri": "https://github.com/fabrikam-fiber-inc/myextension"
    },
    "contributions": [
        {
            "id": "showCommits",
            "type": "ms.vss-web.action",
            "description": "Adds a menu action from builds grid to show associated items.",
            "targets": [
                "ms.vss-build-web.completed-build-menu"
            ],
            "properties": {
                "title": "View associated items",
                "uri": "launch.html"
            }
        }
    ],
    "files": [
        {
            "path": "launch.html",
            "addressable": true
        },        
        {
            "path": "node_modules/vss-web-extension-sdk/lib",
            "addressable": true,
            "packagePath": "lib"
        }
    ]
}

Aby uzyskać informacje o danych wejściowych, zobacz ...

Wymagane atrybuty

Wymagane są następujące właściwości:

Przykłady wymaganych atrybutów

{
    "manifestVersion": 1,
    "id": "tools",
    "version": "0.1.0",
    "name": "Fabrikam Tools",
    "publisher": "fabrikam",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ]
}

Atrybuty opcjonalne

Atrybuty środowiska uruchomieniowego

{
    "scopes": [
        "vso.work",
        "vso.code_write",
        "vso.build_execute"
    ],
    "demands": [
        "api-version/3.0"
    ],
    "contributions": [
        {
            "id": "showCommits",
            "type": "ms.vss-web.action",
            "description": "Adds a menu action from builds grid to show associated items.",
            "targets": [
                "ms.vss-build-web.completed-build-menu"
            ],
            "properties": {
                "title": "View associated items",
                "uri": "launch.html"
            }
        }
    ]
}

Atrybuty odnajdywania

Następujące opcjonalne właściwości ułatwiają użytkownikom odnajdywanie i poznawanie rozszerzenia:

Oznacz rozszerzenie jako publiczne

Domyślnie wszystkie rozszerzenia w witrynie Azure DevOps Marketplace są prywatne. Są one ukryte w widoku publicznym i są widoczne tylko dla wydawcy i określonych kont udostępnionych przez wydawcę. Jeśli wydawca zostanie zweryfikowany, możesz upublicznić rozszerzenie, ustawiając flagę Public w manifeście rozszerzenia:

{
    "galleryFlags": [
        "Public"
    ]
}            

Lub:

{
    "public": true
}            

Aby uzyskać więcej informacji, zobacz Package/Publish/Install.

Oznaczanie rozszerzenia, które ma być w wersji zapoznawczej

Jeśli rozszerzenie jest gotowe dla użytkowników w witrynie Marketplace do wypróbowania, ale nadal pracujesz nad kilkoma usterkami lub dodawaniem funkcji, możesz oznaczyć ją jako preview:

{
    "galleryFlags": [
        "Preview"
    ]
}            

Oznaczanie rozszerzenia jako płatnej wersji zapoznawczej

Jeśli zamierzasz sprzedać rozszerzenie w witrynie Marketplace, oznacz je jako płatną wersję zapoznawcza. Nie można zmienić rozszerzenia oznaczonego bezpłatnie na płatne.

{
    "galleryFlags": [
        "Paid",
        "Preview"
    ]
}            

Oznacz rozszerzenie jako płatne

Jeśli chcesz sprzedać rozszerzenie na Marketplace, możesz oznaczyć je flagą Paid i tagiem __BYOLENFORCED (który zaczyna się od dwóch podkreśleń):

{
    "galleryFlags": [
        "Paid"        
    ],
     "tags": [        
        "__BYOLENFORCED"
    ]
}            

Zarówno flaga Paid , jak i __BYOLENFORCED tag muszą być obecne, aby oznaczyć rozszerzenie jako płatne w witrynie Marketplace. Bring-Your-Own-License (BYOL) oznacza, że wydawca rozszerzenia udostępnia mechanizm rozliczeń i licencjonowania rozszerzenia, ponieważ nie jest on dostarczany przez firmę Microsoft dla rozszerzeń Usługi DevOps platformy Azure. Wszystkie płatne rozszerzenia są wymagane do zdefiniowania zasad ochrony prywatności, zasad pomocy technicznej i umowy licencyjnej użytkownika końcowego. Wydawcy muszą podać zawartość karty cennika w witrynie Marketplace w następujący sposób:

{
    "content": {
        "details": {
            "path": "overview.md"
        }, 
        "pricing": {
            "path": "pricing.md"
        }
    }
}          

Musisz również dodać nową sekcję w manifeście rozszerzenia, aby zastąpić płatne licencjonowanie. W przyszłości usuniemy kontrolę płatnego licencjonowania i nie będziemy już wymagać nadpisywania ustawień. Na razie upewnij się, że rozszerzenie jest wyświetlane zgodnie z oczekiwaniami. Każde zastąpienie składa się z "ID" i "zachowania". Dopasuj "ID" do wartości ID wkładów zdefiniowanych w manifeście.

"licensing": {

      "overrides": [

        { "id": "my-hub", "behavior": " AlwaysInclude" }
      ]
    }

Jeśli płatne rozszerzenie BYOL oferuje okres próbny (zalecamy to), możesz określić długość okresu próbnego w dniach:

{
    "galleryproperties": {
        "trialDays": "30"
    } 
}          

Przykład większej liczby właściwości

{
    "description": "Awesome tools to help you and your team do great things everyday.",
    "icons": {
        "default": "images/fabrikam-logo.png"
    },
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "license-terms.md"
        }
    },
    "links": {
        "home": {
            "uri": "https://www.fabrikam-fiber-inc.com"
        },
        "getstarted": {
            "uri": "https://www.fabrikam-fiber-inc.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.fabrikam-fiber-inc.com/features"
        },
        "support": {
            "uri": "https://www.fabrikam-fiber-inc.com/support"
        },
        "repository": {
            "uri": "https://github.com/fabrikam-fiber-inc/tools"
        },
        "issues": {
            "uri": "https://github.com/fabrikam-fiber-inc/tools/issues"
        }
    },
    "repository": {
        "type": "git",
        "uri": "https://github.com/fabrikam-fiber-inc/tools"
    },
    "badges": [
        {
            "href": "https://travis.ci/fabrikam-fiber-inc/myextension",
            "uri": "https://travis.ci/fabrikam-fiber-inc/myextension.svg?branch=master",
            "description": "TravisCI build for the project"
        },
        {
            "href": "https://ci.appveyor.com/projects/fabrikam-fiber-inc/myextension",
            "uri": "https://ci.appveyor.com/api/projects/status/vlg2sgs2y7tsdxpj4c?svg=true",
            "description": "AppVeyor build for the project"
        }
    ],
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    },
    "screenshots": [
        {
            "path": "screenshots/screen1.png"
        },
        {
            "path": "screenshots/screen2.png"
        }
    ]
}

Przykład strony szczegółów

• 1 — opis
• 2 — ikona
• 3 — kategorie
• 4 — zrzuty ekranu
• 5 — zawartość (szczegóły)
• 6 - łącza
• 7 — znakowanie

Pytania i odpowiedzi Marketplace — właściwość CustomerQnASupport

Wszystkie rozszerzenia na Visual Studio Marketplace mają sekcję Pytania i odpowiedzi (Q & A), aby umożliwić jeden-na-jeden publiczną rozmowę między użytkownikami rozszerzeń i wydawcami. Wydawcy mogą wybierać między ofertą Marketplace Q & A, zagadnieniami w GitHub lub niestandardowym adresem URL Q & A. W witrynie Marketplace można wyłączyć funkcję Q & A przy użyciu właściwości CustomerQnASupport w manifeście.

Środowisko domyślne (nie są wymagane żadne zmiany manifestu)

• W przypadku rozszerzeń z repozytorium GitHub witryna Marketplace przekierowuje użytkowników w sekcji Pytań i odpowiedzi do skojarzonych problemów z usługą GitHub.
• W przypadku rozszerzeń bez repozytorium GitHub jest włączona obsługa pytań i odpowiedzi w witrynie Marketplace.

Aby uzyskać inne doświadczenie niż standardowe opcje, użyj właściwości CustomerQnASupport w manifeście.

{
    "CustomerQnASupport": {
        "enablemarketplaceqna": true,
        "url": "http://uservoice.visualstudio.com"
    } 
}

Właściwości

Właściwości sekcji Customer Q & A Support (Obsługa techniczna dla klientów):

• enablemarketplaceqna — pole logiczne, ustawione na wartość true dla marketplace lub niestandardowego Q&A; false, aby wyłączyć pytania i odpowiedzi
• url — ciąg, adres URL dla niestandardowych pytań i odpowiedzi

Przykłady przedstawiające użycie obsługi języka Q &A

Przykład: rozszerzenie korzystające z niestandardowego języka Q & A

{
     "CustomerQnASupport": {
        "enablemarketplaceqna":"true",
        "url": "http://uservoice.visualstudio.com"
    } 
}

Przykład: rozszerzenie z repozytorium GitHub, ale korzystanie z Marketplace Q&A zamiast zgłoszeń problemów na GitHubie

{
     "CustomerQnASupport": {
        "enablemarketplaceqna":"true"
    } 
}

Przykład: wyłączanie sekcji pytań i odpowiedzi

{
     "CustomerQnASupport": {
        "enablemarketplaceqna":"false"
    } 
}

Zakresy

W rozszerzeniu można zdefiniować jeden lub więcej zakresów. Te zakresy określają zasoby, do których rozszerzenie może uzyskać dostęp, oraz operacje dozwolone do wykonania na tych zasobach. Zakresy określone w manifeście rozszerzenia to zakresy ustawione dla tokenów dostępu wystawionych dla rozszerzenia. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie i zabezpieczenia.

Jeśli nie określono żadnych zakresów, rozszerzenia mają dostęp tylko do danych profilu użytkownika i rozszerzenia.

Obsługiwane zakresy

Zmiana zakresu opublikowanego rozszerzenia

Zakres opublikowanego rozszerzenia można zmienić. Jeśli wcześniej zainstalowałeś rozszerzenie (i autoryzowałeś poprzedni zestaw uprawnień), autoryzuj nowe uprawnienia przed uaktualnieniem do najnowszej wersji.

Sekcja Akcja wymagana w ustawieniach rozszerzenia pokazuje użytkownikowi, które z zainstalowanych rozszerzeń wymagają autoryzacji:

Administrator może następnie przejrzeć i autoryzować nowy zestaw zakresów:

Miejsca docelowe instalacji

Jak wskazuje nazwa, cele instalacji definiują produkty i usługi, w których można zainstalować rozszerzenie. Microsoft.VisualStudio.Services jest najczęstszym celem instalacji i wskazuje, że rozszerzenie można zainstalować w usłudze Azure DevOps.

Cele instalacji rozszerzenia lub integracji są określane za pośrednictwem targets pola w manifeście.

Obsługiwane identyfikatory rozszerzeń:

• Microsoft.VisualStudio.Services.Cloud: instaluje się w usługach Azure DevOps Services
• Microsoft.TeamFoundation.Server: instaluje się w usłudze Azure DevOps Server
• Microsoft.VisualStudio.Services: instaluje się w obu. Skrót do Microsoft.VisualStudio.Services.Cloud i Microsoft.TeamFoundation.Server wersji [14.2,)

Obsługiwane identyfikatory dla integracji:

• Microsoft.VisualStudio.Services.Cloud.Integration: integruje się z usługą Azure DevOps Services
• Microsoft.TeamFoundation.Server.Integration: integruje się z usługą Azure DevOps Server
• Microsoft.VisualStudio.Services.Integration: integruje się z obydwoma. Skrót dla Microsoft.VisualStudio.Services.Cloud.Integration i Microsoft.TeamFoundation.Server.Integration

Aby uzyskać więcej informacji, zobacz Punkty rozszerzalności.

Przykłady miejsc docelowych instalacji

Przykład: rozszerzenie współpracujące z usługą Azure DevOps

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ]
}

Przykład: rozszerzenie, które działa tylko z usługą Azure DevOps Services

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Cloud"
        }
    ]
}

Cele instalacji mogą być również używane w manifeście integracji. Na przykład produkty, aplikacje lub narzędzia, z którymi pracujesz, ale nie instaluj ich w usłudze Azure DevOps.

Przykład: integracja, która współpracuje z usługą Azure DevOps

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ]
}

Przykład: integracja, która działa tylko z usługą Azure DevOps Server

{
    "targets": [
        {
            "id": "Microsoft.TeamFoundation.Server.Integration"
        }
    ]
}

Wersje docelowe instalacji

Niektóre identyfikatory docelowe instalacji, takie jak Microsoft.TeamFoundation.Server i Microsoft.TeamFoundation.Server.Integration, obsługują opcjonalny zakres wersji. Ten opcjonalny zakres wersji dodatkowo wyjaśnia obsługiwane wersje rozszerzenia lub integracji.

Wersja lub zakres wersji jest określony za pośrednictwem version pola w obiekcie docelowym instalacji. Ta wartość może być następująca:

• Określona wersja, na przykład: 15.0 (tylko RTM 2017)
• Zakres obsługiwanych wersji, na przykład: [14.0) (2015 RTM i nowsze), [14.3,15.1] (2015 Update 3 do 2017 Update 1). Wartości zakresu są uściślone przy użyciu:
  • [: minimalna wersja włącznie
  • ]: wersja maksymalna włącznie
  • (: wersja minimalna wyłączna
  • ): maksymalna wersja na wyłączność

Numery wersji serwera Azure DevOps Server:

Przykłady przedstawiające wersje

Przykład: rozszerzenie współpracujące z usługą Azure DevOps

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Cloud"
        },
        {
            "id": "Microsoft.TeamFoundation.Server",
            "version": "[15.0,)"
        }
    ]
}

Skróty

Microsoft.VisualStudio.Services to skrót do usługi Azure DevOps.

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ]
}

jest odpowiednikiem:

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Cloud"
        },
        {
            "id": "Microsoft.TeamFoundation.Server",
            "version": "[14.2,)"
        }
    ]
}

Korzystanie z celów instalacji i wymagań

Cele instalacji i wymagania są używane razem do prezentowania użytkownikom poprawnego widoku produktów i usług, z których twoje rozszerzenie lub integracja jest zgodna. Na przykład określenie docelowego miejsca instalacji Microsoft.VisualStudio.Services z wymogiem api-version/3.0 oznacza, że rozszerzenie działa z usługą Azure DevOps.

Przykład: rozszerzenie korzystające z interfejsów API w wersji 3.0

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ],
    "demands": [
        "api-version/3.0"
    ]
}

Rozwiązuje następujące cele instalacji:

1. Microsoft.VisualStudio.Services.Cloud
2. Microsoft.TeamFoundation.Server, Wersja: [15.0,)

Przykład: integracja korzystająca z interfejsów API w wersji 2.0

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ],
    "demands": [
        "api-version/2.0"
    ]
}

Rozwiązuje następujące cele instalacji:

1. Microsoft.VisualStudio.Services.Cloud.Integration
2. Microsoft.TeamFoundation.Server.Integration, Wersja: [14.0,)

Wymagania

Wymagania umożliwiają określenie możliwości i innych funkcji wymaganych przez rozszerzenie. Możesz użyć tych wymagań, aby ograniczyć miejsce publikowania lub instalowania rozszerzenia.

Wymagania są używane przez witrynę Visual Studio Marketplace, aby wyświetlić listę produktów i środowisk, z którymi twoje rozszerzenie jest zgodne, co pomaga klientom zrozumieć, czy rozszerzenie działa z ich wersją usługi Azure DevOps, na przykład.

Zobacz poniższy przykład sposobu, w jaki wymagania są określone w manifeście rozszerzenia.

{
    "demands": [
        "api-version/3.0",
        "contribution/ms.vss-dashboards-web.widget-catalog"
    ]
}

W tym przykładzie rozszerzenie wymaga wersji 3.0 interfejsów API, co oznacza, że można go zainstalować tylko w usłudze Azure DevOps. Wymaga również, aby rozszerzenie ms.vss-dashboards-web (i jego widget-catalog wkład) było zainstalowane (i włączone) w kolekcji przed zainstalowaniem Twojego rozszerzenia.

Obsługiwane wymagania

Files

Sekcja files zawiera odwołania do wszystkich plików, które mają zostać dołączone do rozszerzenia. Można dodawać zarówno foldery, jak i pojedyncze pliki:

{
    "files": [
        {
            "path": "hello-world.html", "addressable": true
        },
        {
            "path": "scripts", "addressable": true
        },
        {
            "path": "images/logo.png", "addressable": true, "packagePath": "/"
        }
    ]
}

Właściwości

Właściwości sekcji Pliki:

• path — ścieżka do zasobu na dysku, która może być względna względem katalogu głównego.
• addressable — (opcjonalnie) ustaw wartość true , jeśli chcesz, aby plik był adresowalny pod adresem URL. Wartość domyślna to false.
• packagePath — (opcjonalnie) ścieżka do zasobu w pakiecie. Domyślnie jest to ścieżka względna na dysku, zaczynająca się od katalogu głównego.
• contentType — opcjonalny typ MIME pliku. Domyślnie opiera się na najlepszym domyśle na podstawie rozszerzenia pliku i ustawień systemu operacyjnego.
• assetType — (opcjonalnie) Określ wartość atrybutu Type wpisu zasobu w manifeście VSIX. Może być również tablicą ciągów, w takim przypadku do tego pliku zostanie dodanych wiele wpisów zasobów. Domyślnie jest ustawione na ścieżkę packagePath.
• lang — (opcjonalnie) Język tego elementu zawartości. Zlokalizowane pliki są serwowane na podstawie nagłówka Accept-Language. Pozostaw wartość pustą, aby oznaczyć ten plik w domyślnym (lub rezerwowym) języku. Zlokalizowane wersje tego samego pliku powinny mieć ten sam typ zasobu.

Udziały

Każdy wpis wkładu ma następujące właściwości:

• id — referencyjny identyfikator (tekst) dla udziału. Upewnij się, że każdy identyfikator wkładu jest unikatowy w ramach rozszerzenia. Zobacz odniesienia do wkładów i typów.
• type — Identyfikator typu wkładu tego udziału.
• description — (Opcjonalnie) Ciąg opisujący, co udostępnia wkład.
• targets — tablica identyfikatorów wkładów, na które kierowane są współtworzenia. Zobacz Ukierunkowanie wkładów.
• properties — (opcjonalnie) Obiekt, który zawiera właściwości wkładu jako zdefiniowane w typie wkładu.

Aby uzyskać więcej informacji, zobacz omówienie modelu współtworzenia.

Typy wkładów

Każdy wpis wkładu ma następujące właściwości:

• id — identyfikator odniesienia (ciąg znaków) dla typu udziału. Upewnij się, że każdy identyfikator typu wkładu jest unikatowy w obrębie rozszerzenia. Zobacz odniesienia do wkładów i typów.
• name — przyjazna nazwa typu udziału.
• description — (Opcjonalnie) Ciąg opisujący bardziej szczegółowo typ udziału.
• properties — Słownik (opcjonalnie) mapujący nazwy właściwości na ich opisy. Te cechy opisują wymagane i opcjonalne właściwości, których mogą używać wkłady tego rodzaju.

Opisy właściwości mają następujące cechy:

• description — (opcjonalnie) Ciąg opisujący, do czego służy właściwość.
• required — (Opcjonalnie) Wartość logiczna, która wskazuje, że właściwość jest wymagana dla wszystkich wkładów tego typu, jeśli wartość jest true.
• type — typ wartości, którą może mieć właściwość, która może być ciągiem, identyfikatorem URI, identyfikatorem GUID, wartością logiczną, liczbą całkowitą, podwójną, datą/godziną, tablicą lub obiektem.

Aby uzyskać więcej informacji, zobacz omówienie modelu współtworzenia.

Odniesienie do wkładów i typów

Użyj unikatowych identyfikatorów, aby odwoływać się do wkładów i rodzajów wkładów. Odwołaj się do typów za pomocą właściwości type i odwołaj się do innych wkładów za pomocą właściwości targets.

• Pełne odniesienie wkładu obejmuje identyfikator wydawcy, identyfikator rozszerzenia oraz identyfikator wkładu/typu, oddzielony kropką (.). Na przykład ms.vss-web.hub jest pełnym identyfikatorem dla udziału, które ma identyfikator hub w rozszerzeniu vss-web opublikowanym przez wydawcę "ms" (Microsoft).
• Odwołania do wkładu względnego mogą być używane w manifeście rozszerzenia w celu odniesienia się do innego wkładu lub typu wkładu w ramach tego samego rozszerzenia. W tym przypadku identyfikatory wydawcy i rozszerzenia nie są uwzględniane, a identyfikator jest kropką (.), a następnie identyfikatorem udziału. Na przykład .hub można użyć w ramach rozszerzenia vss-web wymienionego wcześniej jako skrótu dla ms.vss-web.hub.

Kierowanie wkładem

Niektóre wkłady działają jako kontenery, na które są ukierunkowane inne wkłady.

• Wkład w koncentrator może dotyczyć Grup Hubu. Gdy strona jest renderowana, interfejs webowy wyświetla wszystkie wkłady do centrum skierowane do wybranej grupy centrum. Grupy hubów są przeznaczone dla kolekcji grup hubów, która definiuje zestaw grup pokazywanych w określonym obszarze nawigacyjnym, na przykład na stronach administracyjnych na poziomie projektu.
• Różne typy wkładów mogą być skierowane na menu: akcja, akcja-hiperłącze i dostawca działań. Akcje i akcje hiperłączy zapewniają wpisy pojedynczych elementów menu. Dostawca akcji może udostępnić wiele dynamicznych elementów menu. Dla danego menu elementy są agregowane we wszystkich wkładach (dowolnego z tych typów), które dotyczą tego konkretnego wkładu do menu.

Dodawanie ikony centrum

Aby uzyskać informacje na temat dodawania ikony do centrum, zapoznaj się ze wskazówkami dotyczącymi ikony centrum.

Obsługiwane usługi odznaki

Witryna Marketplace obsługuje tylko znaczki z następujących zaufanych usług:

• api.travis-ci.org/
• badge.fury.io/
• badges.frapsoft.com/
• badges.gitter.im/
• badges.greenkeeper.io/
• cdn.travis-ci.org/
• ci.appveyor.com/
• codeclimate.com/
• codecov.io/
• coveralls.io/
• david-dm.org/
• gemnasium.com/
• img.shields.io/
• isitmaintained.com/
• marketplace.visualstudio.com/
• snyk.io/
• travis-ci.com/
• travis-ci.org/
• vsmarketplacebadges.dev/
• bithound.io/
• deepscan.io/
• githost.io/
• gitlab.com/
• opencollective.co/

Aby wyświetlić znaczek z innej usługi, skontaktuj się z Obsługą Klienta w Społeczności Deweloperów.

Przykładowy manifest

Następujące rozszerzenie dodaje akcję do menu kontekstowego ukończonych kompilacji i element w grupie Centrum kompilacji.

{
    "manifestVersion": 1,
    "id": "tools",
    "version": "0.1.0",
    "name": "Fabrikam Tools",
    "publisher": "fabrikam",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ],
    "demands": [
        "api-version/3.0"
    ],
    "icons": {
        "default": "images/fabrikam-logo.png"
    },
    "scopes": [
        "vso.work",
        "vso.code_write"
    ],
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    },
    "screenshots": [
        {
            "path": "screenshots/screen1.png"
        },
        {
            "path": "screenshots/screen2.png"
        }
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "eula.md"
        }
    },
    "links": {
        "home": {
            "uri": "https://www.fabrikam-fiber-inc.com"
        },
        "getstarted": {
            "uri": "https://www.fabrikam-fiber-inc.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.fabrikam-fiber-inc.com/features"
        },
        "support": {
            "uri": "https://www.fabrikam-fiber-inc.com/support"
        },
        "repository": {
            "uri": "https://github.com/fabrikam-fiber-inc/tools"
        },
        "issues": {
            "uri": "https://github.com/fabrikam-fiber-inc/tools/issues"
        }
    },
    "repository": {
        "type": "git",
        "uri": "https://github.com/fabrikam-fiber-inc/myextension"
    },
    "badges": [
        {
            "href": "https://travis.ci/fabrikam-fiber-inc/myextension",
            "uri": "https://travis.ci/fabrikam-fiber-inc/myextension.svg?branch=master",
            "description": "TravisCI build for the project"
        },
        {
            "href": "https://ci.appveyor.com/projects/fabrikam-fiber-inc/myextension",
            "uri": "https://ci.appveyor.com/api/projects/status/vlg2sgs2y7tsdxpj4c?svg=true",
            "description": "AppVeyor build for the project"
        }
    ],
    "contributions": [
        {
            "id": "showCommits",
            "type": "ms.vss-web.action",
            "description": "Adds a menu action from builds grid to show associated items.",
            "targets": [
                "ms.vss-build-web.completed-build-menu"
            ],
            "properties": {
                "title": "View associated items",
                "uri": "launch.html"
            }
        }
    ]
}