Launcher / Как задать имя установщика лаунчера
  На главную

Launcher

Как задать имя установщика лаунчера

Как это работает

По умолчанию файлы установщика лаунчера называются installer.exe для автономной версии и web_installer.exe — для веб-версии. Вы можете задать собственное название в коде вашего сайта. Когда пользователь нажмет кнопку или ссылку для скачивания, имя установочного файла автоматически заменится браузером.

Как настроить

  1. Добавьте в код вашего сайта невидимый для пользователя iframe, внутри которого будет формироваться ссылка на скачивание установочного файла с измененным названием, как показано в примере ниже.

Пример:

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. Реализуйте вызов метода postMessage(), который по нажатию на ссылку или кнопку передаст в iframe параметры:
      • <LINK TO INSTALLER> — URL-адрес установочного файла. Вы можете найти его в разделе Launcher > Настройки > Сборка лаунчера Личного кабинета. Пример: https://installer.launcher.xsolla.com/xlauncher-builds/xsolla-launcher-update/123456789/bin/web_installer.exe
      • <NEW INSTALLER NAME> — имя установочного файла.

    Пример:

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

      Ниже приведены примеры кода ссылки и кнопки для скачивания установочного файла.

      Пример кода ссылки для скачивания установочного файла:

      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>
        

        Пример кода кнопки для скачивания установочного файла:

        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>
          
          Была ли статья полезна?
          Спасибо!
          Что может сделать страницу еще лучше? Сообщение
          Жаль, что так произошло
          Расскажите, почему статья не была полезна. Сообщение
          Спасибо за обратную связь!
          Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
          Последнее обновление: 22 января 2024

          Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

          Сообщите о проблеме
          Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
          Укажите email-адрес, чтобы мы могли связаться с вами
          Спасибо за обратную связь!