Sitecore Helix Base 项目使用教程

Sitecore Helix Base 项目使用教程

1. 项目介绍

Sitecore Helix Base 是一个基于 Sitecore Helix 架构的开源解决方案，适用于新项目（Greenfield projects）。它为开发者提供了一套成熟的框架，帮助解决在使用 Sitecore 平台时遇到的常见问题。Helix Base 支持 Headless 版本，集成 Glass Mapper v5，支持 Sitecore 内容序列化（SCS），自动生成 C# 脚本，兼容 Sitecore 10.3.0，并具备预编译 Razor 视图等特性。

2. 项目快速启动

环境准备

• 安装 Visual Studio 2022 17.2 或更高版本。
• 安装 Sitecore Experience Platform 10.3.0。
• 从 SXA 下载页面安装 Sitecore PowerShell Extensions（SXA 不是必需的）。
• 安装 Sitecore Management Services 包。
• 克隆仓库，并在 Local.pubxml 中更新 'publishUrl' 属性以指向目标 IIS 文件夹。

克隆与部署

# 克隆仓库
git clone https://github.com/muso31/Helixbase.git

# 使用 'Local' 发布配置在 Helixbase.Website 项目中发布解决方案
# 更新 publishUrl 后使用以下命令发布
dotnet publish "path\to\Helixbase.Website.csproj" -c Release -p Configuration=Local

# 推送 Sitecore 项目项
dotnet sitecore ser push

配置与运行

• 配置 IIS 以运行 Sitecore 应用程序。
• 确保所有依赖项都已正确安装和配置。

3. 应用案例和最佳实践

使用 Hero Feature 作为示例

在 HeroService.cs 中查看如何使用内容 API 和搜索 API 获取 Sitecore 项目项的示例。

路由注册示例

在 Register routes 中查看如何注册一个路由的示例。

修改项目设置

• 若要更改项目版本限制，请编辑 /sitecore/system/Settings/Rules/Item Saved/Rules/Delete Old Versions 项上的规则。
• 在安全编辑器中可以分配非管理员解锁权限。

特性删除

如果不需要某个特性，可以轻松删除它。

4. 典型生态项目

• Helix Publishing Pipeline：用于发布的管道。
• Helix Base Modules：与 Helix Base 兼容的模块仓库。

以上是 Sitecore Helix Base 的基本使用教程，通过这些步骤，您可以快速开始使用该项目，并根据具体需求进行定制。