Cargar compilación del juego

Para cargar una compilación del juego en el servidor de actualizaciones, utilice la utilidad de línea de comandos del Cargador de compilaciones.

Requisitos del sistema para Cargador de compilaciones:

• Sistema operativo Windows 10 de 64 bits o macOS 12.4.0 o superior.
• CPU de 1,6 GHz
• 100 MB de RAM libres
• Espacio libre en disco: 1,5 × tamaño de compilación del juego

Cargador de compilaciones acepta las siguientes opciones:

• –init - inicialización de la utilidad.
• –update - envío de la compilación del juego al servidor.
• –builds-list - una lista de compilaciones del juego.
• –descr <build-description> - la descripción de la compilación.
• –api-key <API-key> - una clave de API.
• –game-path <path-to-game> - una ruta de acceso a la compilación del juego.
• –chunk-size <chunk-size> - el tamaño de los fragmentos (partes en las que se divide el archivo del juego). Acepta valores desde 10mb hasta 500mb, por defecto es 500mb.
• –retry-timeout <timeout> - el tiempo de espera entre intentos de subir archivos en segundos. Acepta valores desde 10 hasta 60, por defecto es 20.
• –retry-count <retry-count>: número de intentos de subir archivos. Acepta valores desde 1 hasta 10, por defecto es 3.
• –set-build-on-test: pasar la compilación del juego a la fase de prueba. El juego estará disponible solo para pruebas.
• –set-build-on-master: pasar al juego a la fase principal. El juego estará disponible para los usuarios finales. Si se especifica –set-build-on-test, esta opción se ignora.
• -no-progressbar: deshabilitar la barra de progreso.

Para cargar una compilación del juego:

1. Vaya a Publisher Account > Build settings.
2. Copie la clave de API.
3. Descargue e instale Cargador de compilaciones.
4. Inicialice la utilidad.
5. Cargue la compilación o compilaciones del juego en el servidor.
6. Pase la compilación del juego a la fase.
7. Establecer los archivos del juego.

Descargar e instalar Cargador de compilación

Para descargar e instalar el Cargador de compilaciones:

1. En la sección Games, haz clic en Set up a la derecha de tu juego.
2. Ve a Builds > Game builds.
3. Descargue el archivo con el Cargador de compilación haciendo clic en BuildLoader.zip que sea más adecuado para su sistema operativo.
4. Extraiga el archivo.

La ubicación de la utilidad relativa a la carpeta donde extrajo el archivo:

• Para Windows: Win\build_loader.exe
• Para MacOS: Mac/build_loader

Inicializar el Cargador de compilaciones (Build Loader)

Para inicializar Cargador de compilaciones:

1. En la sección Games, haga clic en Set up a la derecha de su juego.
2. Vaya a la sección Builds > Game builds.
3. Copia la clave de API haciendo clic en el icono + en API key (launcher ID). La clave permite al Cargador de compilaciones subir su juego al servidor.
4. Inicialice la utilidad ejecutando el siguiente comando:

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

Cargar una compilación del juego en el servidor

Para cargar una compilación del juego en el servidor, ejecute el siguiente comando:

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

Puede omitir el parámetro –game-path si ya lo ha utilizado al inicializar la utilidad o al cargar la compilación anterior.

Durante la primera carga, el servidor de actualización recibe la compilación completa del juego. Después recibirá los parches (aplicación de revisiones) del juego generados por Cargador de compilaciones.

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Launcher en el menú lateral.
3. En la sección Games, haga clic en Configure a la derecha de su juego.
4. Vaya a Builds > Game builds.
5. Desplácese hasta la tabla Game builds.

Pasar el juego a la fase

Puede pasa la compilación del juego a una fase de la siguiente manera:

• Cuando suba la compilación al servidor, transmita la opción apropiada a Cargador de compilaciones: --set-build-on-master o --set-build-on-test.
• Después de subir la compilación al servidor, haga lo siguiente en el proyecto de lanzador:
  1. En Games, haga clic en Set up a la derecha de su juego.
  2. Vaya a Builds > Game builds.
  3. Desplácese hacia abajo hasta la tabla Game builds.
  4. En la tabla Game builds, haga clic en el icono del lápiz a la derecha de la compilación requerida.
  5. Haga clic en Set as master para pasar la compilación del juego a la fase principal, o haga clic en Set as staged para la fase de prueba. Si se añade a la fase principal, la compilación del juego se añadirá a la compilación publicada de su lanzador. Si se añade a la fase de prueba, la versión del juego se añadirá a la versión borrador de su lanzador.
  6. Confirme su elección.
  7. Haga clic en Close.
  8. Verá el nombre de la rama correspondiente para su versión en la columna Branch de la tabla Game builds. También aparecerá en la tabla Branches.

Establecer los archivos del juego

Para que el lanzador envíe los archivos correctos a los usuarios, establezca e inicialice primero los archivos de instalación en su proyecto de lanzador:

1. En Games, haga clic en Configure a la derecha de su juego.
2. Vaya a la pestaña Executable files.
3. Para cada sistema operativo, introduzca el nombre y la extensión del archivo que lanza el juego. Este archivo debe estar en el directorio raíz de la carpeta del juego. Por ejemplo: game.exe
4. Si su juego tiene archivos redistribuibles:
   1. vaya a la pestaña Redistributables y haga clic en Upload.
   2. En la ventana que aparece:
      1. Introduzca el nombre del archivo.
      2. Haga clic en Upload file y seleccione un archivo ejecutable.
      3. Haga clic en Upload.

El lanzador envía los siguientes parámetros al juego:

• –xsolla-locale <locale>: idioma de la interfaz;
• –xsolla-login-token <token>: JWT de Xsolla Login (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

Tutoriales

Seguir leyendo