Meteor package.js

在本章中，我们将学习如何创建自己的 meteor 包。

创建包

让我们添加在桌面上的新文件夹用来创建新的包。使用命令提示符窗口执行如下命令。

C:\Users\Administrator\Desktop\meteorApp> mkdir packages 

现在我们可以在上面创建的文件夹中创建你的包。运行命令提示符运行以下命令。Username 是您的 Meteor 开发者的用户名和package-name是你的包的名称。

C:\Users\Administrator\Desktop\meteorApp\packages>meteor create --package username:package-name

添加包

为了能够本地包添加到我们的应用程序，需要设置环境变量(ENVIRONMENT VARIABLE)，将告诉 meteor 从本地文件夹加载包。右键单击"计算机"图标，然后选择属性/高级系统设置/环境变量/新建。

变量名应该是PACKAGE_DIR变量值路径应该是指向创建的文件夹。在我们的示例中是：C:\Users\Administrator\Desktop\meteorApp\packages.

注意：不要忘记在添加新的环境变量后重新启动命令提示符。

现在，我们可以运行下面的代码将包添加到我们的应用程序-

C:\Users\Administrator\Desktop\meteorApp>meteor add username:package-name

包文件

如果打开创建软件包的文件夹，你会看到四个文件。

• package-name-test.js
• package-name.js
• package.js
• README.md

测试包(package-name-test.js)

Meteor 提供 tinytest 包用于测试。让我们先从命令提示符窗口来安装它。

C:\Users\Adminitrator\Desktop\meteorApp>meteor add tinytest

如果你打开 package-name-test.js, 你会看到默认的测试例子。我们将用这个例子来测试应用程序。开发 Meteor 包时，你应该要写写自己的测试。

要测试包，需要运行在命令提示符下此代码。

 C:\Users\Administrator\Desktop>meteor test-packages packages/package-name

你应该得到以下结果。

package.js文件

我们可以在这个文件中编写代码。现在我们在包中实现一些简单的功能。包将日志记录一些文本到控制台。

packages/package.js

myPackageFunction = function() {
   console.log('This is simple package...');
}

package-name.js文件

这是我们可以设定一些程序包配置文件。 我们一会再回到它，但现在需要导出myPackageFunction，就可以在应用程序中使用它了。我们需要添加这些到 Package.onUse 函数内。该文件将是这个样子。

packages/package-name.js

Package.describe({
   name: 'username:package-name',
   version: '0.0.1',
   // Brief, one-line summary of the package.
   summary: '',
   // URL to the Git repository containing the source code for this package.
   git: '',
   // By default, Meteor will default to using README.md for documentation.
   // To avoid submitting documentation, set this field to null.
   documentation: 'README.md'
});

Package.onUse(function(api) {
   api.versionsFrom('1.2.1');
   api.use('ecmascript');
   api.addFiles('mypackage.js');
   api.export('myPackageFunction'); // We are exporting the function we created above...
});

Package.onTest(function(api) {
   api.use('ecmascript');
   api.use('tinytest');
   api.use('username:package-name');
   api.addFiles('package-name-tests.js');
});

使用软件包

现在，我们终于可以从 app.js 文件调用myPackageFunction()函数了。

packages/package.js

if(Meteor.isClient) {
   myPackageFunction();
}

控制台将日志记录包中的文本，其结果如下：

为了更好地理解package.js文件如何配置，我们将使用Meteor 官方文档的例子。

这是一个例子文件...看看一就知道了

/* Information about this package */
Package.describe({
   // Short two-sentence summary.
   summary: "What this does",
   // Version number.
   version: "1.0.0",
   // Optional.  Default is package directory name.
   name: "username:package-name",
   // Optional github URL to your source repository.
   git: "https://github.com/something/something.git",
});

/* This defines your actual package */
Package.onUse(function (api) {
   // If no version is specified for an 'api.use' dependency, use the
   // one defined in Meteor 0.9.0.
   api.versionsFrom('0.9.0');
   // Use Underscore package, but only on the server.
   // Version not specified, so it will be as of Meteor 0.9.0.
   api.use('underscore', 'server');
   // Use iron:router package, version 1.0.0 or newer.
   api.use('iron:router@1.0.0');
   // Give users of this package access to the Templating package.
   api.imply('templating')
   // Export the object 'Email' to packages or apps that use this package.
   api.export('Email', 'server');
   // Specify the source code for the package.
   api.addFiles('email.js', 'server');
});

/* This defines the tests for the package */
Package.onTest(function (api) {
   // Sets up a dependency on this package
   api.use('username:package-name');
   // Allows you to use the 'tinytest' framework
   api.use('tinytest@1.0.0');
   // Specify the source code for the package tests
   api.addFiles('email_tests.js', 'server');
});

/* This lets you use npm packages in your package*/
Npm.depends({
   simplesmtp: "0.3.10",
   "stream-buffers": "0.2.5"
});