L'Unreal Engine (UE) prend en charge le développement sur les appareils Linux avec des builds créés à partir de code source ou de builds installés précompilés. Dans cette page, nous vous fournissons des instructions de configuration de l'Unreal Engine sous Linux, notamment votre environnement de développement et votre pipeline de version. À l'issue de ce tutoriel, vous serez en mesure de développer des applications dans l'Unreal Engine sur votre machine Linux.
1. Logiciels et matériel recommandés
L'Unreal Engine est compatible avec diverses distributions et EDI Linux, à condition de présenter la configuration minimale suivante :
| Exécuter le moteur | |
|---|---|
Système d'exploitation | Rocky Linux 8 / Redhat Linux 8 ou ultérieur |
Version de noyau Linux | noyau 4.18 ou ultérieur |
Dépendances supplémentaires | glibc 2.28 ou ultérieur |
Si le chargement de l'Unreal Editor ou de jeux UE installés est trop lent, assurez-vous que vous utilisez la version 2.35 de glibc ou une version ultérieure, l'implémentation de dlopen s'avérant lente dans les versions précédentes.
Nous vous recommandons de disposer d'un système respectant les normes suivantes pour assurer un fonctionnement optimal de l'Unreal Editor :
Recommended Operating System | Ubuntu 22.04 |
Processor | Quad-core Intel or AMD, 2.5 GHz or faster |
Memory | 32 GB RAM |
Graphics Card | GeForce 2080 |
Graphics RAM | 8 GB or more |
RHI Version | Vulkan: AMD (RADV minimum 24.2.8+, recommended 25.0.0+) and NVIDIA (570+) |
Comparée à d'autres backends, l'interface matérielle de rendu (RHI) Vulkan utilisée sous Linux n'est pas compatible avec les faibles quantités de VRAM. Il est vivement recommandé d'utiliser un processeur graphique dédié avec une grande quantité de VRAM.
Pour configurer votre environnement de développement, nous vous recommandons le logiciel suivant, que nous utilisons le plus souvent pour les tests :
| Développer avec le moteur | |
|---|---|
Système d'exploitation | Ubuntu 22.04, Rocky Linux 8 |
Compilateur | Clang 18.1.0 |
Facultatif | |
EDI | Visual Studio Code, Rider |
Pour en savoir plus sur leur configuration, consultez la documentation de votre distribution Linux ou de votre EDI. Bien que cette documentation ne traite pas la configuration de votre SE et de votre matériel, la configuration de votre IDE pour fonctionner avec l'Unreal Engine est abordée ci-dessous.
2. Installer l'Unreal Engine
Pour configurer l'Unreal Engine sous Linux, vous pouvez en installer une version précompilée ou compiler le moteur à partir du code source.
2a. Télécharger une version installée
Pour exécuter l'Unreal Engine, la solution la plus simple consiste à utiliser une version installée. Pour en télécharger une et l'installer, procédez comme suit :
L'Unreal Engine est disponible sur Linux sous la forme d'un build d'installation précompilé ou d'un build de code source. Pour en savoir plus sur l'utilisation des builds sources, consultez Building Unreal Engine from Source (Compiler l'Unreal Engine à partir du code source).
Pour utiliser un build précompilé, suivez la procédure suivante :
Ouvrez la page Unreal Engine for Linux. Un message vous invite à vous connecter à votre compte Epic Games ou à en créer un. Si vous en possédez déjà un, connectez-vous pour accéder à la page. Si vous ne possédez pas de compte, cliquez sur S'inscrire pour en créer un.
Vous pouvez créer un compte Epic Games avec votre adresse e-mail ou avec votre compte sur une plateforme de jeux vidéo/un réseau social pris en charge.
Téléchargez le fichier
.zipcontenant la version de l'Unreal Engine dont vous avez besoin.Décompressez le contenu du fichier
.zipdans le répertoire d'installation souhaité.Exécutez
Engine/Binaries/Linux/UnrealEditordepuis le terminal pour lancer l'Unreal Engine.
2b. Générer l'Unreal Engine à partir du code source
Pour installer l'Unreal Engine à partir du code source, consultez la page Télécharger le code source de l'Unreal Engine. Une fois le moteur compilé, exécutez Engine/Binaires/Linux/UnrealEditor depuis le Terminal pour lancer l'Unreal Editor.
3. Configurer un nouveau projet
Pour en savoir plus sur la configuration d'un nouveau projet, consultez les instructions de la page Créer un nouveau projet dans l'Unreal Engine. Dans le cadre de ce tutoriel, vous n'aurez pas besoin d'un modèle ou d'un type de projet spécifique, mais assurez-vous que C++ est activé si vous configurez votre environnement pour ce langage.
4. Configurer votre environnement de développement (C++)
Si vous prévoyez de développer des projets en C++ , vous devez configurer la chaîne d'outils Clang et un EDI pour fonctionner avec l'Unreal Engine. Vous pouvez utiliser l'EDI de votre choix, mais nous vous recommandons Visual Studio Code ou Rider. Dans cette section, nous vous fournissons des instructions propres à Visual Studio Code, car cet outil offre un environnement de développement commun pour d'autres systèmes d'exploitation.
Installez la chaîne d'outils Clang personnalisée pour votre configuration. Pour en savoir plus, consultez la section Configuration requise pour le développement sous Linux.
Recherchez le répertoire d'installation de l'Unreal Engine, ouvrez
Build/BatchFiles/Linux, puis exécutezSetupToolchain.sh.Téléchargez et installez VS Code ainsi que le pack d'extensions officiel C/C++ et l'extension C#. Ceux-ci sont nécessaires pour lire le code source de l'Unreal Engine et de ses outils de build.
Dans l'Unreal Editor, ouvrez les Préférences de l'éditeur et configurez l'éditeur de code source sur Visual Studio Code ; vous pouvez également modifier
BaseEngine.inipour inclure ce qui suit :C++[/Script/SourceCodeAccess.SourceCodeAccessSettings] PreferredAccessor=VisualStudioCodeExécutez
GenerateProjectFiles.sh -vscodepour générer l'espace de travail VS Code pour votre distribution de moteur (dans le cas d'une version du code source) ou pour votre projet. Ajoutez-project=(chemin d'accès à votre projet)pour choisir un projet spécifique.
Pour en savoir plus sur la configuration de VS Code avec IntelliSense et d'autres utilitaires pratiques, consultez la page Configurer VS Code pour l'Unreal Engine.
5. Créer un projet
Maintenant que votre environnement est entièrement configuré, vous pouvez exécuter une version de test de votre projet pour vérifier que votre flux de travail fonctionne correctement.
5a. Créer un projet dans l'Unreal Editor
Ouvrez votre projet dans l'Unreal Editor, cliquez sur le menu déroulant Plateformes, puis sur Linux > Empaqueter le projet. Si votre système est correctement configuré, l'Unreal Engine compile, prépare et empaquette votre projet.
5b. Créer un projet via la ligne de commande
Pour créer un projet via la ligne de commande, utilisez la commande BuildCookRun du script RunUAT, dont vous trouverez les détails dans le guide Opérations de création. Voici un exemple de commande BuildCookRun fonctionnel :
[UE Root Directory]/RunUAT BuildCookRun -Build -Cook -Stage -Package -Run -Project=[ProjectName]Vous pouvez également utiliser la ligne de commande Turnkey pour lancer ce processus.
[UE Root Directory]/RunUAT Turnkey -command=ExecuteBuild -platform=Linux -Project=[ProjectName]En principe, vous utilisez RunUAT depuis le répertoire source de l'Unreal Engine. Pour faciliter l'exécution de cette commande, définissez une variable d'environnement $UE_ROOT. Cela permet d'utiliser RunUAT avec une commande telle que $UE_ROOT/RunUAT BuildCookRun et évite d'avoir à fournir le chemin complet vers le script RunUAT.