SuperAPI AI 工具集

umbraco-extension-template

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:Umbraco Extension Template 是创建 Umbraco 后台扩展的官方 .NET 模板,提供预配置的项目结构、TypeScript/Vite 工具链和扩展开发所需的基础文件。每个后台扩展都建议从该模板开始。

主要能力:通过 dotnet new 命令脚手架生成扩展项目;可选 -ex 标志附带示例代码,包括示例 API 控制器、Swagger API 注册、示例仪表板组件和生成的 API 客户端。模板包含 .csproj、Constants.cs、README.md 以及 Client 目录(package.json、tsconfig.json、vite.config.ts、src)。

使用方式:前置条件为 .NET SDK 10.0 或更高、Node.js 24 或更高。先运行 umbraco-version-guard 确认目标站点 Umbraco 主版本与技能目标一致,不匹配则停止。一次性安装模板:dotnet new install Umbraco.Templates;创建扩展:dotnet new umbraco-extension -n MyExtension(加 -ex 生成示例);进入客户端目录安装依赖:cd MyExtension/Client && npm install;开发:npm run watch;生产构建:npm run build;类型检查:npm run check;发布:dotnet publish --configuration Release;打包 NuGet:dotnet pack --configuration Release。创建后必须将扩展的 .csproj 作为 ProjectReference 添加到主 Umbraco 实例,否则扩展不会加载(参考 umbraco-add-extension-reference)。

适用场景:为 Umbraco 后台添加分区、仪表板、菜单、工作区、树等扩展类型时,先以本模板搭建项目骨架,再按需引入相关技能。

限制:需匹配 Umbraco 主版本;必须手动添加项目引用;文档与具体版本行为以官方最新文档为准,本资料未提供收费、价格或平台支持等额外信息。