日期:2014-05-16  浏览次数:20408 次

Cordova CLI源码分析(二)——package.json

每个包需要在其顶层目录下包含一个package.json文件,该文件不仅是包的说明,也影响npm安装包时的配置选项

  更多参数详见参考文档https://npmjs.org/doc/json.html 

{
  "name": "cordova",
  "version": "3.0.4",
  "preferGlobal": "true",//如果安装包是作为命令行应用程序,应该全局模式安装,如果用户使用本地模式安装,则警告提醒
  "description": "Cordova command line interface tool",
  "main": "cordova",
  //表示Node.js在调用某个模块的时候,将寻找main指向的路径作为模块的接口,在这里Node将寻找同目录下的cordova文件,并尝试从它那加载模块;
  //如果没有cordova,Node还是会尝试寻找cordova.js或者cordova.node作为包的接口。
  //相当于这是初始化函数,返回此文件中export的对象内容
  "engines":{
      "node":">=0.9.9"
      //指定使用node的版本
  },
  "engineStrict":true,
//如果确定模块只能能在engines 参数指定的版本正常工作,则设置此参数
  "bin": {
  "cordova": "./bin/cordova"
  //用户在命令行输入时,解析参数执行此文件
cordova文件
#!/usr/bin/env node
var CLI = require('../src/cli');
new CLI(process.argv);


  },
  "scripts": {
  "test": "jasmine-node --color spec"
//存储一些默认运行命令脚本信息
  //cordova test 执行 jasmine-node --color spec
  },
  "repository": {
    "type": "git",
  "url": "https://git-wip-us.apache.org/repos/asf/cordova-cli.git"
  // 存储位置
  },
  "bugs":{
    "url" : "https://issues.apache.org/jira/browse/CB",
    "email" : "dev@cordova.apache.org"
  },
  "keywords": [
    "cordova",
    "client",
    "cli"
  ],
  "dependencies": {
    "colors":">=0.6.0",
    "elementtree":"0.1.3",
    "plugman":"0.10.0",
    "plist":"0.4.x",
    "xcode":"0.5.1",
    "express":"3.0.0",
    "shelljs":"0.1.2",
    "ncallbacks":"1.0.0",
    "request":"2.22.0",
    "ripple-emulator":"0.9.18",
    "semver":"1.1.0",
    "glob":"3.2.x",
    "follow-redirects":"0.0.x",
    "prompt":"0.2.7",
    "tar":"0.1.x",
    "open": "0.0.3",
    "npm":"1.3.x",
    "optimist":"0.6.0"
  },
/*依赖模块列表
version 版本号必须精确匹配
>version 必须大于当前版本号
>=version 必须大于等于
<version   小于
<=version  小于等于
~1.2.3 := >=1.2.3-0 <1.3.0-0  1.3.0-beta 不满足 ~1.2.3支持条件
~1.2 := >=1.2.0-0 <1.3.0-0 以1.2开始的版本
1.2.x := >=1.2.0-0 <1.3.0-0 以1.2开始的版本
~1 := >=1.0.0-0 <2.0.0-0 以1开始的版本
1.x := >=1.0.0-0 <2.0.0-0 以1开始的版本
1.2.x 1.2.0, 1.2.1,等,不超过 1.3.0
http://... 见链接地址
* 匹配任意版本
"" 匹配任意版本
version1 - version2 等价于 >=version1 <=version2.
range1 || range2 range1 或 range2均可
git... 见git地址
user/repo见 'GitHub ' 地址
*/
  "devDependencies": {
    "jasmine-node":"1.8.x"
  },
   / /开发阶段使用的模块,在用户使用时不需要依赖的模块
  "author": "Anis Kadri",
//开发者
  "contributors": [
    {"name": "Brian LeRoux","email": "b@brian.io"},
    {"name": "Fil Maj", "email": "maj.fil@gmail.com"},
    {"name": "Mike Reinstein", "email":"reinstein.mike@gmail.com"},
    {"name": "Darry Pogue", "email":"darryl@dpogue.ca"},
    {"name":