# fis3-packager-map

**Repository Path**: mirrors_fex-team/fis3-packager-map

## Basic Information

- **Project Name**: fis3-packager-map
- **Description**: A packager plugin for fis to pack resources.
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

fis3-packager-map
=====================


fis3 中内嵌的打包工具。


## 配置方式

$ vi path/to/project/fis-conf.js

```javascript
fis.match('*.css', {
  packTo: '/pkg/all.css'
});

fis.match('*.js', {
  packTo: '/pkg/all.js'
});
```

或者：

```js
fis.match('::package', {
  packager: fis.plugin('map', {
    'pkg/all.js': [
      'libs/*.js',
      'widget/*.js'
    ]
  })
})
```
{'pkg/xxx': [...], ...} 的格式也可用于 fis.set("pack", ) 或 fis-pack.json 来设置。
```
规则优先级：

通过插件配置 > fis.set("pack", {}) > fis-pack.json > match( 'xxx' , {`packTo`})

## 配置项

1. `useTrack` 默认 `true`。 是否将合并前的文件路径写入注释中，方便定位代码。
2. `useSourceMap` 默认为 `false`。是否开启 souremap 功能。

### 关闭输出路径信息

默认打包后输出路径信息,便于调试.形式如下

```js
/*!/components/underscore/underscore.js*/
```

可以在插件的配置中关闭路径信息输出

```js
fis.match('::package', {
  packager: fis.plugin('map', {
    useTrack : false, // 是否输出路径信息,默认为 true
    'pkg/all.js': [
       'libs/*.js',
       'widget/*.js'
    ]
  })
})
```

### 开启 SourceMap 功能

```js
fis.match('::package', {
  packager: fis.plugin('map', {
    useSourceMap : true, // 合并后开启 SourceMap 功能。
    'pkg/all.js': [
       'libs/*.js',
       'widget/*.js'
    ]
  })
})
```

### 排除某个文件
顺序不可颠倒，必须在**规则里的文件里排除某个文件

```js
fis.match('::package', {
  packager: fis.plugin('map', {
    'pkg/all.js': [
       'libs/**.js',
       '!libs/external.js'
    ]
  })
})
```