# @xiyun/xy-plugin-block-dev

> #### 简介

Latest version **1.3.15** (published 2019-10-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install @xiyun/xy-plugin-block-dev
pnpm add @xiyun/xy-plugin-block-dev
yarn add @xiyun/xy-plugin-block-dev
bun add @xiyun/xy-plugin-block-dev
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.3.15 |
| Published | 2019-10-22 |
| First published | 2019-10-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 19 |
| Unpacked size | 25.7 KB |
| Known vulnerabilities | 0 (+7 in 2 direct dependencies) |
| Install scripts | no |
| Maintainers | changwenxia, huqq123, iamalisa, kybetter, wubaiqing |

## Links

- npm: https://www.npmjs.com/package/@xiyun/xy-plugin-block-dev
- npm.io page: https://npm.io/package/@xiyun/xy-plugin-block-dev

## Dependencies (19)

- [less](https://npm.io/package/less.md) ^3.10.3
- [assert](https://npm.io/package/assert.md) ^2.0.0
- [core-js](https://npm.io/package/core-js.md) ^3.2.1
- [webpack](https://npm.io/package/webpack.md) ^4.41.0
- [css-loader](https://npm.io/package/css-loader.md) ^3.2.0
- [url-loader](https://npm.io/package/url-loader.md) ^2.2.0
- [vue-loader](https://npm.io/package/vue-loader.md) ^15.7.1
- [file-loader](https://npm.io/package/file-loader.md) ^4.2.0
- [less-loader](https://npm.io/package/less-loader.md) ^5.0.0
- [style-loader](https://npm.io/package/style-loader.md) ^1.0.0
- [webpack-merge](https://npm.io/package/webpack-merge.md) ^4.2.2
- [ant-design-vue](https://npm.io/package/ant-design-vue.md) ^1.3.17
- [@vue/cli-service](https://npm.io/package/@vue/cli-service.md) ^3.12.0
- [vue-style-loader](https://npm.io/package/vue-style-loader.md) ^4.1.2
- [webpack-dev-server](https://npm.io/package/webpack-dev-server.md) ^3.8.2
- [html-webpack-plugin](https://npm.io/package/html-webpack-plugin.md) ^3.2.0
- [@vue/cli-plugin-babel](https://npm.io/package/@vue/cli-plugin-babel.md) ^3.12.0
- [vue-template-compiler](https://npm.io/package/vue-template-compiler.md) ^2.6.10
- [html-webpack-tags-plugin](https://npm.io/package/html-webpack-tags-plugin.md) ^2.0.17

## Recent versions

- 1.3.15 (latest) — 2019-10-22
- 1.3.7 — 2019-10-17
- 1.3.6 — 2019-10-16
- 1.3.5 — 2019-10-15
- 1.3.4 — 2019-10-15
- 1.3.3 — 2019-10-14
- 1.3.2 — 2019-10-14
- 1.3.1 — 2019-10-14
- 1.3.0 — 2019-10-14
- 1.0.0 — 2019-10-14

## README

# 禧云区块开发服务工具

#### 简介

区块开发服务工具是为了方便开发独立 Vue 组件使用的，运行该命令后，会开启一个开发环境服务，并渲染你提供的组件，非常方便。

![screenshot](./block-dev.gif)

本环境默认提供了以下这些资源，你可以在组件中使用：
- ant-design-vue 默认提供的全局 UI 组件，你无需额外引入即可使用，可被选项和配置文件覆盖。
- lodash 
- moment
- less

#### 使用方法
```bash
$ xy block-dev [options] <vue-file>
```

#### 选项参考

- `--port <8080>` 端口配置，默认 8080
- `--config <config-file>` 指定资源配置文件，优先级最高
- `--antd` 使用 ant-design-vue 组件资源，不定期维护版本
- `--element` 使用 element-ui 组件资源，不定期维护版本
- `--vant` 使用 vant-ui 组件资源，不定期维护版本

#### 配置文件

如果你想要使用没有默认提供的资源，你可以使用配置文件的方式来引入。

首先，在执行命令的当前目录下创建一个名为`xy.config.js`的文件，我们将在这个文件里面写入资源配置项：

假设我们要引入`element-ui`和`echarts`：
```js
// xy.config.js 文件内容：
module.exports = {
  resources: [
    {
      // 在项目中使用 import 时的名称
      importName: 'element-ui',
      // 暴露出来的全局变量名
      globalVar: 'Element',
      // js
      jsUrl: 'https://unpkg.com/element-ui/lib/index.js',
      // css
      cssUrl: 'https://unpkg.com/element-ui/lib/theme-chalk/index.css',
    },
    {
      importName: 'echarts',
      globalVar: 'echarts',
      jsUrl: 'https://cdn.bootcss.com/echarts/4.3.0/echarts.js',
    }
  ]
}
```

我们也提供了`package.json`文件的配置项支持：
```json
// package.json 文件内容：
"resources": [
    {
      "importName": "vant",
      "globalVar": "vant",
      "jsUrl": "https://cdn.jsdelivr.net/npm/vant@2.2/lib/vant.min.js",
      "cssUrl": "https://cdn.jsdelivr.net/npm/vant@2.2/lib/index.css"
    }
  ]
```

如果当前目录存在`xy.config.js`或`package.json`文件，那么会自动读取其中的配置，无需手动指定。

#### 资源配置项的优先顺序
`手动指定 --config <config-file>` > `xy.config.js` > `package.json` > `默认命令行选项：--element 等`

---
_Source: https://npm.io/package/@xiyun/xy-plugin-block-dev · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
