|
|
| (15 intermediate revisions by 4 users not shown) |
| Line 2: |
Line 2: |
| | ==STEM Source Code== | | ==STEM Source Code== |
| | | | |
| − | All of the files that constitute the STEM project are maintained | + | All Eclipse project source code moved to Git. For information on how to access the source code please go to the page [[STEM Eclipse Setup]] |
| − | in a “source code control” system. Anyone can obtain a copy of
| + | |
| − | the files in the system, but only people designated as “committers”
| + | |
| − | are allowed to add new files or make other changes to the repository.
| + | |
| − | Since STEM graduated to a top level technology project, the source
| + | |
| − | code repository is SVN. | + | |
| − | | + | |
| − | The only files that are in the repository are those that cannot be
| + | |
| − | derived from others. For instance, Java<FONT FACE="Times New Roman, serif">™</FONT>
| + | |
| − | source files would be in the repository, but not Java<FONT FACE="Times New Roman, serif">™</FONT>
| + | |
| − | class files.
| + | |
| − | | + | |
| − | The following sections cover some of the more common SVN tasks that you would use for STEM development. For more information:
| + | |
| − | <ul>
| + | |
| − | <li>[http://wiki.eclipse.org/SVN_Howto]</li>
| + | |
| − | </ul>
| + | |
| − | | + | |
| − | ===Downloading and installing the SVN plugin===
| + | |
| − | To access the STEM SVN repository, you need to install an SVN plugin in Eclipse for instance Subclipse. For Eclipse 3.4, open Help->Software Updates. Click the "Available Software" tab and "Add Site". Type this location:
| + | |
| − | | + | |
| − | http://subclipse.tigris.org/update_1.6.x
| + | |
| − | | + | |
| − | Select these components (at minimum):
| + | |
| − | | + | |
| − | Under "Core SVNKit Library", select "SVNKit Library"
| + | |
| − | Under "Optional JNA Library", select "JNA Library"
| + | |
| − | Under "Subclipse", select "Subclipse Integration for Mylyn", "Subversion Revision Graph" and "SVNKit Client Adapter"
| + | |
| − | | + | |
| − | Click Install and restart Eclipse when prompted
| + | |
| − | | + | |
| − | ===Accessing the STEM Source Code Repository with SVN===
| + | |
| − | | + | |
| − | All elements of the Eclipse STEM project are available for anonymous read-only access to the development CVS repository.
| + | |
| − | *'''Anonymous CVS Connection Information'''
| + | |
| − | **'''Host''': dev.eclipse.org
| + | |
| − | **'''Repository Path''': /cvsroot/technology
| + | |
| − | **'''User''': anonymous
| + | |
| − | **'''Password''': leave blank
| + | |
| − | **'''Connection Type''': pserver
| + | |
| − | | + | |
| − | To import the STEM plugin projects from CVS using the Eclipse import function, you can follow these steps:
| + | |
| − | *Startup Eclipse with '''c:\stem''' as the workspace.
| + | |
| − | **select '''file->import'''
| + | |
| − | **select '''CVS'''->'''Projects from CVS'''->'''next'''
| + | |
| − | **fill in the resulting panel with the Repository connection information above.
| + | |
| − | **select '''next'''
| + | |
| − | **select '''Use existing module'''
| + | |
| − | **Find '''org.eclipse.ohf''' from the resulting list.
| + | |
| − | **expand '''org.eclipse.ohf''' -> '''plugins'''
| + | |
| − | **select '''all''' of the '''org.eclipse.ohf.stem.*''' projects
| + | |
| − | **select '''finish'''
| + | |
| − | | + | |
| − | The optional STEM projects are:
| + | |
| − | *org.eclipse.ohf.stem.data
| + | |
| − | *org.eclipse.ohf.stem.sample
| + | |
| − | *org.eclipse.ohf.stem.utility
| + | |
| − | *org.eclipse.ohf.stem.tests.*
| + | |
| − | | + | |
| − | The '''org.eclipse.ohf.stem.ui.reports''' requires the Eclipse BIRT product and can be left out if you don't have BIRT installed.
| + | |
| − | | + | |
| − | The rest of the '''org.eclipse.ohf.stem.*''' projects are required.
| + | |
| − | | + | |
| − | At this point, all of the selected projects will be checked out and then built. It should result with no errors and usually 2 warnings.
| + | |
| − | The remaining warnings about missing files will be resolved in the subsequent steps when the disease scenario is built. You can now continue with the instructions for running the STEM application.
| + | |
| − | [http://wiki.eclipse.org/index.php/Installation_Guide#Preparing_to_Run_STEM_as_a_STEM_developer]
| + | |
| − | | + | |
| − | The repository is also available for browsing [http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.ohf/plugins/?root=Technology_Project here].
| + | |
| − | | + | |
| − | === How do I send someone a patch? ===
| + | |
| − | | + | |
| − | If you have modified a project that you checked out from CVS,
| + | |
| − | you may want to send those changes to someone else. This often occurs
| + | |
| − | when you do not have commit rights, but want to send the changes to
| + | |
| − | someone who does. To create a patch file:
| + | |
| − | | + | |
| − | <ol>
| + | |
| − | <li>Select the changed project in the Navigator or other view.</li>
| + | |
| − | <li>Context Menu->Team->Create Patch...</li>
| + | |
| − | <li>Select a location for the patch.</li>
| + | |
| − | <li>Use E-mail or other delivery method to send the patch to
| + | |
| − | someone else.</li>
| + | |
| − | <li>If the patch is associated with a Bugzilla item, it is a good idea to append to the Bugzilla item with the patch as an attachment.
| + | |
| − | </ol>
| + | |
| − | | + | |
| − | Note that Create patch can be run with multiple projects selected.
| + | |
| − | | + | |
| − | === How do I apply a patch that someone sent me? ===
| + | |
| − | | + | |
| − | To apply a patch, such as one generated in the previous step, do
| + | |
| − | the following:
| + | |
| − | <ol>
| + | |
| − | <li>Select the changed project in the Navigator or other view.</li>
| + | |
| − | <li>Context Menu->Compare With->Patch...</li>
| + | |
| − | <li>Fill in the location of the patch file</li>
| + | |
| − | <li>Click Next. A summary of changed files will appear.</li>
| + | |
| − | <li>Click Finish. The changes are now merged into the workspace.</li>
| + | |
| − | <li>Context Menu->Team->Synchronize.</li>
| + | |
| − | <li>After testing the patch, if you have commit access, you may then commit the changes into the repository.</li>
| + | |
| − | </ol>
| + | |
| − | | + | |
| − | ===Committer access to CVS===
| + | |
| − | | + | |
| − | Developers with commit rights have individual user ids and passwords in the Eclipse project development repository. As a committer you can use SSH (Secure SHell) to connect to the CVS repository as follows. Go to a Repository View and add a new CVS repository location. When asked for the repository location enter the following:
| + | |
| − | | + | |
| − | {| style="width:60%;" border="0" cellpadding="2"
| + | |
| − | |+Committer CVS Connection Information
| + | |
| − | |-
| + | |
| − | | '''Host''' || dev.eclipse.org
| + | |
| − | |-
| + | |
| − | | '''Repository Paths''' || /cvsroot/technology
| + | |
| − | |-
| + | |
| − | | '''User''' || (your committer user id, supplied by the webmaster)
| + | |
| − | |-
| + | |
| − | | '''Password''' || (your committer password)
| + | |
| − | |-
| + | |
| − | | '''Connection Type''' || extssh
| + | |
| − | |-
| + | |
| − | |}
| + | |
| − | | + | |
| − | Once your information is authenticated, you can browse the repository and add projects to your workspace. If you do some changes that you'd like to contribute, after testing and ensuring that you have followed the contribution guidelines, you are free to release your changes to the repository. Of course, you can only release changes to projects for which you have commit rights. The current list of committers for OHF can be found [http://www.eclipse.org/ohf/committers/index.php here].
| + | |
| − | | + | |
| − | Note that you can use the SSH protocol and your Eclipse user id to access projects for which you are not a committer but you will not be able to release changes.
| + | |
| − | | + | |
| − | More information about CVS usage with Eclipse is available [http://wiki.eclipse.org/index.php/CVS_Howto here].
| + | |
All Eclipse project source code moved to Git. For information on how to access the source code please go to the page STEM Eclipse Setup
