原文链接:http://blog.csdn.net/zeping891103/article/details/50786259
原谅原版链接:https://github.com/nwjs/nw.js/wiki/Using-Node-modules
在Node.js中有三种模块类型:
1)内部模块(部分Node API)
2)用JavaScript写的第三方模块
3)C/C++插件的第三方模块
这些所有的模块类型,都在会在node-webkit中使用到。你可以在Node's wiki中找到很多这方面的资料和开源代码。
如
https://github.com/nodejs/node-v0.x-archive/wiki/Modules
https://www.npmjs.com/
(一)Internal modules(内部模块)
内部模块的Node.js同样可以在node-webkit中直接使用,详细请查看Node.js的API:
https://nodejs.org/docs/latest/api/
例如,你可以使用var fs = require('fs')直接启动Node.js的File System的API:
https://nodejs.org/docs/latest/api/fs.html
例如,你可以直接使用 the process 模块(没有任何require(....))。然而,建议使用Node.js的API尽量使用require(....)语句来调用,如the process 模块使用为require(process)。
(注):当前,Node.js API 和在node-webkit的Node.js还是有些区别的,可以参考:
https://github.com/nwjs/nw.js/wiki/Changes-related-to-node
(注):Node.js API参考如下:
https://nodejs.org/docs/latest/api/
(二)3rd party JavaScript modules(用JavaScript写的第三方模块)
如果第三方模块用纯JavaScript写,即不包含任何C/C++插件代码,那么这个模块也node-webkit中同样也可以使用Node内部模块(require(...))。但这里需要重点注意一个问题:
想要使用JavaScript编写的第三方模块,你的应用的根目录必须有一个命名为node_modules的文件夹,该文件夹为node-webkit默认使用JavaScript写的第三方模块使用目录。假设有个第三方JavaScript模块名为a_modules,有两种调用方法:
1)如果使用require(a_modules)的方法调用,则无需添加任何导入语句。
2)如果使用像jQuery的方法调用,如a_modules.(...),则需要添加导入语句<script src="..."> 。
下面我们主要介绍第一种调用情况,因为该调用方法可以很好地隐藏了调用的相对地址,而且会更加便捷。
(1)将已经嵌入到node-webkit的内部模块代码获取至源码根目录的node_modules文件夹
这种方法可以让开发者阅读到内部模块的源码及对其进行扩展。下面以内部模块之一的async为例。正常情况下,我们在无需添加导入语句,即可使用async,只需调用如下语句:
- var async = require('async');
下面我们将介绍如何获取async的类库源码,以下为Windows系统环境为例:
只需调用命令行即可
- cd /path/to/your/app
- npm install async
这样你就可以获取该类库源码,源码位置在你的项目根目录node_modules的文件夹
- .
- ./package.json
- ./index.html
- ./node_modules
- ./node_modules/async
- ./node_modules/async/.gitmodules
- ./node_modules/async/package.json
- ./node_modules/async/Makefile
- ./node_modules/async/LICENSE
- ./node_modules/async/README.md
- ./node_modules/async/.npmignore
- ./node_modules/async/lib
- ./node_modules/async/lib/async.js
- ./node_modules/async/index.js
这时候你就可以查阅并扩展async模块。
(注):博主不建议随意扩展官方已提供的内部模块,但可以扩充内部模块。
(2)使用第三方或自己编写的类库,扩充内部模块。
假设你有一个类库yy库,你想在你的应用中可以使用require(yy)的方法进行调用,内部扩充了一个yy库,该如何做呢?
1)在你的项目根目录下新建文件夹node_modules,在该文件夹中新建yy文件夹,作为你调用的yy库的地址。
dist目录和lib目录下的yy.js就是你要编写的yy库的源码文件,而yy库下package.json文件则是yy库的配置文件。
2)yy.js编写的代码格式如下:
- (function() {
- var yy = {};
- yy.hello = function() {
- return "hello";
- };
- // Establish the root object, `window` (`self`) in the browser, `global`
- // on the server, or `this` in some virtual machines. We use `self`
- // instead of `window` for `WebWorker` support.
- var root = typeof self === 'object' && self.self === self && self ||
- typeof global === 'object' && global.global === global && global ||
- this;
- // Node.js
- if (typeof module === 'object' && module.exports) {
- module.exports = yy;
- }
- // AMD / RequireJS
- else if (typeof define === 'function' && define.amd) {
- define([], function() {
- return yy;
- });
- }
- // included directly via <script> tag
- else {
- root.yy = yy;
- }
- }());
3)yy库下package.json文件内容如下:
- {
- "name": "yy",
- "description": "yy lib",
- "main": "lib/yy.js",
- "files": [
- "lib",
- "dist/yy.js"
- ]
- }
这样你就可以在你的应用中使用yy库
(三)3rd party modules with C/C++ addons(C/C++插件的第三方模块)
这块内容较为复杂,对于一般的开发者也比较少用,同时由于博主对C/C++不是很熟悉,待有空时重新捡起C/C++,再做补充。如需要了解的开发者仍可以阅读如下地址:
https://github.com/nwjs/nw.js/wiki/Using-Node-modules