Install git, JDK, gradle and groovy
git
Download and run 64-bit Git for Windows Setup: https://git-scm.com/download/win
JDK
Download and run microsoft-jdk-17.x.y.z-windows-x64.msi: https://docs.microsoft.com/en-us/java/openjdk/download
Gradle
Create an empty directory C:\Gradle
and download und extract the ZIP file from https://gradle.org/next-steps/?version=7.5.1&format=bin into this directory.
Groovy
Create an empty directory C:\Groovy
and download and extract the ZIP file from https://groovy.apache.org/download.html into this directory.
Install Pinuts Dev Tools / Scripts
Clone the following git repository using PowerShell:
C: cd \ git clone https://gitext.pinuts.de/um-public/devtools.git UM-Dev-Tools
Set global environment variables
Open the Windows (File) Explorer, right-click on This PC and select Properties.
Chose Advanced system settings from the right side bar and open Environment Variables.
Double click the Path environment variable under System variables and add the following three paths:
C:\Gradle\gradle-7.5.1\bin
C:\Groovy\groovy-4.0.4\bin
C:\UM-Dev-Tools\bin
(Be sure to actually specify the correct paths including the matching version numbers.)
Access to Pinuts maven repository
After having received your credentials for the Pinuts maven repository, add them as User variables:
PINUTS_MAVENREPO_USERNAME
: <access-key-id>PINUTS_MAVENREPO_PASSWORD
: <secret-value>
Visual Studio Code
This step is optional but strongly recommended:
Download and install Visual Studio Code from https://code.visualstudio.com/download
Reboot
Reboot once to activate the newly set environment variables.
umkickstarter
The freshly installed PowerShell script C:\UM-Dev-Tools\bin\umkickstarter.ps1
creates a new directory (default: .\umkickstarter
) and prepares the directory and file structure needed to start developing a new UM project. Open PowerShell and try:
umkickstarter my-um-app
Optionally you can pass the package name of an UM plugin that should be scaffolded as well:
umkickstarter my-um-app --name acme.myumapp
License
After having received your development UM license, copy the file to env/devel/cmsbs-conf/cmsbs.license
.
Next steps…
Read more about the Kickstarter: Kickstarter.md