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.
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)
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.4.2 (Luna) or newer
- 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
- Checkout the source code:
git clone https://github.com/aws/aws-toolkit-eclipse
- Step into the target folder:
- Install the third-party dependencies and build the target platform:
- Build and test with Maven using Luna platform:
mvn clean verify
- Build and test with Maven using Mars platform:
mvn -Pbuild-eclipse-mars clean verify
- Build and test with Maven using Neon platform:
mvn -Pbuild-eclipse-neon clean verify
- 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.
- 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 havn't created the target platform:
- Back to Eclipse, open Preferences page, choose
Plug-in Development -> Target Platform
- In the Target Platform page, choose
Add -> Next -> Add -> Software Site -> Add -> Localto select the target repository you just built. This repository is located at
- Type a name for this repository, say aws devide, and choose
- 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.