Démarrage rapide du développement Linux

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 :

Nous vous recommandons de disposer d'un système respectant les normes suivantes pour assurer un fonctionnement optimal de l'Unreal Editor :

Pour configurer votre environnement de développement, nous vous recommandons le logiciel suivant, que nous utilisons le plus souvent pour les tests :

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 :

1. 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.

   

2. Téléchargez le fichier .zip contenant la version de l'Unreal Engine dont vous avez besoin.

   

3. Décompressez le contenu du fichier .zip dans le répertoire d'installation souhaité.

4. Exécutez Engine/Binaries/Linux/UnrealEditor depuis 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.

1. 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.

2. Recherchez le répertoire d'installation de l'Unreal Engine, ouvrez Build/BatchFiles/Linux, puis exécutez SetupToolchain.sh.

3. 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.

4. 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.ini pour inclure ce qui suit :

   C++

   [/Script/SourceCodeAccess.SourceCodeAccessSettings]
            PreferredAccessor=VisualStudioCode

   Copy full snippet(2 lines long)

5. Exécutez GenerateProjectFiles.sh -vscode pour 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]