AWS Toolkit for Eclipse
The AWS Toolkit for Eclipse will reach end of life on May 31, 2023. After this date, the Toolkit will not receive any updates including security patches. We don’t encourage using the Toolkit for Eclipse after this date. The AWS Toolkit for Eclipse open source project on GitHub will be archived, meaning its issues, pull requests, code, labels, milestones, projects, wiki, releases, commits, tags, branches, reactions, code scanning alerts, comments and permissions will become read-only for all users.
Your existing workloads on AWS will not be impacted. You can continue to use Eclipse as your preferred IDE with AWS CLI, AWS SAM CLI, AWS Console or the AWS SDKs, to supplement your development tasks in the IDE. We don’t encourage using the AWS Toolkit for Eclipse (the IDE plugin/extension) after it’s end-of-life date.
In addition, AWS will continue to support the AWS Toolkit for Microsoft’s Visual Studio (Learn More) and Visual Studio Code (Learn More) and the AWS Toolkit for JetBrains (Learn More), which supports IntelliJ for Java, WebStorm for Node.js, Rider for .NET, PyCharm for Python, GoLand for Go, CLion for C & C++, and RubyMine for Ruby.
Direct any questions, issues, or concerns to AWS Support or to the developer team on GitHub.
The AWS Toolkit for Eclipse is an open source plug-in for the Eclipse Java IDE that makes it easier for developers to develop, debug, and deploy Java applications using Amazon Web Services. With the AWS Toolkit for Eclipse, you’ll be able to get started faster and be more productive when building AWS applications.
Components
The Eclipse plugins included in the AWS Toolkit for Eclipse.
- com.amazonaws.eclipse.core (AWS Toolkit for Eclipse Core)
- com.amazonaws.eclipse.sdk.ui (AWS Toolkit for Eclipse UI)
- com.amazonaws.eclipse.ec2 (AWS Toolkit for Eclipse EC2)
- com.amazonaws.eclipse.dynamodb (AWS Toolkit for Eclipse DynamoDB)
- com.amazonaws.eclipse.identitymanagement (AWS Toolkit for Eclipse IAM)
- com.amazonaws.eclipse.cloudformation (AWS Toolkit for Eclipse CloudFormation)
- com.amazonaws.eclipse.codecommit (AWS Toolkit for Eclipse CodeCommit)
- com.amazonaws.eclipse.codedeploy (AWS Toolkit for Eclipse CodeDeploy)
- com.amazonaws.eclipse.codestar (AWS Toolkit for Eclipse CodeStar)
- com.amazonaws.eclipse.elasticbeanstalk (AWS Toolkit for Eclipse Elastic Beanstalk)
- com.amazonaws.eclipse.lambda (AWS Toolkit for Eclipse Lambda)
- com.amazonaws.eclipse.opsworks (AWS Toolkit for Eclipse OpsWorks)
- com.amazonaws.eclipse.rds (AWS Toolkit for Eclipse RDS)
- com.amazonaws.eclipse.simpledb (AWS Toolkit for Eclipse SimpleDB)
Contributing
Requirements
To contribute to the AWS Toolkit for Eclipse, you need to have at least these requirements met.
- Java 8
- git, maven 3.3+
- Eclipse IDE 4.8 (Photon) or newer
- EGit 3.4.2+, M2Eclipse 1.5.1+ (Note: these two plugins are part of the standard Eclipse)
- WebTools
Build and Test with Maven
- Checkout the source code:
git clone https://github.com/aws/aws-toolkit-eclipse
- Step into the target folder:
cd aws-toolkit-eclipse
- Install the third-party dependencies and build the target platform:
sh setup.sh
- Build and test with Maven using Photon platform:
mvn -Pbuild-eclipse clean verify
- Build and test with Maven using 2018.9 platform:
mvn -Pbuild-eclipse -Declipse.target=20189 clean verify
- Build and test with Maven using 2019.6 platform:
mvn -Pbuild-eclipse -Declipse.target=20196 clean verify
- Build and test with Maven using 2019.9 platform:
mvn -Pbuild-eclipse -Declipse.target=20199 clean verify
- Build and test with Maven using 2020.3 platform:
mvn -Pbuild-eclipse -Declipse.target=20203 clean verify
- Build and test with Maven using 2020.9 platform:
mvn -Pbuild-eclipse -Declipse.target=20209 clean verify
note, 2019-3 and 2019-12 do not build because we reach into Eclipse internals, but it will work on those versions
Import into Eclipse and Set up Development Environment
You must have EGit installed to your Eclipse IDE.
- Open Eclipse, and choose File, Import, Git, Projects from Git, then choose Next.
- Open EGit Import Wizard, then choose Clone URI, Next.
- Type https://github.com/aws/aws-toolkit-eclipse in the URI field, and enter your Github user name and password. Then, choose Next.
- Select master branch, and specify the destination directory in the next two pages, and choose Next.
- Select Import existing Eclipse projects, and then choose Next.
- Select Search for nested projects, you would see all the plugin projects and feature projects etc. Select the projects you are interested in or all the projects, and then choose Finish.
Now you have imported all the plugin projects into Eclipse, but you need to set up the target platform since the plugins have dependencies which are not the standard OSGi bundles.
- Open the terminal and step into the root folder of the repository.
- Run the setup.sh script if you haven't created the target platform:
sh setup.sh
. - Back to Eclipse, open Preferences page, choose
Plug-in Development -> Target Platform
- In the Target Platform page, choose
Add -> Next -> Add -> Software Site -> Add -> Local
to select the target repository you just built. This repository is located ataws-toolkit-eclipse/releng/com.amazonaws.eclipse.devide/target/repository
. - Type a name for this repository, say aws devide, and choose
Finish
. SelectUncategorized
and chooseFinish
- Type a name for this target platform, say AWS Target Platform, and choose
OK
. Use this new target platform, and you would be able to run the AWS plugins under this target platform. - It will rebuild the workspace with the target platform. If you see
plugin execution not covered by lifecycle configuration
, right click on the problem and selectQuick Fix -> Discover new m2e connectors
Notice: If you imported the com.amazonaws.eclipse.javasdk project into your Eclipse workspace when you are checking in the repo, you may need to close that project as it overrides the Java SDK bundle in the target platform. If the platform is set up correctly, you will see no errors in Markers
Build and test the IDE
- Right click on the aws-toolkit-for-eclipse node
run as -> run configurations
- Add an
eclipse application
configuration - In
Run a product
selectorg.eclipse.platform.ide
- In the plug ins tab make sure to select
All workspace enabled plugins and features
- Press run, it should build and run
Getting Help
- You can submit issues for bug reports and feature requests by using Github issues.
- You can also send us email at [email protected] to send feedback or report issues.