Megosztás a következőn keresztül:

Központ hozzáadása

  • Cikk

Azure DevOps Services

Ebben a cikkben létrehozunk egy új központot, amely az Azure Boardsban jelenik meg a Sprints and Queries hubok után.

Screen shot showing location of new hub in Azure Boards.

A bővítmény felépítése

|--- README.md
|--- sdk    
	|--- node_modules           
	|--- scripts
		|--- SDK.js       
|--- images                        
	|--- icon.png                           
|--- scripts                        	// not used in this tutorial
|--- hello-world.html				// html page to be used for your hub  
|--- vss-extension.json				// extension's manifest

Az ügyfél SDK lekérése: SDK.js

Az alapvető SDK-szkript, az SDK.js lehetővé teszi, hogy a webkiterjesztések kommunikáljanak a gazdagéppel, az Azure DevOps Services-keretrendszerrel. Ez a szkript inicializálja is a bővítményt, értesíti a betöltött bővítményt, vagy kontextust kap az aktuális lapról. Szerezze be az Ügyfél SDK-fájlt SDK.js , és adja hozzá a webalkalmazáshoz. Helyezze a home/sdk/scripts mappába.

Az SDK lekéréséhez használja az "npm install" parancsot a parancssoron keresztül (csomópont szükséges):

npm install azure-devops-extension-sdk

Megjegyzés:

További információ: Azure DevOps Web Extension SDK.

A központi lap: hello-world.html

Hozzon létre egy hello-world.html fájlt a home bővítmény könyvtárában. Hivatkozzon az SDK-ra, és hívja meg az init() és a notifyLoadSucceeded() parancsot.

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
	<title>Hello World</title>
	<script src="sdk/scripts/SDK.js"></script>
</head>
<body>
	<script type="text/javascript">SDK.init();</script>
	<h1>Hello World</h1>
	<script type="text/javascript">SDK.notifyLoadSucceeded();</script>
</body>
</html>

A bővítmény jegyzékfájlja: vss-extension.json

  • Minden bővítménynek rendelkeznie kell egy kiterjesztésjegyzékfájllal
  • A bővítményjegyzék referenciájának elolvasása
  • További információ a bővíthetőségi pontokban található hozzájárulási pontokról

Hozzon létre egy json-fájlt (vss-extension.jsonpéldául) a home könyvtárban a következő tartalommal:

	{
		"manifestVersion": 1,
		"id": "sample-extension",
		"version": "0.1.0",
		"name": "My first sample extension",
		"description": "A sample Visual Studio Services extension.",
		"publisher": "fabrikamdev",
		"categories": ["Azure Boards"],
		"targets": [
			{
				"id": "Microsoft.VisualStudio.Services"
				}
			],
		"icons": {
			"default": "images/logo.png"
		 },
		"contributions": [
			{
				"id": "Fabrikam.HelloWorld",
				"type": "ms.vss-web.hub",
				"description": "Adds a 'Hello' hub to the Work hub group.",
				"targets": [
					"ms.vss-work-web.work-hub-group"
					],
				"properties": {
					"name": "Hello",
					"order": 99,
					"uri": "hello-world.html"
				}
			}
		],
		"scopes": [
			"vso.work"
		],
		"files": [
			{
				"path": "hello-world.html", "addressable": true
			},
			{
				"path": "sdk/scripts", "addressable": true
			},
			{
				"path": "images/logo.png", "addressable": true
			}
		]
	}

Megjegyzés:

Módosítsa a közzétevőt a közzétevő nevére. Közzétevő létrehozásához tekintse meg a Csomag, közzététel és telepítés című témakört.

Ikonok

Az ikonok stanza a bővítmény ikonjának elérési útját határozzák meg a jegyzékben.

Adjon hozzá egy négyzet alakú képet a logo.pngbővítményjegyzékben látható módon.

Hozzájárulások

A stanza által nyújtott hozzájárulások hozzáadják a közreműködését - a Hello Hubot - a bővítményjegyzékhez.

A bővítmény minden egyes közreműködéséhez a jegyzék a következőket határozza meg:

  • hozzájárulás típusa, központ
  • hozzájárulási cél, a munkaközpont-csoport (tekintse meg az összes megcélzott központcsoportot,
  • az egyes hozzájárulástípusokra jellemző tulajdonságok. A központ a következő tulajdonságokkal rendelkezik.
Tulajdonság Leírás
név A központ neve.
Rendelés A központ elhelyezése a hubcsoportban.
Uri Az oldal elérési útja (a bővítmény alap URI-éhez viszonyítva) a központként való felszínre hozása.

Hatókörök

Adja meg a bővítmény által igényelt hatóköröket .

Ebben az esetben hozzá kell vso.work férnünk a munkaelemekhez.

Fájlok

A fájlok stanza azt jelzik, hogy mely fájlokat szeretné belefoglalni a csomagba – a HTML-oldalt, a szkripteket, az SDK-szkriptet és az emblémát.

Állítsa be addressable , true kivéve, ha olyan fájlokat is tartalmaz, amelyeknek nem kell URL-címmel rendelkeznie.

Megjegyzés:

A bővítmény jegyzékfájljáról, például a tulajdonságokról és a függvényről további információt a bővítmény jegyzékfájljának hivatkozásában talál.

További lépések

Bővítmények csomagolása, közzététele és telepítése