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

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

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

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

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

Пример:

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

Пример:

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)

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

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

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>

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

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

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

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