Comment installer le Game Porting Toolkit d’Apple avec un programme d’installation

Lors de la WWDC ’23, Apple a présenté Apple Game Porting Toolkit (AGPT) – un nouveau SDK qui permet aux développeurs de jeux de porter des jeux DirectX existants basés sur Windows sur Mac via une couche de traduction.

Notre article original sur l’installation de Game Porting ToolKit vous a montré comment installer l’AGPT à l’aide du terminal macOS, mais pour de nombreux utilisateurs, le processus est complexe et sujet aux erreurs.

Désormais, InstallAware – traditionnellement un fabricant d’outils d’installation Windows – a créé un programme d’installation macOS pour AGPT qui vous permet d’installer le logiciel en quelques clics à partir d’un programme d’installation macOS traditionnel.

Ci-dessous, nous vous expliquerons comment utiliser le programme d’installation d’InstallAware pour AGPT.

Cette procédure pas à pas suppose que le système de contrôle de code source git est déjà installé sur votre Mac. Sinon, récupérez le programme d’installation auprès de git-scm.com et exécutez-le pour installer git.

Tout d’abord, vous souhaiterez rassembler toutes les pièces du programme d’installation à partir de Dépôt GitHub d’InstallAware: les sources, le .dmg et l’installateur qui est contenu sur le .dmg.

Pour ce faire, créez un dossier local pour contenir tous les fichiers sur le lecteur de votre Mac, où vous conserveriez normalement tous vos téléchargements et sources. Nous utiliserons le nom de travail « AGPT » pour le dossier.

Ensuite, ouvrez l’application Terminal dans le dossier Utilitaires sur votre Mac. Remplacez le répertoire par le dossier que vous venez de créer à l’aide du cd commande suivie d’un espace, puis faites glisser le nouveau dossier AGPT dans la fenêtre du terminal pour ajouter le chemin.

Presse Retour. Cela modifie votre répertoire de travail actuel dans Terminal vers le dossier AGPT.

Ensuite, accédez à la page AGPT GitHub d’InstallAware et cliquez sur le bouton Code bouton, puis le petit presse-papiers bouton icône pour copier l’URL pour cloner le référentiel dans le nouveau dossier AGPT :

De retour dans Terminal, sur un nouveau type de ligne git cloneun espace, puis collez-le dans la ligne du dépôt GitHub que vous avez copiée ci-dessus.

Si tout se passe bien, git récupérera le dépôt distant AGPT dans votre dossier AGPT sur le lecteur de votre Mac. Cela vous laisse avec le contenu du référentiel distant pour le programme d’installation InstallAware dans le dossier AGPT que vous avez créé.

La commande git clone se termine.

Ensuite, faites défiler un peu la page du dépôt GitHub juste au-dessus de la capture d’écran et cliquez sur le lien pour obtenir le fichier .dmg du programme d’installation à partir de www.installaware.com/iamp/agpt.dmg

Une fois téléchargé, dans le Finder, faites glisser manuellement le fichier .dmg dans le dossier AGPT que vous avez créé. Maintenant, double-cliquez dessus dans le Finder pour ouvrir le .dmg.

Si vous le souhaitez, vous pouvez également copier le programme d’installation dans le dossier AGPT pour le copier sur le lecteur de votre Mac, ou simplement double-cliquer dessus depuis le .dmg pour l’ouvrir :

Le programme d’installation InstallAware.

Si vous recevez un avertissement indiquant que « Game Porting Toolkit Installer » est une application que vous avez téléchargée sur Internet, cliquez simplement sur « Ouvrir » pour l’ouvrir quand même.

Une fois que vous double-cliquez sur le programme d’installation, vous obtenez une fenêtre avec plusieurs options (dont plusieurs, selon le programme d’installation, sont facultatives).

En haut se trouvent les options permettant d’installer le gestionnaire de packages Homebrew, la couche de traduction Wine et de configurer les paramètres Windows. Le programme d’installation indique qu’il détecte automatiquement si ces options sont déjà installées, mais sur notre Mac, il n’a pas décoché l’option Homebrew même si nous l’avions déjà installée.

Si cela se produit et que Homebrew est déjà installé, décochez cette option.

Dans le champ ci-dessous, vous avez la possibilité de sélectionner le fichier Apple Game Porting Toolkit .dmg que le programme d’installation utilisera en cliquant sur le bouton Parcourir bouton – si vous en avez déjà téléchargé un depuis Apple, mais que cette étape est facultative. Le programme d’installation sait comment trouver lui-même le fichier Apple Game Porting Toolkit .dmg sur Internet.

Si vous n’avez pas déjà téléchargé le .dmg pour Apple Game Porting Toolkit sur votre Mac, cliquez sur le petit lien au-dessus du champ de texte supérieur pour le télécharger :

Cliquez sur le lien texte pour télécharger le jeu Porting Toolkit d’Apple.

Cela ouvrira la section Plus de téléchargements sur le site Web des développeurs d’Apple, mais vous devrez d’abord vous connecter avec votre identifiant Apple.

Une fois connecté, développez l’élément Game Porting Toolkit en cliquant sur le bouton Voir les détails lien, puis cliquez sur le bouton de téléchargement .dmg. Cela téléchargera le Game Porting Toolkit .dmg d’Apple sur votre Mac :

Téléchargez Game Porting Toolkit sur le site Web d’Apple.

Une fois téléchargé, le .dmg devrait être monté automatiquement sur le bureau de votre Mac, mais copiez-le dans votre dossier AGPT pour référence future.

Revenez maintenant à l’application d’installation InstallAware, qui devrait toujours être en cours d’exécution, et cliquez sur le bouton Parcourir bouton à côté du champ de texte. Accédez au Game Porting Toolkit .dmg d’Apple que vous avez téléchargé et sélectionnez-le en cliquant sur le bouton Ouvrir bouton.

L’étape suivante est facultative, mais si vous souhaitez également configurer une application Windows lors de l’installation de Game Porting ToolKit, cliquez sur la deuxième étape. Parcourir sous le premier et sélectionnez n’importe quel fichier d’installation Windows .exe compatible à partir du disque. Dans cet exemple, nous allons installer Médaille d’honneur : assaut allié:

Sélectionnez une application tierce à installer.

Vous êtes maintenant enfin prêt à tout installer. Clique le Suivant bouton pour démarrer l’installation.

Si vous obtenez l’erreur « Échec de l’appui sur Apple Homebrew ! » avec le code d’erreur -1, vous devrez soit activer l’option Homebrew en haut de la fenêtre du programme d’installation d’origine, soit appuyer manuellement sur la formule Apple Homebrew dans le terminal avec :

brew tap apple/apple

Mais comme nous l’avons indiqué dans notre article original, cela peut prendre beaucoup de temps – jusqu’à une heure sur une machine Apple Silicon. Vous voudrez peut-être simplement vérifier le Homebrew dans le programme d’installation d’InstallAware et réessayez.

Lorsque le programme d’installation démarre, il vous demandera le mot de passe administrateur de votre Mac avec une invite « Vérification de l’accès sudo ». Vous devrez saisir un mot de passe administrateur pour votre Mac pour continuer :

Entrez un mot de passe administrateur.

Vous ne verrez aucun indicateur de progression, il est donc préférable de laisser le programme d’installation s’exécuter, ce qui peut prendre un certain temps. Une fois terminé, vous serez invité à indiquer Wine et d’autres paramètres. Utilisez simplement les valeurs par défaut :

Invite à modifier les paramètres facultatifs.

Enfin, si vous avez sélectionné un logiciel tiers à installer, le programme d’installation exécutera ce programme d’installation en dernier et vous devrez le parcourir. Si vous installez un logiciel commercial, vous aurez besoin d’un numéro de série pour votre programme d’installation :

Programme d’installation du jeu en cours d’exécution.

Une fois le programme d’installation tiers terminé, vous avez terminé. Clique le Fait ou Finition bouton et vous avez terminé.

Nous avons déjà expliqué comment exécuter des jeux tiers dans Game Porting Toolkit dans notre article précédent, alors consultez cet article pour obtenir des instructions.

Le programme d’installation d’InstallAware facilite l’installation de Game Porting Toolkit avec beaucoup moins d’étapes et beaucoup moins de commandes dans le terminal – même s’il semble y avoir quelques problèmes ou particularités ici et là.