Visual Studio 2019のプロジェクトテンプレートと拡張機能を作成する方法

こんにちは!

最近、Vue JS + Asp.Net Coreの2つのプロジェクトテンプレートを作成しました。どちらもVisual Studio 2019拡張機能として使用しています。 以下のリンクで確認できるように、それらはVisual Studioマーケットプレイスで共有されました。

  • テンプレートVue JS + Asp.Net Core 3.1

独自の拡張機能を作成し、独自のテンプレートを公開する方法を知りたいですか? はいの場合、記事の残りの部分は、それを行う方法に関する段階的なプロセスです。

プロジェクトの作成

あなたがしなければならない最初のことは、テンプレートとして共有したいプロジェクトを作成することです。 この記事では、既に公開したVue JS + Asp.Net Coreプロジェクトを使用して、段階的に説明します。

プロジェクトのエクスポート

プロジェクトが作成されたら、Visual Studio 2019で[プロジェクト]メニューオプションに移動し、[テンプレートのエクスポート]オプションを選択します。

テンプレートには、プロジェクトテンプレートとアイテムテンプレートの2種類があります。 私たちの場合と同様に、プロジェクトテンプレートを作成しているので、基礎となるオプションを選択しました。

次のステップは、ユーザーに表示される名前、説明、アイコンと画像プレビューを構成することです。 この情報は、できるだけ高品質で適切に設定することが非常に重要です。テンプレート/拡張機能をダウンロードしてインストールする最終ユーザーに表示されるためです。

また、[Visual Studioに自動的にインポートする]オプションをオフにします。 このようにして、作成中の拡張機能をインストールできます。

最後に、プロセスはテンプレート自体を含むコンパクトフォルダーを生成しますが、作成の終わりではありません。

タグの定義

Visual Studio 2019で新しいプロジェクトを作成すると、テンプレートが特定のタグとともに表示され、テンプレートのフィルターに役立ちます。

Visual Studio 2019の最新バージョン以降、これらのタグは拡張機能を公開するユーザーには必須です。 これらがない場合、拡張機能はインストールされますが、ユーザーが検索しても、テンプレートはリストに表示されません。

これらのタグを作成するには、最後の手順でテンプレートを使用して生成されたコンパクトフォルダーを開き、テキストエディターを使用して.vstemplateファイルを開きます。

「テンプレートデータ」セクションで、「ProvideDefaultName」タグの後に、プラットフォーム、プロジェクトタイプ、言語など、テンプレートへのタグリスト参照を追加します。私の場合、次のように指定しました。

利用可能なタグの完全なリストは、以下のリンクにあります。

拡張の作成

テンプレートが既に作成され、タグが設定されているので、拡張機能のインストールファイルを作成します。

そのためには、VSIXプロジェクトタイプのプロジェクトを作成します。

これがプロジェクトの基本構造です。

PS:ただし、特定の特殊文字を「+」として使用してプロジェクト名を作成しましたが、これは教育目的のために、実際のシナリオではそうしないでください。 空のスペースや特殊文字を使わずに作成することをお勧めします。たとえば、私が付けた名前の代わりに、TemplateVueJSAspNetCoreArtigoMediumを使用します。 VSはその名前を使用して名前空間とクラスを自動的に生成するため、ビルドの問題を防ぎます。

ルートに、テンプレートへのコンパクトフォルダー参照を含めます。 コンパクトフォルダーには、前述のタグを含む.vstemplateファイルの変更が含まれていることが重要です。 それを忘れないでください。

このプロジェクトにはマニフェストファイルがあり、拡張機能のインストール手順に関する情報が含まれます。

そのファイルをダブルクリックすると、フォームのように開かれます。フォームはフィールドごとに入力できます。

必要なすべての情報は、インストールやマーケットプレイスの最終ユーザーにも表示されるため、品質を慎重に変更してください。 また、通常は「ラップトップ」名が付いているため、「作成者」フィールドを適切に指定する必要があります。

その後、「アセット」をクリックします。

既存のアセットがある場合は削除し、「新規」をクリックします。

パスに配置するオプションを選択し、プロジェクトに追加したコンパクトフォルダーを指定します。

世代

インストールファイルを作成するには、リリースモードでプロジェクトをビルドするだけです。 VSに拡張機能をインストールするために使用される.exeファイルを生成します。

できた! 拡張機能が作成されました。 Visual Studioマーケットプレイスで公開する前に、今すぐテストして、すべてが正常に機能しているかどうかを確認できます。

Visual Studio Market Publish

拡張機能を公開したい場合は、Visual Studio Marketplaceで行うことができます。

これを行うには、marketplace.visualstudio.comに移動し、Microsoftアカウントでログインした後、以下のオプションに移動します。

拡張機能の.exeをアップロードします。

テンプレートと拡張情報をフォームに入力します。 その情報は公開されるので、細かく注意してください。

プロセスが完了したら、保存して承認プロセスを待ちます。 これには数分かかる場合があります。

結論

この記事がお役に立てば幸いです。 読んでいただきありがとうございます。

以下は私のソーシャルメディアプロフィールです。 接続して質問してください。 これらのプロファイルでは、WebテクノロジーやITイベントに関するコンテンツを頻繁に共有しています。

Twitter:https://twitter.com/alemalavasi Linkedin:https://www.linkedin.com/in/alexandremalavasi/

.NET Core、Vue JS、Azureなどに焦点を当て、このプラットフォームを使用してテクニカルコミュニティにも貢献するために最近YouTubeチャンネルを作成しました。 これらのテーマに興味がある場合は、購読することをお勧めします。 間もなくコンテンツが定期的にリリースされますが、高品質なエクスペリエンスを提供するためにオーディオ、ビデオ、コンテンツをセットアップしています。

リンク:https://www.youtube.com/channel/UC-KFGgYiot1eA8QFqIgLmqA