🍐

C#ベースのオープンソースCMS「Orchard Core」のプロジェクトをVisual Studioで作成する

2024/06/12に公開

dotnet コマンドでプロジェクトを作成する手順は以下の記事で紹介しましたが、Visual Studio を使ってもプロジェクトを作成することができます。

https://zenn.dev/zead/articles/orchardcore-setup

以下の2つの方法があります。

  1. プロジェクトテンプレートを使う方法
  2. 空のプロジェクトから作成する方法

この2つの方法について手順を示します。

2つの方法ともに、Orchard Core CMSのテンプレートのインストールが済んでいることが前提となります。

テンプレートは、以下のコマンドでインストールできます。

dotnet new install OrchardCore.ProjectTemplates::1.8.3

1. プロジェクトテンプレートを使う方法

Visual Studioを起動し、「新しいプロジェクトの作成」を選択します。

新しいプロジェクトの作成ダイアログで、"orchard"と入力し、見つかったテンプレートから「Orchard Core Cms Web App」を選びます。

プロジェクト名を入力し、[次へ]ボタンをクリックします。

追加情報ダイアログは、.NET8.0が選ばれていることを確認し、[作成]ボタンをクリックすます。

これで、プロジェクトが作成されました。F5でデバッグ起動すると以下のようなセットアップページが開きます。


2. 空のプロジェクトから作成する方法

Visual Studio を起動し、「新しいプロジェクトの作成」を選択します。
新しいプロジェクトの作成ダイアログで、"ASP.NET Core"と入力し、見つかったテンプレートから「ASP.NET Core(空)」を選びます。

プロジェクト名を入力し、[次へ]ボタンをクリックします。

追加情報ダイアログは、.NET8.0が選ばれていることを確認し、[作成]ボタンをクリックすます。

プロジェクトが作成されたら、ソリューションエクスプローラーで,「ソリューションのNuGetパッケージの管理」を選びます。

"OrchardCore.Application.Cms.Targets"パッケージをインストールします。
似たようなパッケージがあるので間違わないようにしてください。

パッケージがインストールできたら、Program.cs を以下のように書き換えます。

※ やっとC#プログラマーっぽい内容になった(笑)

program.cs
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddOrchardCms();

var app = builder.Build();

if (!app.Environment.IsDevelopment()) {
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseStaticFiles();
app.UseOrchardCore();

app.Run();

F5キーでデバッグ開始すれば、セットアップページが表示されます。

終わりに

以上で、Visual Studioを使いOrchard Coreのプロジェクトを作成する方法の説明は終わりです。
C#でWebアプリケーションを開発したことがあれば、何も難しいことはありませんね。

Orchard Coreに関する記事一覧は以下のページで確認できます。

https://zenn.dev/zead/articles/orchardcore-list-of-article

GitHubで編集を提案
株式会社ジード テックブログ

Discussion