Globalyzer First Steps

Running the Globalyzer Workbench

Globalyzer lets you internationalize your application in a completely integrated development environment: We call this the Globalyzer Workbench. You can install Globalyzer either as a standalone development environment or, if you already run in an Eclipse development environment, as an Eclipse plugin.

Globalyzer Projects and Workbench Projects

In order for your Globalyzer Projects to work in the Workbench, they must each be associated with a Workbench Project. There are various ways to set up this association, depending on your setup.

Globalyzer Project without a Workbench Project

This can occur for a variety of reasons:

  • You've created a Globalyzer Project in Project=>Manage Projects.
  • You've imported a Globalyzer Project through the Globalyzer Commandline Client.
  • You've created Globalyzer Projects in an earlier release of Globalyzer and have now upgraded to a later version.
  • You've deleted the associated Workbench Project.

    Follow these steps to associate your Globalyzer Project with a new Workbench Project:

    1. Click on Project=>Manage Projects. This dialog lists all your Globalyzer Projects: Any Globalyzer Project that is associated with a Workbench Project will have a W icon next to its name.
    2. Click on the Globalyzer Project that you want to associate with a Workbench Project.


      Note that once you've associated your Globalyzer Project with a Workbench Project, you'll no longer be able to change its name or source code location until you break the association.

    3. Click on the Associate button. This will bring up Eclipse's New Project wizard so that you can create the associated Workbench Project. Be sure to use the exact same Globalyzer Project name and source code location. Otherwise, the Eclipse Workbench Project won't be associated with the Globalyzer Project. Once you make the association, you'll see a W icon next to the Globalyzer Project's name. You'll also now be able to fully use Globalyzer features on the Project.

    Importing a Globalyzer Project into the Workbench

    In this case, you're running Globalyzer Workbench and importing your Globalyzer Project .gprog file. Follow these steps to import a Globalyzer Project (.gproj file) into the Globalyzer Workbench.

    1. Select File=>Import.
    2. In the dialog box, select Globalyzer=>Import Project and click on Next.
    3. Browse to the Globalyzer gproj file, optionally check Include Scan Results, and click on Finish. Globalyzer will import your project, bringing up a Reconcile Project window.
    4. In the Reconcile Project window, adjust your source code basepath and any Globalyzer Rule Sets as needed. Continue to click Next.
    5. Click the Finish button. You're now in Eclipse's Project Wizard, where you create a Workbench project for your Globalyzer Project.
    6. Choose the type of Workbench Project you want to create. For example, if your application is a Java application, you can choose Java Project. If you don't have a plug-in for your application's programming language or you're planning to build and run your application outside the Globalyzer Workbench, select General=>Project and click Next.
    7. Make sure that you enter the exact Project Name and source code Location in the New Project dialog. If you can't remember the name, you can always click Cancel and create the Workbench Project using Manage Projects as described above.
    8. Once the Globalyzer Project import is finished and a Workbench Project has been created, you're all set!

    Creating a Workbench Project

    If you create the Workbench Project first, Globalyzer will automatically create the Globalyzer Project.

    1. Select File=>New to launch Eclipse's Project Wizard.
    2. Choose the type of Workbench Project you want to create. For example, if your application is a Java application, you can choose Java Project. If you don't have a plug-in for your application's programming language or you're planning to build and run your application outside the Globalyzer Workbench, select General=>Project and click Next.
    3. Enter a Project Name and source code Location in the New Project dialog.
    4. Once the Eclipse Workbench Project is created, it will automatically create the corresponding Globalyzer Project and lead you into the Scan creation.

    Workbench Project without a Globalyzer Project

    This final scenario occurs when you've already set up an Eclipse Project for your application and now you want to use Globalyzer on it.

    1. Right-click on the Eclipse Workbench Project name in the Project Explorer view.
    2. Select Globalyzer=>Add/Remove Globalyzer Nature. This will create an associated Globalyzer Project and bring you into the New Scan Wizard.