Skip to content

advancedSettings: document Minimum iOS Version #216

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
XeduR wants to merge 3 commits into
base: master
Choose a base branch
from
Open

advancedSettings: document Minimum iOS Version #216

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
69d503d
Add clarifying Gotchas regarding JSON encoding
XeduR Jun 11, 2026
afd3094
advancedSettings: document Minimum iOS Version
XeduR Jul 8, 2026
d45bd9c
Merge branch 'coronalabs:master' into master
XeduR Jul 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions markdown/guide/distribution/advancedSettings/index.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,39 @@ This guide is intended for those who require more specialized configuration opti

## Advanced Settings — iOS

### Minimum iOS Version

Providing a minimum iOS version with the `MinimumOSVersion` key allows you to exclude your app from being installed on devices with older versions of iOS. It's specified within the <nobr>`iphone` &rarr; `plist`</nobr> table and corresponds to Apple's [`MinimumOSVersion`](https://developer.apple.com/documentation/BundleResources/Information-Property-List/MinimumOSVersion) property list key.

``````{ brush="lua" gutter="false" first-line="1" highlight="[7]" }
settings =
{
iphone =
{
plist =
{
MinimumOSVersion = "11.0",
},
},
}
``````

<div class="guide-notebox">
<div class="notebox-title">Notes</div>

* The value must be specified as a __string__ <nobr>(e.g. `"11.0"`)</nobr>. A numeric value such as `11.0` is ignored and the default minimum version is used instead.

* If not specified, the minimum version defaults to `"8.0"`, the lowest version of iOS that Solar2D supports. However, when building against iOS&nbsp;SDK&nbsp;16.4 or later, Solar2D raises any value below `"11.0"` up to `"11.0"`. Since current versions of Xcode ship newer SDKs, `"11.0"` is effectively the lowest value you can target.

</div>

<div class="guide-notebox-imp">
<div class="notebox-title-imp">Important</div>

If a plugin you use requires a newer version of iOS than your app's minimum, Solar2D does __not__ raise `MinimumOSVersion` automatically to accommodate it. You must set it yourself to match the highest iOS version required by any of your plugins, otherwise the build can fail. Some plugins, such as [Appodeal][plugin.appodeal], document the exact value they require.

</div>

### Device Capabilities

If you wish to limit your iOS app to devices with specific capabilities, you can include the optional `UIRequiredDeviceCapabilities` key within the <nobr>`iphone` &rarr; `plist`</nobr> table. The value of this key should be a table containing specific keys matching Apple's [documentation](https://developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW3). For&nbsp;example:
Expand Down