舰队基地 Ember Core

车队基地控制台背后的服务、合同、装饰和公用事业 舰队基地的扩建工程已经建成.

文档 • 妇女 快速启动 • 妇女 Ember 用户界面 • 妇女 捐款

概览

@fleetbase/ember-core 是舰队基地控制台和舰队基地扩展的安伯号 共享 。 它规定:

• 宇宙间 扩展层,用于插入控制台:菜单, 登记册、仪表板部件、生命周期钩、引擎加载和资源视图.
• 合同 ——描述扩展贡献的小,可连锁分类 (单位:千美元)MenuItem, (中文(简体) ), Widget, (中文(简体) ), Hook, (中文(简体) ), TableColumn, (中文(简体) ), ResourceAction (见a/cn.9/wg.iii/wp.iii/wp.48,第2段).
• 应用程序服务 ——认证,API客户端,当前用户,CRUD工作流程, 过滤器,通知,套接字,主题等等.
• 装饰和公用事业 ——存储和API后置属性,引擎服务注入,以及 帮助控制台全程依赖.

有部分人,住在伴侣的外甥中, @fleetbase/ember-ui (英语)。 。 。 .

文档

这些文件住在 舰队基地.io/docs/扩展-发展。 。 。 .

安装

pnpm add @fleetbase/ember-core

或者,与Ember CLI: :

ember install @fleetbase/ember-core

需要节点 18 或更新。 附加物由Ember 5.4建造并测试.

使用量

注册扩展名

扩展帮助控制台从 setupExtension 钩上它 addon/extension.js。 。 。 . 这个 universe 它得到的是其他一切的切入点:

// addon/extension.js
import { ResourceAction, TableColumn } from '@fleetbase/ember-core/contracts';

export default {
    setupExtension(app, universe) {
        // Add an item to the console header
        universe.getService('menu').registerHeaderMenuItem('Acme', 'console.acme', {
            icon: 'rocket',
            priority: 5,
        });

        // Add a column and a row action to Fleet-Ops' drivers table
        const views = universe.getService('resource-view');

        views.register(
            'fleet-ops:driver:table:columns',
            new TableColumn({ id: 'safety-score', label: 'Safety Score', valuePath: 'meta.safety_score' }).after('status')
        );

        views.register(
            'fleet-ops:driver:table:row-actions',
            new ResourceAction({ id: 'acme-sync', label: 'Sync to Acme', icon: 'sync', permission: 'acme sync driver' })
                .withHandler((driver, ctx) => ctx.owner.lookup('service:acme').sync(driver))
        );
    },
};

使用服务

每个服务都以通常的方式注入:

import Controller from '@ember/controller';
import { inject as service } from '@ember/service';
import { action } from '@ember/object';

export default class OrdersController extends Controller {
    @service fetch;
    @service currentUser;
    @service notifications;

    @action async dispatch(order) {
        await this.fetch.post(`orders/${order.id}/dispatch`);
        this.notifications.success(`Dispatched by ${this.currentUser.name}`);
    }
}

包括什么

发展

pnpm install --frozen-lockfile

pnpm start                # serve the dummy app
pnpm test                 # lint + the full suite
pnpm run test:ember       # the suite on its own
pnpm run lint             # eslint, ember-template-lint, stylelint
pnpm run build            # production build

在一个区域工作时运行子集 :

pnpm exec ember test --filter="Unit | Service | fetch"

测试和覆盖范围

套房以无头Chrome通过Testem运行. 覆盖范围设于 100%(百分比) addon/ 来源 - 陈述、分支、功能和行,每个文件检查,并在CI中执行 报告结果 代码。 。 。 .

pnpm run coverage            # run the suite with coverage
pnpm run coverage:check      # enforce the gate

捐款

见 捐款 向导。 欢迎提出问题和意见 GitHub 讨论 继续 解析器。 。 。 .

许可证

凭 GNU 阿费罗通用公共许可证 v3.0 或以后。 。 。 .