拡張機能サンプル
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
サンプルから作業して拡張機能の開発を開始します。
ヒント
Azure DevOps 拡張機能 SDK を使用した拡張機能開発に関する最新のドキュメントを確認してください。
次の Microsoft サンプルは、拡張機能フレームワークの機能と、さまざまな領域に貢献する方法を示しています。 各サンプルは、1 つ以上のコントリビューションを示しています。 拡張フレームワークの理解を深めるために、各サンプルのコントリビューションの数を制限します。 ソース情報については、 Azure DevOps 拡張機能のサンプル リポジトリを参照してください。
| サンプル | 貢献 | 説明 |
|---|---|---|
| BreadcrumbService | 階層リンク サービス、ハブ | 階層リンク サービスを追加します。このサービスは、サンプル ハブに "Sample Breadcrumb Item" を追加します。 この項目を表示するには、Pipelines ハブ グループの Sample Hub に移動します。 |
| CodeEditorContribution | コード エディター | コード エディターの言語定義と JSON スキーマを追加します。 |
| 機能 | 機能、ハブ、プロパティ プロバイダー | ユーザー プロファイル メニューの Preview Features パネルにフックする方法について説明します。 "ABC" 機能を有効にしたときにのみ表示される単純なハブを追加します。 機能のオンとオフは、ユーザーごと、または組織ごとに切り替えることができます。 |
| ハブ | ハブ | Sample Hub という名前のハブを Pipelines ハブ グループに追加します。 サンプル ハブは、プロジェクト レベルのページの Pipelines ナビゲーション要素の下にあります。 |
| メニュー | [ビルド定義] メニュー項目 | ドロップダウン アクション メニューの Builds ハブにサンプル ビルド定義メニュー項目を追加します。 メニュー ハンドラーは、渡されたコンテキストから現在のビルド定義を取得し、REST 呼び出しを行い、結果をメッセージ ボックスに表示します。 |
| Panel | パネル コンテンツ、ハブ | Hub サンプル内で適用されます。 切り替えボタンと、 OK と Cancel ボタンが含まれています。 カスタム パネルまたはダイアログ コンテンツとして使用できます。 |
| ピボット | [Web] タブ | Sample Pivot タブを組織またはプロジェクト コレクションのホーム ページの [Projects、My 作業項目、およびMy pull requests の横に追加します。 |
| ピル | Pii Provider | パイプライン定義 (実行) ページのタイトルに丸薬を追加します。 |
| QueryParamsHandler | イベント サブスクリプション | 任意のページが読み込まれるときに、 showMyPanel クエリ パラメーターが URL に表示されるたびに、任意のページに読み込むサービスを追加します。 スタートアップ サービスでは、パネル のサンプルからカスタム パネルが表示され、オプションの myPanelTitle クエリ パラメーターがパネル タイトルとして使用されます。 |
| RepositoryActions | メニュー項目 | サンプル リポジトリ アクションメニュー項目をコード ハブ ページのヘッダーのリポジトリ ピッカーに追加します。 hrefプロパティが表示される場合は、指定した URL に移動するアクションを選択します。 uri プロパティが指定されている場合、そのコードはアクションを選択したときに実行されます。 |
| RepositoryServiceHub | ハブ | Repository Information ハブを Code ハブ グループに追加します。 IVersionControlRepositoryServiceと対話して、ユーザーの Git リポジトリに関する基本情報を取得する方法を示します。 |
| WorkItemFormGroup | 作業項目フォーム グループ | Sample WorkItem フォーム グループ拡張機能を作業項目フォームに追加して、IWorkItemFormService サービスとIWorkItemNotificationListenerを操作する方法を示します。 フォーム サービスを使用してフィールド値を変更し、作業項目フォーム通知イベントを表示する方法を示す UI を提供します。 |
| WorkItemOpen | ハブ | Sample WorkItem Open ハブを Boards ハブ グループに追加して、IWorkItemFormNavigationService サービスと対話する方法を示します。 既存の作業項目を ID で開いたり、作業項目の種類別に新しい作業項目の作業項目フォームを開いたりするための UI を提供します。 これらのオプションのいずれかを選択すると、ホスト フレームでダイアログが開きます。 |
DevLabs の例
その他のオープンソース例を参考にしてください。
| サンプル | ソース | 貢献 | 説明 |
|---|---|---|---|
| チーム予定表 | GitHub | ハブ、イベント ソース | チームにとって重要なイベントの追跡、休暇の表示と管理、スプリントの開始と終了のタイミングをすばやく確認できます。 |
| WSJF (Weighted Shortest Job First) | GitHub | 通知 (作業項目)、コンテキスト メニュー アクション (作業項目) | 自動では、作業項目ごとに WSJF (最も短いジョブの重み付け) が計算され、作業項目フィールドに格納されます。 |
| Cascading Lists | GitHub | 作業項目フォーム | 作業項目フォームの選択リストの連鎖動作を定義します。 |
| 遡及 | GitHub | ハブ | 振り返りと一般的なフィードバック ボードのシナリオに関するファーストクラスのエクスペリエンス。 プロジェクトのマイルストーンに関するフィードバックを収集し、整理と優先順位付けを行い、実用的なタスクを作成して追跡します。これは、チームが時間の経過とともに改善するのに役立ちます。 |
| 見積もる | GitHub | ハブ、作業項目のアクション メニュー | Azure DevOps で Planning Poker をプレイします。 イテレーション、クエリ、またはバックログから作業を選択し、チームでそれらの項目の作業量を見積もり、作業項目をすぐに更新します。 |
| 複数値コントロール | GitHub | 作業項目フォーム | 複数の値を選択できる作業項目フォーム コントロール。 |
| Azure DevOps 拡張機能のタスク | GitHub | タスクのビルドとリリース | Azure Devops および Visual Studio 拡張機能を Visual Studio Marketplace にパッケージ化して発行するための Azure Pipelines タスク。 |
作業の開始
できるだけ早く開始するには、TypeScript を使用して拡張機能をビルドするために必要なファイルを含む seed プロジェクト を使用します。 拡張機能のビルド、パッケージ化、発行を自動化するスクリプトがあります。