PreviousNext

Set application information and type

Users see the application information when they install the application using the BlackBerry® Desktop Software. This information is also available on the BlackBerry device after the application is installed: in the BlackBerry device options, users click Applications and then click an application.

    1. In the Workspace files window, right-click a project file.
    2. Click Properties.
    3. Click the General tab.
    4. Set any of the following options:
      Field
      Description

      Title

      Type a descriptive name for this project.

      To create a keyboard shortcut for an application, add the unicode underscore character (\u0332) after a letter in the title. For example, for the Hello World application, type H\u0332ello World. When the user presses the h key on the Home screen of the BlackBerry device, the Hello World application starts. If more than one application uses the same keyboard shortcut, the application that appears first on the Home screen opens.

      To support multiple languages, create resource files for localization, and then set the options on the Resources tab.

      Version

      Type the version number of the project. See "Set workspace properties" for more information about setting the version for all projects in the workspace.

      Vendor

      Type the name of the company that owns the project. See "Set workspace properties" for more information about setting the vendor for all projects in the workspace.

      Description

      Type a description for the project.

      Always make project active

      Select this option to make the project always active; this option disables the Deactivate menu item when you right-click the project. Active projects are built when you click Build on the Build menu or Go on the Debug menu.

      Excluded from "Build All"

      Select this option to prevent this project from being built when you click Build All on the Build menu.

    5. Click the Application tab.
    6. Set any of the following options:
      Field
      Description

      Project type

      In the Project type drop-down list, select one of the following options:

      • CLDC Application: an application that uses CLDC/MIDP and BlackBerry APIs
      • MIDlet: an application that uses MIDP APIs only
      • Library: a library on which other applications can depend
      • Alternate CLDC Application Entry Point: a project that does not contain code; it appears on the BlackBerry device as a separate application, but it invokes another CLDC application with different arguments (as specified in the Arguments passed to field)
      • Alternate MIDlet Entry Point: a project that does not contain code; it appears on the BlackBerry device as a separate application, but it invokes another MIDlet

      Alternate entry point for

      In the drop-down list, select another project in the workspace that this project invokes.

      Note: This field is available only if the project type is Alternate CLDC Application Entry Point.

      Name of main MIDlet class

      Type the name of the class that extends javax.microedition.midlet.MIDlet.

      Note: This field is available only if the Project type is MIDlet or Alternate MIDlet Entry Point.

      Argument passed to "static public void main(String args[])"

      Specify arguments to pass into the application main() method.

      Note: This field is available only if the project type is ECMAScript, CLDC Application, or Alternate CLDC Application Entry Point.

      Home screen position

      Clear this option to set the position of the application icon on the Home screen. Type a number from 1 to 255, where 1 is highest priority and 255 is lowest priority.

      Note: This field is not available if the Project type is Library.

      System module

      Select this option to run the application in the background, without displaying an icon on the BlackBerry device Home screen.

      This field is not available if the Project type is Library.

      Auto-run on startup

      Select this option to start the application automatically when the BlackBerry device starts.

      This option is not available if the Project type is MIDlet.

      Note: Auto-run applications must be digitally signed by Research In Motion to run on BlackBerry devices.

      Startup tier

      If the Auto-run on startup option is selected, select a startup tier to determine the priority with which the application is started, in relation to other applications.

      For third-party applications, you can select 6 or 7 (other startup tiers are reserved for RIM applications). If you do not specify a startup tier, the default tier is 7 (lowest priority).

      Note: This option is not available if the Project type is MIDlet.

Specify a localized application title and description

Before you set the options on this tab, verify that you have added a resource for the application title. See "Change resource files" for more information.

    1. In the Workspace files window, right-click a project file.
    2. Click Properties.
    3. Click the Resources tab.
    4. Select the Title Resource Available check box.
    5. Set any of the following options:
      Field
      Description

      Resource Bundle

      Click the resource header file to use for this application, such as HelloWorldRes.

      Title Id

      Click the resource key to use for the application title, such as APPLICATION_TITLE. If you do not provide a resource for the application title, the BlackBerry® IDE uses the Title field on the General tab.

      Description Id

      Click the resource key to use for the application description, such as APPLICATION_DESCRIPTION. If you do not provide a resource for the application description, the BlackBerry IDE uses the Description field on the General tab.

      Icon files

      Specify icon image files to use with this application.

Set the compilation process for a project

    1. In the Workspace files window, right-click a project file.
    2. Click Properties.
    3. Click the Compile tab.
    4. Set any of the following options:
      Field
      Description

      Output messages about what the compiler is doing

      Select this option to view detailed compiler information when you build this project.

      Note: Selecting this option is equivalent to setting the -verbose option for rapc.

      If you select this option, the BlackBerry® IDE will create many "rapc_XXXX.dir" directories in the %TEMP% directory during compilation.

      Generate no warnings

      Select this option to hide compiler warnings when you build this project.

      Tip: Warnings do not prevent the project from being built successfully, but they can indicate possible errors in your code.

      Treat warnings as errors

      Select this option to handle warnings as errors when you build the project.

      Output source locations where deprecated APIs are used

      Select this option to view the location of deprecated APIs in the source files.

      Don't convert image files to png

      By default, the BlackBerry IDE converts the image files in your project to .png format. Select this option to prevent the BlackBerry IDE from converting image files in your project to .png format. Select this option if your application needs to access raw image data on the BlackBerry device.

      No warning for no exported static routine: .main(String[])

      Select this option to prevent the compiler from issuing a warning if main() is undefined.

      Alias list

      To repackage existing API libraries into a new library project, list one or more libraries that this project replaces, separated by a semi-colon (;).

      For example, if you are creating a library project called "newlib" that repackages existing libraries "libA" and "libB", you can specify libA;libB in this field so that .cod files that use those libraries continue to work correctly.

Set the build process for a project

    1. In the Workspace files window, right-click a project file.
    2. Click Properties.
    3. Click the Build tab.
    4. Set any of the following options.
      Field
      Description

      Output file name

      Specify the name of the .cod file that is output for the project. If this field is empty, the project name is used.

      Pre build step

      Type a command that the BlackBerry® IDE runs before building the project.

      You can use regular expressions. If you do not specify an absolute path, file locations are relative to the folder in which this workspace is located.

      Post build step

      Type a command that the BlackBerry IDE runs after building the project.

      You can use regular expressions. If you do not specify an absolute path, file locations are relative to the folder in which the workspace is located.

      Clean step

      Type a command that the BlackBerry IDE runs when you click Clean or Clean All on the Build menu.

      Imported jar files

      Click Add to add external .jar files that you want to build with your application. This option enables you to include applications on which your project depends that are not in the current workspace.

      Imported alx files

      Click Add to add external .alx files that you want to build with your application. This option enables you to include applications on which your project depends that are not in the current workspace. The .alx files that you add here are included in <requires id> tags in the .alx file that is generated for your project.

Related topic


   BlackBerry