Como configurar o nome do instalador do inicializador

Como funciona

Os arquivos do instalador do inicializador são nomeados installer.exe para a versão autônoma e web_installer.exe para a versão da web por padrão. Você pode definir seu próprio nome no código do seu site. Quando um usuário clica no botão ou link de download, o navegador substitui automaticamente o nome do arquivo de instalação.

Como obtê-lo

  1. Adicione um iframe invisível ao código do seu site, dentro do qual será formado um link para baixar o arquivo de instalação com o nome modificado, como mostrado no exemplo abaixo.

Exemplo:

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 o método postMessage() que passa parâmetros para o iframe quando um link ou botão é pressionado:
      • <LINK TO INSTALLER> — o URL do arquivo de instalação. Ele se encontra na Conta de Distribuidor na seção Launcher > Settings > Launcher Build. Exemplo: https://installer.launcher.xsolla.com/xlauncher-builds/xsolla-launcher-update/123456789/bin/web_installer.exe
      • <NEW INSTALLER NAME> — o nome do arquivo de instalação.

    Exemplo:

    Copy
    Full screen
    Small screen
      postMessage(
        {
          type: "download",
          href: "<LINK TO INSTALLER>",
          name: "<NEW INSTALLER NAME>",
        },
        "https://installer.launcher.xsolla.com"
      )
      

      Abaixo estão exemplos de código para um link de download e botão para baixar o arquivo de instalação.

      Código de exemplo para um link de download para o arquivo de instalação:

      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 exemplo para um botão de download para o arquivo de instalação:

        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>
          
          Este artigo foi útil?
          Obrigado!
          Podemos melhorar alguma coisa? Mensagem
          Que pena ouvir isso
          Explique porque este artigo não foi útil para você. Mensagem
          Obrigado pelo seu feedback!
          Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
          Última atualização: 22 de Janeiro de 2024

          Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

          Relatar um problema
          Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
          Forneça um e-mail para que possamos responder
          Obrigado pelo seu feedback!