Cómo establecer el nombre del instalador del lanzador

Cómo funciona

Por defecto, los archivos de instalación del lanzador se denominan installer.exe para la versión independiente y web_installer.exe para la versión web. Puede establecer su propio nombre en el código de su sitio web. Cuando un usuario hace clic en el botón o en el enlace de descarga, el navegador sustituye automáticamente el nombre del archivo de instalación.

Cómo conseguirlo

  1. Agregue un iframe invisible al código de su sitio web, dentro del cual se generará un enlace para descargar el archivo de instalación con el nombre modificado, como se muestra en el siguiente ejemplo.

Ejemplo

Copy
Full screen
Small screen
 1<body>
 2  ...
 3  <script>
 4    const frame = document.createElement("IFRAME");
 5    frame.id = "xsolla-installer-renamer";
 6    frame.src = `https://installer.launcher.xsolla.com/launcher-installer-renamer-prod/v1/renamer.html?cache=${Date.now()}`;
 7    frame.style = "display: none";
 8    document.body.append(frame);
 9  </script>
10  ...
11<body>

  1. Implemente el método postMessage() que transmite parámetros al iframe cuando se hace clic en un enlace o botón:
    • <LINK TO INSTALLER>: la URL del archivo de instalación. En Cuenta del editor en Distribution > Launcher > Settings > Launcher Build. Ejemplo: https://installer.launcher.xsolla.com/xlauncher-builds/xsolla-launcher-update/123456789/bin/web_installer.exe
    • <NEW INSTALLER NAME>: el nombre del archivo de instalación.

Ejemplo

Copy
Full screen
Small screen
1postMessage(
2  {
3    type: "download",
4    href: "<LINK TO INSTALLER>",
5    name: "<NEW INSTALLER NAME>",
6  },
7  "https://installer.launcher.xsolla.com"
8)

A continuación se muestran ejemplos de código para un enlace de descarga y un botón para descargar el archivo de instalación.

Código de ejemplo para un enlace de descarga del archivo de instalación:

Copy
Full screen
Small screen
 1<body>
 2  ...
 3  <a
 4      href="#"
 5      onclick="document.getElementById('xsolla-installer-renamer').contentWindow.postMessage({ type: 'download', href: '<LINK TO INSTALLER>', name: '<NEW INSTALLER NAME>' }, 'https://installer.launcher.xsolla.com');"
 6  >
 7    Donwload
 8  </a>
 9  ...
10<body>

Código de ejemplo para un botón de descarga del archivo de instalación:

Copy
Full screen
Small screen
 1<body>
 2  ...
 3  <button id="button-download">Download</button>
 4  <script>
 5    const btn = document.getElementById("button-download");
 6    btn.onclick = () => {
 7      document
 8        .getElementById("xsolla-installer-renamer")
 9        .contentWindow.postMessage(
10          {
11            type: "download",
12            href: "<LINK TO INSTALLER>",
13            name: "<NEW INSTALLER NAME>",
14          },
15          "https://installer.launcher.xsolla.com"
16        );
17    };
18  </script>
19  ...
20<body>
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Última actualización: 19 de Septiembre de 2025

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!
No hemos podido enviar sus comentarios
Vuelva a intentarlo más tarde o escríbanos a doc_feedback@xsolla.com.