This tutorial and repository provides documentation and resources on how to configure a Jenkins CI installation to build and compile an Unreal Engine 4 project.
Before you begin: This documentation is solely meant for Jenkins running on Windows servers and desktops. This may also work on GNU/Linux build servers, however the included build scripts have only been tested for Windows installations.
Clone (or download) this repository to your CI server to access the required build files for the final steps of the tutorial.
You will also need to download cURL (only if posting notifications to Slack), Unreal Engine 4, as well as install MSBuild v14.0.
This first step is pretty straightforward. Once Jenkins is configured, start by creating a new Freestyle project.
Under General > Advanced check Use custom workspace and put the directory on the root of your drive, to prevent issues with long filenames during the build. Something like
C:\Source\<project name> or similar should do the job.
Set up your source control repository as normal.
For our configuration, we poll the SCM every 3 minutes for changes, and build only if a certain keyword is present in the commit message. To do so, enter
H/3 * * * * within the Schedule textbox. To trigger on commit messages, scroll back up to Source Code Management, click Advanced, and under Excluded Commit Messages enter
KEYWORD with your own keyword to check for.
Locate the directory where you downloaded the build scripts to. If you plan on posting to a Slack channel during the build process, you will need to configure an incomming webhook integration, and replace
WEBHOOK_URL with the URL of the integration in
In each of the build scripts, make sure to replace
PROJECT_NAME with the name of your project.
Finally, add the build commands to Jenkins. At this point, you should have the build scripts somewhere on your server. Take note of the directory they reside in. For our setup, we post to a Slack channel during each step of the build. If you would also like to do this, make sure to include the
PostToSlack.bat files during each step, as laid out below:
Make sure to replace
C:\path\to\scripts\ with the actual path of your build scripts!
call C:\path\to\scripts\PostToSlack.bat "✔️ Starting %JOB_NAME% Build -- Revision %SVN_REVISION%" "C:\path\to\scripts\Step1_StartBuild.bat"
call C:\path\to\scripts\PostToSlack.bat "⚙️ Compiling game scripts..." "C:\path\to\scripts\Step2_CompileScripts.bat"
call C:\path\to\scripts\PostToSlack.bat "🔨 Building project files..." "C:\path\to\scripts\Step3_BuildFiles.bat"
call C:\path\to\scripts\PostToSlack.bat "🔥 Cooking project..." "C:\path\to\scripts\Step4_CookProject.bat"
call C:\path\to\scripts\PostToSlack.bat "📦 Archiving build..." C:\path\to\scripts\Step5_Archive.bat "%SVN_REVISION%"
C:\path\to\scripts\PostToSlack.bat "🎉 Done!"
...and that should be it! Feel free to run a test build to see if everything builds and compiles correctly. The first build will take longer than normal, as Jenkins has to download all of the files from the repository specified.