Apple’s Recreation Porting ToolKit is usually a bit difficult to put in onto macOS. Now there is a third-party installer that makes the method a lot less complicated.
At WWDC ’23 Apple launched the Apple Recreation Porting Toolkit (AGPT) – a brand new SDK which permits recreation builders to port present Home windows-based DirectX video games to the Mac by way of a translation layer.
Our authentic article on how one can set up the Recreation Porting ToolKit confirmed you how one can 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 how one can 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 wish 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 information in your Mac’s drive the place you’ll usually preserve 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 modifications 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 nicely, 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 only 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.
Should you like, you may also 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.
Should you get a warning about “Recreation 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 elective).
On the high are choices to put in the Homebrew package deal 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 choice though we already had it put in.
If this occurs, and you have already got Homebrew put in, go forward and uncheck that choice.
Within the discipline beneath, you have got the choice to pick out which Apple Recreation Porting Toolkit .dmg the installer will use by clicking the Browse button – when you’ve already downloaded one from Apple, however this step is elective. The installer is aware of how one can discover the Apple Recreation Porting Toolkit .dmg on the web by itself.
Should you do not have already got the .dmg for the Apple Recreation Porting Toolkit downloaded to your Mac, click on the small hyperlink above the highest textual content discipline to obtain it:
Click on the textual content hyperlink to obtain Apple’s recreation Porting Toolkit.
It will open the Extra Downloads part on Apple’s Developer web site, however you may first have to sign up along with your Apple ID.
As soon as signed in, increase the Recreation Porting Toolkit merchandise by clicking the View Particulars hyperlink, then click on the .dmg obtain button. It will obtain Apple’s Recreation Porting Toolkit .dmg to your Mac:
Obtain Recreation 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 operating, and click on the Browse button subsequent to the textual content discipline. Navigate to Apple’s Recreation Porting Toolkit .dmg you downloaded and choose it by clicking the Open button.
Set a Home windows app to put in
The following step is elective however when you additionally wish to arrange a Home windows app whereas putting in the Recreation 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 all the things. Click on the Subsequent button to start out the set up.
Should you get the error “Tapping Apple Homebrew Failed!” with Error code -1, you may have to both activate the Homebrew choice on the high of the unique installer window or else manually faucet the Apple Homebrew formulation in Terminal with:
brew faucet apple/apple http://github.com/apple/homebrew-apple
However as we said in our authentic article, this will likely take a very long time – as much as an hour on an Apple Silicon machine. So you might simply wish to examine the Homebrew choice in InstallAware’s installer and check out once more.
Because the installer begins operating, it should ask you in your Mac’s admin password with a “Checking for sudo entry” immediate. You will have to enter an admin password in 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 elective settings’ change.
Lastly, when you chosen any third-party software program to put in, the installer will run that installer final and you may have to step by way of it. Should you’re putting in industrial software program, you may want a serial quantity in your installer:
Recreation installer operating.
As soon as any third-party installer finishes, you are finished. Click on the Performed or End button and also you’re completed.
We have already coated how one can run third-party video games in Recreation Porting Toolkit in our earlier article, so try that article for directions.
InstallAware’s installer does make putting in the Recreation Porting Toolkit simpler with far fewer steps and much fewer instructions within the Terminal – even when it does appear to have a number of glitches or idiosyncrasies right here and there.
