Buildship Gradle Integration Eclipse Project

Eclipse plug-ins that provide support for building software using Gradle.

This solution is provided by the Eclipse Foundation.

Get Help • Report a Bug • More Information

Project Import

You can import an existing Gradle project through the Eclipse Import Wizard functionality. In distinct steps, the import wizard allows you to specify the location of the Gradle project, configure the various optional, advanced settings, and see a summary of how the project will be imported. The summary page will also warn if you are using a target Gradle version for which Buildship is not able to offer all its functionality.

During the import, the Eclipse projects are created and added to the current workspace. In case of Java projects, the source paths and the classpath container which contains the external dependencies and the project dependencies are configured. The content of the classpath container is refreshed each time the project is opened.

Projects that already contain a .project folder are left untouched except the Gradle nature being configured and the Gradle preferences file being added. This ensures that the given project and its tasks still show up in the Tasks View.

Importing composite builds is also supported. Composite builds behave just like simple multi-project builds in the IDE. 

Composite builds support only works with target Gradle version 2.1 or newer.

You can stop the import at any time by pressing the Stop button in the Progress View.

Project Creation

You can create a new Gradle project and have it be added to the current workspace through the Eclipse New Wizard functionality. In distinct steps, the creation wizard allows you to specify the name and location of the Gradle project, configure the various optional, advanced settings, and see a summary of how the project will be created and imported.

Project Refresh

You can refresh the configuration of all imported projects that belong to the same multi-project build by right-clicking on any imported project in the Explorer View or from the context menu of the build script editor. New projects in the Gradle build are added to the workspace, removed projects are detached from Buildship but kept in the workspace, and existing projects are updated.

Tasks View

In the Gradle Tasks View, you can see the tasks of all the imported Gradle projects. The tasks can be sorted, filtered, and executed. The selection in Eclipse can be key linked to the selection of the tasks view, both ways. The content of the tasks view can be refreshed, meaning the latest versions of the Gradle build files are loaded. You can navigate from a project to its build file through the context menu.

Task Execution

You can run Gradle tasks from the Tasks View through double-clicking, right-clicking, or via keyboard. In case multiple tasks are selected, they are passed to Gradle in the order they were selected. Each time a Gradle build is executed with a different set of tasks, a new Gradle run configuration is created. You can edit existing run configurations and create new run configurations through the Run Configurations dialog. All settings can be configured in the run configurations dialog.

Whenever a Gradle build is executed, a new Gradle console is opened that contains the output from the build. You can cancel the execution of the build by pressing the Stop button in the Gradle console. The Gradle consoles can be closed individually or all at once.

Executions View

Whenever a Gradle build is executed, a new Execution page is opened in the Executions View that displays the progress of running the build. You can see the different life-cycle phases of the build, the tasks and tests being run, and the success of each operation.

You can switch between the execution pages and you can jump to the corresponding Gradle console. You can also rerun a finished build. You can cancel the execution of the build by pressing the Stop button in the execution page. The execution pages can be closed individually or all at once.

This is available if the Gradle build is run with target Gradle version 2.5 or newer.

Test Execution

You can run tests from the Execution page through right-clicking on a node that represents a test class or test method. A new Gradle build is executed and the selected tests are run by Gradle. If the test task to which the tests belongs has setup and cleanup tasks configured, those are run accordingly. Once the build has finished and there are test failures, you can rerun all failed tests by pressing the Rerun Failed Tests button in the execution page.

This is available if the Gradle build is run with target Gradle version 2.6 or newer.

Basic Web Project Support

If you import a web project and your Eclipse contains the Web Tools Platform plugin then Buildship will automatically generate the WTP configuration files. The generated files will respect all customizations that are defined in the eclipse-wtp Gradle plugin.

Build scans

You can easily enable build scans from the preferences for the entire workspace as well as per project. If the preference is enabled and the project applies the com.gradle.build-scan plugin then a build scan is published for each build. You can open the published build scans by clicking on the URL in the console view or by clicking on the 'Open build scan' button on the Execution view's toolbar.

Hierarchical preferences

There are three hierarchical levels of configuration in Buildship. You can define default workspace settings for the project import, the build scans capturing, and for the offline mode. You can override those workspace settings in the project configuration settings. Finally, you can override the project configuration settings on any run configuration.

Cancellation

You can cancel all long-running operations like importing a project, executing tasks, refreshing the tasks, etc.

This is available if the Gradle build is run with target Gradle version 2.1 or newer.

Offline mode

Just like the build scans, you can enable the offline mode from the workspace or from the project preferences. If enabled, the project synchronization and the build execution won't try to connect to the internet so that you can continue working without continuous connectivity.