This article contains information to help you set up the Android export in GameMaker Studio 2. Each section covers a different potential issue and how to resolve it, but if you have an issue that cannot be resolved through this article, please contact support.
Enable Developer Mode and USB Debugging on the Device
Before you can get your device to connect and run games with GameMaker Studio, you must first have enabled Developer Mode, and then enabled USB Debugging. On Android 4.2 and higher, the Developer Mode screen is hidden by default, so to make it visible, go to Settings > About phone and tap the Build Number seven (7) times. Return to the previous screen to find Developer Options at the bottom. In the Developer options you can enable USB Debugging.
Connecting a Device (PC)
If you are having problems getting your device to be detected by your development computer or GameMaker Studio 2, you need to make sure that it is discoverable using ADB. Below explains how to go about this:
- Connect your Android device to your PC via the data cable (USB)
- The device drivers should be installed automatically at this stage (if they aren't already), but if they are not, then please refer to your device manufacturer's support information to locate and install the correct ADB drivers. It is very important you get ADB drivers, not the standard consumer ones.
- Now test your phone driver to confirm if it's correct. This can be done in a couple of ways:
- If you have already set up a PATH variable to point to ADB directly (see here), then simply Windows Key and R to open a new Run window and type "cmd" (no quotes) and hit enter, then type "adb devices"
- Go to your Android install folder and then the "platform-tools" folder inside it (e.g. C:\android-sdk\platform-tools) and then hold down the shift key and then right-click in some empty space and choose "Open a command window here". In the new command window, type "adb devices" (without the quotes).
Once this has been done, GameMaker Studio 2 should be able to auto-detect the device in the Device Manager.
Connecting a Device (Mac)
When you first connect your Android device to your Mac via USB, you will get a message on bothe the device and the Mac about file transfer protocols, and GameMaker Studio 2 will not be able to communicate with the device. To resolve this issue, download and install the Android File transfer app which you can get from the following link:
Once you have installed the app on your Mac, follow these steps:
- Open Android File Transfer.
- Unlock your Android device.
- With a USB cable, connect your device to your computer.
- On your device, tap the "USB for..." notification.
- Select Transfer files.
- An Android File Transfer window will open on your Mac.
GameMaker Studio 2 should now be able to detect your device, and every time you connect it to the Mac from now on the Android File Transfer app will open automatically.