umbraco-entry-point

Umbraco 入口点

什么是入口点？

入口点是一种扩展，会在 Umbraco 后台启动时执行 JavaScript 代码。后台入口点会在用户身份验证后运行，用于执行初始化逻辑、加载外部库、动态注册 UI 扩展或引入全局 CSS。可选的 onUnload 函数用于处理清理工作。

文档

实现前务必获取最新文档：

• 主要文档：https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/extending-overview/extension-types/backoffice-entry-point
• 基础知识：https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/foundation
• 扩展注册表：https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/extending-overview/extension-registry

工作流

1. 获取文档 - 对上述 URL 使用 WebFetch
2. 提出问题 - 需要哪些初始化操作？是否需要外部库？是否需要清理工作？
3. 生成文件 - 根据最新文档创建清单文件和入口点
4. 说明 - 展示创建的内容以及测试方法

最简示例

清单文件（umbraco-package.json）

{
  "name": "My Package",
  "extensions": [
    {
      "type": "backofficeEntryPoint",
      "alias": "My.EntryPoint",
      "name": "My Entry Point",
      "js": "/App_Plugins/MyPackage/index.js"
    }
  ]
}

实现（index.ts）

import type { UmbEntryPointOnInit } from '@umbraco-cms/backoffice/extension-api';

export const onInit: UmbEntryPointOnInit = (host, extensionRegistry) => {
  console.log('My package initialized');

  // Register extensions dynamically
  extensionRegistry.register({
    type: 'dashboard',
    alias: 'My.Dashboard',
    name: 'My Dashboard',
    element: () => import('./dashboard.js'),
    meta: {
      label: 'My Dashboard',
      pathname: 'my-dashboard'
    }
  });
};

// Optional cleanup
export const onUnload = () => {
  console.log('My package unloaded');
};

就是这样！务必获取最新文档，保持示例简洁，并生成完整可运行的代码。