nw.js node-webkit系列（15）如何使用内部模块和第三方模块进行开发

原文链接：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，只需调用如下语句：

1. var async = require('async');

下面我们将介绍如何获取async的类库源码，以下为Windows系统环境为例：

只需调用命令行即可

1. cd /path/to/your/app
2. npm install async

这样你就可以获取该类库源码，源码位置在你的项目根目录node_modules的文件夹

1. .
2. ./package.json
3. ./index.html
4. ./node_modules
5. ./node_modules/async
6. ./node_modules/async/.gitmodules
7. ./node_modules/async/package.json
8. ./node_modules/async/Makefile
9. ./node_modules/async/LICENSE
10. ./node_modules/async/README.md
11. ./node_modules/async/.npmignore
12. ./node_modules/async/lib
13. ./node_modules/async/lib/async.js
14. ./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编写的代码格式如下：

1. (function() {
2. var yy = {};
3. yy.hello = function() {
4. return "hello";
5. };
6. // Establish the root object, `window` (`self`) in the browser, `global`
7. // on the server, or `this` in some virtual machines. We use `self`
8. // instead of `window` for `WebWorker` support.
9. var root = typeof self === 'object' && self.self === self && self ||
10. typeof global === 'object' && global.global === global && global ||
11. this;
12. // Node.js
13. if (typeof module === 'object' && module.exports) {
14. module.exports = yy;
15. }
16. // AMD / RequireJS
17. else if (typeof define === 'function' && define.amd) {
18. define([], function() {
19. return yy;
20. });
21. }
22. // included directly via <script> tag
23. else {
24. root.yy = yy;
25. }
26. }());

3）yy库下package.json文件内容如下：

1. {
2. "name": "yy",
3. "description": "yy lib",
4. "main": "lib/yy.js",
5. "files": [
6. "lib",
7. "dist/yy.js"
8. ]
9. }

这样你就可以在你的应用中使用yy库

1. <script>
2. var yy = require('yy');
3. console.log(yy.hello());
4. </script>

（三）3rd party modules with C/C++ addons（C/C++插件的第三方模块）

这块内容较为复杂，对于一般的开发者也比较少用，同时由于博主对C/C++不是很熟悉，待有空时重新捡起C/C++，再做补充。如需要了解的开发者仍可以阅读如下地址：

https://github.com/nwjs/nw.js/wiki/Using-Node-modules