Referenční informace k manifestu rozšíření

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

Každá přípona má soubor manifestu JSON, který definuje základní informace o rozšíření. Soubor také definuje, jak může rozšířit a vylepšit prostředí. V tomto článku se dozvíte, jak vytvořit manifest pro rozšíření Azure DevOps.

Doporučení

Projděte si naši nejnovější dokumentaci k vývoji rozšíření s Azure DevOps Extension SDK.

Vytvořte soubor s názvem vss-extension.json v kořenové složce s příponou. Tento soubor obsahuje požadované atributy, jako je ID rozšíření a cíle instalace, kde se dá spustit. Také definuje příspěvky poskytnuté vaším rozšířením.

Podívejte se na následující příklad typického 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"
        }
    ]
}

Pro informace o vstupech viz ...

Povinné atributy

Jsou vyžadovány následující vlastnosti:

Vlastnost	Popis	Poznámky
manifestVersion	Číslo odpovídající verzi formátu manifestu.	Měla by mít hodnotu `1`.
ID	Identifikátor rozšíření.	Th ID je řetězec, který musí být jedinečný mezi rozšířeními od stejného vydavatele. Musí začínat abecedním nebo číselným znakem a obsahovat "A" až "Z", "a" až "z", "0" až "9" a "-" (spojovník). Příklad: `sample-extension`.
verze	Řetězec určující verzi rozšíření.	Měla by být ve formátu `major.minor.patch`, například `0.1.21.0.0`. Můžete také přidat čtvrté číslo pro následující formát: `0.1.2.3`
Jméno	Krátký, čitelný název rozšíření. Omezeno na 200 znaků.	Příklad: `"Fabrikam Agile Board Extension"`.
vydavatel	Identifikátor vydavatele.	Tento identifikátor musí odpovídat identifikátoru, pod který je rozšíření publikováno. Viz Vytvoření a správa vydavatele.
Kategorie	Pole řetězců představujících kategorie, do kterých vaše rozšíření patří. Musí být k dispozici alespoň jedna kategorie a neexistuje žádné omezení počtu kategorií, které můžete zahrnout.	Platné hodnoty: `Azure Repos`, `Azure Boards`, `Azure Pipelines`, `Azure Test Plans`a `Azure Artifacts`. Poznámky: – Pokud publikujete rozšíření prostřednictvím kódu programu, použijte verzi >=0.6.3 tfx-cli. – Pokud k publikování používáte rozšíření Azure DevOps Extension Tasks, ujistěte se, že jeho verze je >= 1.2.8. Aktualizaci rozšíření možná budete muset schválit kvůli nedávným změnám oboru. – Zmíněné kategorie jsou nativně přítomné ve Visual Studio Marketplace a Azure DevOps Server 2019 &.
cíle	Produkty a služby podporované vaší integrací nebo rozšířením. Další informace najdete v tématu Cíle instalace.	Pole objektů, kde každý objekt obsahuje `id` pole označující jednu z následujících možností: - `Microsoft.VisualStudio.Services` (rozšíření, která fungují s Azure DevOps), - `Microsoft.TeamFoundation.Server` (rozšíření, které funguje s Azure DevOps Serverem), - `Microsoft.VisualStudio.Services.Integration`, - `Microsoft.TeamFoundation.Server.Integration` (integrace, které pracují s Azure DevOps Serverem)

Příklady požadovaných atributů

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

Volitelné atributy

Atributy runtime

Vlastnost	Popis	Poznámky
rozsahy	Pole oborů autorizace (řetězců) uvádějící oprávnění vyžadovaná vaším rozšířením.	Například `vso.work` a `vs.code_write` označují, že vaše rozšíření potřebuje přístup pouze pro čtení k pracovním položkám a přístup pro čtení a zápis ke zdrojovému kódu a souvisejícím prostředkům. Rozsahy se uživateli zobrazí při instalaci vašeho rozšíření. Další informace najdete v úplném seznamu oborů.
požadavky	Pole požadavků (řetězců) se seznamem schopností požadovaných rozšířením	Označuje například, `api-version/3.0` že vaše rozšíření používá rozhraní API verze 3.0, a proto nejde spustit ve starších produktech, které tuto verzi nepodporují. Další informace najdete v úplném seznamu požadavků.
baseUri	(Volitelná) základní URL pro všechny relativní odkazy specifikované příspěvky rozšíření.	Například: `https://myapp.com/{{account.name}}/`. Tato vlastnost by měla zůstat prázdná, pokud je obsah součástí balíčku rozšíření.
příspěvky	Pole příspěvků do systému.
typy příspěvků	Pole typů příspěvků definovaných rozšířením

{
    "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"
            }
        }
    ]
}

Atributy zjišťování

Následující volitelné vlastnosti pomáhají uživatelům zjišťovat a učit se o vašem rozšíření:

Vlastnost	Popis	Poznámky
popis	Několik vět popisujících rozšíření. Omezeno na 200 znaků.	Popis by měl být stručná úderná prezentace vašeho rozšíření – několik řádků, které popisují vaše rozšíření na Marketplace a přiměly lidi si ho nainstalovat. Podívejte se na následující příklad.
ikony	Slovník ikon představujících rozšíření	Platné klávesy: `default` (128 × 128 pixelů) typu BMP, GIF, EXIF, JPG, PNG a TIFF). V budoucnu se můžou podporovat další klíče, například `large` (512 × 512 pixelů). Hodnota každého klíče je cesta k souboru ikony v příponě.
štítky	Pole řetězcových tagů, které uživatelům pomohou najít vaše rozšíření.	Příklady: `agile`, `project management`, `task timer`atd.
snímky obrazovky	Pole obrázků, které nebylo možné zahrnout do obsahu	Snímky obrazovky jsou cennější, když jsou ve vašem obsahu zvýrazněny a měly by se tam použít pro vytvoření kvalitní stránky s podrobnostmi o trhu pro vaše rozšíření. Snímky obrazovky můžete použít pro méně důležité obrázky, které nejsou uvedené ve vašem obsahu. Každý obrázek by měl být 1366 × 768 pixelů. Každá `path` položka obsahuje cestu k souboru v rozšíření.
obsah	Slovník souborů obsahu, které popisují vaše rozšíření uživatelům.	Každé rozšíření by mělo obsahovat plný obsah. Tímto způsobem zobrazíte uživatelům, co vaše rozšíření může dělat. Udělejte to bohaté, snadno srozumitelné a v případě potřeby zahrňte snímky obrazovky. Zahrňte `overview.md` soubor jako základní část obsahu. Každý soubor se předpokládá ve formátu GitHub Flavored Markdown . Každá `path` položka je cesta k souboru Markdownu v rozšíření. Platné klíče: `details`. V budoucnosti možná budou podporovány další klíče.
odkazy	Slovník odkazů, které uživatelům pomůžou získat další informace o vašem rozšíření, získat podporu a přesunout.	Platné klíče: `getstarted` – první kroky, postup nastavení nebo použití. `learn` – podrobnější obsah, který uživatelům pomůže lépe porozumět vašemu rozšíření nebo službě. `license` - licenční smlouva s koncovým uživatelem. `privacypolicy` - zásady ochrany osobních údajů pro rozšíření. `support` - získejte nápovědu a podporu pro rozšíření. Hodnota každého klíče je objekt s polem `uri` , což je absolutní adresa URL odkazu.
skladiště	Slovník vlastností popisujících úložiště zdrojového kódu pro rozšíření	Platné klíče: `type` – typ úložiště. Příklad: git. `uri` – Absolutní adresa URL úložiště.
odznaky	Pole odkazů na externí odznaky metadat, jako jsou TravisCI, Appveyor atd., ze schválených webů pro odznaky	Platné klíče: `href` – Odkaz, na který uživatel přejde při výběru odznaku. `uri` - Absolutní adresa URL obrázku odznáčku, který se má zobrazit. `description` - Popis odznáčky, který se zobrazí při najetí myší.
značkování	Slovník vlastností souvisejících se značkou	Platné klíče: `color` – primární barva rozšíření nebo vydavatele; může být v šestnáctkovém formátu (#ff00ff), RGB (rgb(100,200,50)) nebo jako podporovaný název barvy HTML (modrá). `theme` - doplňuje barvu; používejte tmavou barvu pro tmavé značky nebo světlo pro světlejší barvy značky.

Označte rozšíření jako veřejné

Ve výchozím nastavení jsou všechna rozšíření na Azure DevOps Marketplace soukromá. Jsou skryté z veřejného zobrazení a jsou viditelné pouze pro vydavatele a konkrétní účty sdílené vydavatelem. Pokud je váš vydavatel ověřený, můžete rozšíření zveřejnit nastavením příznaku Public v manifestu rozšíření:

{
    "galleryFlags": [
        "Public"
    ]
}

Nebo:

{
    "public": true
}

Další informace najdete v tématu Balíček, Publikování/ Instalace.

Označte rozšíření, aby bylo v náhledu

Pokud je vaše rozšíření připravené pro uživatele na Marketplace, ale stále pracujete na několika chybách nebo přidávání funkcí, můžete ho označit jako preview:

{
    "galleryFlags": [
        "Preview"
    ]
}

Označit rozšíření jako placený náhled

Pokud chcete své rozšíření prodávat na Marketplace, označte ho jako placenou verzi Preview. Rozšíření označené zdarma nejde změnit na placené.

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

Označte rozšíření jako placené

Pokud chcete na Marketplace prodat rozšíření, můžete ho označit příznakem Paid a značkou __BYOLENFORCED (začíná dvěma podtržítky):

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

Příznak Paid i __BYOLENFORCED značka musí být k dispozici, aby bylo možné rozšíření označit jako placené na Marketplace. Používání vlastní licence (BYOL) znamená, že vydavatel rozšíření poskytuje fakturační a licenční mechanismus rozšíření, protože ho microsoft neposkytuje pro rozšíření Azure DevOps. Všechna placená rozšíření se vyžadují k definování zásad ochrany osobních údajů, zásad podpory a licenční smlouvy s koncovým uživatelem. Vydavatelé musí na Marketplace zadat obsah na kartě Ceny následujícím způsobem:

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

Abyste přepsali placené licencování, musíte do manifestu rozšíření přidat také nový oddíl. V budoucnu odebereme kontrolu placené licence a už nebudeme vyžadovat přepisování. Prozatím se ujistěte, že se vaše rozšíření zobrazuje podle očekávání. Každé přepsání se skládá z "ID" a "chování." Ujistěte se, že "ID" odpovídá ID příspěvků definovaných v manifestu.

"licensing": {

      "overrides": [

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

Pokud vaše placené rozšíření BYOL nabízí zkušební období (doporučujeme proto), můžete určit délku zkušební verze ve dnech:

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

Poznámka:

Pokud chcete cílit na Azure DevOps, ale nechcete pro své rozšíření zobrazit možnost Stažení , přidejte __DoNotDownload značku (začíná dvěma podtržítky) do manifestu rozšíření. Pokud přesouváte rozšíření ze systému dříve nabízené fakturace a licencování & od Microsoftu do modelu BYOL (Bring Your Own License), kontaktujte nás pro vhodné kroky.

Příklad dalších vlastností

{
    "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"
        }
    ]
}

Příklad stránky Podrobností

1 – popis
2 – ikona
3 – kategorie
4. snímky obrazovky
5 – obsah (podrobnosti)
6 – odkazy
7 - značka

karta

Marketplace Q &A – Vlastnost CustomerQnASupport

Všechna rozšíření na Webu Visual Studio Marketplace mají oddíl Otázky a odpovědi (Q &A), který umožňuje individuální veřejné konverzace mezi uživateli rozšíření a vydavateli. Vydavatelé si můžou vybrat mezi Marketplace Q & A, hlášením na GitHubu nebo vlastní adresou URL Q & A. Q & A v Marketplace můžete zakázat pomocí vlastnosti CustomerQnASupport v manifestu.

Výchozí prostředí (nejsou vyžadovány žádné změny manifestu)

U rozšíření s úložištěm GitHubu marketplace přesměruje uživatele v části Q&A na přidružené problémy GitHubu.
U rozšíření bez úložiště GitHub je služba Marketplace Q&A povolená.

Pro jiné prostředí než jednu z výchozích možností použijte vlastnost CustomerQnASupport v manifestu.

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

Vlastnosti

Vlastnosti oddílu Zákaznické otázky a podpora:

enablemarketplaceqna – logické pole, nastavené na true marketplace nebo vlastní Q&A; false pro zakázání Q&A
url – řetězec, adresa URL pro přizpůsobené Q&A

Příklady použití podpory Q &A

Příklad: Rozšíření s využitím vlastní sekce otázek a odpovědí

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

Příklad: Rozšíření s úložištěm na GitHubu, ale použitím Q & A na Marketplace místo problémů na GitHubu.

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

Příklad: Zakázání oddílu Q &A rozšířením

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

Působnosti

V rozšíření můžete definovat jeden nebo více oborů. Tyto obory určují, ke kterým prostředkům má vaše rozšíření přístup, a operace, které s těmito prostředky smí provádět. Obory, které zadáte v manifestu rozšíření, jsou obory nastavené pro přístupové tokeny vydané pro vaše rozšíření. Další informace najdete v tématu Ověřování a zabezpečení.

Pokud nejsou určeny žádné obory, je poskytován pouze přístup k profilům uživatelů a datům rozšíření.

Podporované obory

Kategorie	Scope	Název	Vysoká oprávnění	Popis	Dědí z
Pokročilé zabezpečení	`vso.advsec`	Pokročilé zabezpečení (čtení)	Ano	Uděluje možnost číst výstrahy, instance výsledků a instance výsledků analýzy.
	`vso.advsec_write`	Pokročilé zabezpečení (čtení a zápis)	Ano	Uděluje možnost nahrávat analýzy v bezpatku.	`vso.advsec`
	`vso.advsec_manage`	Pokročilé zabezpečení (čtení, zápis a správa)	Ano	Uděluje možnost nahrávat analýzy v bezpatku.	`vso.advsec_write`
Fondy agentů	`vso.agentpools`	Fondy agentů (čtení)		Umožňuje zobrazit úkoly, fondy, fronty, agenty a aktuálně spuštěné nebo nedávno dokončené úlohy pro agenty.
	`vso.agentpools_manage`	Fondy agentů (čtení a správa)	Ano	Poskytuje schopnost spravovat fondy, fronty a agenty.	`vso.agentpools`
	`vso.environment_manage`	Prostředí (čtení a správa)	Ano	Uděluje možnost spravovat fondy, fronty, agenty a prostředí.	`vso.agentpools_manage`
Analytika	`vso.analytics`	Analytika (číst)		Uděluje možnost dotazovat se na analytická data.
Auditing	`vso.auditlog`	Protokol auditu (čtení)		Uděluje možnost číst protokol auditování uživatelům.
	`vso.auditstreams_manage`	Auditování datových proudů (čtení)	Ano	Uděluje možnost spravovat streamy auditování uživatelům.	`vso.auditlog`
Build	`vso.build`	Sestavení (čtení)		Uděluje možnost přístupu k artefaktům sestavení, včetně výsledků sestavení, definic a požadavků, a také možnost přijímat oznámení o událostech sestavení prostřednictvím služebních hooků.	`vso.hooks_write`
	`vso.build_execute`	Sestavení (čtení a spuštění)	Ano	Uděluje možnost přístupu k artefaktům sestavení, včetně výsledků sestavení, definic a požadavků. Umožňuje také zařadit sestavení do fronty, aktualizovat vlastnosti sestavení a přijímat oznámení o událostech sestavení prostřednictvím volání služby.	`vso.build`
Code	`vso.code`	Kód (přečteno)		Uděluje možnost číst zdrojový kód a metadata o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Umožňuje také prohledávat kód a dostávat oznámení o událostech správy verzí prostřednictvím háků služby.	`vso.hooks_write`
	`vso.code_write`	Kód (čtení a zápis)	Ano	Uděluje možnost číst, aktualizovat a odstraňovat zdrojový kód a přistupovat k metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Umožňuje také vytvářet a spravovat žádosti o přijetí změn a kontroly kódu a přijímat oznámení o událostech správy verzí prostřednictvím volání služeb.	`vso.code`
	`vso.code_manage`	Kód (čtení, zápis a správa)	Ano	Uděluje možnost číst, aktualizovat a odstraňovat zdrojový kód, přistupovat k metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Poskytuje také možnost vytvářet a spravovat úložiště kódu, vytvářet a spravovat žádosti o přijetí změn a kontroly kódu a přijímat oznámení o událostech správy verzí prostřednictvím volání služeb.	`vso.code_write`
	`vso.code_full`	Kód (plný)	Ano	Uděluje úplný přístup ke zdrojovému kódu, metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Uděluje také možnost vytvářet a spravovat úložiště kódu, vytvářet a spravovat žádosti o přijetí změn a kontroly kódu a přijímat oznámení o událostech správy verzí prostřednictvím volání služeb. Zahrnuje také omezenou podporu rozhraní API klientského objektového modelu (OM).	`vso.code_manage`
	`vso.code_status`	Kód (stav)		Uděluje možnost čtení a zápisu potvrzení a žádosti o přijetí změn.
Připojený server	`vso.connected_server`	Připojený server		Uděluje možnost přistupovat ke koncovým bodům potřebným z místního připojeného serveru.
Nároky	`vso.entitlements`	Nároky (čtení)		Uděluje přístup jen pro čtení ke koncovým bodům licenčního nároku, aby získal nároky na účty.
	`vso.memberentitlementmanagement`	Správa nároků členů (čtení)		Umožňuje číst uživatele, jejich licence a projekty a rozšíření, ke kterým mají přístup.
	`vso.memberentitlementmanagement_write`	Správa nároků členů (zápis)	Ano	Uděluje možnost spravovat uživatele a jejich licence a projekty a rozšíření, ke kterým mají přístup.	`vso.memberentitlementmanagement`
Extensions	`vso.extension`	Rozšíření (ke čtení)		Uděluje možnost číst nainstalovaná rozšíření.	`vso.profile`
	`vso.extension_manage`	Rozšíření (čtení a spravování)	Ano	Uděluje možnost instalovat, odinstalovat a provádět další akce správy u nainstalovaných rozšíření.	`vso.extension`
	`vso.extension.data`	Data rozšíření (čtení)		Uděluje možnost číst data (nastavení a dokumenty) uložená nainstalovanými rozšířeními.	`vso.profile`
	`vso.extension.data_write`	Čtení a zápis rozšiřovacích dat		Uděluje možnost číst a zapisovat data (nastavení a dokumenty) uložená nainstalovanými rozšířeními.	`vso.extension.data`
Připojení GitHubu	`vso.githubconnections`	Připojení GitHubu (čtení)		Uděluje možnost číst připojení GitHubu a data úložišť GitHub.
	`vso.githubconnections_manage`	Připojení GitHubu (čtení a správa)	Ano	Uděluje možnost číst a spravovat připojení GitHubu a data úložišť GitHub.	`vso.githubconnections`
Graf a identita	`vso.graph`	Graf (čtení)		Uděluje možnost číst informace o uživatelích, skupinách, jejich členech a rozsahu.
	`vso.graph_manage`	Graf (řízení)	Ano	Uděluje možnost číst informace o členství uživatelů, skupin, oborů a skupin, přidávat uživatele a skupiny a spravovat členství ve skupinách.	`vso.graph`
	`vso.identity`	Identita (čtení)		Uděluje schopnost číst identity a skupiny.
	`vso.identity_manage`	Identita (řízení)	Ano	Uděluje možnost čtení, zápisu a správy identit a skupin.	`vso.identity`
Skupina počítačů	`vso.machinegroup_manage`	Skupina nasazení (čtení, správa)	Ano	Uděluje možnost spravovat skupiny nasazení a fondy agentů.	`vso.agentpools_manage`
Marketplace	`vso.gallery`	Marketplace		Uděluje přístup ke čtení veřejných a soukromých položek a přístup k vydavatelům.	`vso.profile`
	`vso.gallery_acquire`	Marketplace (nákup)		Uděluje přístup pro čtení a umožňuje získání položek.	`vso.gallery`
	`vso.gallery_publish`	Tržiště (publikování)	Ano	Uděluje přístup pro čtení a možnost nahrávat, aktualizovat a sdílet položky.	`vso.gallery`
	`vso.gallery_manage`	Marketplace (správa)	Ano	Uděluje přístup pro čtení a umožňuje publikovat a spravovat položky a vydavatele.	`vso.gallery_publish`
Notifications	`vso.notification`	Oznámení (přečtená)		Uděluje přístup pro čtení k odběrům a metadatům událostí, včetně filtrovatelných hodnot polí.	`vso.profile`
	`vso.notification_write`	Oznámení (psaní)		Uděluje přístup pro čtení a zápis k odběrům a přístup pro čtení k metadatům událostí, včetně filtrovatelných hodnot polí.	`vso.notification`
	`vso.notification_manage`	Oznámení (spravovat)		Uděluje přístup ke čtení, zápisu a správě předplatných a oprávnění ke čtení metadat událostí, včetně filtrovatelných hodnot polí.	`vso.notification_write`
	`vso.notification_diagnostics`	Oznámení (diagnostika)		Uděluje přístup k diagnostickým protokolům souvisejícím s oznámeními a uděluje možnost povolit diagnostiku pro jednotlivá předplatná.	`vso.notification`
Balení	`vso.packaging`	Balení (čtěte)		Uděluje oprávnění číst informační kanály a balíčky.	`vso.profile`
	`vso.packaging_write`	Balení (čtení a zápis)	Ano	Poskytuje schopnost vytvářet a číst informační kanály a balíčky.	`vso.packaging`
	`vso.packaging_manage`	Balení (čtení, zápis a správa)	Ano	Uděluje možnost vytvářet, číst, aktualizovat a odstraňovat informační kanály a balíčky.	`vso.packaging_write`
Zdroje potrubí	`vso.pipelineresources_use`	Prostředky kanálu (použití)	Ano	Udělí možnost schválit žádost pipeline o použití chráněného prostředku: fond agentů, prostředí, fronta, repozitář, zabezpečené soubory, připojení služby a skupina proměnných.
	`vso.pipelineresources_manage`	Prostředky kanálu (použití a správa)	Ano	Uděluje možnost spravovat chráněný prostředek nebo žádost kanálu o použití chráněného prostředku: fond agentů, prostředí, fronta, úložiště, zabezpečené soubory, připojení služby a skupina proměnných.	`vso.pipelineresources_use`
Projekt a tým	`vso.project`	Projekt a tým (ke čtení)		Uděluje možnost prohlížet projekty a týmy.
	`vso.project_write`	Projekt a tým (čtení a zápis)		Uděluje možnost číst a aktualizovat projekty a týmy.	`vso.project`
	`vso.project_manage`	Projekt a tým (čtení, zápis a správa)	Ano	Uděluje možnost vytvářet, číst, aktualizovat a odstraňovat projekty a týmy.	`vso.project_write`
Vydání	`vso.release`	Vydání (číst)		Uděluje možnost číst artefakty vydané verze, včetně vydaných verzí, definic vydaných verzí a prostředí vydaných verzí.	`vso.profile`
	`vso.release_execute`	Vydání (čtení, zápis a spuštění)	Ano	Uděluje možnost číst a aktualizovat artefakty vydané verze, včetně vydaných verzí, definic vydaných verzí a prostředí verze. Také uděluje možnost zařadit novou verzi do fronty.	`vso.release`
	`vso.release_manage`	Verze (čtení, zápis, spouštění a správa)	Ano	Uděluje možnost číst, aktualizovat a odstraňovat artefakty vydané verze, včetně vydaných verzí, definic verzí a prostředí vydaných verzí. Umožňuje také zařadit frontu a schválit novou verzi.	`vso.release_execute`
Zabezpečené soubory	`vso.securefiles_read`	Zabezpečené soubory (čtení)	Ano	Uděluje možnost číst zabezpečené soubory.
	`vso.securefiles_write`	Zabezpečené soubory (čtení a vytváření)	Ano	Uděluje možnost číst a vytvářet zabezpečené soubory.	`vso.securefiles_read`
	`vso.securefiles_manage`	Zabezpečené soubory (čtení, vytváření a správa)	Ano	Uděluje možnost číst, vytvářet a spravovat zabezpečené soubory.	`vso.securefiles_write`
Zabezpečení	`vso.security_manage`	Zabezpečení (správa)	Ano	Uděluje možnost číst, zapisovat a spravovat oprávnění zabezpečení.
Připojení služeb	`vso.serviceendpoint`	Koncové body služby (čtení)		Uděluje oprávnění ke čtení koncových bodů služby.	`vso.profile`
	`vso.serviceendpoint_query`	Koncové body služby (čtení a dotazování)		Uděluje možnost čtení a dotazování koncových bodů služby.	`vso.serviceendpoint`
	`vso.serviceendpoint_manage`	Koncové body služby (čtení, dotazování a správa)	Ano	Uděluje možnost číst, dotazovat a spravovat koncové body služby.	`vso.serviceendpoint_query`
Servisní háky	`vso.hooks`	Rozhraní služeb (čtení)		Uděluje oprávnění ke čtení odběrů služeb a metadata, včetně podporovaných událostí, uživatelů a akcí. (Už není veřejné.)	`vso.profile`
	`vso.hooks_write`	Servisní háčky (čtení a zápis)		Uděluje možnost vytvářet a aktualizovat odběry háčků služby a číst metadata, včetně podporovaných událostí, konzumentů a akcí. (Už není veřejné.)	`vso.hooks`
	`vso.hooks_interact`	Služební háčky (interakce)		Uděluje možnost interakce a provádění akcí na událostech přijatých prostřednictvím service hooks. (Už není veřejné.)	`vso.profile`
Nastavení	`vso.settings`	Nastavení (čtení)		Uděluje možnost čtení nastavení.
	`vso.settings_write`	Nastavení (čtení a zápis)		Uděluje možnost čtení a zápisu nastavení.	`vso.settings`
Symbols	`vso.symbols`	Symboly (přečteno)		Uděluje možnost číst symboly.	`vso.profile`
	`vso.symbols_write`	Symboly (čtení a zápis)		Uděluje možnost číst a zapisovat symboly.	`vso.symbols`
	`vso.symbols_manage`	Symboly (čtení, zápis a správa)		Uděluje možnost číst, zapisovat a spravovat symboly.	`vso.symbols_write`
Skupiny úloh	`vso.taskgroups_read`	Skupiny úloh (čtení)		Uděluje přístup ke čtení skupin úkolů.
	`vso.taskgroups_write`	Skupiny úloh (čtení a vytváření)		Uděluje možnost číst a vytvářet skupiny úloh.	`vso.taskgroups_read`
	`vso.taskgroups_manage`	Skupiny úloh (čtení, vytváření a správa)	Ano	Uděluje možnost číst, vytvářet a spravovat skupiny úloh.	`vso.taskgroups_write`
Týmový řídicí panel	`vso.dashboards`	Týmové řídicí panely (číst)		Uděluje možnost číst informace o týmovém řídicím panelu.
	`vso.dashboards_manage`	Týmové řídicí panely (správa)		Uděluje možnost spravovat informace o týmovém řídicím panelu.	`vso.dashboards`
Správa testů	`vso.test`	Správa testů (pouze pro čtení)		Uděluje možnost číst testovací plány, případy, výsledky a další artefakty související se správou testů.	`vso.profile`
	`vso.test_write`	Správa testů (čtení a zápis)		Uděluje možnost číst, vytvářet a aktualizovat testovací plány, případy, výsledky a další artefakty související se správou testů.	`vso.test`
Threads	`vso.threads_full`	Vlákna PR		Poskytuje schopnost číst a zapisovat do vláken komentářů u žádostí o přijetí změn.
Tokény	`vso.tokens`	Delegovaná autorizační tokeny	Ano	Poskytuje uživatelům schopnost spravovat delegované autorizační tokeny.
	`vso.tokenadministration`	Správa tokenů	Ano	Uděluje možnost spravovat (zobrazit a odvolat) stávající tokeny správcům organizace.
Profil uživatele	`vso.profile`	Profil uživatele (přečteno)		Uděluje možnost číst váš profil, účty, kolekce, projekty, týmy a další artefakty organizace nejvyšší úrovně.
	`vso.profile_write`	Profil uživatele (zápis)		Uděluje možnost psát do vašeho profilu.	`vso.profile`
Skupiny proměnných	`vso.variablegroups_read`	Skupiny proměnných (čtení)		Uděluje oprávnění číst skupiny proměnných.
	`vso.variablegroups_write`	Skupiny proměnných (čtení a vytváření)		Uděluje možnost číst a vytvářet skupiny proměnných.	`vso.variablegroups_read`
	`vso.variablegroups_manage`	Skupiny proměnných (čtení, vytváření a správa)	Ano	Uděluje možnost číst, vytvářet a spravovat skupiny proměnných.	`vso.variablegroups_write`
Wiki	`vso.wiki`	Wiki (přečteno)		Uděluje možnost číst wikiweby, stránky wikiwebu a přílohy wikiwebu. Umožňuje také prohledávat stránky wikiwebu.
	`vso.wiki_write`	Wiki (čtení a zápis)		Uděluje možnost číst, vytvářet a aktualizovat wikiweby, stránky wikiwebu a přílohy wikiwebu.	`vso.wiki`
Pracovní položky	`vso.work`	Pracovní úkoly (pro čtení)		Uděluje možnost číst pracovní položky, dotazy, panely, cesty oblastí a iterací a další metadata související se sledováním pracovních položek. Umožňuje také spouštět dotazy, prohledávat pracovní položky a přijímat oznámení o událostech pracovních položek prostřednictvím volání služby.	`vso.hooks_write`
	`vso.work_write`	Pracovní položky (čtení a zápis)		Umožňuje číst, vytvářet a aktualizovat pracovní položky a dotazy, metadata aktualizačních panelů, cesty ke čtení a iterace a další metadata související se sledováním pracovních položek, spouštět dotazy a přijímat oznámení o událostech pracovních položek prostřednictvím volání služeb.	`vso.work`
	`vso.work_full`	Pracovní položky (úplné)		Uděluje úplný přístup k pracovním položkám, dotazům, backlogům, plánům a metadatům sledování pracovních položek. Umožňuje také přijímat oznámení o událostech pracovních položek prostřednictvím zahoknutých služeb.	`vso.work_write`
Zosobnění uživatele	`user_impersonation`	Zosobnění uživatele	Ano	Uděluje úplný přístup k rozhraním REST API služby Visual Studio Team Services. Požádejte nebo odsouhlaste tento rozsah s opatrností, protože je velmi výkonný.

Změna rozsahu publikovaného rozšíření

Rozsah publikovaného rozšíření můžete změnit. Pokud jste dříve nainstalovali rozšíření (a autorizovali předchozí sadu oborů), před upgradem na nejnovější verzi povolte nové obory.

Sekce Požadovaná akce v centru nastavení rozšíření ukazuje uživateli, které nainstalované rozšíření, pokud existují, vyžadují autorizaci:

změna oboru

Správce pak může zkontrolovat a autorizovat novou sadu oborů:

dialogové okno pro změnu rozsahu

Cíle instalace

Jak název napovídá, cíle instalace definují produkty a služby, kde můžete nainstalovat rozšíření. Microsoft.VisualStudio.Services je nejběžnější cíl instalace a označuje, že rozšíření je možné nainstalovat do Azure DevOps.

Cíle instalace pro rozšíření nebo integraci se zadají prostřednictvím targets pole v manifestu.

Podporované identifikátory pro rozšíření:

Microsoft.VisualStudio.Services.Cloud: Nainstaluje se do Azure DevOps Services
Microsoft.TeamFoundation.Server: Nainstaluje se na Azure DevOps Server.
Microsoft.VisualStudio.Services: instaluje se do obou. Zkratka pro Microsoft.VisualStudio.Services.Cloud a Microsoft.TeamFoundation.Server verze [14.2,)

Podporované identifikátory pro integrace:

Microsoft.VisualStudio.Services.Cloud.Integration: se integruje se službami Azure DevOps Services
Microsoft.TeamFoundation.Server.Integration: se integruje s Azure DevOps Serverem
Microsoft.VisualStudio.Services.Integration: integruje se s oběma. Zkratka pro Microsoft.VisualStudio.Services.Cloud.Integration a Microsoft.TeamFoundation.Server.Integration

Další informace naleznete v tématu Rozšiřitelnost bodů.

Příklady cílů instalace

Příklad: Rozšíření, které funguje s Azure DevOps

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

Příklad: Rozšíření, které funguje jenom s Azure DevOps Services

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

Cíle instalace lze použít také v manifestu integrací. Například produkty, aplikace nebo nástroje, které fungují s Azure DevOps, ale nenainstalují se do něj.

Příklad: Integrace, která funguje s Azure DevOps

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

Příklad: Integrace, která funguje jenom s Azure DevOps Serverem

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

Cílové verze instalace

Některé identifikátory cíle instalace, například Microsoft.TeamFoundation.Server a Microsoft.TeamFoundation.Server.Integration, podporují volitelný rozsah verzí. Tento volitelný rozsah verzí dále objasňuje podporované verze, které rozšíření nebo integrace podporuje.

Verze nebo rozsah verzí se zadává prostřednictvím version pole cílového objektu instalace. Tato hodnota může být následující:

Konkrétní verze, například: 15.0 (pouze 2017 RTM)
Rozsah podporovaných verzí, například: [14.0) (2015 RTM a novější), [14.3,15.1] (2015 Update 3 až 2017 Update 1). Hodnoty rozsahu se upřesní pomocí:
- [: včetně minimální verze
- ]: maximální verze včetně
- (: minimální verze exkluzivně
- ): maximální verze vyjímaje

Čísla verzí pro Azure DevOps Server:

Vydání	Vydání	Verze
2010	Všechna vydání	10.0
2012	Všechna vydání	11.0
2013	RTM a aktualizace	12.0, 12.1, 12.2, 12.3, 12.4
2015	RTM a aktualizace	14.0, 14.1, 14.2, 14.3
2017	RTM a aktualizace	15.0, 15.1
2018	RTM a aktualizace	16.0
2019	RTM a aktualizace	17.0
2020	RTM a aktualizace	18,0

Příklady zobrazující verze

Příklad: Rozšíření, které funguje s Azure DevOps

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

Zkratky

Microsoft.VisualStudio.Services je zkratka pro Azure DevOps.

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

odpovídá:

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

Použití instalačních cílů a požadavků

Cíle a požadavky instalace se používají společně k prezentaci uživatelů se správným pohledem na produkty a služby, se kterými je vaše rozšíření nebo integrace kompatibilní. Například zadání cíle Microsoft.VisualStudio.Services instalace s poptávkou api-version/3.0 znamená, že rozšíření funguje s Azure DevOps.

Doporučení

Další informace o rozhraních REST API najdete v referenčních informacích k rozhraní REST API.

Příklad: Rozšíření, které používá rozhraní API verze 3.0

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

Určuje následující cíle instalace:

Microsoft.VisualStudio.Services.Cloud
Microsoft.TeamFoundation.Server verze: [15.0,)

Příklad: Integrace, která používá rozhraní API verze 2.0

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

Určuje následující cíle instalace:

Microsoft.VisualStudio.Services.Cloud.Integration
Microsoft.TeamFoundation.Server.Integration verze: [14.0,)

Požadavky

Požadavky umožňují určit možnosti a další funkce vyžadované rozšířením. Tyto požadavky můžete použít k omezení toho, kde je možné rozšíření publikovat nebo nainstalovat.

Požadavky, které Visual Studio Marketplace používá k výpisu produktů a prostředí, se kterými je vaše rozšíření kompatibilní, což zákazníkům pomáhá pochopit, jestli vaše rozšíření funguje s jejich verzí Azure DevOps, například.

Podívejte se na následující příklad toho, jak se požadavky zadává v manifestu rozšíření.

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

V tomto příkladu vyžaduje rozšíření verzi 3.0 rozhraní API, což znamená, že je možné ho nainstalovat jenom do Azure DevOps. Aby bylo možné nainstalovat vaše rozšíření, je také potřeba, aby bylo rozšíření ms.vss-dashboards-web (a jeho widget-catalog příspěvek) nejprve nainstalováno a povoleno v kolekci.

Podporované požadavky

Typ	Popis	Zkontrolováno při publikování?	Zkontrolovali jsme instalaci?
`environment/cloud`	Vyžaduje spuštění v cloudovém prostředí.	Ano	Ano
`environment/onprem`	Vyžaduje spuštění v místním prostředí.	Ano	Ano
`api-version/{version}`	Vyžaduje konkrétní verzi rozhraní API (minimálně).	Ne	Ano
`extension/{id}`	Vyžaduje instalaci nebo povolení konkrétního rozšíření.	Ne	Ano
`contribution/{id}`	Vyžaduje, aby byl k dispozici konkrétní příspěvek.	Ne	Ano
`contributionType/{id}`	Vyžaduje, aby byl k dispozici konkrétní typ příspěvku.	Ne	Ano

Poznámka:

Používejte environment/cloud a environment/onprem pouze v případech, kdy má vaše rozšíření požadavky související s topologií, které vyžadují spuštění v daném prostředí.
extension, contributiona požadavky na contributionType se v době instalace vyhodnocují a vyžadují, aby zadané rozšíření bylo již nainstalované a povolené v organizaci nebo kolekci.

Files

Oddíl files je místo, kde odkazujete na všechny soubory, které chcete zahrnout do svého rozšíření. Můžete přidat složky i jednotlivé soubory:

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

Vlastnosti

Vlastnosti oddílu Soubory:

path - Cesta ke zdroji na disku, která může být relativní vzhledem ke kořenovému adresáři.
addressable – (volitelné) Nastavte hodnotu true , pokud chcete, aby váš soubor byl adresovatelný. Výchozí hodnota je false.
packagePath – (volitelná) cesta k prostředku v rámci balíčku. Výchozí nastavení je relativní cesta na disku z kořenového adresáře.
contentType – (volitelný) typ MIME souboru. Standardně je nastaveno jako nejlepší odhad podle přípony souboru a nastavení operačního systému.
assetType – (volitelné) Zadejte hodnotu atributu Type položky assetu v manifestu VSIX. Může to být také pole řetězců, v takovém případě se pro tento soubor přidá více položek assetů. Výchozí hodnota je nastavena na packagePath.
lang – (volitelné) Jazyk tohoto prostředku. Lokalizované soubory se obsluhují na základě hlavičky Accept-Language. Pokud ponecháte toto pole prázdné, znamená to, že soubor je ve výchozím (nebo náhradním) jazyce. Lokalizované verze stejného souboru by měly mít stejný assetType.

Příspěvky

Každá položka příspěvku má následující vlastnosti:

ID – REFERENČNÍ ID (řetězec) pro příspěvek. Každé ID příspěvku můžete nastavit jako jedinečné v rámci rozšíření. Podívejte se na odkazy na příspěvky a jejich typy.
type - ID příspěvkuType tohoto příspěvku.
description – (Volitelné) Řetězec popisující, co příspěvek poskytuje.
targets – pole ID příspěvků, na které je příspěvek zacílený (přispívá k nim). Podívejte se na Cílení příspěvků.
properties - (Volitelné) Objekt, který obsahuje vlastnosti příspěvku definovaného v typu příspěvku.

Další informace najdete v přehledu modelu přispívání.

Typy příspěvků

Každá položka příspěvku má následující vlastnosti:

id – REFERENČNÍ ID (řetězec) pro typ příspěvku. Každé ID typu příspěvku můžete nastavit jako jedinečné v rámci rozšíření. Podívejte se na odkazy na příspěvky a jejich typy.
name – popisný název typu příspěvku.
description – (Volitelné) Řetězec popisující podrobněji, k čemu typ příspěvku slouží.
properties – (Volitelné) Slovník, který mapuje názvy vlastností na popisy vlastností. Tyto vlastnosti popisují požadované a volitelné vlastnosti, které mohou použít příspěvky tohoto typu.

Popisy vlastností mají následující vlastnosti:

description – (Volitelné) Řetězec popisující, k čemu se vlastnost používá.
required - (Volitelné) Logická hodnota, která pokud je pravda, znamená to, že vlastnost je vyžadována pro všechny příspěvky tohoto typu.
type – typ hodnoty, kterou může mít vlastnost, což může být řetězec, identifikátor URI, guid, logická hodnota, celé číslo, double, dateTime, pole nebo objekt.

Další informace najdete v přehledu modelu přispívání.

Odkazování na příspěvky a typy

Pomocí jedinečných identifikátorů můžete odkazovat na příspěvky a typy příspěvků. Odkazovat typy s type vlastností a odkazovat na další příspěvky s targets vlastností.

Úplný odkaz na příspěvek obsahuje identifikátor vydavatele, identifikátor rozšíření a identifikátor příspěvku/typu oddělený tečkou (.). Například ms.vss-web.hub je úplný identifikátor příspěvku s identifikátorem hub v rozšíření vss-web publikovaném vydavatelem „ms“ (Microsoft).
Relativní odkazy na příspěvky mohou být použity v manifestu rozšíření pro odkazování na jiný příspěvek nebo typ příspěvku v rámci stejného rozšíření. V tomto případě nejsou zahrnuty identifikátory vydavatele a rozšíření a identifikátor je tečka (.) následovaný identifikátorem příspěvku. Například .hub lze použít v rozšíření vss-web zmíněném dříve jako zástupce pro ms.vss-web.hub.

Cílení příspěvků

Některé příspěvky fungují jako kontejnery, na které cílí jiné příspěvky.

Příspěvky centra můžou cílit na skupiny center. Když je stránka vykreslena, webové rozhraní zobrazí všechny příspěvky, které cílí na vybranou skupinu hubů. Skupiny hubů cílí na kolekci hub skupin, která definuje sadu skupin hubů, které se zobrazují v dané navigační oblasti, například na stránkách pro správu projektu.
Různé typy příspěvků můžou cílit na nabídky: akce, akce hypertextového odkazu a poskytovatel akcí. Akce a akce hypertextového odkazu poskytují jednotlivé položky nabídky. Zprostředkovatel akcí může poskytovat více dynamických položek nabídky. U dané nabídky se položky agregují napříč všemi příspěvky (z jakéhokoli z těchto typů), které cílí na daný příspěvek nabídky.

Přidání ikony centra

Informace o přidání ikony do vašeho hubu najdete v pokynech k ikonám hubu.

Podporované služby odznáček

Marketplace podporuje pouze odznáčky z následujících důvěryhodných služeb:

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/

Poznámka:

Nahraďte vsmarketplacebadge.apphb.com s vsmarketplacebadges.dev.

Pokud chcete zobrazit odznáček z jiné služby, obraťte se na zákaznickou podporu v komunitě vývojářů.

Příklad manifestu

Následující rozšíření přidává akci do kontextové nabídky dokončených sestavení a nástroj do skupiny nástrojů Sestavení.

{
    "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"
            }
        }
    ]
}

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-12-17

Sdílet prostřednictvím

Referenční informace k manifestu rozšíření

Povinné atributy

Příklady požadovaných atributů

Volitelné atributy

Atributy runtime

Atributy zjišťování

Označte rozšíření jako veřejné

Označte rozšíření, aby bylo v náhledu

Označit rozšíření jako placený náhled

Označte rozšíření jako placené

Příklad dalších vlastností

Příklad stránky Podrobností

Marketplace Q &A – Vlastnost CustomerQnASupport

Vlastnosti

Příklady použití podpory Q &A

Příklad: Rozšíření s využitím vlastní sekce otázek a odpovědí

Příklad: Rozšíření s úložištěm na GitHubu, ale použitím Q & A na Marketplace místo problémů na GitHubu.

Příklad: Zakázání oddílu Q &A rozšířením

Působnosti

Podporované obory

Změna rozsahu publikovaného rozšíření

Cíle instalace

Příklady cílů instalace

Příklad: Rozšíření, které funguje s Azure DevOps

Příklad: Rozšíření, které funguje jenom s Azure DevOps Services

Příklad: Integrace, která funguje s Azure DevOps

Příklad: Integrace, která funguje jenom s Azure DevOps Serverem

Cílové verze instalace

Příklady zobrazující verze

Příklad: Rozšíření, které funguje s Azure DevOps

Zkratky

Použití instalačních cílů a požadavků

Příklad: Rozšíření, které používá rozhraní API verze 3.0

Příklad: Integrace, která používá rozhraní API verze 2.0

Požadavky

Podporované požadavky

Files

Vlastnosti

Příspěvky

Typy příspěvků

Odkazování na příspěvky a typy

Cílení příspěvků

Přidání ikony centra

Podporované služby odznáček

Příklad manifestu

Váš názor

Další materiály