Difference between revisions of "Rifidi:Source Code"
From RifidiWiki
(→Install Subclipse) |
m (→Updating the code) |
||
Line 63: | Line 63: | ||
=Updating the code= | =Updating the code= | ||
+ | |||
+ | Now that you have downloaded the code into an eclipse workspace, it is easy to get changes to the code as soon as we add them to the svn. | ||
To update the code: | To update the code: | ||
Line 69: | Line 71: | ||
* Click the button that says "Synchronize". | * Click the button that says "Synchronize". | ||
* Select all projects. | * Select all projects. | ||
− | * Install any updates by selecting all the updates show, right clicking and choosing 'update' | + | * Install any updates by selecting all the updates show, right clicking and choosing 'update' |
+ | |||
+ | Now that you have the new code, just hit the green run button on the toolbar at the top (Eclipse automatically compiles the code for you, so you don't have to worry about that). | ||
=Reporting Bugs= | =Reporting Bugs= |
Revision as of 16:59, 8 November 2007
If you are interested in running the latest and greatest, bleeding edge Rifidi, or if you want to have a look at the source code, you will need to follow the instructions on this page. However, please keep in mind that the code in this repository is not guaranteed to be stable. If you are interested in our latest stable release, visit our sourceforge page: http://sourceforge.net/projects/rifidi/.
Contents
Downloading the Code
Our code is hosted at http://rifidi.googlecode.com. The svn repository on this site is actually a mirror of our internal svn, so as soon as we post any code to it, the public svn on googlecode will be automatically updated.
Prerequisites
Rifidi is written in java and consists of Eclipse plugins. At this point it must be compiled and built inside of the eclipse environment.
Install Eclipse
- If you do not already have eclipse, or if you have a different version, you will need to get this version
- Go to http://www.eclipse.org/downloads/ and download the "Eclipse for RCP/Plug-in Developers" version of Eclipse to a convenient location.
- Unzip the package.
- Double click on the execution file to get it started
- If you have not used eclipse before, you will be required to select a workspace when eclipse is opening.
- After eclipse opens go to the workbench
- If you have an existing workspace, you will need to create a new one.
- Go to file -> switch workspace -> other
- Select a new directory for your Rifidi workspace.
Install Subclipse
Subclipse is an eclipse plugin that manages svn commands.
- Follow the instructions at http://subclipse.tigris.org/install.html.
- In step 6 of the above instructions, don't install the Optional Integrations. Only the subclipse plugin is needed
Add Repository
- Open the 'SVN Repository Exploring' perspective
- Window -> Open Perspective -> Other
- SVN Repository Exploring
- Add the rifidi repository
- Click 'Add SVN Repository' button
- Add 'http://rifidi.googlecode.com/svn'
Check Out Code
- Check out all the projects in the rifidi/trunk folder of the repository
- Highlight every folder in the rifidi/trunk/ folder (all the ones that begin with org.rifidi.*)
- Right click them and select checkout
- Select Finish.
Running Rifidi
The last step to get Rifidi Running you need to change the Runtime Configuration
- Switch to the Java perspective in the same way that you switched to the repository exploring view
- Right click on Rifidi.product in the org.rifidi.ide project
- Click on "Run as eclipse application"
- If you get an error, click no and perform the following instructions:
- Run -> Open Run Dialog -> Eclipse Application -> Rifidi.product
- Goto the Tab Plug-ins
- click the Button "Add Required Plug-ins"
- check any plugins specifically required for the application to run (for example, the emulator requires the readers to be included)
- click the Button "Validate Plug-ins" to make sure everything is set up correctly
- click the Button "Apply"
- click the Button "Run" and start the Project
- From now on, you can start Rifidi via the green triangle button at the top of eclipse
Updating the code
Now that you have downloaded the code into an eclipse workspace, it is easy to get changes to the code as soon as we add them to the svn.
To update the code:
- Open up the Team Synchronizing Perspective in eclipse
- Click the button that says "Synchronize".
- Select all projects.
- Install any updates by selecting all the updates show, right clicking and choosing 'update'
Now that you have the new code, just hit the green run button on the toolbar at the top (Eclipse automatically compiles the code for you, so you don't have to worry about that).
Reporting Bugs
To report bugs, please use the bug tracker on our sourceforge page, or send a note out on our mailing list. For more information
For more information, please subscribe to and contact us via our mailing list:
http://sourceforge.net/mail/?group_id=170933,
or drop by our IRC channel:
#rifidi on irc.freenode.org.
You can also visit us online at http://www.rifidi.org