我们通常通过 npm 来安装和使用开源的模块。但是，通常我们有些私有的模块，不想通过npm发布，但是又想在一些项目中共享使用，而且我们不想将公共模块是复制到各个项目中来使用。而且一旦公有模块更新，我们也不能及时更新。当然，如果不嫌麻烦，可以用相对目录，不过这种在开发代码时，引用时，写法上就要将相对目录写上。但是我们现在探讨的是另一种方式——利用现有的git，既不用搭建私有的npm私有仓库(npm private repository)，又能满足上面的需求，它做为一个快速解决方案, 后期是可以慢慢过渡升级到使用完整 npm 私有仓库的解决方案的.
打造一个完整的 npm 私有仓库, 需要服务器, 需要安装环境。后面会有文章单独介绍。
新建 npm 私有模块
下面以一个实例来说明如何在 GitLab 中新建一个 npm 私有模块, 假设我们要新建的私有模块名为: wave-test
在 GitLab 上新建一个 project, 名字为: wave-test
对于公共模块, 最好是放在同一个 group 下, 例如放在 wavesnows 这个 group 下. 那么以后所有公共模块的 git 地址就可以统一为:
http://git.your-inc.com/{group}/{project}.git
将项目 clone 下来
git clone http://git.your-inc.com/wavesnows/wave-test.git
添加 package.json 配置, 注意限定 @scope
npm init --scope=wavesnows
然后提交 push 上去
到这里私有模块就已经发布好了, 如果有项目要使用, 就配置下项目的 dependencies 即可.
使用私有模块
添加私有模块的依赖
在项目的 package.json 中添加依赖, 例如: 依赖 @wavesnows/wave-test 这个私有模块
"@wavesnows/wave-test": "git+http://git.your-inc.com/wavesnows/wave-test.git"
如果想固定依赖某个分支，可以加上分支的名字，比如分支branch1，
"@wavesnows/wave-test": "git+http://git.your-inc.com/wavesnows/wave-test.git#branch1"
安装私有模块
跟安装开源的模块一样, 使用 npm install 安装依赖即可. 私有模块会安装在 @scope 的子文件夹中, 例如:
node_modules/@wavesnows/wave-test
代码中使用私有模块
- 跟使用开源的模块一样, 我们只要写对应的包名即可. 私有模块的包名只是带有
@scope而已.
var wave = require('@wavesnows/wave-test');
// 另外一种引用方式
import WT from '@wavesnows/wave-test'
- 如果在使用webpack的项目中使用，我们还可以通过配置alias来简化代码中的写法
alias: {
'wave-test': '@wavesnows/wave-test'
}
在代码中就可以和引用其他module一样了
var wave = require('wave-test');
// 或者
import WT from 'wave-test'
如果alias中配置了
'@': resolve('src')我们在使用带有scope的模块的时候，如果不配置alias，
@可能会造成冲突，这个和webpack的>ModuleAliasPlugin的实现有关。'@': resolve('src'), 'wave-test': resolve('node_modules/@waevsnows/wave-test'), // 或者 'wave-test': '@wavesnows/wave-test',
更新私有模块
如果私有模块的版本更新了, 我们使用 npm update 是无法更新私有模块的, 只能通过
npm install @wavesnows/wave-test
这样的方式来重新安装一次私有模块, 才能获取到最新版本的私有模块.
私有模块的规范
-
package.json#name必须限定@scope
@scope 一般为 GitLab group 的名字, 例如 @companyfe, 那么 name 为: @wavesnows/wave-test
-
package.json#private设置为true防止你一不小心将私有模块发布上去
{
"name": "@wavesnow/wave-test",
"version": "0.0.1",
"description": "Wave Tools",
"main": "index.js",
"private": "true",
"repository": {
"type": "git",
"url": "http://git.your-inc.com/wavesnow/wave-test.git"
},
"keywords": [
"wave",
"git",
"tool",
"javescript"
],
"author": "wavesnow",
"license": "MIT"
}
参考
you can specify private git repositories urls as a dependency in your package.json files.
All private packages are scoped. If a package's name begins with
@, then it is a scoped package. The scope is everything in between the@and the slash.
When used in package names, scopes are preceded by an
@symbol and followed by a slash. Scopes are a way of grouping related packages together.
