Idea notes

§    Handy links

Documentation overview:

Online Help:

Reference card:

§    Startup

I start with a script containing the following
cd /my/webbed/jetbrains/idea-9164/bin

It seems to be necessary to run from the actual directory.

My ~/.idea_vmoptions contains

The install of IDEA creates an enormous directory ~/.IntelliJIdea8x/system/ in my home directory. After stepping through the install wizard, I exit, move this directory to local disk and point to it with a symbolic link.

Many plugins are blamed for freezes and hangs. I select only the few that I know I want, and postpone installing any others.

§    New Project from existing SVN repository

  1. Go to File -> New Project and select "Create Java project from existing sources."
  2. I select a directory like $HOME/projects below the directory containing all repositories of interest.
  3. I give the project a general name like "projects" because it will contain many independent repositories as modules.
  4. I get a list of source directories, and unselect all the false postivies. Our correct directories are usually named "src" and contain directories like "com", "edu", and "gov".
  5. If I plan to use existing module files *.iml, then I unselect all directories at this point.
  6. Next you must "review libraries." Select the ones that contain essential third-party applications. Ours are usually called "jar" and contain "jogl.jar" and so on. Unselect any duplicates of these jars in built images. Prefer the ones used by ant "build.xml".

    Again, if I plan to use existing module files *.iml, then I unselect all libraries at this point. This is easier if you hit the "stop searching" button right away.

  7. Next it will suggest "module" names for each of the respositories I have under "projects". These are generally correct. If you have unselected source and libraries, then this list will be empty.
  8. You must select a JSDK.
  9. Hit "finish."
  10. First chance you get, set File -> Settings -> HTTP Proxy, if you have one. Also set File -> Settings -> Web Browsers.
  11. This is a good time to shut down and move ~/.IntelliJIdea8x/system/ to another directory, with a symbolic link from the original location.
  12. Go to File -> Settings -> Updates -> Check now and get the IDE update out of the way.
  13. Before adding modules to very large projects, you may want to disable automatic updating from the file system. This often causes IDEA to hang for me. Go to File -> Settings -> General and uncheck "Synchronize files on frame activation."
  14. It is easy to add additional modules now. Select File -> New Module -> Create module from scratch and hit Next. Choose a name and path as before. It may only ask for your source path.
  15. Alternatively, Select File -> Import existing module -> Select IDEA module (.iml) to import. At my office, many repositories provide these in the top directory.

You should now see new projects.iws and projects.ipr files in your top level projects directory.

§    Configuring modules

§    Other useful settings

Bill Harlan, 2008-2009

Return to parent directory.