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

  1. 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 :

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. 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 :

    Copy
    Full screen
    Small screen
      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 :

      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>
        

        Exemple de code pour un bouton de téléchargement du fichier d’installation :

        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>
          
          Cet article vous a été utile ?
          Merci !
          Que pouvons-nous améliorer ? Message
          Nous sommes désolés de l'apprendre
          Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
          Merci pour votre commentaire !
          Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
          Dernière mise à jour: 22 Janvier 2024

          Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

          Signaler un problème
          Nous améliorons continuellement notre contenu grâce à vos commentaires.
          Indiquez votre adresse e-mail pour un suivi
          Merci pour votre commentaire !