Feature/mobile deployment #169

olivegamestudio · 2025-08-18T16:56:48Z

This is the documentation part of deploying to the app stores - Apple and Google Play. This covers the continuation of Dungeon Slime game from it's Windows-ness to the mobile world.

In addition, we have a separate touch demo that can be used to test out the gestures.

* Add screenshots from deploying to iOS simulator and Android emulator. * Set landscape orientation. * Android documentation started. * Updated android doc. * More information about csproj. * Fix image link. * Initial notes for part 1. * Updated doc and images. * Add android doc and images. * Add android project image. * Work on the cross platform changes. * More tidy ups. * notes * Restructure. * Update for debugging. * Updated image. * Renamed screenshots. * Add iOS simulator. * Adding rider images. * Added getting started section. * Refactoring folders. * Parts 1 and 2. Setup 3 and 4 the right order. * Update mobile development tutorial: refine iOS section, add modern .NET features, and enhance clarity * Updated versions of library. * Cropped image better and removed unnecessary one. * Touch tutorial. * Publishing documentation. * Include transporter images. * Updated documents and tidy ups.

Copilot

Pull Request Overview

This PR introduces a comprehensive mobile deployment tutorial series for MonoGame, extending the existing desktop tutorial to cover Android and iOS development. The tutorial covers the complete mobile development lifecycle from initial setup through app store publishing.

Key changes include:

Complete mobile development workflow tutorial spanning 5 chapters
Cross-platform project architecture and setup guidance
Touch input handling for mobile interfaces
Publishing processes for both iOS App Store and Google Play Store

Reviewed Changes

Copilot reviewed 5 out of 40 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
01_getting_started/index.md	Introduction chapter covering development environment setup and requirements for Android/iOS
02_crossplatform/index.md	Guide for converting Windows-only projects to cross-platform architecture
03_touch/index.md	Touch gesture handling fundamentals and implementation patterns
04_debugging_locally/index.md	Local debugging setup with screenshots for Android and iOS
05_publishing/index.md	Comprehensive publishing guide for iOS App Store and Google Play Store

Comments suppressed due to low confidence (1)

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-08-18T16:57:41Z

articles/tutorials/advanced/MobileDeployment/05_publishing/index.md

+|120x120|![120x120](images/icons/appicon40x40@3x.png)|
+|120x120|![120x120](images/icons/appicon60x60@2x.png)|
+|152x152|![152x152](images/icons/appicon76x76@2x.png)|
+|83.5x83.5|![167x167](images/icons/appicon83.5x83.5@2x.png)|


The table shows '83.5x83.5' but the image filename and alt text show '167x167'. This inconsistency will confuse readers about the correct icon size.

Suggested change

|83.5x83.5|![167x167](images/icons/appicon83.5x83.5@2x.png)|

|167x167|![167x167](images/icons/appicon83.5x83.5@2x.png)|

articles/tutorials/advanced/MobileDeployment/05_publishing/index.md

articles/tutorials/advanced/MobileDeployment/04_debugging_locally/index.md

articles/tutorials/advanced/MobileDeployment/01_getting_started/index.md

vchelaru · 2025-08-28T12:54:36Z

articles/tutorials/advanced/MobileDeployment/02_crossplatform/index.md

+[https://github.com/vchelaru/Gum](https://github.com/vchelaru/Gum)
+
+```xml
+<PackageReference Include="Gum.MonoGame" Version="2025.6.26.1" />


I would recommend upgrading to the latest version of Gum before releasing this, unless of course you are concerned that you haven't spent enough time with it to verify compatibility.

I don't have an issue with updating the version number and would need to check compatibility.

The 3.8.5 base branch has been updated, so you should be able to refresh to the latest used by the base tutorial

The mobile tutorial is using 2025.8.3.3 where as the original tutorial is using 2025.5.1.1.
I've updated the doc to match the tutorial.

articles/tutorials/advanced/MobileDeployment/03_touch/index.md

articles/tutorials/advanced/MobileDeployment/04_publishing/index.md

vchelaru · 2025-08-28T13:04:17Z

articles/tutorials/advanced/MobileDeployment/04_publishing/index.md

+
+#### Using Command Line
+
+The creation of an IPA file can be achieved on the terminal. Currently, Rider does **not** support this process.


What about Visual Studio - is that worth discussing here?

The 2D tutorial focused on Visual Studio Code, so I think it is ok to continue with that here. Using full Visual Studio is the same pattern, just a different interface. Same with Rider.

Yes the tooling for MacOS is not perfect since the departure of VS for Mac. Especially when terminal is needed to do the publish part then it's just a preference about the IDE.

vchelaru · 2025-08-28T13:04:49Z

articles/tutorials/advanced/MobileDeployment/04_publishing/index.md

+    AlwaysRetainTaskState = true,
+    LaunchMode = LaunchMode.SingleInstance,
+    ScreenOrientation = ScreenOrientation.SensorLandscape,
+    ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.Keyboard | 


What do these mean? Why might I want to change them?

vchelaru · 2025-08-28T13:05:04Z

articles/tutorials/advanced/MobileDeployment/04_publishing/index.md

+    Label = "@string/app_name",
+    MainLauncher = true,
+    Icon = "@drawable/icon",
+    AlwaysRetainTaskState = true,


What does AlwaysRetainTaskState mean? Why might I want to change it?

Issue raised - olivegamestudio#2

vchelaru · 2025-08-28T13:06:02Z

articles/tutorials/advanced/MobileDeployment/04_publishing/index.md

+
+```bash
+# Build AAB using .NET CLI
+dotnet publish -f net8.0-android -c Release


Is it worth discussing how to do all of this in normal Visual Studio? Or linking to the MS docs?

olivegamestudio#3

…econtroller class was updated to use the new "TouchInfo" class.

SimonDarksideJ

A good start, but a few crucial changes needed to align with the styles from the original 2D tutorial:

Encapsulation of images into figures.
More explanation of subjects instead of just headings.
No contractions :D (just ask @AristurtleDev :P )
More instructions rather than referring to the sample
Doesn't include links to the finished sample :S

Overall a great start, just needs some finishing touches.

SimonDarksideJ · 2025-08-30T14:15:09Z

articles/tutorials/advanced/MobileDeployment/01_getting_started/index.md

+
+# Getting Started and Overview
+
+This tutorial extends the **MonoGame 2D Dungeon Slime tutorial** to mobile platforms. If you haven't completed the desktop tutorial yet, we recommend finishing it first as we'll be building directly on that foundation.


When mentioning other content or API's, provide a hyperlink back to the source content so the user does not have to search

articles/tutorials/advanced/MobileDeployment/01_getting_started/index.md

SimonDarksideJ · 2025-08-30T14:18:12Z

articles/tutorials/advanced/MobileDeployment/01_getting_started/index.md

+
+**Required Tools:**
+- **Android Device Manager** - Used to set up simulators (accessible through Visual Studio)
+- **Android SDK Manager** - Used to install the SDK platforms


iOS mentions having an iOS developer account. Is the same setup not also required for Android?

A Google Developer account is required to publish, but not to build I think.

Added comment to page to say that you do not need a paid developer account to build locally and test.

articles/tutorials/advanced/MobileDeployment/01_getting_started/index.md

SimonDarksideJ · 2025-08-30T14:23:00Z

articles/tutorials/advanced/MobileDeployment/02_crossplatform/index.md

+
+# Prerequisites
+
+Before starting this chapter, ensure you have:


Ideally, this should be included in the previous chapter, which detailed what the reader should know before starting the tutorial.
By Chapter 2, they should be "ready" to begin :D

articles/tutorials/advanced/MobileDeployment/04_publishing/index.md

SimonDarksideJ · 2025-08-30T14:58:10Z

articles/tutorials/advanced/MobileDeployment/04_publishing/index.md

+
+### Creating Your App
+
+1. **Create App** in Google Play Console


Pretty much the same comments as already stated for the iOS walk through.

More concise

Explain a bit more (far too many sections are just lists, e.g. signing configuration, shows the configuration but does not explain to the reader what signing is and what it is for?

include links to tools that help, e.g. generating icons/images

articles/tutorials/advanced/MobileDeployment/04_publishing/index.md

dellis1972 · 2025-08-30T15:38:14Z

articles/tutorials/advanced/MobileDeployment/02_crossplatform/index.md

+For **Android**:
+
+```xml
+<ItemGroup Condition="'$(TargetFramework)'=='net8.0-android'">


These should be using
Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'"
This means the code will not need to change when the TargetFramework changes

…ecklist and conclusion. (#18)

…properties. AoT issue may happen during publish on own projects.

olivegamestudio and others added 2 commits June 12, 2025 18:46

Add folder structure for mobile deployment tutorials.

5945f88

Copilot AI review requested due to automatic review settings August 18, 2025 16:56

Copilot AI reviewed Aug 18, 2025

View reviewed changes

Removed 04 debugging locally folder.

cdaa253

vchelaru reviewed Aug 28, 2025

View reviewed changes

olivegamestudio added 4 commits August 28, 2025 21:27

Added xml tag.

9a22ba8

Updated details about Rider and VS Code being usable.

f20f79d

Added relation about touchpanel to the dungeon slime example. The gam…

f66fa9d

…econtroller class was updated to use the new "TouchInfo" class.

Added a section about the bundle identifier.

ba1387c

SimonDarksideJ requested changes Aug 30, 2025

View reviewed changes

dellis1972 reviewed Aug 30, 2025

View reviewed changes

olivegamestudio and others added 8 commits September 1, 2025 21:39

Remove contractions. You'll, let's etc. (#15)

cb5c95a

Merge branch 'main' into feature/MobileDeployment

60acf90

Merge branch 'main' into feature/MobileDeployment

3173777

Patch path to 2D tutorial

dec9803

No toc in "building 2D games", updated to index page

68091a4

Set link to the original tutorial for continuation.

ed11443

Added link to Android workload. (#16)

85bf058

Updated existing images to be figures and follow tutorial style. (#17)

cfab710

olivegamestudio and others added 18 commits September 2, 2025 18:22

Broke up publishing into smaller parts - publishing, ios, android, ch…

ac7cc3b

…ecklist and conclusion. (#18)

Added link to microsoft site about android getting started.

c0479e3

Added maui link.

f797549

Add some more details about registering for developer account. (#20)

cb42e6e

Add tip about disabling encryption dialog. (#21)

295fae7

Added link to pair visual studio with mac.

90b9914

WIP minor changes to indicate bits need tweaking.

2676f5c

Polishing.

f52ec09

Updates to conclusion.

b1af154

Updated ios publishing and polish.

a5906bb

Add note about signing

0e62b4a

Add section about API usage descriptions.

69be315

Added section about API descriptions and tidy up some of sections.

2b159a3

Hookup to the tutorial.

2fbf92d

Prefix with Chapter.

7f134a6

Add link to tutorial.

e9e2421

More tidyups.

3f8f99a

Tidyup tabs.

5af3400

olivegamestudio force-pushed the feature/MobileDeployment branch from 5af3400 to 1504684 Compare October 14, 2025 17:55

Updated scripts for .NET 8, 9 and 10. Tahoe 26 property.

b484644

olivegamestudio force-pushed the feature/MobileDeployment branch from 98d170a to b484644 Compare October 22, 2025 21:05

Add information about UseInterpreter and CheckEolTargetFramework …

2dd9925

…properties. AoT issue may happen during publish on own projects.

	\|83.5x83.5\|![167x167](images/icons/appicon83.5x83.5@2x.png)\|
	\|167x167\|![167x167](images/icons/appicon83.5x83.5@2x.png)\|


		#### Using Command Line

		The creation of an IPA file can be achieved on the terminal. Currently, Rider does not support this process.


		# Getting Started and Overview

		This tutorial extends the MonoGame 2D Dungeon Slime tutorial to mobile platforms. If you haven't completed the desktop tutorial yet, we recommend finishing it first as we'll be building directly on that foundation.


		# Prerequisites

		Before starting this chapter, ensure you have:


		### Creating Your App

		1. Create App in Google Play Console

Feature/mobile deployment #169

Are you sure you want to change the base?

Feature/mobile deployment #169

Uh oh!

Conversation

olivegamestudio commented Aug 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

SimonDarksideJ left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

olivegamestudio commented Aug 18, 2025 •

edited

Loading