Spiel-Build hochladen

Nutzen Sie die Eingabeaufforderung des Build-Loaders, um eine Entwicklungsstufe des Spiels auf den Update-Server hochzuladen.

Build-Loader-Systemanforderungen:

• Windows 10 64-Bit-Betriebssystem oder macOS 12.4.0 und höher
• 1,6 GHz CPU
• 100 MB verfügbarer RAM
• Freier Festplattenspeicher: 1,5-fache der Build-Größe

Build-Loader akzeptiert die folgenden Optionen:

• –init — Initialisieren des Dienstprogramms.
• –update — Senden des Spiel-Build an den Server.–builds-list — Eine Liste der Spiel-Builds.
• –descr <build-description> — Beschreibungen der Build.
• –api-key <API-key> — API-Schlüssel.
• –game-path <path-to-game> — Pfad zur Spiel-Build.
• –chunk-size <chunk-size> — Die Größe der Datenblöcke, in die das Archiv unterteilt ist. Zulässige Werte: von 10mb bis 500mb. Standardwert: 500mb.
• –retry-timeout <timeout> — Timeout zwischen den Upload-Versuchen. Angabe in Sekunden. Zulässige Werte: von 10 bis 60. Standardwert: 20.
• –retry-count <retry-count> — Anzahl der Upload-Versuche. Zulässige Werte: von1 bis 10. Standardwert: 3.
• –set-build-on-test — Versetzen der Spiel-Build in das Entwurf-Stadium, d.h. das Spiel ist nur für Testzwecke verfügbar.
• –set-build-on-master — Versetzen der Spiel-Build in das Veröffentlichungs-Stadium, d.h. das Spiel ist für Endanwender verfügbar. Wenn–set-build-on-testfestgelegt ist, wird diese Option ignoriert.
• -no-progressbar — Deaktivierung des Fortschrittsbalkens.

So laden Sie eine Spiel-Build hoch:

1. Navigieren Sie zu Kundenportal > Build-Einstellungen.
2. Kopieren Sie den API-Schlüssel.
3. Laden Sie den Build-Loader herunter, und installieren Sie ihn.
4. Initialisieren Sie das Dienstprogramm.
5. Laden Sie die Spiel-Build(s) auf den Server hoch.
6. EVersetzen Sie die Spiel-Build in ein Stadium.
7. Richten Sie die Spieldateien ein.

Build-Loader herunterladen und installieren

So gelingt der Download und die Installation des Build-Loaders:

1. Klicken Sie im Abschnitt Spiele rechts neben Ihrem Spiel auf Einrichten.
2. Navigieren Sie zu Builds > Spiel-Builds.
3. Laden Sie das Archiv mit dem Build-Loader herunter, klicken Sie dazu auf die zu Ihrem Betriebssystem passende BuildLoader.zip-Datei.
4. Entpacken Sie das Archiv.

Der Speicherort des Dienstprogramms relativ zu dem Ordner, in den Sie das Archiv extrahiert haben:

• Bei Windos: Win\build_loader.exe
• Bei macOS: Mac/build_loader

Build-Loader initialisieren

So initialisieren Sie den Build-Loader:

1. Klicken Sie im Abschnitt Spiele rechts neben Ihrem Spiel auf Einrichten.
2. Navigieren Sie zu Builds > Spiel-Builds.
3. Kopieren Sie den API-Schlüssel, indem Sie bei API-Schlüssel (Startprogramm-ID) auf das +-Symbol klicken. Der Schlüssel ermöglicht es Build-Loader, Ihr Spiel auf den Server hochzuladen.
4. Initialisieren Sie das Dienstprogramm mit dem folgenden Befehl:

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

Build auf den Server hochladen

Um ein Spiel-Build auf den Server hochzuladen, müssen Sie den folgenden Befehl ausführen:

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

Sie können den Parameter –game-path weglassen, wenn Sie ihn bereits beim Initialisieren des Dienstprogramms oder beim Hochladen der vorherigen Build verwendet haben.

Beim ersten Upload erhält der Update-Server die gesamte Entwicklungsstufe des Spiels. Danach erhält der Server die vom Build-Loader erstellten Patches.

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Launcher.
3. Klicken Sie im Abschnitt Spiele rechts neben Ihrem Spiel auf Einrichten.
4. Navigieren Sie zu Builds > Spiel-Builds.
5. Scrollen Sie zur Tabelle Spiel-Builds.

Spiel-Build in ein Stadium versetzen

So versetzen Sie die Spiel-Build in ein Stadium:

• Übermitteln Sie dem Build-Loader beim Upload der Build auf den Server die entsprechende Option: --set-build-on-master oder --set-build-on-test.
• Nachdem Sie die Build auf den Server hochgeladen haben, gehen Sie im Startprogramm-Projekt wie folgt vor:
  1. Klicken Sie im Abschnitt Spiele rechts neben Ihrem Spiel auf Einrichten.
  2. Navigieren Sie zu Builds > Spiel-Builds.
  3. Scrollen Sie nach unten zur Tabelle Spiel-Builds.
  4. Klicken Sie in der Tabelle Spiele-Builds auf das Stiftsymbol rechts neben der gewünschten Build.
  5. Klicken Sie auf Als Veröffentlichung festlegen, um die Spiel-Build in das Veröffentlichungs-Stadium zu versetzen, oder klicken Sie auf Als Entwurf festlegen, um die Build in das Entwurf-stadium zu versetzen.
  6. Bestätigen Sie Ihre Auswahl.
  7. Klicken Sie auf Schließen.
  8. Der Name der entsprechenden Verzweigung Ihrer Build wird in der Spalte Verzweigung der Tabelle Spiel-Builds angezeigt. Außerdem wird Ihr Build in der Tabelle Verzweigungen angezeigt.

Spieldateien einrichten

Damit das Startprogramm die korrekten Dateien an die Benutzer sendet, müssen Sie zunächst die Installationsdateien in Ihrem Startprogramm-Projekt einrichten und initialisieren:

1. Klicken Sie im Abschnitt Spiele rechts neben Ihrem Spiel auf Einrichten.
2. Wechseln Sie zur Registerkarte Ausführbare Dateien. Geben Sie für jedes Betriebssystem den Namen und die Erweiterung der Datei an, mit der das Spiel gestartet wird. Diese Datei sollte sich im Stammverzeichnis des Spielordners befinden, z. B.: game.exe
3. Wenn Ihr Spiel über Redistributionsdateien verfügt:
   1. Wechseln Sie zur Registerkarte Redistributionen, und klicken Sie auf Hochladen.
   2. Gehen Sie in dem sich daraufhin öffnenden Fenster wie folgt vor:
      1. Geben Sie den Dateinamen ein.
      2. Klicken Sie auf Datei hochladen, und wählen Sie eine ausführbare Datei aus.
      3. Klicken Sie auf Hochladen.

Das Startprogramm übermittelt dem Spiel folgende Parameter:

• –xsolla-locale <locale>: Sprache der Benutzeroberfläche;
• –xsolla-login-token <token>: Xsolla Login-JWT (JSON Web Token).

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

Tutorials

Weitere Informationen