@ eclipse- docks/ 创建- app
脚手架 新的 Eclipse Docs app 有单一命令.
本地测试
从 Eclipse Docs 单列波根,用节点运行 CLI(不需要发布):
node packages/create-app/index.js my-app
# or non-interactive:
node packages/create-app/index.js my-app --yes
或使用 npx 使用软件包路径 :
npx file:./packages/create-app my-app --yes
礛 cd my-app && npm run dev 运行脚手架应用程序.
用法(已公布的套件)
npm create @eclipse-docks/app
项目名称( 指南 ):
npm create @eclipse-docks/app my-app
在提供项目名称时跳过提示 :
npm create @eclipse-docks/app my-app -- --yes
今后的步骤
脚手架后:
cd my-app
npm run dev
从创建的项目根, npm run dev 运行应用程序( Vite) 。 使用 npm run build 财务报告和审定财务报表 npm run preview 用于构建和预览.
你得到的东西
- A 类 单相 有两个工作空间包:
packages/app— Docks app (Vite, Core + 从 npm 扩展), 包括 巴布亚新几内亚 (网络应用程序清单,注入 Manifest服务工人,@eclipse-docks/extension-pwa在工具栏中安装/更新).packages/example-extension- 可以复制或扩展的最小示例扩展.
- 该应用程序注册 a 图标贡献 左侧主工具栏(槽)
start)与正文并用my!app; 您可以在packages/app/src/main.ts。 。 。 . - 示例扩展由app加载,并在左侧面板上添加"示例"视图.
示例扩展
模板包含实例扩展名 : packages/example-extension 以显示如何在不发布单独的 npm 包的情况下构建自己的扩展.
src/index.ts- 将扩展注册为:extensionRegistry.registerExtension()(id,名称,描述,加载器,图标). 和公布的扩展图案相同@eclipse-docks/extension-howto-system财务报告和审定财务报表@eclipse-docks/extension-utils。 。 。 .src/example-extension-loader.ts– 启动扩展时已装入. 登记a Tab 贡献 改为SIDEBAR_MAIN(左侧面板),因此"示例"标签与工作空间文件浏览器同时出现.tsconfig.json– 扩展名的TypeScript配置(IDE和类型检查).vite.config.ts- 自由号建设;运行npm run build -w example-extension到产出dist/当您想要发布扩展名时.
您可以编辑 packages/example-extension 或复制后开始新的扩展。 应用程序取决于它通过 "example-extension": "*" 内 packages/app/package.json (npm链接工作空间包). 应用程序从 dev 的源头编译扩展; 如果您单独发布, 请使用扩展的构建脚本 .