STS3 Migration

Migration Guide from Spring Tool Suite 3 (STS) to Spring Tools 4

Preface

Migrating to the Spring Tools 4 in Eclipse is not complicated or requires a huge amount of work. The overall goal is that most of your projects will "just work" in the Spring Tools 4 for Eclipse.

However, the feature set of the Spring Tools 4 for Eclipse and the overall user experience is quite different. So before you migrate, we recommend that you make yourself familiar with the way the Spring Tools 4 work using a sample project or a project of your choice, read through the user guide for Spring Tools 4 in this wiki, and take a look at the feature comparison between Spring Tool Suite 3 and Spring Tools 4 here.

We would recommend to do the migration in these steps:

1. Make yourself familiar with Spring Tools 4 (as described above)
2. backup your projects and your workspace (including its metadata)
3. start with a fresh Spring Tools 4 for Eclipse distribution (do not update an existing STS3 install)
4. make sure to install all your additional third-party plugins into that fresh install
5. try to open your workspace using the new and fresh Spring Tools 4 installation

Common problems and how to solve them

Spring Perspective looks strange and broken

In case you had the Spring Perspective open in your workspace when working with the Spring Tool Suite 3, opening up that workspace will re-open the Spring Perspective again, but it doesn't really exist anymore in the Spring Tools 4. Therefore the workbench looks broken, shows red icons for some empty views, and similar things.

You can solve that by simply closing the Spring Perspective. Right-click on the perspective text at the top of the workbench and select "Close". And continue to use a different perspective, like the default Java one.

Error on pom.xml file

On certain projects, the is an error showing up on the pom.xml files, saying: Project configuration is not up-to-date with pom.xml. Select: Maven->Update Project... from the project context menu or use Quick Fix.. Following the advice in the description will usually fix the issue.

Depending on the additional third-party m2e extensions that you might have installed into your previous Spring Tool Suite 3 installation, more errors and warnings no our pom.xml files might not go away after updating the Maven project. In those cases, you might need to re-install those m2e extensions into your new Spring Tools 4 for Eclipse install.

(if you have additional advice or came across specific issues here, please let us know or submit a pull request for this page to fill it up with additional details and information)

Unknown reference to Spring nature

Most of the projects in your workspace will surface a warning saying: Unknown referenced nature: org.springframework.ide.eclipse.core.springnature.. The reason for that is that the Spring project nature from the Spring Tool Suite 3 is still part of your project metadata (in the .project file), but no longer exists in the Spring Tools 4 for Eclipse. The best way to deal with this is either to ignore this warning (in case you want to continue to use the same project with an Spring Tool Suite 3 installation, e.g. of your team mates) or to delete the line from your .project file. For example:

  ...
  <natures>
    <nature>org.springframework.ide.eclipse.core.springnature</nature> <== DELETE THIS LINE
    <nature>org.eclipse.jdt.core.javanature</nature>
    <nature>org.eclipse.m2e.core.maven2Nature</nature>
    <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
  </natures>
  ...

Project facet for Cloud Foundry standalone app not found

Another warning that might appear in your workspace says: Implementation of project facet cloudfoundry.standalone.app could not be found. Functionality will be limited.. This is caused by the fact that the Spring Tools 4 for Eclipse do not include the Cloud Foundry Integration for Eclipse add-on by default, which contributed the above mentioned project facet and probably got added to your Spring projects automatically. In case you don't need the Cloud Foundry Integration for Eclipse, you can open the properties of the project, select the Project Facets node and deselect the entry called cloudfoundry.standalone.app.