AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse

Open the AEM Developer Tools Web Site.

Copy the Installation Link.

Alternatively you can download an archive instead of using the installation link. This method allows offline installation but you do not receive miss automatic update notifications this way.

In Eclipse, open the Help menu.

Click Install New Software.

Click Add….

In the Name field, enter AEM Developer Tools.

In the Location field, copy the installation URL.

Click Add.

Check both AEM and Sling plugins.

Click Next.

In the Install Details window, click Next again.

Accept the license agreements and click Finish.

Click RestartNow to restart Eclipse.

In the File > New > Project menu, browse to the AEM section and select AEM Sample Multi-Module Project.

Click Next.

Choose com.adobe.granite.archetypes : sample-project-archetype : <highest-number> from the menu, then click Next.

Provide the following fields for the sample project:

• Name
• Group Id
• Artifact Id
• appId - You may need to expand the Advanced options to set this value.
• appTitle - You may need to expand the Advanced options to set this value.
• Package - You may need to expand the Advanced options to set this value.

Click Next.

You then configure an AEM server to which Eclipse connects.

To use the debugger feature, you need to have started AEM in debug mode - which can be achieved, for by adding the following to the command line:

    -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123

Click Finish. The project structure is created.

Follow the instructions to create a Sample Multi-Module Project and you have the following projects created for you, which permit a healthy separation of concerns:

• PROJECT.ui.apps for /apps and /etc content
• PROJECT.ui.content for /content that is authored
• PROJECT.core for Java™ bundles (these become interesting when you want to add Java™ code)
• PROJECT.it.launcher and PROJECT.it.tests for integration tests

Replace the content of your PROJECT.ui.apps project with the apps and etc folders of your package:

1. In the Project Explorer panel, unfold PROJECT.ui.apps > src > main > content > jcr_root > apps.
2. Right-click the apps folder and choose Show In > System Explorer.
3. Delete the apps and etc folders that you should now see and place here the apps and etc folders of your content package.
4. In Eclipse, right-click the PROJECT.ui.apps project and choose Refresh.

Then do the same for the PROJECT.ui.content and replace its content folder with the one of your packages:

1. In the Project Explorer panel, unfold PROJECT.ui.content > src > main > content > jcr_root > content.
2. Right-click the deeper content folder and choose Show In > System Explorer.
3. Delete the content folder that you should now see and place here the content folder of your content package.
4. In Eclipse, right-click the PROJECT.ui.content project and choose Refresh.

Now you have to update the filter.xml files of these two projects to correspond to the content of your content package. For that, open the META-INF/vault/filter.xml file of your content package in a separate text/code editor.

• This is an example of how your filter.xml file can look:

<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
    <filter root="/apps/foo"/>
    <filter root="/apps/foundation/components/bar"/>
    <filter root="/etc/designs/foo"/>
    <filter root="/content/foo"/>
    <filter root="/content/dam/foo"/>
    <filter root="/content/usergenerated/content/foo"/>
</workspaceFilter>

As for the content of your package that was split into two projects, you must also split these filter rules into two and update accordingly the filter.xml files of the two projects.

1. In Eclipse, open PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

2. Replace the content of the <workspaceFilter> element with the rules of your package that start with /apps and /etc

   • For example:

     code language-xml
     <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/apps/foo"/> <filter root="/apps/foundation/components/bar"/> <filter root="/etc/designs/foo"/> </workspaceFilter>

3. Then open PROJECT.ui.content/src/main/content/META-INF/filter.xml.

4. Replace the rules with the ones of your package that start with /content.

   • For example:

     code language-xml
     <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/content/foo"/> <filter root="/content/dam/foo"/> <filter root="/content/usergenerated/content/foo"/> </workspaceFilter>

Make sure to save all your changes. You can now synchronize that new content to your AEM instance.

In the Servers panel, make sure that your connection is started, and if not start it.

Click the Clean and Publish icon.