Installation and setup
Important: make sure you have read the Key concepts page and familiarised yourself with all of the relevant background material prior to following the steps below.
Prerequisites and Python package installation
Since conan-ue4cli is a plugin for ue4cli, it shares the same requirements:
- Python version 3.5 or newer
- Unreal Engine 4.19.0 or newer
To install ue4cli and conan-ue4cli, run the following command:
This will install both ue4cli and conan-ue4cli, along with their dependencies, including the Conan C++ package management system.
Generating Conan profiles and wrapper packages
In order to compile code that is compatible with a given version of the Unreal Engine, UE4 Conan profiles and Wrapper packages must first be generated for that Engine version. Rather than requesting the path to the Unreal Engine from the user, conan-ue4cli uses the Engine installation that ue4cli is currently configured to act as an interface for.
There is one important factor that must be taken into consideration when performing profile and wrapper package generation. Installed Builds of the Unreal Engine (such as those distributed via the Epic Games Launcher) do not contain the full set of files for all of the the Unreal Engine’s bundled third-party libraries, whereas Engine installations that have been built from source do include all of the required files. As a result, the workflow for profile and wrapper package generation varies depending on whether you are working with a source build of the Unreal Engine or an Installed Build:
- If you are using a source build of the Unreal Engine then you simply need to ensure
ue4cliis configured to act as an interface to your Engine installation prior to running the ue4 conan generate command:
- If you are using an Installed Build of the Unreal Engine then you will need to download the source code for the relevant Engine version and use the source tree for generating profiles and wrapper packages. Fortunately, it is not necessary to build the Engine from this source tree, merely to run the
GenerateProjectFiles.shscripts to download the required third-party dependency files and build UnrealBuildTool (UBT) so it can be queried for information. After profile and wrapper package generation is complete then ue4cli can be configured to act as an interface to the Installed Build you normally use:
Once profile and wrapper package generation has completed successfully then you are ready to move on to Creating Conan packages.
Installation using a Docker container image
If you have used ue4-docker to build the ue4-full container image for your version of the Unreal Engine then you already have a fully-configured installation of conan-ue4cli inside the container image, including generated UE4 Conan profiles and Wrapper packages for the encapsulated Unreal Engine installation. This installation can be used as-is inside Docker containers or alternatively used to bootstrap the process of configuring conan-ue4cli on the host system:
If you want to use conan-ue4cli inside a container, simply start a container using the built ue4-full container image and you will immediately have access to all conan-ue4cli commands.
If you want to use the container image to bootstrap the process of configuring conan-ue4cli on the host system, you can use the ue4-docker export command from ue4-docker to export generated wrapper packages to the host system and then create Conan profiles to make use of them:
Once you have a container image that you will use, or the host system has been bootstrapped successfully, then you are ready to move on to Creating Conan packages.