> For the complete documentation index, see [llms.txt](https://docs.flatredball.com/flatredball/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flatredball.com/flatredball/glue-reference/multi-platform/glue-reference-ios.md).

# iOS

{% hint style="warning" %}
**iOS projects cannot currently be created.** The iOS engine targets `net8.0-ios`, whose workload has reached end of life and is no longer available on the build machines, so the iOS engine is not built or published and the **iOS** option has been removed from the New Project and New Synced Project windows. This page and its sub-pages are kept for reference and for whenever the iOS project is retargeted. Existing iOS projects are unaffected — their NuGet packages are still published.
{% endhint %}

### Introduction

FlatRedBall support development for iOS (iPhone and iPad) using .NET 8 (as of March 2024).

### Creating a New iOS Project

To create a new iOS project, launch the FlatRedBall Editor, create a new project, and select iOS as your target platform. This option is not currently available — see the note above.

### Troubleshooting

#### The MinimumOSVersion value in the Info.plist (11.0) does not match the SupportedOSPlatformVersion value (11.2)

You may see the following when deploying your project:

```
The MinimumOSVersion value in the Info.plist (11.0) does not match 
the SupportedOSPlatformVersion value (11.2) in the project file 
(if there is no SupportedOSPlatformVersion value in the project 
file, then a default value has been assumed). Either change the 
value in the Info.plist to match the SupportedOSPlatformVersion 
value, or remove the value in the Info.plist (and add a 
SupportedOSPlatformVersion value to the project file if it doesn't 
already exist).
```

Verify that your Info.plist Deployment Target matches your csproj's SupportedOSPlatformVersion.

<figure><img src="https://951240982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_fye9Ufg3vzJxwX5Hk%2Fuploads%2FAfHEBlG6lTjdUwFI4lu9%2Fimage.png?alt=media&amp;token=9062b0ed-b76f-42c3-b4db-c19b605c3d8e" alt=""><figcaption><p>Match Deployment Target to SupportedOSPlatformVersion</p></figcaption></figure>

### Additional Information

* If you have a NullReferenceException in Microsoft.Xna.Framework.Audio.OpenALSoundController.Update, and you are playing on the simulator, verify that audio is working properly on your Mac.
* For information on errors playing SoundEffects and SounEffectInstances see [the SoundEffectInstance page](https://github.com/flatredball/FlatRedBallDocs/tree/main/frb/docs/index.php).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flatredball.com/flatredball/glue-reference/multi-platform/glue-reference-ios.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
