seajs-packager

A spm2 plugin for building the seajs business modules

Get start

该spm2插件采用自定义的方式来打包业务模块。 基本的思想与chaos-build一致，就是将业务模块经过transport以及concat后，将文件使用md5值进行重命名，并通过seajs-config配置map，从而达到在使用时做require的映射转换。不过增加了一些自己的想法，即开发人员要对每个模块的暴露出来的对象以及它下面的子模块划分有一个清晰的认识，这个配置通过每个模块目录下的package.json文件来配置。

在dev环境开发时，我们希望页面上的js文件是原始的文件，即没有经过concat和minify过的，这时只要讲seajs.config的seajs.production = false即可。我们保持build出来的目录层级关系与开发时一致，从而可以轻松切换dev和production环境。

其模块组织方式类似与java的包管理，每个模块为单独一个目录，每个目录下面可以有一个package.json文件，定义该目录下需要暴露出的模块有哪些，并可以定义其下级子模块(使用modules配置)。比如有如下目录结构：

-- js\
    -- app\
        -- userCenter\
            -- base \
            -- blogs \
            -- users \
            auth.js
            package.json

package.json 如下:

{   
    "spm" : {
        "modules": [ "base", "blogs", "users" ],
        "output": {
            "relative": [ "auth.js" ]
        }
    }
}

上面的配置表明在目录下有base blogs users 3个子模块(每个模块下面可以在使用package.json进行配置), 并且该目录有auth.js需要编译，采用relative方式进行。

Install

确保已经安装了最新版本的Node.js

$ npm install spm -g
$ npm install seajs-packager -g

Usage

$ seajs-packager [dir] [options]

Options

• -C Sea.js的配置文件，默认为./seajs-config.js
• -O build输出目录, 默认为sea-modules
• -D 指定默认Sea.js的配置文件路径(.json), 比如一些alias， preload选项

0.0.1

• 初步实现功能