Running and Debugging an App Engine Flex Project Locally Inside Eclipse

This page shows you how to run and debug your App Engine flexible project in a Jetty server running on your local computer.

Before you begin

  1. Install the Eclipse Jetty Integration from the Eclipse marketplace if you have not already done so.

Creating run and debug configurations

To create a new run and debug configuration for your app:

  1. Select your flex application in the Project Explorer.

  2. Select Run > Run Configurations....

    A dialog box
to create run configurations for the selected project. The left panel
provides a list of server options, and Jetty Webapp is selected. Icons are
available to create, duplicate, and delete launch configurations.

  3. Select Jetty Webapp in the left panel.

  4. Click the New launch configuration icon.

    A dialog
box to configure run configurations for the selected project. The left panel
provides a list of server options, and Jetty Webapp is selected. The right
panel has fields for run configuration name and project name. A browse
button to select a different project. Fields for WebApp Folder and Context
Path. Buttons for selecting different HTTP and HTTPS ports, with a checkbox
to enable HTTPS.

  5. The run configuration Name autofills with the project name.

  6. Fill in other fields as needed.

  7. Click Run.

For more information about the configuration options available when creating run and debug configurations, refer to the Eclipse Jetty documentation.

Launching your project with Jetty

After creating the run configuration, you can launch your project on the Jetty server by selecting Run > Run As > Run with Jetty. Your project is available at http://localhost:8080/, or on the port you specified in the run configuration.

You can debug your project by selecting Run > Debug As > Run with Jetty.

To stop the Jetty server, click the Terminate button (the red square) in the Console toolbar for the Jetty output.

What's next