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
    <body>
      ...
      <script>
        const frame = document.createElement("IFRAME");
        frame.id = "xsolla-installer-renamer";
        frame.src = `https://installer.launcher.xsolla.com/launcher-installer-renamer-prod/v1/renamer.html?cache=${Date.now()}`;
        frame.style = "display: none";
        document.body.append(frame);
      </script>
      ...
    <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. Pulse en Cuenta del editor en la sección 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
      postMessage(
        {
          type: "download",
          href: "<LINK TO INSTALLER>",
          name: "<NEW INSTALLER NAME>",
        },
        "https://installer.launcher.xsolla.com"
      )
      

      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
        <body>
          ...
          <a
              href="#"
              onclick="document.getElementById('xsolla-installer-renamer').contentWindow.postMessage({ type: 'download', href: '<LINK TO INSTALLER>', name: '<NEW INSTALLER NAME>' }, 'https://installer.launcher.xsolla.com');"
          >
            Donwload
          </a>
          ...
        <body>
        

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

        Copy
        Full screen
        Small screen
          <body>
            ...
            <button id="button-download">Download</button>
            <script>
              const btn = document.getElementById("button-download");
              btn.onclick = () => {
                document
                  .getElementById("xsolla-installer-renamer")
                  .contentWindow.postMessage(
                    {
                      type: "download",
                      href: "<LINK TO INSTALLER>",
                      name: "<NEW INSTALLER NAME>",
                    },
                    "https://installer.launcher.xsolla.com"
                  );
              };
            </script>
            ...
          <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: 22 de Enero de 2024

          ¿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!