Get R3 and Compile it
- Install an SVN client, such as TortoiseSVN. For most machines, grab the 32-Bit MSI installer file.
- Go to http://code.google.com/p/papertoolkit/. That is where the R3 open-source project is hosted.
- Create a directory for R3. For convenience, I tend to put all my projects in subdirectories of my Eclipse Workspace. You can set the workspace path under File > Switch Workspace...
With the above Workspace path, I would create a new directory at C:\Documents and Settings\Ron Yeh\My Documents\Projects\PaperToolkit. Some of my colleagues like shorter paths, and will use something like C:\Dev\PaperToolkit. It's your call.
- In the google hosting page, you can find the SVN URL for downloading R3. For anonymous access, use http://papertoolkit.googlecode.com/svn/trunk/.
You will need to enter this URL into TortoiseSVN's checkout panel. Alternatively, if you have command-line subversion, you can just type in the command as displayed on the google web page.
- Right Click the empty R3 folder, and choose SVN Checkout. Type in the URL of the repository. The other settings should be left at their defaults.
- Once the Checkout is done, you will need to import the project into Eclipse. There are multiple ways to do this. I tend to use the New Java Project command.
For the Project Name, you should use the name of the folder that contains R3 (e.g., PaperToolkit). Once you type the name, Eclipse will recognize that this folder already exists. You can just click Finish and Eclipse will import the project.
- If you are developing a project that will take advantage of R3, you will want to create your own Eclipse project that references R3. That way, you can leverage any of the services that the toolkit provides. Use the New Java Project command again. This time, type the name of your project. I like to choose the option "Create separate source and output folders." Click Next.
- Navigate to the Projects tab, and Click Add... Select R3 and Click OK. Click Finish.
- Now, you should see both your project and R3 in the same Package Explorer. You can now proceed to use R3's API in your own project.
- From here on out, feel free to explore R3 and use it as you see fit. If you have a question about functionality, post it to the User's Newsgroup (http://groups.google.com/group/papertoolkit). I will field questions there, and hopefully other users can chime in if they know the answer to something. R3 itself is an experiment, so I will guarantee that it is NOT bug-free software. If you are interested, you can also join the open-source project. =)
Ron B. Yeh