Requirements for Setting up your Developer Environment

Overview

A developer environment is the local environment used by Java programmers to implement Self-Managed Commerce custom functionality. The developer environment is often installed on the programmer's personal workstation. Follow the instructions in this guide to set up a standard Elastic Path developer environment with the following:

• Azul Zulu OpenJDK™ 17
• Apache Maven 3.9.1

After completing the setup instructions, you can:

• Build and run Elastic Path Web Applications from the command line
• Import the projects into an IDE of your choice for development

System Hardware Requirements

Your developer environment must meet the following minimum requirements:

• Processor: 2.5 GHz quad-core processor
• RAM: 16 GB
• Hard Drive: Solid state drive

Prerequisites

Before you begin setting up your developer environment, you must set up either a team infrastructure environment or a Proof of Concept infrastructure environment with the following items:

• A Maven repository
• Elastic Path source code

Install Development Tools

Zulu Java

Development on Elastic Path requires Azul Zulu OpenJDK™ 17.

1. Go to the Azul Zulu OpenJDK site.
2. In the Java Version field, select Java 17.
3. In the Operating System field, select an operating system.
4. Download and extract the appropriate installation file.

note

To see the exact version of Java supported by Self-Managed Commerce, see Supported Technologies.

Apache Maven

Apache Maven is a dependency management and project build system that is required to build this version of Self-Managed Commerce.

Maven Compatibility

This version of Self-Managed Commerce requires Maven 3.9.1.

To install Maven (on Windows):

1. Go to Maven distribution.
2. Download the Maven 3.9.1 (Binary zip): apache-maven-3.9.1-bin.zip.
3. Unzip apache-maven-3.9.1-bin.zip to C:\apache-maven-3.9.1 (For Windows).

To install Maven (on Mac or Linux):

1. Go to Maven distribution.

2. Download the Maven 3.9.1 (Binary tar.gz): apache-maven-3.9.1-bin.tar.gz.

3. Create a tools directory in your home folder and extract Maven to it:

   mkdir -p ~/tools && tar -xzf apache-maven-3.9.1-bin.tar.gz -C ~/tools/

Git

Git is a source code management tool for retrieving and merging source code with other developers.

Download from Git Downloads.