Comment configurer le nom de l’installateur de Launcher
Comment ça marche
Les fichiers d’installation de Launcher sont nommés par défaut installer.exe
pour la version autonome et web_installer.exe
pour la version Web. Vous pouvez définir votre propre nom dans le code de votre site Web. Lorsque l’utilisateur clique sur le bouton ou le lien de téléchargement, le navigateur remplace automatiquement le nom du fichier d’installation.
Comment configurer
- Ajoutez un iframe invisible au code de votre site Web, à l'intérieur duquel un lien pour télécharger le fichier d'installation avec le nom modifié sera généré, comme indiqué dans l'exemple ci-dessous.
Exemple :
<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>
- Implémentez la méthode
postMessage()
qui passe les paramètres à l'iframe lorsqu'un lien ou un bouton est cliqué :<LINK TO INSTALLER>
— URL du fichier d'installation. Elle se trouve dans le Compte éditeur dans la section Launcher > Settings > Launcher Build. Exemple :https://installer.launcher.xsolla.com/xlauncher-builds/xsolla-launcher-update/123456789/bin/web_installer.exe
;<NEW INSTALLER NAME>
— nom du fichier d'installation.
Exemple :
postMessage(
{
type: "download",
href: "<LINK TO INSTALLER>",
name: "<NEW INSTALLER NAME>",
},
"https://installer.launcher.xsolla.com"
)
Vous trouverez ci-dessous des exemples de code pour un lien de téléchargement et un bouton pour télécharger le fichier d’installation.
Exemple de code pour un lien de téléchargement du fichier d’installation :
<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>
Exemple de code pour un bouton de téléchargement du fichier d’installation :
<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>
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.