AGK Repository

New Home of AGK Source Code for 2024 and Beyond.

WINDOWS PC INSTRUCTIONS

The following instructions require Windows 10 or above:

Pre-requisites to compile AGK Studio

Ensure the following are installed with particular attention to the versions:

• Install Visual Studio 2022
• Android Studio (android-studio-2023.2.1.25-windows.exe)
• Android SDK 34
• Android 14.0 platform
• Install Java JDK 17
• Install GitHub Desktop
• Install Git Large File Storage (https://docs.github.com/en/repositories/working-with-files/managing-large-files/configuring-git-large-file-storage)

Notes on project settings

New APKs submitted to the Google Store require API 33 (Android 13) since August 2023: https://developer.android.com/google/play/requirements/target-sdk Small changes to any pre-API 33 projects include:

• Add namespace 'com.thegamecreators.agk_player2' in "AGKPlayer2\build.gradle"
• Add mavenCentral() in "build.gradle"
• Remove jcenter() in "build.gradle"
• Update version classpath 'com.android.tools.build:gradle:8.1.1' // was 7.2.1
• Update version compileSdkVersion 34 in "AGKPlayer2\build.gradle"
• Ensure that any Android Studio project points to JDK 17 (via "Settings>Build,Exe&Dep>Build Tools>Gradle>GradleJDK")

Sequence to build AGK Studio

You need to open in Android Studio and build these projects once before attempting to compile AGK:

• \AGK\apps\interpreter_android_google
• \AGK\apps\interpreter_android_amazon
• \AGK\apps\interpreter_android_ouya

Setup all environment variables

• Add Environment Variable called NDK_PATH with absolute path to "D:\DEV\AGKREPO\AGK_Build\External\android-ndk-r20b"
• Add Environment Variable called USERNAMEFORAGK with the folder truncation of your Username (so would be 'fred' as might appear in "C:\Users\fred\Documents"). Do not use your full username or include any path text, just the folder name that appears in the example given.
• Add Environment Variable called VULKAN_SDK_PATH with absolute path to "D:\DEV\AGKREPO\AGK_Build\External"
• Add Environment Variable called AGK_STUDIO_PATH with absolute path to "D:\DEV\AGKREPO\AGK"
• Add Environment Variable called STEAMWORKS_PATH with absolute path to "D:\DEV\AGKREPO\AGK_Build\External\Steamworks"
• Add Environment Variable called ANDROID_HOME with absolute path to "C:\Users\YOURS\AppData\Local\Android\Sdk" where YOURS is the folder assigned you from your username

Prerequisite Zip Files (SDK files not part of repository, download separately from Release area)

• Unzip "AGK_Build-External.zip" into the "D:\DEV\AGKREPO\AGK_Build\External" folder
• Unzip "AGK_Build-Build.zip" into the "D:\DEV\AGKREPO\AGK_Build\Build" folder
• Unzip "AGK_Build-Shared.zip" into the "D:\DEV\AGKREPO\AGK_Build\Shared" folder

Your Own Keystore file

• Part of the build process is being able to produce APKs that require a Keystore file that you must provide yourself in "AGK_Build\Signing\keystore.keystore"
• You will be able to enter the password of your own keystore file during the build process

Compile AGK in Visual Studio 2022

• Open the AGKBuild project found here "\AGK\tools\AGKBuildSystem\Windows"
• Stick with Debug x64 and select REBUILD on the project shown
• When compile completes, you can run this to open a command line menu to handle the build processes
• The system allows individual steps to be executed, or for simplicity, you can run the whole process in Sequence
• When all steps have been completed successfully and in order, the "AGK_Build\Builds" folder will contain updated files for AGK

MAC INSTRUCTIONS

The following instructions require a modern Mac or Mac-Mini:

Pre-requisites to compile the Apple binaries

Ensure the following are installed:

• XCODE 15.2 or above
• Install GitHub Desktop for Mac-Mini
• Select YES to any prompt asking to initialize Git Large File Storage

Sequence to build Apple binaries

• Use GitHub Desktop to clone AGKREPO into a local folder (could be "Users/YourName/DEV/AGKREPO")
• Create a folder at "Users/YourName/AGKStudioBuild" and "Users/YourName/AGKStudioBuild/AppGameKitStudio"
• Copy the SIGN.SH script file into "Users/YourName/AGKStudioBuild" and configure to your own paths (for step 15 in build tool)
• Open Finder and navigate to the tools folder (e.g. /Users/YourName/DEV/AGKREPO/AGK/tools/AGKBuildSystem/Mac)
• Open Paths.h and confirm the paths specified here match existing folders in the repo folder structure
• Open the Terminal via the Utilities on your Mac and navigate to the folder (e.g. cd /Users/YourName/DEV/AGKREPO/AGK/tools/AGKBuildSystem/Mac)
• Now type MAKE to compile and create the AGK Build Program
• Can ignore terminal warnings, there should be no errors reported
• You can now call "./AGKBuild" to run the build program
• Follow the steps in a similar way to the Windows steps sequence until all 15 steps completed (i.e. type 1 and press RETURN)
• Any errors you get along the way should be output in the terminal for you to report to TGC (if any)
• Issues are likely to arise from missing folders. When the error reports this, create the empty folder with the exact path and name required
• You will need an Apple Developer Account to create your certificates and provisions to replace those used by TGC (Apple website has instructions)
• The AGK IDE for the Mac uses an older AGK Lib file that has been provided and hard copied to the repo for predictable compiling

LINUX INSTRUCTIONS

The Linux source code is not supported in the AGKREPO at this time. * Linux version of AGK Studio downloaded from Steam, Tier 2 Android contains a bat file to start compiling C++ code, instead of an sh script.

How to Implement Tracking Transparency

App tracking transparency was implemented a few years ago using the external command functionality. Here's how to use it:

supportsIDFA = ExternalSDKSupported ( "idfatracking" ) if ( supportsIDFA ) ExternalCommand ( "idfatracking", "requestconsent", "", "" )

while ( ExternalCommandInt ( "idfatracking", "trackingallowed", "", "" ) < 0 )
    sync ( )
endwhile

endif