This is an automated email from the ASF dual-hosted git repository. mergebot-role pushed a commit to branch mergebot in repository https://gitbox.apache.org/repos/asf/beam-site.git
commit e12f93209d6055f6a63d3675217a8c8db1d59712 Author: Scott Wegner <sweg...@google.com> AuthorDate: Wed Apr 11 16:23:36 2018 -0700 Update Eclipse documentation for Gradle build. --- src/contribute/eclipse.md | 57 ++++++++++++++++++++++++++--------------------- 1 file changed, 31 insertions(+), 26 deletions(-) diff --git a/src/contribute/eclipse.md b/src/contribute/eclipse.md index e0cf477..592851e 100644 --- a/src/contribute/eclipse.md +++ b/src/contribute/eclipse.md @@ -17,42 +17,47 @@ section_menu: section-menu/contribute.html ## Eclipse version -Use a recent Eclipse version that includes m2e. Currently we recommend Eclipse -Neon. Start Eclipse with a fresh workspace in a separate directory from your +Use a recent Eclipse version that includes +[Buildship](https://projects.eclipse.org/projects/tools.buildship) for Gradle integration. +Currently we recommend Eclipse Oxygen. Start Eclipse with a fresh workspace in a separate directory from your checkout. ## Initial setup -1. Install m2e-apt: Beam uses apt annotation processing to provide auto - generated code. One example is the usage of [Google - AutoValue](https://github.com/google/auto/tree/master/value). By default m2e - does not support this and you will see compile errors. +1. Before setting up Eclipse integration, verify that you can successfully build + from the commandline using instructions from the [Contribution guide]({{ site.baseurl }}/contribute/contribution-guide#building). - Help - -> Eclipse Marketplace - -> Search for "m2 apt" - -> Install m2e-apt 1.2 or higher +1. If running on Mac or Linux, launch Eclipse from a terminal. This is necessary + to ensure that Eclipse has proper environment setup from user profile + scripts, i.e. .bashrc. -2. Activate the apt processing +1. Install [Buildship Gradle + Integration](https://marketplace.eclipse.org/content/buildship-gradle-integration). + This will allow importing and interacting with the Gradle build. - Window - -> Preferences - -> Maven - -> Annotation processing - -> Switch to Experimental: Delegate annotation processing ... - -> Ok +1. Open the project import wizard in Eclipse via "File" > "Import". -3. Import the beam projects +1. From the "Import" screen, select "Gradle" > "Existing Gradle Project", and click + Next. - File - -> Import... - -> Existing Maven Projects - -> Browse to the directory you cloned into and select "beam" - -> make sure all beam projects are selected - -> Finalize +1. From the "Import Gradle Project" screen, fill in the Project root directory + with your local git path, and click Finish. -You now should have all the beam projects imported into Eclipse and should see -no compile errors. +Eclipse will scan the project tree and import each as a separate +Package. + +Verify that your workspace is correctly configured by invoking +'beam-runners-direct-java:build' from the "Gradle Tasks" pane. The build should +succeed with now errors. + +## Building + +Once your Eclipse workspace is properly setup, you will have a "Gradle +Tasks" window with a set of operations. If you don't see the pane, open it +from "Window" > "Show View" > Other.. > "Gradle" > "Gradle Tasks". + +From the "Gradle Tasks" window, you can build any task registered with Gradle. +For example, if you are working on Kinesis IO, select 'beam-sdks-java-io-kinesis:build'. ## Checkstyle -- To stop receiving notification emails like this one, please contact mergebot-r...@apache.org.