Apple’s Recreation Porting ToolKit could be a bit tough 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 Recreation Porting Toolkit (AGPT) – a brand new SDK which permits recreation builders to port current Home windows-based DirectX video games to the Mac by way of a translation layer.
Our unique article on find out how to set up the Recreation Porting ToolKit confirmed you find out how 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.
Under we’ll stroll you thru find out how 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 will 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 recordsdata in your Mac’s drive the place you’ll usually hold all of your downloads and sources. We’ll use the working title “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 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.
In case you like, you may as well 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 case 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 non-compulsory).
On the high are choices to put in the Homebrew package deal superv isor, 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 regardless that 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 subject beneath, you might have the choice to pick out which Apple Recreation Porting Toolkit .dmg the installer will use by clicking the Browse button – in case you’ve already downloaded one from Apple, however this step is non-compulsory. The installer is aware of find out how to discover the Apple Recreation Porting Toolkit .dmg on the web by itself.
In case 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 subject to obtain it:
Click on the textual content hyperlink to obtain Apple’s recreation Porting Toolkit.
This may open the Extra Downloads part on Apple’s Developer web site, however you will first have to sign up together 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. This may 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 subject. 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 subsequent step is non-compulsory however in case 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 suitable 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.
In case you get the error “Tapping Apple Homebrew Failed!” with Error code -1, you will have to both activate the Homebrew choice 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 said in our unique article, this may increasingly take a very long time – as much as an hour on an Apple Silicon machine. So chances are you’ll simply wish to verify the Homebrew choice in InstallAware’s installer and take a look at once more.
Because the installer begins operating, it should ask you to your Mac’s admin password with a “Checking for sudo entry” immediate. You will have to enter an admin password to 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 achieved you will be prompted for Wine and different settings. Simply use the defaults:
Immediate for non-compulsory settings’ change.
Lastly, in case you chosen any third-party software program to put in, the installer will run that installer final and you may have to step by it. In case you’re putting in industrial software program, you will want a serial quantity to your installer:
Recreation installer operating.
As soon as any third-party installer finishes, you are achieved. Click on the Completed or End button and also you’re completed.
We have already lined find out how to 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 couple of glitches or idiosyncrasies right here and there.
