Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Point to official documentation

Sling IDE Tooling User Guide

Prerequisites

The Sling IDE tooling is known to work on Eclipse versions starting with Indigo. There is a hard dependency on the faceted project framework, which is included in the 'Eclipse IDE for Java EE Developers' package. If you're running a different package, you can always install it from the main Eclipse update site.

There is an optional feature which relies on m2eclipse. For now it only provides project creation wizards, so if you don't use Maven you don't have to install it.

Installation

There is no official release yet, but I ( Robert Munteanu ) am maintaining unnoficial preview builds at The contents of this page has moved to http://peoplesling.apache.org/~rombertdocumentation/slingdevelopment/ide/preview/Image Removed . Feel tree to give them a try.

Overall concepts

The Sling IDE tooling is centered around the Server and Module concepts. A Server is an instance of a Sling launchpad - or derivatives such as Adobe CQ - on which you deploy your content. A Module is a collection of resources grouped into a single Eclipse project which can be deployed onto one or multiple Servers.

The tooling supports content and bundle modules. Content modules typically hold Sling scripts - like JSP and ESP files, client-side resources like CSS and JSS file, but also arbitrary repository content. Bundle modules represent a single OSGi bundle.

Server definition

To create a new Sling launchpad server you will need to start a Sling launchpad outside of Eclipse. We do not yet support starting Sling Launchpad instances from Eclipse.

To kick off, create a new Sling Launchpad Server using the File -> New -> Other... menu entry.

Image Removed

In the resulting wizard, select the External Sling Launchpad category and enter the host name.

Image Removed

Once that is done, press finish.

Server configuration

The server will appear in the servers view. You can double-click on it to review the settings which were automatically provided.

Image Removed

There are a couple of important settings in the server definition page:

  • port: used for connecting to the server
  • publishing interval: controls how fast the resources will be published after a change. We recommend setting the interval to 0, for fast deploy times
  • username, password, context path: controls the connection details to the CQ instance.
  • debug port: used for connecting in debug mode

Image Removed

You can now connect to the server

Content sync

Bundle sync

...

-tooling.html . Downloads can be found at http://sling.apache.org/downloads.cgi