Orchard Core的NuGet包使用入门篇¶

在这篇文章中，我们将看到使用Orchard Core提供的NuGet包创建CMS Web应用程序有多么简单。

创建Orchard Core CMS应用程序¶

在Visual Studio中，创建一个新的空白的.NET Core Web应用程序。例如：'Cms.Web'。不要勾选“将解决方案和项目放在同一个目录中”，因为后来当你创建模块和主题时，你会想让它们与解决方案中的Web应用程序一起生存。

注意

如果你想使用preview包，请在Package sources中配置OrchardCore Preview url。

要添加对包的引用，请右键单击项目并单击“管理NuGet包...”，如果需要，请勾选“包括预发布版本”。如果你添加了上面的预览源，请从右上方的“Package Source”选择此源。在“Browse”选项卡中，搜索“OrchardCore.Application.Cms.Targets”并“安装”该包。

仅使用.NET 6框架和`Program.cs`入门？¶

提示

当使用.NET 6框架启动新项目时，你会注意到创建的项目没有像以前的.NET框架版本一样拥有Startup类。

打开Program.cs文件，并删除如下代码：

builder.UseOrchardCore();

此外，删除以下代码

app.UseHttpsRedirection();
app.UseRouting();
app.UseAuthorization();
app.MapRazorPages();

最后，在请求管道中添加以下代码

builder.UseOrchardCore();

在完成后，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();

使用 `Program.cs` 入门？¶

打开 Program.cs 文件，然后添加 OrchardCore CMS 服务，可以通过加入这一行代码来实现：

builder.Services.AddOrchardCms();

构建 WebApplication 后，将这一行代码:

app.MapGet("/", () => "Hello World!");

然后使用以下代码替换:

app.UseOrchardCore().Run();

最后，删除默认的 Pages 和/或 Views 文件夹，允许OrchardCore从当前主题渲染视图。

设置你的应用程序¶

运行项目 (Ctrl+F5)。浏览器显示了安装界面。

在安装界面输入需要的信息：

站点名字。比如： Orchard Core.
配方。比如： Agency.
默认时区。比如： (+01:00) Europe/Paris.
数据库类型。比如： SqLite.
超级用户名。比如： admin.
超级用户的电子邮箱。比如： foo@bar.com
超级用户的密码以及确认密码。

提交表单，你的网站在几秒后将会生成。

然后，你就可以使用 /admin 地址访问管理界面了。开始享受成果吧。

Last update: April 26, 2023

Orchard Core的NuGet包使用 入门篇¶