当前页面: 开发资料首页 → Netbeans 专题 → NetBeans Project Sample 模块教程

NetBeans Project Sample 模块教程

摘要: NetBeans Project Sample 模块教程反馈本教程演示如何创建包含技术项目示例的模块。拥有包含技术项目示例的模块之后，使用您的技术项目示例便更为容易，NetBeans IDE 5....

NetBeans Project Sample 模块教程

本教程演示如何创建包含技术项目示例的模块。拥有包含技术项目示例的模块之后，使用您的技术项目示例便更为容易，NetBeans IDE 5.0 允许您创建一个可以发送给其他人的二进制文件，然后其他人通过 Update Center 来安装。将该模块安装到 IDE 中之后，在 New Project 向导中便可以使用这些项目示例。

本教程将介绍以下主题：

安装软件
创建模块项目
将示例应用程序打包
构建和安装模块

注意： 如果项目示例依赖于外部的 JAR 文件和 Javadoc，您可以将它们打包到包含项目示例的模块中。很容易做到这一点。有关详细信息，请参阅 NetBeans Project Template 模块教程。

安装完软件之后，本教程可以在 20 分钟之内完成。

有关使用 NetBeans 模块的详细信息，请参阅 NetBeans 网站上的 NetBeans Development Project 主页。如果有问题，请访问 NetBeans Developer FAQ 或使用本页顶部的反馈链接。

安装软件

开始之前，需要在您的计算机上安装以下软件：

NetBeans IDE 5.0（下载）
Java Standard Development Kit (JDK!") version 1.4.2（下载）或 5.0（下载）

创建模块项目

选择 File > New Project (Ctrl-Shift-N)。在 Categories 下，选择 NetBeans Plug-in Modules。在 Projects 下，选择 Module Project 并单击 Next。
在 Name and Location 面板中，在 Project Name 中键入 AdditionalSamples。将 Project Location 更改为您计算机上的任何目录，如 c:\mymodules。选中 Standalone Module 单选按钮和 Set as Main Project 复选框。现在该面板应该如下所示：

单击 Next。
在 Basic Module Configuration 面板中，用 myorg 替换 Code Name Base 中的 yourorghere，从而整个 Code Name Base 为 org.myorg.additionalsamples。向默认的 Module Display Name 中添加空格，将它更改为 Additional Samples。留出本地化包和 XML 层的位置，以便它们存储在名为 org/myorg/additionalsamples 的包中。该面板应该如下所示：
单击 Finish。

IDE 创建 Additional Samples 项目。该项目包含所有资源和项目元数据，如该项目的 Ant 构建脚本。该项目在 IDE 中打开。您可以在 Projects 窗口 (Ctrl-1) 中查看其逻辑结构，在 Files 窗口 (Ctrl-2) 中查看其文件结构。例如，现在 Projects 窗口应该如下所示：

有关以上每个文件的基本信息，请参阅 NetBeans 插件模块的快速入门指南。

将示例应用程序打包

右键单击项目节点并选择 New > File/Folder。在 Categories 下，选择 NetBeans Module Development。在 Projects 下选择 Project Template。单击 Next。
在 Select Project 面板中，选择您要打包为示例的项目，如下所示。

您可以使用使用 NetBeans IDE 5.0 开发 Web 应用程序快速入门指南创建项目，也可以从此处下载它。或者也可以使用一个自己的项目。
单击 Next。
在 Name and Location 面板中，键入 MyHelloWorldSample 作为模板名称，键入 Hello World Sample 作为显示名称，然后在 Category 下拉列表中选择 Samples|Web，如下所示：
单击 Finish。

IDE 执行以下操作：

创建包含您的项目的 ZIP 文件
提供一个 Java 面板和一个在 New Project 向导中用来创建示例的迭代程序
为在 New Project 向导中显示的描述提供一个 HTML 文件
在 XML 层文件中注册示例
向 bundle.properties 文件中添加本地化字符串

现在 Projects 窗口应该显示如下：

构建和安装模块

IDE 使用 Ant 构建脚本来构建和安装您的模块。构建脚本是创建模块项目时为您创建的。

安装 NetBeans 模块

在 Projects 窗口，右键单击 Additional Samples 项目并在 Target Platform 中选择 Install/Reload。
模块即在目标 IDE 或平台中构建和安装。目标 IDE 或平台打开，您可以试用新的模块。默认目标 IDE 或平台是由开发 IDE 的当前实例使用的安装平台。注意到当您运行模块时，您将使用临时测试用户目录，而不是开发 IDE 的用户目录。

使用 NetBeans 模块

选择 File > New Project (Ctrl-Shift-N)。
将打开 New Project 向导并显示新项目示例：
选择新项目示例，然后单击 Next。将出现向导面板：

在项目名称字段中键入一个名称。
单击 Finish。IDE 打开并显示新创建的项目示例。

创建可共享的模块二进制文件

在 Projects 窗口中，右键单击 Additional Samples 项目，并选择 Create NBM。
将创建 NBM 文件并且可以在 Files 窗口中查看它 (Ctrl-2)：
通过电子邮件使其他人也可以使用。

下一步

有关创建和开发 NetBeans 模块的更多信息，请参见以下资源：

版本控制

版本

日期

更改

1 2005 年 7 月 9 日初始版本

2 2005 年 7 月 10 日
添加了 org.netbeans.modules.java.examples.J2SESampleProjectIterator 向导作为可选项 -- 不如 Web 向导严格。
扩展了解压缩项目示例的 Ant 脚本，因此现在它排除了构建、dist 和 nbproject/私人文件夹。

3 2005 年 8 月 23 日
由于 Project Template 向导的原因，完全重新编写了本教程。
问题：
什么是 Category 下拉列表？在将注册但尚未实现的示例的 New Project 向导中选择类别。
层文件指示没有 Bundle 文件存在，但是它确实存在。

待办事项：
添加有关每个创建的文件的详细信息（当前只有一个句子，应该扩展）。
解释所生成文件和获得的项目模板向导之间的关系。
添加一些后处理自定义步骤（例如，如何将不同类别的示例放置到 New Project 向导中）。
向每个部分添加介绍性的语句。
有关要添加的 XML 层文件的信息。

4 2005 年 10 月 1 日

阅读一遍本教程，熟悉现在的构建和调整。

没有大的变化（只是使用 Category 将示例放置在类别中）。
已创建 http://www.netbeans.org/issues/show_bug.cgi?id=65595。

待办事项：
添加有关每个创建的文件的详细信息（当前只有一个句子，应该扩展）。
解释所生成文件和获得的项目模板向导之间的关系。
添加一些后处理自定义步骤（例如，如何将不同类别的示例放置到 New Project 向导中）。
向每个部分添加介绍性的语句。
有关要添加的 XML 层文件的信息。

↑返回目录
前一篇: NetBeans Code Snippet Module 教程
后一篇: NetBeans Project Template 模块教程

版本	日期	更改
1	2005 年 7 月 9 日	初始版本
2	2005 年 7 月 10 日	添加了 `org.netbeans.modules.java.examples.J2SESampleProjectIterator` 向导作为可选项 -- 不如 Web 向导严格。扩展了解压缩项目示例的 Ant 脚本，因此现在它排除了构建、dist 和 nbproject/私人文件夹。
3	2005 年 8 月 23 日	由于 Project Template 向导的原因，完全重新编写了本教程。问题：什么是 Category 下拉列表？在将注册但尚未实现的示例的 New Project 向导中选择类别。层文件指示没有 Bundle 文件存在，但是它确实存在。待办事项：添加有关每个创建的文件的详细信息（当前只有一个句子，应该扩展）。解释所生成文件和获得的项目模板向导之间的关系。添加一些后处理自定义步骤（例如，如何将不同类别的示例放置到 New Project 向导中）。向每个部分添加介绍性的语句。有关要添加的 XML 层文件的信息。
4	2005 年 10 月 1 日	阅读一遍本教程，熟悉现在的构建和调整。没有大的变化（只是使用 Category 将示例放置在类别中）。已创建 http://www.netbeans.org/issues/show_bug.cgi?id=65595。待办事项：添加有关每个创建的文件的详细信息（当前只有一个句子，应该扩展）。解释所生成文件和获得的项目模板向导之间的关系。添加一些后处理自定义步骤（例如，如何将不同类别的示例放置到 New Project 向导中）。向每个部分添加介绍性的语句。有关要添加的 XML 层文件的信息。