Compilation fr FR

Compilation

La compilation est le processus de création d'un fichier exécutable. C’est ce que vous souhaitez faire si vous souhaitez ajouter vos propres modifications à ASF ou si, pour une raison quelconque, vous ne faites pas confiance aux fichiers exécutables fournis dans les ** versions officielles </ 0>. Si vous êtes utilisateur et non développeur, vous voudrez probablement utiliser des binaires déjà précompilés, mais si vous souhaitez utiliser vos propres binaires ou apprendre quelque chose de nouveau, continuez à lire.

ASF peut être compilé sur n’importe quelle plate-forme actuellement prise en charge, à condition que vous disposiez de tous les outils nécessaires pour le faire.

---

.NET Core SDK

Quelle que soit la plate-forme, vous avez besoin du SDK .NET Core complet (pas seulement de l'exécutable) pour compiler ASF. Les instructions d'installation se trouvent sur la ** page d'installation de .NET Core </ 0>. Vous devez installer la version appropriée du .NET Core SDK pour votre système d'exploitation. Une fois l'installation réussie, la commande ` dotnet </ 0> devrait fonctionner et être opérationnelle. Vous pouvez vérifier si cela fonctionne avec dotnet --info </ 0>. Assurez-vous également que votre SDK .NET Core répond aux exigences d'exécution ASF </ 0>.

---

Compilation

Assuming you have .NET Core SDK operative and in appropriate version, simply navigate to source ASF directory (cloned or downloaded and unpacked ASF repo) and execute:

dotnet publish ArchiSteamFarm -c "Release" -f "netcoreapp2.2" -o "out/generic" "/p:LinkDuringPublish=false"
`

Si vous utilisez Linux / OS X, vous pouvez utiliser le script ` cc.sh </ 0> qui fera de même, de manière un peu plus complexe.

Si la compilation s'est terminée avec succès, vous pouvez trouver votre fichier ASF dans le répertoire source 0> du répertoire ArchiSteamFarm/out/generic 0>. Il s'agit de la même chose que la version officielle générique 0> ASF, mais elle a imposé UpdateChannel 0> et UpdatePeriod 0> à 0 0>.

OS-spécifique

Vous pouvez également générer un package .NET Core spécifique au système d'exploitation si vous avez un besoin spécifique. En général, vous ne devriez pas le faire car vous venez de compiler un générique 0> que vous pouvez exécuter avec votre environnement d'exécution .NET Core déjà installé que vous avez utilisé pour la compilation, mais uniquement si vous voulez:

dotnet publish ArchiSteamFarm -c "Release" -f "netcoreapp2.2" -o "out/linux-x64" -r "linux-x64" "/p:CrossGenDuringPublish=false"
`

Of course, replace linux-x64 with OS-architecture that you want to target, such as win-x64. Cette mise à jour aura également des mises à jour désactivées.

.NET Framework

Dans de très rares cas où vous souhaitez créer le package generic-netf </ 0>, vous pouvez modifier le cadre cible de <code> netcoreapp2.2 </ 0> à <code> net472 </ 0>. Keep in mind that you'll need appropriate <strong><a href="https://dotnet.microsoft.com/download/visual-studio-sdks">.NET Framework</a></strong> developer pack for compiling <code>netf variant, in addition to .NET Core SDK, so the below will work only on Windows:

dotnet publish ArchiSteamFarm -c "Release" -f "net472" -o "out/generic-netf"

In case of being unable to install .NET Framework or even .NET Core SDK itself (e.g. because of building on linux-x86 with mono), you can call msbuild directly. You'll also need to specify ASFNetFramework manually, as ASF by default disables netf build on non-Windows platforms:

msbuild /m /p:Configuration=Release /p:PublishDir=out/generic-netf /p:TargetFramework=net472 /p:ASFNetFramework=true /r /t:Publish ArchiSteamFarm

---

Développement

Si vous souhaitez modifier le code ASF, vous pouvez utiliser n'importe quel IDE compatible avec .NET Core à cette fin, même si cela reste facultatif. Vous pouvez également éditer avec un bloc-notes et compiler avec la commande dotnet </ 0>. décrit ci-dessus. Néanmoins, pour Windows, nous recommandons la dernière version de Visual Studio </ 0> (la version communautaire gratuite est largement suffisante). We also suggest to use it together with ReSharper (optionally), although it's not a free product.

Si vous souhaitez plutôt utiliser du code ASF sous Linux / OS X, nous vous recommandons le dernier Visual Studio Code 0>. Ce n'est pas aussi complet que le classique Visual Studio, mais c'est suffisant.

Bien sûr, toutes les suggestions ci-dessus ne sont que des recommandations, vous pouvez utiliser ce que vous voulez, cela revient à la commande dotnet build 0>. Nous utilisons Visual Studio + ReSharper pour le développement ASF, avec une petite partie des outils tiers 0> que vous pouvez trouver dans le référentiel.

---

Tags

Il n’est pas garanti que la branche master 0> soit dans un état permettant une compilation réussie ou une exécution sans faille du fichier ASF en premier lieu, étant donné qu’elle est une branche de développement comme l’indique notre cycle de publication 1>. Si vous voulez compiler ASF à partir des sources, vous devez alors utiliser le tag 0> appropriée, ce qui garantit au moins une compilation réussite et très probablement une exécution sans faille (si la construction a été marquée comme une version stable). Pour vérifier la "santé" actuelle de l’arbre, vous pouvez utiliser nos CIs - AppVeyor ou Travis.

---

Versions Officielles

Les versions officielles ASF sont compilées par AppVeyor 0> sous Windows, avec le dernier SDK .NET Core correspondant aux exigences d'exécution 1> ASF Une fois les tests passés, tous les packages sont déployés sur GitHub. Cela garantit également la transparence, car AppVeyor utilise toujours des sources publiques officielles pour toutes les versions, et vous pouvez comparer les taux de contrôle de AppVeyor avec les actifs GitHub. ASF developers do not compile or publish builds themselves, except for private development process and debugging.