sergi-e/update-carla (#2437)

* Update second draft

* New fix l86

* Fourth draft on Update CARLA
This commit is contained in:
sergi.e 2020-02-07 13:59:31 +01:00 committed by GitHub
parent 49a09ff841
commit 0a822af312
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 101 additions and 1 deletions

99
Docs/update_carla.md Normal file
View File

@ -0,0 +1,99 @@
<h1>Update CARLA</h1>
* [__Get lastest binary release__](#get-latest-binary-release)
* [__Update Linux and Windows build__](#update-linux-and-windows-build)
* Clean the build
* Pull from origin
* Download the assets
* Launch the server
* [__Get development assets__](#get-development-assets)
To post unexpected issues, doubts or suggestions, feel free to login in the CARLA forum.
<div class="build-buttons">
<!-- Latest release button -->
<p>
<a href="https://forum.carla.org/" target="_blank" class="btn btn-neutral" title="Go to the latest CARLA release">
CARLA forum</a>
</p>
</div>
---------------
##Get latest binary release
Binary releases are prepackaged and thus, tied to a specific version of CARLA. In order to get the latest, erase the previous one and follow the procedure stated in the [quick start installation](../getting_started/quickstart). In the CARLA repository, releases are listed in __Development__ and there is also a highly experimental __Nightly build__ containing the current state of CARLA up to date:
<div class="build-buttons">
<!-- Latest release button -->
<p>
<a href="https://github.com/carla-simulator/carla/blob/master/Docs/download.md" target="_blank" class="btn btn-neutral" title="Go to the latest CARLA release">
<span class="icon icon-github"></span> Get the latest release</a>
</p>
<!-- Nightly build button -->
<p>
<a href="http://carla-assets-internal.s3.amazonaws.com/Releases/Linux/Dev/CARLA_Latest.tar.gz" target="_blank" class="btn btn-neutral" title="Go to the nightly CARLA build">
<span class="icon fa-cloud-download"></span> Get the nightly build</a>
</p>
</div>
-------------------
##Update Linux and Windows build
!!! Important
Make sure to be in the local `master` branch before updating to then merge or rebase the changes to other branches.
The process of updating is quite similar and straightforward for both platforms:
<h4>Clean the build</h4>
Go to the CARLA main directory and delete binaries and temporals generated by previous build:
```sh
git checkout master
make clean
```
<h4>Pull from origin</h4>
Get the current version from `master` in the CARLA repository:
```sh
git pull origin master
```
<h4>Download the assets</h4>
__Linux:__
```sh
./Update.sh
```
__Windows:__
- Erase the previous content in `Unreal\CarlaUE4\Content\Carla`.
- Go to `\Util\ContentVersions.txt`.
- Download the content for `latest`.
- Extract the new content in `Unreal\CarlaUE4\Content\Carla`.
!!! Note
In order to work with the current content used by developers in the CARLA team, follow the get development assets section right below this one.
<h4>Launch the server</h4>
Run the editor with the spectator view to be sure that everything worked properly:
```sh
make launch
```
-------------------
##Get development assets
The 3D assets, models, and maps have also a [public git repository][contentrepolink] where the CARLA team regularly pushes latest updates. However, using this version of the content is only recommended to developers, as it may contain unfinished maps and/or models.
In order to handle this repository it is highly recommended to install [git-lfs][gitlfslink], as it works faster with large binary files, and these are modified regularly. To clone this repository **go to the main CARLA directory** and run the following command:
```sh
git clone https://bitbucket.org/carla-simulator/carla-content Unreal/CarlaUE4/Content/Carla
```
!!! Warning
Delete the `/Carla` folder containing the assets before using the previous command. Otherwise, an error will show.
[contentrepolink]: https://bitbucket.org/carla-simulator/carla-content
[gitlfslink]: https://github.com/git-lfs/git-lfs/wiki/Installation

View File

@ -13,7 +13,7 @@ nav:
- Building CARLA:
- 'Linux build': 'how_to_build_on_linux.md'
- 'Windows build': 'how_to_build_on_windows.md'
- "Get latest content": 'dev/how_to_upgrade_content.md'
- 'Update CARLA': 'update_carla.md'
- 'Build system': 'dev/build_system.md'
- 'Running in a Docker': 'carla_docker.md'
- 'F.A.Q.': 'faq.md'
@ -47,6 +47,7 @@ nav:
- 'Coding standard': 'coding_standard.md'
- 'Documentation standard': 'doc_standard.md'
- "Make a release": 'dev/how_to_make_a_release.md'
- "Upgrade the content": 'dev/how_to_upgrade_content.md'
- 'Code of conduct': 'CODE_OF_CONDUCT.md'
markdown_extensions: