Opening a Kenai Project in NetBeans IDE
This document demonstrates how to use NetBeans IDE to retrieve the sources of
a project that is hosted on Kenai and how to open a project in the Kenai Dashboard in the IDE.
In most cases, you do not need to be registered with Kenai to retrieve sources
or to open a project in the dashboard.
This document also demonstrates how to become a member of a project that is hosted on Kenai.
To join a project you bookmark the project on Kenai.com.
Any projects that you bookmark are automatically listed in the Kenai Dashboard when you log in to
Kenai in the IDE.
The dashboard provides an easy way to view all the Kenai projects that you have joined.
From the dashboard you can quickly access a project's pages on Kenai.com, view summaries of issues and download project sources.
When you are logged in to Kenai in the IDE, the dashboard displays are variety of information that can help you
keep in touch with other project members and keep up to date on project issues and discussions.
Note. The projects on Kenai will soon be migrated to java.net.
For more information about this process, please consult the Project Kenai.
If you are interested in creating a project or adding a local project to Kenai, see
Creating a Kenai Project in NetBeans IDE.
Watch the Video of Opening a Kenai Project in NetBeans IDE.
Contents
To follow this tutorial, you need the following software and resources.
Notes.
- NetBeans IDE 6.9 requires Java Development Kit (JDK) 6.
- NetBeans IDE 6.9 supports working with the Kenai framework, however, references to Kenai in the IDE were changed to Team to prepare for the move to Java.net.
Before starting this tutorial you may want to familiarize yourself with
the following Kenai documentation.
Checking Out Project Sources
This exercise describes how to use the IDE to find Kenai projects and retrieve sources from a project's repository.
You can download sources that are stored in a Subversion or Mercurial repository.
When you get sources from Kenai, the IDE creates a local repository for the sources.
If the project is a NetBeans project, you can open the project in the IDE after checkout is complete.
You can also check out sources from the Kenai Dashboard.
- Choose Team > Kenai > Get Sources from Kenai from the main menu.
- In the Get Sources from Kenai dialog box, specify the location of the Kenai repository or
click Browse to search for a project.
- Specify a folder(s) in the remote repository that you want to retrieve. (Optional)
If you do not specify a folder, the IDE retrieves all sources starting at the repository's root directory.
- Specify a location for the local repository.
- Click Get From Kenai.
When checkout is complete, the IDE prompts you to open any NetBeans projects in the repository that you checked out.
If the sources do not contain any NetBeans projects, you can use the Favorites window to browse the sources.
Opening a Project from the Kenai Dashboard
The Kenai Dashboard enables you to quickly view details about a Kenai project.
To view a project's details, you open a project in the dashboard by using the Open Kenai Project wizard
or opening a bookmarked project that is listed under My Projects.
You do not have to be a project member to open the project in the dashboard.
After you open a project, you can expand the project's nodes to view a list of the project's members,
search project issues, download the sources and open the project's details page.
Opening a Kenai Project
This exercise describes how to use the Open Kenai Project wizard to open a Kenai project in the Kenai Dashboard.
The wizard enables you to search for projects on Kenai from within the IDE.
You do not need to be logged in to use the wizard.
- Choose Team > Kenai > Open Kenai Project from the main menu to open the Open Kenai Project wizard.
Alternatively, you can open the Kenai Dashboard (Ctrl+8) and click Open Project.
- Type a search term. Click Search.
The IDE searches Kenai for projects containing the search terms and displays the results in the dialog box.
- Select a project from the list. Click OK.
When you click OK, the IDE opens the Kenai Dashboard and displays a node for the project under Open Projects.
You can expand the project node to view additional details.
To remove the project from the dashboard, click the Close button next to the project name.
You can expand the project node and click the details link to open the project's details page in the IDE.
The details page provides links to project pages on Kenai.com, including the project wiki, forum, issue tracker and repository.
Opening a Bookmarked Project
If you are a member of a project, the project is listed under My Projects in the Kenai Dashboard.
The list of projects is updated each time you log in to Kenai in the IDE.
To view and open your bookmarked project, perform the following steps.
- Click login to Kenai in the dashboard.
- Supply your username and password. Click Login.
- Choose Window > Kenai Dashboard from the main menu.
- Click the Open icon for a project that is listed under My Projects.
Note. Only projects that you have joined are listed under My Projects.
You cannot join a project from within the IDE. For steps on how to become a member of a project,
see Joining a Kenai Project.
Checking Out Sources
When you open a Kenai project in the dashboard, the IDE does not automatically retrieve the project sources.
You can checkout the sources by opening the project in the Kenai dashboard.
- Open the project in the Kenai Dashboard.
- Expand the node for the project under Open Project.
- Expand the Sources node.
- Click get to open the Get Sources from Kenai dialog.
- Specify a folder(s) in the remote repository that you want to retrieve. (Optional)
If you do not specify a folder, the IDE retrieves all sources starting at the repository's root directory.
- Specify a location for the local repository.
- Click Get From Kenai.
When you click Get From Kenai, the IDE initializes the local repository for the project and checks out the sources.
If the repository contains a NetBeans project, you are given the option to open the project after checkout is complete.
Note.
In some cases, the Kenai project you checkout might have multiple NetBeans projects.
If you click Open Projects in the dialog box after checking out the sources, the IDE will open all the NetBeans projects.
If you open the NetBeans project, the name of the project is listed under the Sources node.
You can click the project name at any time to open the project in the Projects window.
You can click Browse to view the repository contents in the Favorites window.
You can click Open local project to browse for projects on your local system.
Joining a Kenai Project
Anyone can download a project's sources and view issues, but if
you are interested in getting more involved with or contributing to a project on Kenai you need to
create an account on Kenai and then become a project member.
You become a project member by bookmarking a project on Kenai.com.
By bookmarking a project you join the project as a member with the status of Observer.
When you log in to Kenai in the IDE, all projects that you have bookmarked are listed in the Kenai Dashboard under My Projects.
Depending on their role, members can contribute by reporting and resolving issues, committing sources,
modifying wiki pages, etc.
The project administrator is responsible for assigning roles to project members.
Note.
To join a project you need to first create an account on Kenai.com.
After you create an account, you can bookmark the project on Kenai.com and also login to Kenai in the IDE.
For more about joining and contributing to projects on Kenai, see the following Kenai documents.
If the project is open in the dashboard, you can bookmark the project by performing the following steps.
- Click details in the Kenai Dashboard to open the project details page.
- Click the Project web link in the details page to open the project page on Kenai.com.
- Click Bookmark This Project on the project page.
You need to be logged in to Kenai.com to bookmark a project.
- In the IDE, choose Team > Kenai > Login to Kenai from the main menu.
Alternatively, you can open click Login to Kenai in the Kenai Dashboard.
- Enter your username and password. Click Login.
After you login, all the projects that you have joined are listed under My Projects in the Kenai Dashboard.
You can click the Open icon at any time to open the project under Open Projects.
When you become a member you are added to the list of members under the Members node.
As a member of a project you can participate in the project's chat room.
The steps outlined in this document can be applied to opening and working with most Kenai projects.
See Also
For additional information on using NetBeans IDE in a collaborative environment, see the following tutorials.
