Code Bubbles

Welcome to Code Bubbles. This guide will help you to setup and install Code Bubbles. (Note that some of the windows might appear slightly different in that bubbles keep evolving). Eclipse should not be running before this process starts. Note you will need to have Eclipse 3.5 or higher for things to work correctly. (At least it hasn't been tested with prior versions of Eclipse.)

  1. Double click on bubbles.jar to start the installation process. If a "main class not found" error appears run the jar with:

    2. java -jar jarname

  2. A Bubbles Environment Setup window will pop up in the upper left corner of your screen.

    3. Bubbles Environment Setup

  3. Click Browse and navigate to your Eclipse Installation Directory (this should be the directory that contains your eclipse binary or, for the Mac, the Eclipse.app file/directory).
  4. If you would like to be able to view eclipse while running Code Bubbles then check Run Eclipse in Foreground.We recommend you do not check this option as our goal is to make Code Bubbles a stand alone environment and enable all features from within Bubbles. However, the option is supported.
  5. Click Install Bubbles.
  6. Click Ok.
  7. A Bubbles Workspace Setup window will appear in the upper left corner of your screen.

    8. Bubbles Workspace Setup

  8. Click Browse and navigate to your Eclipse Workspace. The workspace should have been setup by Eclipse and include at least one project. If the workspace is not setup, Code Bubbles will attempt to have Eclipse set up a new project.
  9. If you want this to be your default workspace, you can uncheck Always Ask for Workspace.
  10. Click Ok
  11. A User Metrics Option window will appear.

    12. User Metrics Option

  12. You may choose to disable any of the options listed. The metrics are being used to determine how Code Bubbles is actually used and how it can be improved. We recommend that you at least enable automatic bug reports since these contain no proprietary information and are very helpful for our improving the quality of the environment..
  13. Click Ok.
  14. Code Bubbles will now startup. Please be patient. Code Bubbles must first load Eclipse and the symbol tables for your projects. The first time it starts, the system also needs to cache JavaDoc information from the web.
  15. Code Bubbles is now ready to use. Next time you start Code Bubbles, all you will need to do is choose your workspace (unless you set it to default to the specified one)..
  16. If you have a downloaded version of Java docs on your system, it is recommended that you edit the file ~/.bubbles/Bdoc.props and replace the entry for key Bdoc.javadoc.0 with the url of that verison, i.e. file://pro/java/linux/jdk1.6/docs/api/

    17. Code Bubbles

 

Recommended Hardware:

Tested On:

For more information visit our website: http://www.cs.brown.edu/people/spr/codebubbles/

Copyright 2010 Brown University. All Rights Reserved.