Ember Engines 使用指南

Ember Engines 使用指南

ember-enginesComposable Ember applications for ambitious user experiences项目地址:https://gitcode.com/gh_mirrors/em/ember-engines

1. 项目的目录结构及介绍

Ember Engines 项目的目录结构遵循标准的 Ember.js 项目结构，并添加了一些特定于引擎的目录和文件。以下是主要的目录结构及其介绍：

ember-engines/
├── addon/
│   ├── engines/
│   │   └── my-engine/
│   │       ├── addon/
│   │       ├── app/
│   │       ├── config/
│   │       ├── public/
│   │       └── index.js
│   └── index.js
├── app/
├── config/
├── tests/
├── vendor/
├── package.json
├── ember-cli-build.js
└── README.md

• addon/: 包含引擎的代码。每个引擎都有一个独立的目录，例如 my-engine/。
  • engines/: 包含所有引擎的目录。
    • my-engine/: 具体的引擎目录。
      • addon/: 引擎的公共代码。
      • app/: 引擎的应用代码。
      • config/: 引擎的配置文件。
      • public/: 引擎的静态资源。
      • index.js: 引擎的入口文件。
  • index.js: 主 addon 目录的入口文件。
• app/: 主应用的代码。
• config/: 主应用的配置文件。
• tests/: 测试代码。
• vendor/: 第三方库。
• package.json: 项目的依赖和脚本。
• ember-cli-build.js: 构建配置文件。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

Ember Engines 的启动文件主要位于 addon/engines/my-engine/index.js。这个文件是引擎的入口点，负责初始化和配置引擎。以下是该文件的主要内容：

module.exports = EngineAddon.extend({
  name: 'my-engine',
  lazyLoading: {
    enabled: false
  },
  isDevelopingAddon: function() {
    return true;
  }
});

• name: 引擎的名称。
• lazyLoading: 配置是否启用懒加载。
• isDevelopingAddon: 指示是否正在开发该插件。

3. 项目的配置文件介绍

Ember Engines 的配置文件主要位于 config/ 目录下。以下是主要的配置文件及其介绍：

• config/environment.js: 主应用的环境配置文件。
• config/engines.js: 引擎的配置文件，用于定义引擎的路由和其他配置。

config/environment.js

'use strict';

module.exports = function(environment) {
  let ENV = {
    modulePrefix: 'my-app',
    environment,
    rootURL: '/',
    locationType: 'auto',
    EmberENV: {
      FEATURES: {
        // 启用或禁用特定功能
      },
      EXTEND_PROTOTYPES: {
        // 启用或禁用原型扩展
      }
    },
    APP: {
      // 应用配置
    }
  };

  if (environment === 'development') {
    // 开发环境配置
  }

  if (environment === 'test') {
    // 测试环境配置
  }

  if (environment === 'production') {
    // 生产环境配置
  }

  return ENV;
};

config/engines.js

module.exports = function(environment) {
  return {
    'my-engine': {
      enabled: true,
      routes: {
        'my-engine.route': {
          path: '/my-engine-route'
        }
      }
    }
  };
};

• my-engine: 引擎的名称。
• enabled: 是否启用该引擎。
• routes: 定义引擎的路由和路径。

通过这些配置文件，可以灵活地配置和管理 Ember Engines 项目。

ember-enginesComposable Ember applications for ambitious user experiences项目地址:https://gitcode.com/gh_mirrors/em/ember-engines