Apple’s Sport Porting ToolKit could be a bit difficult to put in onto macOS. Now there is a third-party installer that makes the method a lot easier.
At WWDC ’23 Apple launched the Apple Sport Porting Toolkit (AGPT) – a brand new SDK which permits recreation builders to port present Home windows-based DirectX video games to the Mac through a translation layer.
Our authentic article on the best way to set up the Sport Porting ToolKit confirmed you the best way to set up the AGPT utilizing the macOS Terminal, however for a lot of customers the method is advanced and error-prone.
Now InstallAware – historically a maker of Home windows installer instruments – has created a macOS installer for AGPT which lets you set up the software program with just some clicks from a standard macOS installer.
Beneath we’ll stroll you thru the best way to use InstallAware’s installer for AGPT.
Getting began
This walkthrough assumes you have already got the git supply code management system put in in your Mac. If not, get the installer from git-scm.com and run it to put in git.
First, you may need to collect all of the items for the installer from InstallAware’s GitHub repository: the sources, the .dmg, and the installer which is contained on the .dmg.
To take action, make a neighborhood folder to carry all of the recordsdata in your Mac’s drive the place you’d usually hold all of your downloads and sources. We’ll use the working identify “AGPT” for the folder.
Subsequent, open the Terminal app within the Utilities folder in your Mac. Change the listing to the folder you simply created utilizing the cd command adopted by an area, then drag the brand new AGPT folder into the Terminal window so as to add the trail.
Press Return. This adjustments your current working listing in Terminal to the AGPT folder.
Subsequent, go to InstallAware’s AGPT GitHub web page and click on the Code button, then the small clipboard icon button to repeat the URL to clone the repository into the brand new AGPT folder:
https://github.com/installaware/AGPT.git
Again in Terminal, on a brand new line kind git clone, an area, then paste within the GitHub repo line you copied above.
If all goes properly, git will fetch the AGPT distant repo into your AGPT folder in your Mac’s drive. This leaves you with the contents of the distant repository for the InstallAware installer within the AGPT folder you created.
The git clone command completes.
Get the installer
Subsequent, scroll down the GitHub repo’s web page a bit to simply above the screenshot and click on the hyperlink to get the installer’s .dmg file from www.installaware.com/iamp/agpt.dmg
As soon as downloaded, in Finder manually drag the .dmg file into the AGPT folder you made. Now double-click it in Finder to open the .dmg.
In the event you like, you too can copy the installer into the AGPT folder to repeat it to your Mac’s drive, or simply double-click it from the .dmg to open it:
The InstallAware installer.
In the event you get a warning about “Sport Porting Toolkit Installer” being an app you downloaded from the web, simply click on “Open” to open it anyway.
Run the installer
When you double-click the installer you get a window with a number of choices (a number of of which the installer says are optionally available).
On the high are choices to put in the Homebrew bundle supervisor, the Wine translation layer, and configure Home windows settings. The installer says it auto-detects if these choices are already put in, however on our Mac, it did not uncheck the Homebrew possibility although we already had it put in.
If this occurs, and you have already got Homebrew put in, go forward and uncheck that possibility.
Within the subject beneath, you have got the choice to pick out which Apple Sport Porting Toolkit .dmg the installer will use by clicking the Browse button – when you’ve already downloaded one from Apple, however this step is optionally available. The installer is aware of the best way to discover the Apple Sport Porting Toolkit .dmg on the web by itself.
In the event you do not have already got the .dmg for the Apple Sport Porting Toolkit downloaded to your Mac, click on the small hyperlink above the highest textual content subject to obtain it:
Click on the textual content hyperlink to obtain Apple’s recreation Porting Toolkit.
This can open the Extra Downloads part on Apple’s Developer web site, however you may first have to sign up together with your Apple ID.
As soon as signed in, increase the Sport Porting Toolkit merchandise by clicking the View Particulars hyperlink, then click on the .dmg obtain button. This can obtain Apple’s Sport Porting Toolkit .dmg to your Mac:
Obtain Sport Porting Toolkit from Apple’s web site.
As soon as downloaded, the .dmg ought to auto-mount in your Mac’s desktop, however go forward and duplicate it to your AGPT folder for future reference.
Now head again to the InstallAware installer app, which ought to nonetheless be working, and click on the Browse button subsequent to the textual content subject. Navigate to Apple’s Sport Porting Toolkit .dmg you downloaded and choose it by clicking the Open button.
Set a Home windows app to put in
The subsequent step is optionally available however when you additionally need to arrange a Home windows app whereas putting in the Sport Porting ToolKit, click on the second Browse button beneath the primary one, and choose any appropriate Home windows .exe setup file from disk. On this instance we’ll set up Medal of Honor: Allied Assault:
Choose a third-party app to put in.
Now you are lastly prepared to put in every little thing. Click on the Subsequent button to start out the set up.
In the event you get the error “Tapping Apple Homebrew Failed!” with Error code -1, you may have to both activate the Homebrew possibility on the high of the unique installer window or else manually faucet the Apple Homebrew components in Terminal with:
brew faucet apple/apple http://github.com/apple/homebrew-apple
However as we acknowledged in our authentic article, this may occasionally take a very long time – as much as an hour on an Apple Silicon machine. So you could simply need to examine the Homebrew possibility in InstallAware’s installer and take a look at once more.
Because the installer begins working, it would ask you on your Mac’s admin password with a “Checking for sudo entry” immediate. You will have to enter an admin password on your Mac to proceed:
Enter an admin password.
You will not see any progress indicators, so it is best simply to let the installer run which may take fairly some time. When finished you may be prompted for Wine and different settings. Simply use the defaults:
Immediate for optionally available settings’ change.
Lastly, when you chosen any third-party software program to put in, the installer will run that installer final and you will have to step by means of it. In the event you’re putting in business software program, you may want a serial quantity on your installer:
Sport installer working.
As soon as any third-party installer finishes, you are finished. Click on the Completed or End button and also you’re completed.
We have already lined the best way to run third-party video games in Sport Porting Toolkit in our earlier article, so try that article for directions.
InstallAware’s installer does make putting in the Sport Porting Toolkit simpler with far fewer steps and much fewer instructions within the Terminal – even when it does appear to have just a few glitches or idiosyncrasies right here and there.
