Build the Source Code
Build the Source Code
Checkout Source Code
Do not save your source projects to a directory that is greater than 20 characters in length. Windows file paths are limited to 260 characters. The longest file path in the source code is greater than 230 characters so be careful where you deploy your source files.
Configure Maven Settings.xml
You need to configure your local copy of the settings.xml, which is available in the extensions project before you build the source code.
- With the command line, create a .m2 directory in your user home folder. In Windows,
the command is:
- mkdir C:\Users\<YourWindowsUser>\.m2
- Copy settings.xml from the \extensions\maven source directory to your .m2 directory.
- Modify settings.xml values to match your local developer environment. Pay attention
to:
Property Profile Definition epdb.reset_user mysql-dev-db The DB account with administrative permissions that can drop and create databases and users in your local database. epdb.reset_password mysql-dev-db The password for epdb.reset_user. ep.local.asset.path - The path to your local /extensions/assets/ext-assets/src/main/assets source directory ep.smtp.host - Your SMTP Server Tip:If these property values do not exist in the settings.xml, then your source code has likely not been prepared according to Starting Construction and you will not be able to build and deploy the Elastic Path Web Applications.
Build Commerce Engine
- With the command line, navigate to the commerce-engine directory in your source directory.
- Enter the following Maven command to build Commerce
Engine:
The -DskipAllTests stops Maven from executing any unit and integration tests, but does not stop them from building the tests. For more information on assets, see Managing Assets. For more details on the Maven arguments, see Elastic Path Maven Commands.- mvn clean install -DskipAllTests
Build Extension Projects
- With the command line, navigate to the extensions directory in your source directory.
- Enter the following Maven command to build Commerce Engine:
- mvn clean install -DskipAllTests
Build Commerce Manager Client
After building the Commerce Engine, you can build the Commerce Manager Client, a desktop application that lets you manage your Elastic Path stores.
- With the command line, navigate to <Source Code Root>\cmclient, and enter the following command to build the Commerce Manager Client:
The Commerce Manager client's executable file will be located in the cmclient\product\target\<your architecture>\commercemanager directory, where <your architecture> is one of the platform profiles listed below.- mvn install -DskipAllTests
Building the Commerce Manager Client for Other Platforms
By default, the Commerce Manager Client will build for your local platform. If you would like to build the Commerce Manager Client for a specific platform, follow the instructions below:
- With the command line, navigate to <Source Code Root>\cmclient
- Run one of the following commands:
- To build the Commerce Manager Client for a specific platform:
- mvn package -P<TargetPlatform>,!<CurrentPlatform>
- To build the Commerce Manager Client for all supported platforms:
You may build the Commerce Manager Client for the following platforms:- mvn package -Pmulti-platform
- mvn package -Pwin32-win32-i386,win32-win32-amd64,\!mac-cocoa-i386
- To build the Commerce Manager Client for a specific platform: