Sharing Projects

Before you can share a project, you need to define a repository location. If you haven't already, you may do so by following the steps in Setting up Repositories. Or you can proceed with step one below and set up your repository in step two.

A Note about Project Structure

• The first is your normal project structure: the directories/packages you have created and your source code.
• The second section is the Together Model directory. This contains the actual diagram files generated and used by Together and includes the .project and .classpath files.

Use the project's context menu in the UML Explorer, UML Navigator or Navigator view to share a project.

1. Right click on the project, and select Team > Share Project from the context menu. The Share Project wizard displays:

   
   

   
   
   

   NB: The first time you select Team > Share Project on your project, the Synchronize with Repository view is opened showing you the current files in your project. This allows you to select which files should be added to the repository. Once the project has been added to the repository, the Team menu will contain new commands (discussed below).

   
   

2. Choose whether you want to use the existing repository location or create a new repository location. If you choose to create a new location, the Share Project wizard opens as described in Setting Up Repositories. The example above uses an existing repository. Click Next.

   
   

3. In the new dialog, choose either to use the project name as the module name, or specify a different module name. Click Next.

   
   

4. In the final screen, the wizard explains your status in the process. If you need to make any modifications, click Back. Click Finish, and the wizard imports your project to the repository.

From now on, when using the Team command from this project's context menu, the Update and Commit commands are enabled. Respectively, these options commit your changes to the repository, and refresh your view with changes made by other team members.

• It is recommended that any source files/design diagrams that you created before you shared the project be added to the repository.
• The project's .project file can be shared, but only if the team will use exactly same project name.
• It is not recommended that you version control the default package diagrams (those files with the .txvpck extension) as these change frequently and are easily regenerated automatically by Together if missing.
• You can include the .classpath file if you are using variables to point to libraries, or you are sure that each team member will have the libraries in exactly the same place (for Windows, this includes the drive letter).
• You can specify directories and files that you do not want placed in CVS: from the main menu, select Window > Preferences > Team > Ignored Resources. Add "*.txvpck" and the Commit and Update actions will ignore these default package diagrams. NB: Respectively, each team member would also have to set this up locally.