Genişletilebilirlik noktaları

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

Uzantılar, Azure DevOps kullanıcı arabirimine ve REST yüzeyine özellikler ekler. Bu makalede, hedefleyebileceğiniz en yaygın genişletilebilirlik noktaları listelenir ve uzantı bildiriminizde kullandığınız kimlikler gösterilir. Tam bildirim şeması için bkz. Uzantı bildirimi başvurusu. Uzantı modeline ve katkı desenlerine genel bakış için bkz. Katkı modeli.

Tavsiye

Yeni bir Azure DevOps uzantısı başlatıyorsanız, önce bu bakımlı örnek koleksiyonları deneyin; bunlar geçerli ürün derlemeleriyle çalışır ve modern senaryoları kapsar (örneğin, çekme isteği sayfalarına sekme ekleme).

Kuruluşunuzda bir örnek çalışmıyorsa, bunu kişisel bir kuruluşa veya test kuruluşuna yükleyin ve uzantı bildiriminin hedef kimliklerini ve API sürümlerini geçerli belgelerle karşılaştırın. Başvuru ve API'ler için bkz:

Hub'lar ve hub grupları

Hub'lar ve hub grupları Azure DevOps'ta birincil gezinti sağlar (örneğin, Dosyalar, Sürümler, Kapsamlar, Sorgular). Hub bir hub grubuna aittir; örneğin, Dosyalar hub'ı proje düzeyinde Azure Repos hub grubuna aittir. Hub grupları kuruluş/koleksiyon düzeyinde veya proje düzeyinde bulunabilir. Uzantıların çoğu proje düzeyinde katkıda bulunur.

Aşağıdaki tabloda ortak hub grupları ve bunların katkı kimlikleri listelenmiştir.

İsim Kimlik Seviye Önizleme görüntüsü
Azure Boards ms.vss-work-web.work-hub-group Proje/ekip Azure Boards'a eklenen özel hub'ın ekran görüntüsü.
Azure Repos ms.vss-code-web.code-hub-group Proje/ekip Azure Repos'a eklenen özel hub'ın ekran görüntüsü.
Azure Boru Hatları ms.vss-build-web.build-release-hub-group Proje/ekip Azure Pipelines'a eklenen özel hub'ın ekran görüntüsü.
Azure Test Planları ms.vss-test-web.test-hub-group Proje/ekip Azure Test Planlarına eklenen özel hub'ın ekran görüntüsü.
Proje ayarları ms.vss-web.project-admin-hub-group Proje Proje ayarlarında özel hub'ın ekran görüntüsü.
Kuruluş ayarları ms.vss-web.collection-admin-hub-group Kuruluş/koleksiyon Kuruluş ayarlarında özel hub'ın ekran görüntüsü.

Hub'a katkıda bulun

Bu örnekte Kod hub'ı grubunu hedefleyen bir hub katkısı gösterilmektedir:

{
  "contributions": [
    {
      "id": "my-custom-hub",
      "type": "ms.vss-web.hub",
      "targets": [
        "ms.vss-code-web.code-hub-group"
      ],
      "properties": {
        "name": "Code Hub",
        "order": 30,
        "uri": "/views/code/custom.html"
      }
    }
  ]
}
  • ms.vss-web.hub — katkı türü. vss-web tarafından ms yayımlanan uzantı, bu türü ve ve gibi nameordergerekli ve isteğe bağlı özelliklerini tanımlar.
  • ms.vss-code-web.code-hub-group — bu hub'ın hedefledikleri hub grubunun tam kimliği.
  • my-custom-hub — bu katkının kısa kimliği. Tam kimlik: {publisherId}.{extensionId}.my-custom-hub.

Aşağıdaki tabloda, katkılar için ms.vss-web.hub kullanılabilen özellikler listelenir:

Mülkiyet Türü Zorunlu Açıklama
name String Evet Hub gezintisinde gösterilen görünen ad
order Numara Hayır Diğer hub'lara göre konum (önce düşük değerler görünür)
uri String Evet Hub'ın HTML içerik sayfasının göreli yolu
icon String Hayır Yol kullanan özel asset:// simge
iconName String Hayır Fluent UI icon name
supportsMobile Boolean Hayır Hub'ın mobil cihazlarda görünüp görünmediği

Tavsiye

Katkınız görünmüyorsa hedef kimliğin tam olarak eşleşip eşleşmediğini doğrulayın; kimlikler büyük/küçük harfe duyarlıdır. Uzantıyı tarayıcınızda yeniden yükleyin ve uzantı yükleme hataları için geliştirici araçları konsolunu denetleyin.

Menüye veya araç çubuğuna simge ekleme

icon Bir simge görüntülemek için katkınızdaki veya iconName özelliğini kullanın. Mümkün olduğunda kendi simgenizi belirtin.

Özel simge:

"properties": {
    "name": "Sample hub",
    "uri": "dist/Hub/Hub.html",
    "icon": "asset://static/sample-icon.png",
    "supportsMobile": true
}

Akıcı kullanıcı arabirimi simgesi:

"properties": {
    "iconName": "Code",
    "name": "Code Hub",
    "order": 30,
    "uri": "/views/code/custom.html"
}

Uyarı

icon ve iconName özellikleri yalnızca hub'lar, menüler ve araç çubukları için çalışır. Sekme katkıları için çalışmazlar.

Menüler ve araç çubukları için ayarlar

Bu hedefler, Azure Boards veya Azure Repos gibi hizmete özgü hub'lara değil kuruluş ve proje yönetim sayfalarına uygulanır.

İsim Hedef Kimliği
Kuruluş/koleksiyona genel bakış araç çubuğu ms.vss-admin-web.collection-overview-toolbar-menu
Koleksiyona genel bakış projeleri ızgarası ms.vss-admin-web.projects-grid-menu
Projeye genel bakış araç çubuğu ms.vss-admin-web.project-overview-toolbar-menu
Projeye genel bakış ekipler tablosu ms.vss-admin-web.teams-grid-menu

Azure Boards menüsü ve araç çubuğu

İsim Hedef Kimliği Önizleme görüntüsü
İş öğesi sorgu menüsü ms.vss-work-web.work-item-query-menu Sorgu menüsündeki özel eylemin ekran görüntüsü.
Sorgu sonuçları için iş öğesi araç çubuğu menüsü ms.vss-work-web.work-item-query-results-toolbar-menu Sorgu sonuçları araç çubuğu menüsündeki özel eylemin ekran görüntüsü.
İş öğesiyle ilgili sorgu sonuçları menü öğesi ms.vss-work-web.query-result-work-item-menu Sorgu sonuçları öğesi menüsündeki özel eylemin ekran görüntüsü.
İş öğesi sorgu sonuçları sekmesi ms.vss-work-web.query-tabs Sorgu sonuçlarında özel sekmenin ekran görüntüsü.
Bağlam menüsü için iş öğesi ms.vss-work-web.work-item-toolbar-menu İş öğesi araç çubuğundaki özel eylemlerin ekran görüntüsü.
Backlog öğesi menüsü ms.vss-work-web.backlog-item-menu Kapsam öğesi menüsündeki özel eylemlerin ekran görüntüsü.
Sprint panosu pivot filtresi menüsü ms.vss-work-web.sprint-board-pivot-filter-menu Sprint panosu özet filtresi menüsünün ekran görüntüsü.
Pano pivot filtre menüsü ms.vss-work-web.backlog-board-pivot-filter-menu Kapsam panosu özet filtresi menüsünün ekran görüntüsü.
Kart menüsü ms.vss-work-web.backlog-board-card-item-menu
Ürün backlog sekmesi ms.vss-work-web.product-backlog-tabs Ürün kapsamındaki özel sekmenin ekran görüntüsü.
Yineleme iş listesi sekmesi ms.vss-work-web.iteration-backlog-tabs Yineleme kapsamındaki özel sekmenin ekran görüntüsü.
Portföy iş listesi penceresi ms.vss-work-web.portfolio-backlog-toolpane Portföy kapsamındaki özel bölmenin ekran görüntüsü.
Ürün birikim bölmesi ms.vss-work-web.requirement-backlog-toolpane Ürün kapsamındaki özel bölmenin ekran görüntüsü.
Yineleme birikimi bölmesi ms.vss-work-web.iteration-backlog-toolpane Yineleme kapsamındaki özel bölmenin ekran görüntüsü.

Azure Pipelines menüsü ve araç çubuğu

İsim Hedef Kimliği Önizle
Tamamlanan yapı menüsü ms.vss-build-web.completed-build-menu Tamamlanmış derleme eylemleri menüsünün ekran görüntüsü.
Test Sonuçları Araç Çubuğu İşlemi ms.vss-test-web.test-results-actions-menu Test sonuçları araç çubuğundaki özel eylemin ekran görüntüsü.
Test sonucu ayrıntıları sekmesi ms.vss-test-web.test-result-details-tab-items Test sonucu ayrıntılarındaki özel sekmenin ekran görüntüsü.
Yayın hattı gezgini bağlam menüsü ms.vss-releaseManagement-web.release-definition-explorer-context-menu Yayın tanımı gezgini bağlam menüsünün ekran görüntüsü.
İşlem hattı ayrıntıları görünümü, başlık düğmesi ms.vss-build-web.pipelines-header-menu İşlem hattı ayrıntıları görünümünde üst bilgi düğmesinin ekran görüntüsü.
Veri hattı ayrıntıları görünümü, klasör bağlam menüsü ms.vss-build-web.pipelines-folder-menu İşlem hattı ayrıntıları görünümünde klasör bağlam menüsünün ekran görüntüsü.

Azure Pipelines görevleri

Görevler bir derleme veya yayın işlem hattında iş gerçekleştirir. Daha fazla bilgi için bkz: Özel işlem hatları görev uzantısı ekleme.

Azure Repo'lar menüsü ve araç çubuğu

İsim Hedef Kimliği Önizleme görüntüsü
Kaynak öğe (ızgara) menüsü ms.vss-code-web.source-grid-item-menu Kaynak öğe kılavuz menüsünün ekran görüntüsü.
Kaynak öğe (ağaç) menüsü ms.vss-code-web.source-tree-item-menu Kaynak öğe ağacı menüsünün ekran görüntüsü.
Kaynak öğe (kılavuz ve ağaç) menüsü ms.vss-code-web.source-item-menu Kaynak öğe birleştirilmiş menüsünün ekran görüntüsü.
Liste öğesi menüsünü değiştir ms.vss-code-web.change-list-item-menu
Liste özeti öğesini değiştirme menüsü ms.vss-code-web.change-list-summary-item-menu
Git ağaç dalları menüsü ms.vss-code-web.git-branches-tree-menu Git dalları ağaç menüsünün ekran görüntüsü.
Git çekme talebi eylemleri menüsü ms.vss-code-web.pull-request-action-menu Git çekme isteği eylemleri menüsünün ekran görüntüsü.
Git çekme isteği sekmeleri (sekme bölümleri) ms.vss-code-web.pr-tabs Git çekme isteğindeki özel sekmenin ekran görüntüsü.
Git commit listeleme menüsü ms.vss-code-web.git-commit-list-menu Git işleme listesi menüsünün ekran görüntüsü.
Git komit detay menüsü ms.vss-code-web.git-commit-details-menu Git işleme ayrıntı menüsünün ekran görüntüsü.

Azure Test Planları menüsü ve araç çubuğu

İsim Hedef Kimliği Önizleme görüntüsü
Test çalıştırma kılavuzu menüsü ms.vss-test-web.test-run-grid-menu Test çalıştırma kılavuzu menüsünün ekran görüntüsü.
Test planı takımları ağaç menüsü ms.vss-test-web.test-plans-suites-context Test planları paketleri bağlam menüsünün ekran görüntüsü.
Test planı merkez pivot sekmesi ms.vss-test-web.test-plan-pivot-tabs Test planı hub'ının özel özet sekmesinin ekran görüntüsü.

Diğer genişletilebilirlik noktaları

  • Last updated on