nodejs npm package.json中文文档

2020-06-17 05:45:27易采站长站整理

  , “qux” : “<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0”
  , “asd” : “http://asdf.com/asdf.tar.gz”
  , “til” : “~1.2”
  , “elf” : “~1.2.3”
  , “two” : “2.x”
  , “thr” : “3.3.x”
  }
}

依赖URL

可以指定一个tarball URL,这个tarball将在包被初始化的时候下载并初始化。

依赖Git URL

Git urls 可以是下面几种形式:

git://github.com/user/project.git#commit-ish
git+ssh://user@hostname:project.git#commit-ish
git+ssh://user@hostname/project.git#commit-ish
git+http://user@hostname/project/blah.git#commit-ish
git+https://user@hostname/project/blah.git#commit-ish
commit-ish是可以被git checkout的任何tag、sha或者branch。默认为master。

GitHub URLs

1.1.65版后,你可以仅仅用“user/foo-project”引用GitHub urls,比如:

{
  “name”: “foo”,
  “version”: “0.0.0”,
  “dependencies”: {
    “express”: “visionmedia/express”
  }
}

devDependencies

如果有人计划在他们的程序中下载并使用你的模块,那么他们可能不想或者不需要去下载并构建你使用的外部测试或者文档框架。

在这种情况下,它最好把这些附属的项目列示在devDependencies hash中。

这些东西会在根目录执行npm link或者npm install的时候初始化,并可以像其他npm配置参数一样管理。详见npm-config(7)。

对于非特定平台的构建步骤,比如编译CoffeeScript或者其他语言到Javascript,用prepublish脚本去实现并把他放在devDependency中。

比如:

{ “name”: “ethopia-waza”,
  “description”: “a delightfully fruity coffee varietal”,
  “version”: “1.2.3”,
  “devDependencies”: {
    “coffee-script”: “~1.6.3”
  },
  “scripts”: {
    “prepublish”: “coffee -o lib/ -c src/waza.coffee”
  },
  “main”: “lib/waza.js”
}

prepublish脚本会在publishing前运行,这样用户就不用自己去require来编译就能使用。并且在开发模式中(比如本地运行npm install)会运行这个脚本以便更好地测试。

peerDependencies

在一些场景中,如在一个host中不必须进行require时候,你想表现你的package与一个host工具或者库的兼容关键。这一般用来引用插件。尤其是你的模块可能要暴露一个特定的接口,并由host文档来预期和指定。