Update UE5_BUILD_README.md (#8617)
* Update UE5_BUILD_README.md Updated readme for new Python installation parameters * Update README.md * Update README.md * Update README.md
This commit is contained in:
parent
3ccf69e20a
commit
f724ca762a
10
README.md
10
README.md
|
@ -100,6 +100,8 @@ cd CarlaUE5
|
|||
|
||||
The setup script will prompt you for your sudo password, in order to install the prerequisites. It will then prompt you for your GitHub credentials in order to authorise the download of the Unreal Engine repository.
|
||||
|
||||
The setup script will install by default Python 3 using apt. If you want to target an existing Python installation, you should use the `--python-root=PATH_TO_PYTHON` argument with the relevant Python installation path. You can use whereis python3 in your chosen environment and strip the `/python3` suffix from the path.
|
||||
|
||||
__Building in Linux unattended__:
|
||||
|
||||
If you want to run the setup script unattended, your git credentials need to be stored in an environment variable. Add your github credentials to your `.bashrc` file:
|
||||
|
@ -144,16 +146,18 @@ __Configure__:
|
|||
Linux:
|
||||
|
||||
```sh
|
||||
cmake -G Ninja -S . -B Build --toolchain=$PWD/CMake/LinuxToolchain.cmake \
|
||||
-DLAUNCH_ARGS="-prefernvidia" -DCMAKE_BUILD_TYPE=Release -DENABLE_ROS2=ON
|
||||
cmake -G Ninja -S . -B Build --toolchain=$PWD/CMake/Toolchain.cmake -DCMAKE_BUILD_TYPE=Release -DENABLE_ROS2=ON
|
||||
```
|
||||
|
||||
Windows:
|
||||
|
||||
```sh
|
||||
cmake -G Ninja -S . -B Build -DCMAKE_BUILD_TYPE=Release
|
||||
cmake -G Ninja -S . -B Build --toolchain=$PWD/CMake/Toolchain.cmake -DCMAKE_BUILD_TYPE=Release
|
||||
```
|
||||
|
||||
>[!NOTE]
|
||||
> If you intend to target a specific Python installation, you should add both these arguments to the above cmake command: `-DPython_ROOT_DIR=PATH` and `-DPython3_ROOT_DIR=PATH`.
|
||||
|
||||
__Build__:
|
||||
|
||||
Linux and Windows:
|
||||
|
|
|
@ -27,10 +27,11 @@ env GIT_LOCAL_CREDENTIALS=your_user@your_token bash -x CarlaSetup.sh
|
|||
|
||||
The Setup.sh script installs all the required packages, including Cmake, debian packages, Python packages and Unreal Engine 5.3. It also downloads the CARLA content and builds CARLA. This script can therefore take a long time to complete.
|
||||
|
||||
The setup script will install by default Python 3 using `apt`. If you want to target an existing Python installation, you should use the `--python-root=PATH_TO_PYTHON` argument with the relevant Python installation path. You can use `whereis python3` in your chosen environment and strip the `/python3` suffix from the path.
|
||||
|
||||
> [!NOTE]
|
||||
> * This version of CARLA requires the **CARLA fork of Unreal Engine 5.3**. You need to link your GitHub account to Epic Games in order to gain permission to clone the UE repository. If you have not already linked your accounts, follow [this guide](https://www.unrealengine.com/en-US/ue4-on-github)
|
||||
> * For using CARLA Unreal Engine 5 previous builds, **ensure CARLA_UNREAL_ENGINE_PATH environment variable is defined** pointing to the CARLA Unreal Engine 5.3 absolute path. If this variable is not defined, the Setup.sh script will download and build CARLA Unreal Engine 5 and **this takes more than 1 extra hour of build and 225Gb of disk space**.
|
||||
> * The Setup.sh script checks if there is any Python installed at the top of the PATH variable, and installs Python otherwise. **To use your own version of Python, ensure that the PATH variable is properly set for Python before running the script**.
|
||||
> * CARLA cannot be built on an external disk, Ubuntu is not giving the required read/write/execution permissions for builds.
|
||||
|
||||
|
||||
|
@ -41,11 +42,14 @@ The setup script launches the following commands itself, you will need to use th
|
|||
* Configure:
|
||||
|
||||
```sh
|
||||
cmake -G Ninja -S . -B Build --toolchain=$PWD/CMake/LinuxToolchain.cmake \
|
||||
cmake -G Ninja -S . -B Build --toolchain=$PWD/CMake/Toolchain.cmake \
|
||||
-DLAUNCH_ARGS="-prefernvidia" -DCMAKE_BUILD_TYPE=Release -DENABLE_ROS2=ON \
|
||||
-DBUILD_CARLA_UNREAL=ON -DCARLA_UNREAL_ENGINE_PATH=$CARLA_UNREAL_ENGINE_PATH
|
||||
```
|
||||
|
||||
> [!NOTE]
|
||||
> If you intend to target a specific Python installation, you should add both these arguments to the above cmake command: `-DPython_ROOT_DIR=PATH` and `-DPython3_ROOT_DIR=PATH`.
|
||||
|
||||
* Build CARLA:
|
||||
|
||||
```sh
|
||||
|
@ -167,4 +171,4 @@ The package will be generated in the directory `Build/Package`
|
|||
|
||||
## Run the package
|
||||
|
||||
The package build is not yet tested for Windows
|
||||
The package build is not yet tested for Windows
|
||||
|
|
Loading…
Reference in New Issue