> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/docs.edgegap.com-fr/unreal-engine/plus-de-methodes-de-build.md).

# Autres méthodes de build

Ces approches sont généralement plus lentes et nécessitent une compréhension plus approfondie d’Unreal Engine.

{% hint style="success" %}
Voir [Unreal Engine](/docs.edgegap.com-fr/unreal-engine.md) pour vos premiers pas avec l’hébergement de serveurs de jeu Unreal Engine sur Edgegap.
{% endhint %}

Explorez des méthodes de build alternatives adaptées aux utilisateurs plus avancés d’Unreal Engine et d’Edgegap :

1. [#build-with-scripts](#build-with-scripts "mention") est une méthode rapide et automatisée adaptée à l’intégration continue.
2. [#build-from-plugin](#build-from-plugin "mention") est une méthode de build héritée nécessitant de compiler Unreal Engine à partir du code source.

## ⚡ Compiler avec des scripts

La compilation avec des scripts est une méthode rapide, entièrement automatisée et simple, adaptée à l’intégration continue.

### Préparation <a href="#scripts-before-starting" id="scripts-before-starting"></a>

### 1. Configurer le projet <a href="#scripts-configure-game-builds" id="scripts-configure-game-builds"></a>

### 2. Compiler et publier <a href="#scripts-build-and-upload-to-edgegap" id="scripts-build-and-upload-to-edgegap"></a>

☑️ **Vérifiez que Docker est installé et en cours d’exécution.**

{% embed url="<https://github.com/edgegap/edgegap-unreal-buildutils>" %}

☑️ **Téléchargez nos Edgegap Build Utils** y compris :

* scripts de build spécifiques à la plateforme :
  * `BuildAndUpload.ps1`  pour Windows,
  * `BuildAndUpload.sh`  pour macOS et Linux,
* `Dockerfile`  - recette pour construire vos images Docker,
* `dockerignore`  - liste des fichiers non critiques à supprimer pour accélérer les builds,
* `StartServer.sh`  - script utilitaire gérant le cycle de vie de votre Unreal Engine à l’exécution.

☑️ **Déplacez le `edgegap-unreal-buildutils` dossier vers le répertoire racine de votre projet.**

☑️ **Modifiez le `BuildAndUpload`  script pour votre plateforme** pour configurer :

* identifiants GitHub utilisés pour récupérer des images Unreal Engine précompilées pour les serveurs Linux,
* détails du projet - version du moteur, configuration du serveur, nom du fichier .uproject,
* [Registre Edgegap](https://app.edgegap.com/registry-management/repositories/list) identifiants utilisés pour téléverser vos builds terminés.

☑️ **Exécutez le script modifié** pour démarrer le processus de build et de téléversement. Une fois cette étape terminée, un nouvel **image dans votre** [page du tableau de bord du registre de conteneurs Edgegap dans votre dépôt](https://app.edgegap.com/registry-management/repositories/list).

☑️ Vous serez automatiquement redirigé vers **créer un nouveau** [Applications et versions](/docs.edgegap.com-fr/learn/orchestration/application-and-versions.md#app-versions) dans [tableau de bord](https://app.edgegap.com/application-management/applications/list)**.**

✅ Vous pouvez maintenant passer à l’étape suivante, aller directement à [#test-your-server-locally](#test-your-server-locally "mention").

## ⚡ Compiler depuis le plugin <a href="#build-from-plugin" id="build-from-plugin"></a>

Notre plugin hérité comprend des utilitaires avancés et nécessite de compiler Unreal Engine à partir du code source.

### Préparation <a href="#plugin-before-starting" id="plugin-before-starting"></a>

<details>

<summary>Configurez votre environnement de développement</summary>

* [Téléchargez le code source d’Unreal Engine](https://dev.epicgames.com/documentation/en-us/unreal-engine/downloading-unreal-engine-source-code#downloadingthesourcecode).
* [Configurez Visual Studio](https://dev.epicgames.com/documentation/en-us/unreal-engine/setting-up-visual-studio-development-environment-for-cplusplus-projects-in-unreal-engine).

</details>

<details>

<summary>Installez un plugin Unreal Engine Edgegap officiel</summary>

Choisissez l’un des plugins officiels :

* télécharger [Outils pour développeurs](/docs.edgegap.com-fr/unreal-engine/developer-tools.md#integration-kit),
* ou télécharger [Outils pour développeurs](/docs.edgegap.com-fr/unreal-engine/developer-tools.md#legacy-plugin).

</details>

### 1. Configurer le projet <a href="#scripts-configure-game-builds" id="scripts-configure-game-builds"></a>

☑️ [Compilez votre version d’Unreal Engine à partir du code source](https://dev.epicgames.com/documentation/en-us/unreal-engine/building-unreal-engine-from-source) sur votre machine de développement,

* installez [branche de version spécifique (par ex. ](https://github.com/EpicGames/UnrealEngine/tree/5.5)[`5.5`](https://github.com/EpicGames/UnrealEngine/tree/5.5)[)](https://github.com/EpicGames/UnrealEngine/tree/5.5) pour construire sur une base stable,
* **utilisez un disque SSD** pour accélérer les builds (d’environ \~12+ heures à \~2+ heures),
* cela n’est requis que la première fois et chaque fois que vous mettez à niveau votre version d’Unreal Engine.

{% hint style="warning" %}
**Téléchargez la branche avec un client git !** L’utilisation de l’interface utilisateur GitHub téléchargera toujours la branche instable `release` branche.
{% endhint %}

☑️ [Installez la toolchain officielle de cross-compilation Unreal](https://dev.epicgames.com/documentation/en-us/unreal-engine/linux-development-requirements-for-unreal-engine) pour compiler des serveurs de jeu pour Linux.

☑️ **Redémarrez votre machine de développement**, sinon vous rencontrerez des erreurs plus tard !

### 2. Compiler et publier <a href="#plugin-build-and-upload-to-edgegap" id="plugin-build-and-upload-to-edgegap"></a>

☑️ **Vérifiez que Docker est installé et en cours d’exécution.**

☑️ [Recompilez notre plugin](https://dev.epicgames.com/community/learning/tutorials/qz93/unreal-engine-building-plugins) pour votre version personnalisée d’Unreal Engine compilée à partir du code source.

☑️ **Copiez le plugin compilé** dans votre `Plugins` dossier **à la racine de votre projet Unreal** (pas le moteur).

☑️ **Lancez votre nouvel Unreal Engine** depuis Visual Studio et **ouvrez l’élément de barre d’outils Édition / Plugins**.

☑️ **Activez notre plugin** dans la section **INSTALLÉ / Autre**.

☑️ **Configurez notre plugin** en ouvrant l’élément de barre d’outils **Édition / Paramètres du projet / Edgegap**:

{% hint style="warning" %}
Appuyez toujours sur Entrée après avoir modifié les valeurs de saisie pour **vous assurer qu’elles sont correctement enregistrées**.
{% endhint %}

* **Jeton API** est nécessaire pour téléverser votre serveur vers Edgegap, obtenez-en un en cliquant sur Obtenir un jeton.
* **Nom de l’application** sur Edgegap peut correspondre au nom de votre projet ou être personnalisé, assurez-vous d’utiliser uniquement des lettres minuscules, des chiffres ou le caractère tiret `-` et trait de soulignement `_`.
* **Chemin de l’image** fournit éventuellement une icône personnalisée pour votre serveur de jeu sur Edgegap, ignorez ceci pour l’instant.
* **Nom de version** est utile pour suivre la compatibilité client/serveur et revenir en arrière en cas de problème.
  * Les horodatages sont une excellente option pour les noms de version d’application, par exemple `2024.01.30-16.50.20-UTC` .
  * Plusieurs versions d’application peuvent pointer vers le même tag d’image, comme `v1.1.0` et `dev` .
  * En savoir plus sur [Applications et versions](/docs.edgegap.com-fr/learn/orchestration/application-and-versions.md) plus tard.

{% hint style="warning" %}
**Ne réutilisez pas `latest` version** pour empêcher notre système de déployer une image obsolète (mise en cache).
{% endhint %}

☑️ Cliquez sur **Créer une application.** Une fois cette étape terminée, il en résultera **une nouvelle application apparaissant** dans [Tableau de bord Edgegap](https://app.edgegap.com/application-management/applications/list).

☑️ Ignorez pour l’instant les paramètres personnalisés du registre de conteneurs, vous pourrez utiliser un registre tiers plus tard si vous le souhaitez.

☑️ Une fois que vous êtes satisfait de votre configuration, cliquez sur **Compiler et pousser**, attendez la fin du processus et vérifiez qu’il n’y a pas de nouvelles erreurs dans votre console Unreal. Une fois cette étape terminée, il en résultera **nouveau dossier dans la racine de votre projet** - `Saved/LinuxServer`. En outre, une **nouvelle image apparaît maintenant dans votre** [page du tableau de bord du registre de conteneurs Edgegap sous votre dépôt](https://app.edgegap.com/registry-management/repositories/list), et une nouvelle [Applications et versions](/docs.edgegap.com-fr/learn/orchestration/application-and-versions.md#app-versions) **apparaît dans votre** [tableau de bord sous votre application](https://app.edgegap.com/application-management/applications/list)**.**

☑️ Dans votre nouvelle version d’application, définissez la variable d’environnement `TARGET_FILE_NAME`  pour qu’elle corresponde à votre `DefaultServerTarget`  valeur de l’étape [#id-2.-configure-game-server-builds-1](#id-2.-configure-game-server-builds-1 "mention").

✅ Vous pouvez maintenant passer à l’étape suivante.

## 👉 Prochaines étapes

Continuez vers [/pages/a5a0949e4835c97d66e4d98d4172f7a55c2c3eec#id-5.-deploy-to-cloud](https://docs.edgegap.com/docs.edgegap.com-fr/unreal-engine/pages/a5a0949e4835c97d66e4d98d4172f7a55c2c3eec#id-5.-deploy-to-cloud "mention") avec notre [Déploiement via le tableau de bord](https://app.edgegap.com/deployment-management/deployments/list) fonctionnalité et apprenez-en davantage sur l’arrêt de vos déploiements, les variables injectées et la paramétrisation, ainsi que la découvrabilité des serveurs.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.edgegap.com/docs.edgegap.com-fr/unreal-engine/plus-de-methodes-de-build.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
