AWS Toolkit for Eclipse

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.

• Homepage
• User Guide (Source)
• Getting Started
• Blog Posts
• Issues
• Troubleshooting

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.

1. Java 8+
2. git, maven 3.3+
3. Eclipse IDE 4.4.2 (Luna) or newer
4. EGit 3.4.2+, M2Eclipse 1.5.1+ (Note: these two plugins are part of the standard Eclipse distribution since Luna)

Build and Test with Maven

1. Checkout the source code: git clone https://github.com/aws/aws-toolkit-eclipse
2. Step into the target folder: cd aws-toolkit-eclipse
3. Install the third-party dependencies and build the target platform: sh setup.sh
4. Build and test with Maven using Luna platform: mvn clean verify
5. Build and test with Maven using Mars platform: mvn -Pbuild-eclipse-mars clean verify
6. Build and test with Maven using Neon platform: mvn -Pbuild-eclipse-neon clean verify
7. Build and test with Maven using Oxygen platform: mvn -Pbuild-eclipse-oxygen clean verify

Import into Eclipse and Set up Development Environment

You must have EGit installed to your Eclipse IDE.

1. Open Eclipse, and choose File, Import, Git, Projects from Git, then choose Next.
2. Open EGit Import Wizard, then choose Clone URI, Next.
3. Type https://github.com/aws/aws-toolkit-eclipse in the URI field, and enter your Github user name and password. Then, choose Next.
4. Select master branch, and specify the destination directory in the next two pages, and choose Next.
5. Select Import existing Eclipse projects, and then choose Next.
6. 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.

1. Open the terminal and step into the root folder of the repository.
2. Run the setup.sh script if you havn't created the target platform: sh setup.sh.
3. Back to Eclipse, open Preferences page, choose Plug-in Development -> Target Platform
4. 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 at aws-toolkit-eclipse/releng/com.amazonaws.eclipse.devide/target/repository.
5. Type a name for this repository, say aws devide, and choose Finish. Select Uncategorized and choose Finish
6. 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.

Notice: If you imported the com.amazonaws.eclipse.javasdk project into your Eclipse workspace when you are checking in the repo, you need to close that project as it overrides the Java SDK bundle in the target platform.

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.