やっぱりASP.NET CoreでもJavaScriptフレームワークを使ってSPAをしたいということで、公式ドキュメントにSPAをやるためのページが用意されています。
ただしこのページで取り上げているJSフレームワークは、AngularJSとReactです。
基本はバックエンドエンジニアな私としては、AngularJSとReactは難しいため、Vue.jsを好んで使っています。
しかしASP.NET CoreでVue.jsを使うための手順がドキュメントにないため、下記のリポジトリを参考にしました。
と思ったが一通り試してみると、もうこのリポジトリの手順ではうまくいかなかったので、下記の方法でやるとよいです。
SPAテンプレートのインストール
こちらのページにあるコマンドを実行することで、SPAのためのテンプレートがインストールされます。
PS E:\src\vueapp> dotnet new --install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0-preview1-final
Restoring packages for C:\Users\tsubaki\.templateengine\dotnetcli\v2.1.3\scratch\restore.csproj...
Installing Microsoft.DotNet.Web.Spa.ProjectTemplates 2.0.0-preview1-final.
Generating MSBuild file C:\Users\tsubaki\.templateengine\dotnetcli\v2.1.3\scratch\obj\restore.csproj.nuget.g.props.
Generating MSBuild file C:\Users\tsubaki\.templateengine\dotnetcli\v2.1.3\scratch\obj\restore.csproj.nuget.g.targets.
Restore completed in 371.04 ms for C:\Users\tsubaki\.templateengine\dotnetcli\v2.1.3\scratch\restore.csproj.
テンプレート 短い名前 言語 タグ
--------------------------------------------------------------------------------------------------------
Console Application console [C#], F#, VB Common/Console
Class library classlib [C#], F#, VB Common/Library
Unit Test Project mstest [C#], F#, VB Test/MSTest
xUnit Test Project xunit [C#], F#, VB Test/xUnit
ASP.NET Core Empty web [C#], F# Web/Empty
ASP.NET Core Web App (Model-View-Controller) mvc [C#], F# Web/MVC
ASP.NET Core Web App razor [C#] Web/MVC/Razor Pages
ASP.NET Core with Angular angular [C#] Web/MVC/SPA
ASP.NET Core with React.js react [C#] Web/MVC/SPA
ASP.NET Core with React.js and Redux reactredux [C#] Web/MVC/SPA
ASP.NET Core Web API webapi [C#], F# Web/WebAPI
global.json file globaljson Config
NuGet Config nugetconfig Config
Web Config webconfig Config
Solution File sln Solution
Razor Page page Web/ASP.NET
MVC ViewImports viewimports Web/ASP.NET
MVC ViewStart viewstart Web/ASP.NET
Examples:
dotnet new mvc --auth Individual
dotnet new xunit
dotnet new --help
コマンドの出力にあるように、AngularJSやReactはコマンドが用意されていますが、Vue.jsはありません。
プロジェクトで使用するSDKのバージョンを指定する
結論から言うと、.NET Core SDK 2.0.xでなければVue.jsのテンプレートを利用することができません。
そのためglobal.jsonというファイルを作成し、SDKのバージョンを指定する必要があります。
{ "sdk": { "version": "2.0.3" } }
.NET Core SDKの2.0系の最新は2.0.3になります。
global.jsonについてはこちらのページに説明があります。
テンプレートの種類を確認する
2.0系のSDKを指定したうえで、再度作成できるテンプレートの種類を確認します。
PS E:\src\vueapp> dotnet new -l 使用法: new [options] オプション: -h, --help このコマンドのヘルプを表示します。 -l, --list 指定された名前を含むテンプレートを一覧表示します。名前を指定しない場合は、すべてのテンプレートが一覧表示さ れます。 -n, --name 作成する出力の名前。名前を指定しない場合は、現在のディレクトリの名前が使用されます。 -o, --output 生成する出力を配置する場所。 -i, --install ソースまたはテンプレート パックをインストールします。 -u, --uninstall ソースまたはテンプレート パックをアンインストールします。 --type 使用可能な種類に基づいてテンプレートをフィルター処理します。定義済みの値は、"project"、"item"、"other" です。 --force 既存のファイルが変更されるとしても、強制的にコンテンツを生成します。 -lang, --language 作成するテンプレートの言語を指定します。 テンプレート 短い名前 言語 タグ -------------------------------------------------------------------------------------------------------- Console Application console [C#], F#, VB Common/Console Class library classlib [C#], F#, VB Common/Library Unit Test Project mstest [C#], F#, VB Test/MSTest xUnit Test Project xunit [C#], F#, VB Test/xUnit ASP.NET Core Empty web [C#], F# Web/Empty ASP.NET Core Web App (Model-View-Controller) mvc [C#], F# Web/MVC ASP.NET Core Web App razor [C#] Web/MVC/Razor Pages ASP.NET Core with Angular angular [C#] Web/MVC/SPA ASP.NET Core with React.js react [C#] Web/MVC/SPA ASP.NET Core with React.js and Redux reactredux [C#] Web/MVC/SPA ASP.NET Core with Aurelia aurelia [C#] Web/MVC/SPA ASP.NET Core with Knockout.js knockout [C#] Web/MVC/SPA ASP.NET Core with Vue.js vue [C#] Web/MVC/SPA ASP.NET Core Web API webapi [C#], F# Web/WebAPI global.json file globaljson Config Nuget Config nugetconfig Config Web Config webconfig Config Solution File sln Solution Razor Page page Web/ASP.NET MVC ViewImports viewimports Web/ASP.NET MVC ViewStart viewstart Web/ASP.NET
するとVue.jsのテンプレートも表示され、使えるようになりました。
ASP.NET Core with Vue.jsのプロジェクトを作成する
あとはいつものようにdotnet newコマンドでプロジェクトを作ればよいです。
PS E:\src\vueapp> dotnet new vue
テンプレート "ASP.NET Core with Vue.js" が正常に作成されました。
作成後のアクションを処理しています...
'dotnet restore' を E:\src\vueapp\vueapp.csproj で実行しています...
Restoring packages for E:\src\vueapp\vueapp.csproj...
Restore completed in 46.83 ms for E:\src\vueapp\vueapp.csproj.
Generating MSBuild file E:\src\vueapp\obj\vueapp.csproj.nuget.g.props.
Generating MSBuild file E:\src\vueapp\obj\vueapp.csproj.nuget.g.targets.
Restore completed in 1.43 sec for E:\src\vueapp\vueapp.csproj.
正常に復元されました。
説明:
-------------------------------------------------------------------
IMPORTANT: Before running this project on the command line,
you must restore NPM packages by running "npm install"
-------------------------------------------------------------------
手動の操作手順: Run "npm install"
実行してみる
プロジェクトを作成した段階で簡単なアプリケーションとなっており、実行するとサンプルを確認することができます。
npm install dotnet run
これでVue.jsを使ったASP.NET Coreのプロジェクトを作成することができました。
