C H A P T E R 10

Setting Up the IDE

After you have installed the IDE, use the information in this chapter to start, set up, and register your software.

This chapter covers the following topics:

Starting the IDE

Setting Up the IDE

Using the Startup Options

Starting the IDE

When you first start the IDE, you are prompted to do the following tasks:

Import your customized settings from previous versions

Indicate whether you would like automatic update checking

To Start the IDE (Microsoft Windows Systems)

Use one of these methods:

Double-click the Sun Java Studio Mobility icon located on your desktop.

Choose Start Programs Sun Microsystems Java Studio Mobility 6

Start the IDE by typing the following command at a command line:

C:\> runidew.exe

To start the IDE and display messages in the Windows Console, type:

C:\> runide.exe

The Windows console displays error messages and other console messages generated by using the IDE.

Using runidew.exe just starts the IDE. This is the default launcher used by the desktop icon.

The runide.exe command options can be specified on the command line or in the jstudio-install-directory\bin\ide.cfg file. See Using the Startup Options.

To Start the IDE (Solaris or Linux Systems)

1. Change to the jstudio-install-directory/bin directory

The default installation directory is /opt/SUNWjstudio/Mobile04q3.

% cd /opt/SUNWjstudio/Mobile04q3

2. Start the IDE.

% ./runide.sh

The runide.sh command options can be specified on the command line or in the jstudio-install-directory/bin/ide.cfg file. See Using the Startup Options.

Setting Up the IDE

The IDE has the following wizards that enable you to control aspects of the IDE environment:

Settings Import Wizard

Registration Wizard

Setup Wizard

Settings Import Wizard

The Settings Import wizard is displayed the first time that you start the IDE. The wizard enables you to import settings from prior versions of the IDE for use with the Java Studio Mobility IDE.

Registration Wizard

The Registration wizard is displayed the first time that you start the IDE. This wizard enables you to register with the Sun Java Studio Developer Resources web site.

Registering your Java Studio Mobility IDE software through the web enables you to do the following:

Use the Update Center to download and install new modules and updates specific to your environment

Subscribe to the Early Access Program (http://forte.sun.com/eap) and receive new, nonpublic builds of the IDE, as well as preview releases of Sun Java Studio modules, patches, and bug fixes

Receive product announcements, if desired

If you decide to register with Sun Java Studio Developer Resources at a later time, choose Help right arrow Registration Wizard from the main window of the IDE.

Setup Wizard

You can access the Setup wizard from the IDE Welcome screen or by choosing Tools right arrow Setup Wizard from the main IDE window.

In the Setup wizard you can do the following:

Set the IDE display window mode

Specify the web browser to use for internal and external web pages

Set the web proxy settings to use if you are behind a firewall

Use the Module Installation page to enable or disable IDE modules

Use the Update Center page to control the following:

Automatic update checking

Frequency of automatic updates

Update Center URL to check

To Enable or Disable IDE Modules

1. Choose Tools right arrow Setup Wizard from the main IDE window.

2. Click Next until the Module Installation page is displayed.

3. Expand the module category node for a list of modules.

Click on the module icon to see a short description of the module function.

4. Disable or enable a module by toggling the Enabled property value to true or false.

By default, all the modules installed with the IDE are enabled.

Using the Startup Options

The runide startup scripts can be run with additional command-line options.

You can use the options in the following ways:

Type the options on the command line

Put the options in the jstudio-install-directory/bin/ide.cfg file

The IDE reads the ide.cfg file before parsing any command-line options. You can type options on multiple lines in the ide.cfg file.

TABLE 10-1 lists the runide command-line options.

TABLE 10-1 IDE Startup Options
Option	Description
`-h -help`	Prints a description of the available options and their usage.
`-jdkhome` jdk-home-dir	Specifies the location of a J2SE platform other than the default that was specified during installation.
`-cp:p` additional-classpath	Prepends the specified class path onto the IDE's class path.
`-cp:a` additional-classpath	Appends the specified class path to the IDE's class path.
`-userdir` jstudio-user-directory	Specifies the jstudio-user-directory (the location where your user settings are stored). If this option is not specified, the default location is used. See the installation chapter for your platform for more information.
`-J` jvm-flags	Passes specified flags directly to the Java Virtual Machine (JVM⁾software.
`-Xverify:none`	`-J` `-Xverify:none` tells the JVM software not to verify the correctness of the bytecode, thereby providing for faster startup time. Setting this flag removes some of protection that the Java language gives you. Refer to the JVM software documentation for more information.
`-Xms24m`	`-J` `-Xms24m` sets the initial heap size of the JVM software to 24 MB. This flag prevents the JVM software from extending the heap size during startup, thereby providing a faster startup time.
-`Xms96m`	maximum Java heap size
`-Xss1024k`	Thread stack size
(Microsoft Windows only) `hotspot` or -`classic`	Specifies the Java virtual machine (JVM) variant to be used. The terms "Java virtual machine" and "JVM" mean a virtual machine for the Java platform.
`"-ui"` UI_class_name	Sets the specified UI class as the IDE's look and feel.
`"-fontsize"` size	Sets the font size, expressed in points, in the IDE's user interface. The default value is 11.