Android
Introduction
FlatRedBall supports creating games which run on Android devices. Aside from Android-specific capabilities, FlatRedBall Android development is nearly identical to developing games for other platforms. As of April 2024 FlatRedBall Android projects use .NET 8 which provides access to a much wider set of features and nuget packages compared to the previous Xamarin-based version.
Prerequisites
FlatRedBall Android game development requires a Windows PC just like regular PC game development as well as Visual Studio 2022 or newer.
Primary Android vs. synced Android projects
As mentioned in the Multi-Platform page, the recommended approach for creating full game projects is to create a primary desktop project with a synced Android project. However, if you are evaluating FlatRedBall, or creating a small test project, you may want to create a primary Android project. Both approaches are discussed below.
Creating a primary Android project
Creating an Android project is essentially identical to creating any other platform:
Open the FlatRedBall Editor
Select File->New Project
Enter a project name
Set the Platform to Android .NET
Click Create project!
Select the desired project type in the wizard, or close the wizard to begin with an empty project. Click the Visual Studio icon to open the project in Visual Studio:
Now that the project is in Visual Studio, you can develop an Android game the same as if you were making a PC game, including using the FRB Editor. To launch the game:
Select the target device
If you have a physical phone, you can connect it to your computer. You need to enable your phone for development by turning on developer mode. For more information see the Microsoft page for setting up an Android device: https://learn.microsoft.com/en-us/dotnet/maui/android/device/setup?view=net-maui-8.0
If you do not have a physical phone, or if you prefer to use an Android emulator, see the following page on how to set up an Android emulator: https://learn.microsoft.com/en-us/dotnet/maui/android/emulator/?view=net-maui-8.0
Verify that the Play button in Visual Studio has the desired emulator or device selected. Note that if a physical Android device is connected to your computer and is set up for debugging, then Visual Studio will detect it as a deployment option.
Press the Play button
Creating a synced Android project
Synced Android projects are created just like any other synced project. The first step is to create a regular Windows Desktop project. Once the project is created a new synced Android project can be created as follows:
Open FlatRedBall
Select Project->View Projects
Click the New Synced Project button
Select the Android option
Enter a project name
Click Make my project!
The project will take a moment to download and be created, but once it is, you should see the Android project listed in the Androids project list. Since your FlatRedBall project now has multiple platforms, you can choose which project to open through the Projects tab.
Releasing an Android Project
To create an Android APK, whether for internal testing or for final release, see the Microsoft release documentation.
Troubleshooting
Unfortunately deploying to Android can be fickle at times, and sometimes no errors are provided.
App crashes immediately
If your app crashes immediately without a call stack, then you may want to try the following:
Does the app work on Android hardware? Sometimes an app will not work on emulator but will work on hardware
Have you tried creating a .NET MAUI? MAUI projects can be created with templates which are part of Visual Studio, so they are likely to eliminate common problems in template setup. If a MAUI project doesn't work, then that might mean that prerequisites are not properly installed.
Last updated