+- Sick Gaming (https://www.sickgaming.net)
+-- Forum: Computers (https://www.sickgaming.net/forum-86.html)
+--- Forum: Apples Mac and OS X (https://www.sickgaming.net/forum-87.html)
+--- Thread: AppleInsider - How to install Apple’s Game Porting Toolkit via a third-party insta (/thread-101391.html)
AppleInsider - How to install Apple’s Game Porting Toolkit via a third-party insta - xSicKxBot - 09-05-2023
AppleInsider - How to install Apple’s Game Porting Toolkit via a third-party insta
<div style="margin: 5px 5% 10px 5%;"><img src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer.jpg" width="1312" height="731" title="" alt="" /></div><div><div class="col-sm-12" id="article-hero" aria-labelledby="hero-cap" role="figure"> <a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer.jpg"> <img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer.jpg" alt> </a> </div>
<p class="col-sm-12 article-lead">Apple’s Game Porting ToolKit can be a bit tricky to install onto macOS. Now there’s a third-party installer that makes the process much simpler. </p>
<div class="col-sm-12">
<p>At WWDC ’23 Apple introduced the Apple Game Porting Toolkit (AGPT) – a new SDK which allows game developers to port existing Windows-based DirectX games to the Mac via a translation layer.
</p>
</div>
<div class="col-sm-12">
<p>Our <a href="https://appleinsider.com/inside/macos-sonoma/tips/how-to-install-and-use-game-porting-toolkit-in-xcode">original article</a> on how to install the Game Porting ToolKit showed you how to install the AGPT using the macOS Terminal, but for many users the process is complex and error-prone.
</p>
</div>
<div class="col-sm-12">
<p>Now InstallAware – traditionally a maker of Windows installer tools – has created a macOS <a href="https://appleinsider.com/articles/23/08/21/apple-game-porting-toolkit-is-easier-to-set-up-using-a-new-installer">installer for AGPT</a> which allows you to install the software with just a few clicks from a traditional macOS installer.
</p>
</div>
<div class="col-sm-12">
<p>Below we’ll walk you through how to use InstallAware’s installer for AGPT.
</p>
</div>
<p><h2 data-anchor="getting-started" id="getting-started">Getting started</h2>
</p>
<div class="col-sm-12">
<p>This walkthrough assumes you already have the git source code control system installed on your Mac. If not, get the installer from <a href="https://git-scm.com/">git-scm.com</a> and run it to install git.
</p>
</div>
<div class="col-sm-12">
<p>First, you’ll want to gather all the pieces for the installer from <a href="https://github.com/installaware/AGPT">InstallAware’s GitHub repository</a>: the sources, the .dmg, and the installer which is contained on the .dmg.
</p>
</div>
<div class="col-sm-12">
<p>To do so, make a local folder to hold all the files on your Mac’s drive where you would normally keep all your downloads and sources. We’ll use the working name “AGPT” for the folder.
</p>
</div>
<div class="col-sm-12">
<p>Next, open the Terminal app in the Utilities folder on your Mac. Change the directory to the folder you just created using the <code>cd</code> command followed by a space, then drag the new AGPT folder into the Terminal window to add the path.
</p>
</div>
<div class="col-sm-12">
<p>Press <strong>Return</strong>. This changes your present working directory in Terminal to the AGPT folder.
</p>
</div>
<div class="col-sm-12">
<p>Next, go to InstallAware’s AGPT GitHub page and click the <strong>Code</strong> button, then the small <strong>clipboard</strong> icon button to copy the URL to clone the repository into the new AGPT folder:
</p>
</div>
<div class="col-sm-12">
<p><code>https://github.com/installaware/AGPT.git</code>
</p>
</div>
<div class="col-sm-12">
<p>Back in Terminal, on a new line type <code>git clone</code>, a space, then paste in the GitHub repo line you copied above.
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-1.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-1.jpg" alt="Use the git clone command." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
</div>
<div class="col-sm-12">
<p>Press <strong>Return</strong>.
</p>
</div>
<div class="col-sm-12">
<p>If all goes well, git will fetch the AGPT remote repo into your AGPT folder on your Mac’s drive. This leaves you with the contents of the remote repository for the InstallAware installer in the AGPT folder you created.
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-2.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-2.jpg" alt="The git clone command completes." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
<p><span class="carousel-caption">The git clone command completes.</span></p>
</div>
<p><h2 data-anchor="get-the-installer" id="get-the-installer">Get the installer</h2>
</p>
<div class="col-sm-12">
<p>Next, scroll down the GitHub repo’s page a bit to just above the screenshot and click the link to get the installer’s .dmg file from <strong>www.installaware.com/iamp/agpt.dmg</strong>
</p>
</div>
<div class="col-sm-12">
<p>Once downloaded, in Finder manually drag the .dmg file into the AGPT folder you made. Now double-click it in Finder to open the .dmg.
</p>
</div>
<div class="col-sm-12">
<p>If you like, you can also copy the installer into the AGPT folder to copy it to your Mac’s drive, or just double-click it from the .dmg to open it:
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-3.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-3.jpg" alt="The InstallAware installer." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
<p><span class="carousel-caption">The InstallAware installer.</span></p>
</div>
<div class="col-sm-12">
<p>If you get a warning about “Game Porting Toolkit Installer” being an app you downloaded from the internet, just click “Open” to open it anyway.
</p>
</div>
<p><h2 data-anchor="run-the-installer" id="run-the-installer">Run the installer</h2>
</p>
<div class="col-sm-12">
<p>Once you double-click the installer you get a window with several options (several of which the installer says are optional).
</p>
</div>
<div class="col-sm-12">
<p>At the top are options to install the <a href="https://appleinsider.com/inside/macos/tips/how-to-use-homebrew-on-mac-to-install-third-party-tools-apps">Homebrew</a> package manager, the Wine translation layer, and configure Windows settings. The installer says it auto-detects if these options are already installed, but on our Mac, it didn’t uncheck the Homebrew option even though we already had it installed.
</p>
</div>
<div class="col-sm-12">
<p>If this happens, and you already have Homebrew installed, go ahead and uncheck that option.
</p>
</div>
<div class="col-sm-12">
<p>In the field below, you have the option to select which Apple Game Porting Toolkit .dmg the installer will use by clicking the <strong>Browse</strong> button – if you’ve already downloaded one from Apple, but this step is optional. The installer knows how to find the Apple Game Porting Toolkit .dmg on the internet on its own.
</p>
</div>
<div class="col-sm-12">
<p>If you don’t already have the .dmg for the Apple Game Porting Toolkit downloaded to your Mac, click the small link above the top text field to download it:
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-4.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-4.jpg" alt="Click the text link to download Apple's game Porting Toolkit." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
<p><span class="carousel-caption">Click the text link to download Apple’s game Porting Toolkit.</span></p>
</div>
<div class="col-sm-12">
<p>This will open the More Downloads section on Apple’s Developer website, but you’ll first need to sign in with your Apple ID.
</p>
</div>
<div class="col-sm-12">
<p>Once signed in, expand the Game Porting Toolkit item by clicking the <strong>View Details</strong> link, then click the .dmg download button. This will download Apple’s Game Porting Toolkit .dmg to your Mac:
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-5.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-5.jpg" alt="Download Game Porting Toolkit from Apple's website." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
<p><span class="carousel-caption">Download Game Porting Toolkit from Apple’s website.</span></p>
</div>
<div class="col-sm-12">
<p>Once downloaded, the .dmg should auto-mount on your Mac’s desktop, but go ahead and copy it to your AGPT folder for future reference.
</p>
</div>
<div class="col-sm-12">
<p>Now head back to the InstallAware installer app, which should still be running, and click the <strong>Browse</strong> button next to the text field. Navigate to Apple’s Game Porting Toolkit .dmg you downloaded and select it by clicking the <strong>Open</strong> button.
</p>
</div>
<p><h2 data-anchor="set-a-windows-app-to-install" id="set-a-windows-app-to-install">Set a Windows app to install</h2>
</p>
<div class="col-sm-12">
<p>The next step is optional but if you also want to set up a Windows app while installing the Game Porting ToolKit, click the second <strong>Browse</strong> button below the first one, and select any compatible Windows .exe setup file from disk. In this example we’ll install <em>Medal of Honor: Allied Assault</em>:
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-6.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-6.jpg" alt="Select a third-party app to install." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
<p><span class="carousel-caption">Select a third-party app to install.</span></p>
</div>
<div class="col-sm-12">
<p>Now you’re finally ready to install everything. Click the <strong>Next</strong> button to start the installation.
</p>
</div>
<div class="col-sm-12">
<p>If you get the error “Tapping Apple Homebrew Failed!” with Error code -1, you’ll need to either turn on the Homebrew option at the top of the original installer window or else manually tap the Apple Homebrew formula in Terminal with:
</p>
</div>
<div class="col-sm-12">
<p><code>brew tap apple/apple http://github.com/apple/homebrew-apple</code>
</p>
</div>
<div class="col-sm-12">
<p>And press <strong>Return</strong>.
</p>
</div>
<div class="col-sm-12">
<p>But as we stated in our original article, this may take a long time – up to an hour on an Apple Silicon machine. So you may just want to check the <strong>Homebrew</strong> option in InstallAware’s installer and try again.
</p>
</div>
<div class="col-sm-12">
<p>As the installer starts running, it will ask you for your Mac’s admin password with a “Checking for sudo access” prompt. You’ll need to enter an admin password for your Mac to proceed:
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-7.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-7.jpg" alt="Enter an admin password." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
<p><span class="carousel-caption">Enter an admin password.</span></p>
</div>
<div class="col-sm-12">
<p>You won’t see any progress indicators, so it’s best just to let the installer run which can take quite a while. When done you’ll be prompted for Wine and other settings. Just use the defaults:
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-8.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-8.jpg" alt="Prompt for optional settings' change." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
<p><span class="carousel-caption">Prompt for optional settings’ change.</span></p>
</div>
<div class="col-sm-12">
<p>Finally, if you selected any third-party software to install, the installer will run that installer last and you’ll need to step through it. If you’re installing commercial software, you’ll need a serial number for your installer:
</p>
</div>
<div class="col-sm-12">
<div class="align-center"><a href="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-9.jpg" target="_blank" rel="noopener"><img decoding="async" src="https://www.sickgaming.net/blog/wp-content/uploads/2023/08/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer-9.jpg" alt="Game installer running." height="768" loading="lazy" class="img-responsive article-image"></a>
</div>
<p><span class="carousel-caption">Game installer running.</span></p>
</div>
<div class="col-sm-12">
<p>Once any third-party installer finishes, you’re done. Click the <strong>Done</strong> or <strong>Finish</strong> button and you’re finished.
</p>
</div>
<div class="col-sm-12">
<p>We’ve already covered how to run third-party games in Game Porting Toolkit in our <a href="https://appleinsider.com/inside/macos-sonoma/tips/how-to-install-and-use-game-porting-toolkit-in-xcode">previous article</a>, so check out that article for instructions.
</p>
</div>
<div class="col-sm-12">
<p>InstallAware’s installer does make installing the Game Porting Toolkit easier with far fewer steps and far fewer commands in the Terminal – even if it does seem to have a few glitches or idiosyncrasies here and there.</p>
</div>
</div>
https://www.sickgaming.net/blog/2023/08/27/how-to-install-apples-game-porting-toolkit-via-a-third-party-installer/