Télécharger le build du jeu

Pour charger un build de jeu sur le serveur de mise à jour, utilisez l’utilitaire de ligne de commande Build Loader.

Configuration système pour Build Loader :

• Windows 10 64-bit OS ou macOS 12.4.0 et versions ultérieures
• CPU 1,6 GHz
• RAM libre : 100 Mo
• Espace disque libre : 1,5 × la taille du build du jeu

Build Loader accepte les options suivantes :

• –init — initialisation de l’utilitaire.
• –update — envoi du build du jeu au serveur.
• –builds-list — liste des builds du jeu.
• –descr <build-description> — description du build.
• –api-key <API-key> — clé API.
• –game-path <path-to-game> — chemin d’accès au build du jeu.
• –chunk-size <chunk-size> — taille des chunks : parties en lesquelles l’archive du jeu est divisée. Accepte les valeurs de 10mb à 500mb ou de 1gb à 5gb, la valeur par défaut étant 500mb.
• –retry-timeout <timeout> — délai d’attente entre les tentatives de téléchargement de fichiers en secondes. Accepte les valeurs de 10 à 60, la valeur par défaut étant 20.
• –retry-count <retry-count> — nombre de tentatives de téléchargement de fichiers. Accepte les valeurs de 1 à 10, la valeur par défaut est 3.
• –set-build-on-test — met le build du jeu en stage test. Le jeu ne sera disponible que pour les tests.
• –set-build-on-master — met le build du jeu en stage master. Le jeu sera disponible pour les utilisateurs finaux. Si –set-build-on-test est spécifié, cette option est ignorée.
• -no-progressbar — désactive la barre de progression.

Pour télécharger un build du jeu :

1. Accédez à votre Compte éditeur et rendez-vous à la section Build settings.
2. Copiez la clé API.
3. Téléchargez et installez Build Loader.
4. Initialisez l’utilitaire.
5. Téléchargez le ou les builds du jeu vers le serveur.
6. Mettez le build du jeu en stage.
7. Configurez les fichiers de jeu.

Télécharger et installer Build Loader

Pour télécharger et installer Build Loader :

1. Dans la section Games, cliquez sur Set up à droite de votre jeu.
2. Accédez à Builds > Game builds.
3. Téléchargez l’archive avec Build Loader en cliquant sur BuildLoader.zip qui convient à votre système d’exploitation.
4. Extrayez l’archive.

L’emplacement de l’utilitaire par rapport au dossier dans lequel vous avez extrait l’archive :

• Pour Windows : Win\build_loader.exe ;
• Pour macOS : Mac/build_loader.

Initialiser Build Loader

Pour initialiser Build Loader :

1. Dans la section Games, cliquez sur Set up à droite de votre jeu.
2. Accédez à la section Builds > Game builds.
3. Copiez la clé API en cliquant sur l’icône + dans API key (launcher ID). La clé permet à Build Loader de télécharger votre jeu sur le serveur.
4. Initialisez l’utilitaire en exécutant la commande suivante :

build_loader.exe --init --api-key <api-key> --game-path <path-to-game>

build_loader.exe --init --api-key E51DPZ486S9IUGVF43AH4T48QB7246OQ --game-path C:\Games\LastGameBuild

./build_loader --init --api-key <api-key> --game-path <path-to-game>

./build_loader --init --api-key ZTXBI5EWCSWLH79FHAPE69TUF2F05V52 --game-path /Users/johndoe/Projects/xsolla-build-loader/game

Télécharger le build de jeu vers le serveur

Pour télécharger un build du jeu vers le serveur, exécutez la commande suivante :

build_loader --update --game-path <path-to-game> --descr <build-description>

build_loader.exe --update --game-path C:\Games\LastGameBuild

./build_loader --update --game-path <path-to-game> --descr <build-description>

./build_loader --update --game-path /Users/johndoe/Projects/xsolla-build-loader/game

Vous pouvez omettre le paramètre –game-path si vous l’avez déjà utilisé lors de l’initialisation de l’utilitaire ou du téléchargement du build précédent.

Lors du premier téléchargement, le serveur de mise à jour reçoit l’intégralité du build du jeu. Ensuite, il recevra les correctifs du jeu générés par Build Loader.

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Launcher.
3. Dans la section Games, cliquez sur Set up à droite de votre jeu.
4. Accédez à Builds > Game builds.
5. Faites défiler vers le bas jusqu’au tableau Game builds.

Mettre le build de jeu en stage

Vous pouvez mettre le build du jeu en stage comme suit :

• Lorsque vous téléchargez le build vers le serveur, passez l'option appropriée à Build Loader : --set-build-on-master ou --set-build-on-test.
• Après avoir téléchargé le build vers le serveur, faites ce qui suit dans le projet de Launcher :
  1. Dans Games, cliquez sur Set up à la droite de votre jeu.
  2. Accédez à Builds > Game builds.
  3. Faites défiler vers le bas jusqu'au tableau Game builds.
  4. Dans le tableau Game builds, cliquez sur l'icône de stylo à droite du build nécessaire.
  5. Cliquez sur Set as master pour placer le build du jeu sur la branche principale, ou cliquez sur Set as staged pour le placer sur la branche de test. S'il est ajouté à la branche principale, le build du jeu sera ajouté au build publié de votre Launcher. S'il est ajouté à la branche de test, le build du jeu sera ajouté au build de test de votre Launcher.
  6. Confirmez votre choix.
  7. Cliquez sur Close.
  8. Vous verrez le nom de la branche appropriée pour votre build dans la colonne Branch du tableau Game builds. Votre build apparaîtra également dans le tableau Branches.

Configurer les fichiers de jeu

Pour que Launcher envoie les bons fichiers aux utilisateurs, configurez et initialisez d’abord les fichiers d’installation dans votre projet de Launcher :

1. Dans Games, cliquez sur Set up à droite de votre jeu.
2. Accédez à l'onglet Executable files.
3. Pour chaque système d'exploitation, entrez le nom et l'extension du fichier qui lance le jeu. Ce fichier doit se trouver à la racine du dossier du jeu. Par exemple : game.exe.
4. Si votre jeu possède des fichiers redistribuables :
   1. accédez à l'onglet Redistributables et cliquez sur Upload.
   2. Dans la fenêtre qui apparaît :
      1. Entrez le nom du fichier ;
      2. Cliquez sur Upload file et sélectionnez un fichier exécutable ;
      3. Cliquez sur Upload.

Launcher passe les paramètres suivants au jeu :

• –xsolla-locale <locale> : langue de l’interface ;
• –xsolla-login-token <token> : jeton JWT Xsolla Login.

game.exe --xsolla-login-token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6InAudHVnb2x1a292QHhzb2xsYS5jb20iLCJleHAiOjE1ODU1MDYxMTMsImdyb3VwcyI6W10sImlhdCI6MTU4NDY0MjExMywiaXNzIjoiaHR0cHM6Ly9sb2dpbi54c29sbGEuY29tIiwicGFydG5lcl9kYXRhIjp7ImFkbWluIjp0cnVlfSwicGF5bG9hZCI6IiIsInByb21vX2VtYWlsX2FncmVlbWVudCI6dHJ1ZSwicHJvdmlkZXIiOiJ4c29sbGEiLCJyZWRpcmVjdF91cmwiOiIiLCJzdWIiOiIyNmYxNzI5Ni00Nzk5LTExZTgtOTBkMC00MjAxMGE4YTAwMTkiLCJ0eXBlIjoic29jaWFsIiwidXNlcm5hbWUiOiJzb21lX3VzZXJAbWFpbC5jb20iLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6Ikk2QTJrTEZPQ2JkcnUzamIxMjNyT3JmWnNkTnFpdVcxMjNpWTdKcW85OHI5b0hPbyIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiNDBkYjJlYTQtNWQ0Mi0xMWU2LWEzZmYtMDA1NDU2YTBlMTRhIn0.ZsTNiwY2iPp7HKqHs5g6JXzL2kv_RVuMNBlF-Tn2ccE --xsolla-locale en

game --xsolla-login-token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6InAudHVnb2x1a292QHhzb2xsYS5jb20iLCJleHAiOjE1ODU1MDYxMTMsImdyb3VwcyI6W10sImlhdCI6MTU4NDY0MjExMywiaXNzIjoiaHR0cHM6Ly9sb2dpbi54c29sbGEuY29tIiwicGFydG5lcl9kYXRhIjp7ImFkbWluIjp0cnVlfSwicGF5bG9hZCI6IiIsInByb21vX2VtYWlsX2FncmVlbWVudCI6dHJ1ZSwicHJvdmlkZXIiOiJ4c29sbGEiLCJyZWRpcmVjdF91cmwiOiIiLCJzdWIiOiIyNmYxNzI5Ni00Nzk5LTExZTgtOTBkMC00MjAxMGE4YTAwMTkiLCJ0eXBlIjoic29jaWFsIiwidXNlcm5hbWUiOiJzb21lX3VzZXJAbWFpbC5jb20iLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6Ikk2QTJrTEZPQ2JkcnUzamIxMjNyT3JmWnNkTnFpdVcxMjNpWTdKcW85OHI5b0hPbyIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiNDBkYjJlYTQtNWQ0Mi0xMWU2LWEzZmYtMDA1NDU2YTBlMTRhIn0.ZsTNiwY2iPp7HKqHs5g6JXzL2kv_RVuMNBlF-Tn2ccE --xsolla-locale en

Tutoriels

Poursuivre la lecture