corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

在 NetBeans IDE 中创建 Kenai 项目

本教程将演示如何使用 NetBeans IDE 在 Kenai 上创建项目。在 Kenai 上创建项目,即是创建一个有助于开发者协作开发项目的环境。一旦您成为项目成员,您便能够访问开发基础结构,包括源代码托管服务、问题跟踪以及各种帮助开发者保持联系的通信通道。Kenai 提供的许多服务完全集成在 NetBeans IDE 中,并且可直接从中访问。

通过 IDE 在 Kenai 上创建项目有两种方法,具体选择哪种方法创建项目在很大程度上取决于该项目的要求,以及当前您在开发周期中所处的阶段。如果您已经具有一个 NetBeans 项目,则可以使用“在 Kenai 上共享”向导在 Kenai 上为该项目创建一个项目;但是,如果您不具有任何源代码,则也可以在 Kenai 上创建项目。例如,您可能希望创建一个项目、捕获项目 wiki 上的项目要求、收集归档中的所需文件以进行下载,以及在开始编码前向项目添加成员。

创建项目后,其他开发者可在 Kenai 的项目页上查看有关该项目的详细信息,他们还可以打开该项目并从 IDE 中下载源代码。对于大多数项目,即使开发者不是项目成员,也可以查看源代码和项目页。任何有兴趣参与并协助开发某个项目的开发者都可申请添加为项目成员。项目管理员可从 Kenai 上的项目页添加成员并分配角色。

除了创建新项目以外,您还可以从 IDE 中打开任何 Kenai 项目并获取其源代码。对于大多数项目,即使您不是项目成员,也可以打开 Kenai 项目。有关详细信息,请参见在 NetBeans IDE 中打开 Kenai 项目

观看在 NetBeans IDE 中创建 Kenai 项目的视频

目录

本页上的内容适用于 NetBeans IDE 6.8 和 6.9

要学习本教程,您需要具备以下软件和资源。

软件或资源 要求的版本
NetBeans IDE 6.7 或 6.8
Java Development Kit (JDK) 版本 6 或版本 5

在开始学习本教程之前,您可能需要先阅读下面的 Kenai 文档。

在 Kenai 上创建帐户

要在 Kenai 上创建项目,必须首先在 Kenai.com 上创建一个帐户。您无法从 IDE 中创建帐户。

如果您已具有帐户,则可跳过此练习。

  1. 从主菜单中,选择“团队开发”>“登录至 Kenai”。
  2. 单击“立即注册”以在浏览器中打开 Kenai 注册页。

    或者,可以在浏览器中打开 https://kenai.com/people/new

    Kenai 登录对话框的屏幕快照
  3. 在浏览器的 Kenai 注册表单中输入帐户详细信息。单击 "Create Account"(创建帐户)。

    提交表单后,您将收到一封用于确认注册的电子邮件。

  4. 确认您的注册。

完成注册过程后,您便可以登录至 Kenai.com,并且通过单击左边栏中 "Profile"(个人资料)下的 "Edit My Profile"(编辑我的个人资料),可以修改您的个人资料。

有关编辑个人资料的详细信息,请观看 "Setting Up Your User Profile"(设置您的用户个人资料)截屏视频。您可以在 Kenai 帮助页的 "Screencasts & Tutorials"(截屏视频和教程)下找到所列的截屏视频。

登录至 Kenai

在 Kenai 上具有帐户后,可以直接从 IDE 进行登录。

  1. 选择“团队开发”> "Kenai" >“登录至 Kenai”以打开登录对话框。

    或者,也可以通过单击 "Kenai" 控制板(主菜单中的“窗口”>“Kenai 控制板”)中的“登录至 Kenai”打开登录对话框。

  2. 输入您的用户名和口令。
  3. (可选)选择“联机聊天”还会登录到聊天服务器。
  4. 单击“登录”。

单击“登录”后,IDE 中随即会打开 "Kenai" 控制板。"Kenai" 控制板将显示打开的 Kenai 项目,并且您还可以在其中轻松地解决项目问题和下载项目源代码。

在 Kenai 上创建项目

在 Kenai 上创建项目时,您不只是在为源代码创建一个版本控制资源库。对于每个项目,Kenai 提供了开发项目(尤其是很多人协作开发的项目)所需的重要资源和服务。每个人都是项目的成员,成员可具有不同的角色。一些成员会是开发者,但还有一些成员可能会负责设计用户界面、测试质量、编写文档、管理生成周期等。Kenai 项目可帮助所有项目成员在项目开发过程中保持联系并收到及时通知。

开发项目有几种不同的方法。在某些情况下,特别是从头开始开发某个项目时,您可能希望先设置项目基础结构,然后再开始任何编码工作。而在另外一些情况下,项目可能已开始开发,并且已编写一些代码,但随着项目规模有所扩大,需要再加入一些成员来共同开发项目。

注意:Kenai 上的项目是可公开的,且受项目许可证和 Kenai 使用条款的保护。

创建新的 Kenai 项目

可以使用 IDE 中的“新建 Kenai 项目”向导在 Kenai.com 上创建项目。可以为具有源代码的现有本地项目创建 Kenai 项目,但也可以创建没有源代码的项目,或者以后修改创建的项目以添加服务,如资源库或问题跟踪器。

如果选择创建资源库,将会共享单个 NetBeans 项目,并自动将该项目的根文件夹初始化为本地 Subversion 资源库的根文件夹。

此练习将介绍在无可用的 NetBeans 项目,或未准备好向远程资源库中添加源代码时,如何在 Kenai 上创建新项目。您可以先创建项目并开始使用 Kenai 服务,准备好后再提交源代码。

注意:无法使用“新建 Kenai 项目”向导将 NetBeans 项目添加到现有资源库中。

IDE 将执行以下任务。

  • 在 Kenai 上创建项目
  • 为项目创建问题跟踪器
  • 创建远程资源库
  • 将项目源代码提交到远程资源库(可选)
  • 初始化本地资源库目录
  • 为项目创建聊天室

要在 Kenai 上创建项目,请执行以下步骤。

  1. 登录至 Kenai(如果尚未登录)。
  2. 从主菜单中选择“团队开发”> "Kenai" >“新建 Kenai 项目”。

    要为 NetBeans 项目创建 Kenai 项目,请在“项目”窗口中打开 NetBeans 项目,右键单击项目节点,然后选择“在 Kenai 上共享”。“新建 Kenai 项目”向导将包含 NetBeans 项目的位置。

  3. 检查项目位置是否正确。
  4. 键入 Kenai 项目名称。

    在 Kenai.com 上生成项目页时,将使用该项目名称。缺省情况下,IDE 将使用 NetBeans 项目的名称。

  5. 键入项目标题。

    项目标题是在 Kenai.com 和 IDE 的项目页上所显示的名称。

  6. 键入项目描述(可选)。
  7. 选择一个项目许可证。单击“下一步”。

    您必须选择一个许可证,但稍后可更改该许可证。参与并协助开发项目的成员还必须同意该项目许可证的条款。

    “在 Kenai 上共享本地项目”向导第一个面板的屏幕快照
  8. 选择项目的资源库类型和名称以附加到资源库。

    IDE 集成了对 Subversion 和 Mercurial 的支持。如果项目没有任何源代码,则可以从下拉列表中选择“无”。以后,可以在 Kenai.com 上的项目页中创建资源库。

  9. 为本地资源库指定一个位置。

    资源库的位置必须是一个空目录。

  10. 指定要添加到资源库中的任何项目或文件夹。
  11. (可选)选中“立即将源代码提交到资源库”。

    如果选中此选项,单击“完成”后,IDE 会将源代码添加到远程资源库中。如果项目源代码较多,此过程可能需要花费一段时间。

    “在 Kenai 上共享本地项目”向导第一个面板的屏幕快照
  12. 选择一个问题跟踪系统。单击“下一步”。
  13. 查看摘要。单击“完成”。

在单击“完成”时,IDE 将在 Kenai 上创建项目,并将该项目添加到 "Kenai" 控制板上的“我的项目”下的列表中。

在您创建项目时,系统会自动将您添加为具有管理员角色的项目成员。

"Kenai" 控制板中的“我的项目”的屏幕快照

所有已加入的项目将在 "Kenai" 控制板中的“我的项目”下列出。要查看有关该项目的其他详细信息,请单击“打开”图标以在“打开的项目”下打开项目。

"Kenai" 控制板中的打开项目的屏幕快照

可以在“打开的项目”下展开项目节点,以了解项目问题和消息的概要信息。

提交源代码

Kenai 提供了 Subversion 和 Mercurial 版本控制资源库,作为托管项目可用的一项服务。如果选择在“新建 Kenai 项目”向导中为本地 NetBeans 项目创建资源库,项目的源代码现在将受版本控制。如果您创建了新项目,则可以开始将源代码添加到在向导中指定的本地资源库中。当源代码位于本地资源库时,IDE 会对此进行识别,并且您可以从“项目”、“文件”和“收藏夹”窗口中执行版本控制任务。

有关 Kenai 对版本控制系统的支持的详细信息,请参见 Source Code Management(源代码管理)中的 Kenai 文档。

此练习将演示如何向 Kenai 上的远程 Subversion 资源库提交文件。

  1. 在 IDE 中打开“项目”窗口。
    “项目”窗口和已标记文件的屏幕快照

    对于资源库而言属于新文件的源文件名称以绿色显示。目录上的标记指示目录中包含需要提交的文件。

  2. 右键单击要提交至资源库的文件或目录,然后选择 "Subversion" >“提交”。
  3. 在“提交”对话框中输入一条描述提交的消息。单击“提交”。
    “提交”对话框的屏幕快照

    如果您要提交的内容与某个特定问题有关,则可以在“提交”对话框中标识该问题,方法是打开“更新问题”面板,然后指定问题跟踪器和问题 id。可以选择“解析为 FIXED”以将问题的状态更改为 "RESOLVED"。

    在“提交”对话框中更新问题的屏幕快照

有关在 NetBeans IDE 中使用 Subversion 的详细信息,请参见 Guided Tour of Subversion(Subversion 指导教程)。

管理项目设置

在 Kenai 上创建项目时,系统将自动为您分配项目管理员角色。项目管理员可以修改项目详细信息(如项目标题和许可证)和配置针对项目所启用的 Kenai 功能。

Kenai 上的每个项目都有一个项目页,管理员可在项目页中管理项目设置。您无法在 IDE 中编辑设置,但可以通过在 "Kenai" 控制板中单击项目的“详细信息”链接,在浏览器中打开项目页。要编辑项目设置,您需要登录至 Kenai.com。

有关更多详细信息,请参见下面的 Kenai.com 文档:

向项目中添加成员

项目管理员可以向项目中添加成员,并为每个成员分配一个角色。管理员可将任何已注册的 Kenai 用户作为成员添加到项目中。

Kenai 用户可通过将任何项目加入书签而成为该项目的成员。将某个项目加入书签的用户将作为具有观察者角色的成员添加到该项目中。

有关不同角色的定义,请参见 Kenai 文档 Members Tab(“成员”标签)。

要向项目中添加成员,请执行以下步骤。

  1. 在 "Kenai" 控制板中单击项目名称旁边的“详细信息”,以打开 Kenai.com 上的项目页。
  2. 单击项目页上的 "Manage This Project"(管理此项目)
    Kenai 上项目页的屏幕快照
  3. 单击 "Members"(成员)标签,以查看项目成员列表。
  4. 单击 "Add Member"(添加成员)。输入 Kenai 用户名,然后从 "Role"(角色)下拉列表中选择一个角色。单击 "ADD"(添加)。
    Kenai 上项目成员页的屏幕快照

    当成员的参与级别改变时,管理员可更改项目成员的角色,方法是单击成员名称旁边的 "edit"(编辑),然后从 "Role"(角色)下拉列表中选择一个角色。管理员还可以修改分配给每个角色的缺省权限。

    在 Kenai 上向项目添加成员的屏幕快照

设置角色权限

已注册(和未注册)Kenai 用户对每个项目功能所具有的访问权限级别由分配给角色的权限来决定。项目管理员可以通过为每个成员分配一个角色来控制项目成员的权限。对于每个功能,管理员也可以修改分配给每个角色的缺省权限。

有关如何配置项目功能和角色的更多详细信息,请参见下面的 Kenai 文档:

在 "Features"(功能)标签中,可以针对项目的每个可用 Kenai 功能为角色分配权限。

  1. 在 "Kenai" 控制板中单击项目名称旁边的“详细信息”,以打开 Kenai.com 上的项目页。
  2. 单击项目页上的 "Manage This Project"(管理此项目)
  3. 单击 "Features"(功能)标签,以查看项目可用的 Kenai 功能列表。
  4. 对于要修改的功能,单击其旁边的 "More"(更多),然后选择 "Set Role Permissions"(设置角色权限)
    项目页 "Features"(功能)标签的屏幕快照
  5. 在显示的表中选中相应的复选框,以关联权限和角色。
    版本控制权限/角色表的屏幕快照

另请参见

有关在协作环境中使用 NetBeans IDE 的其他信息,请参见以下教程。