Compiling for Different Devices

PDF for offline use
Related Articles:

Let us know how you feel about this

Translation Quality


0/250

The build properties of your executable can be configured from the Project's iOS Build properties page, which is found by right-clicking on the Project name and browsing to Options > iOS Build in Xamarin Studio, and Properties in Visual Studio:

In addition to the configuration options available on the UI, you can also pass your own set of command line options to the Xamarin.iOS build tool (mtouch).

http://iossupportmatrix.com/ is a helpful resource that can be used to make sure you are including all the required devices, architectures, and iOS versions.

SDK Options

Xamarin Studio lets user configure two important properties related to the SDK: the iOS SDK version used to build your software and the Deployment Target (or the minimum required iOS version).

The iOS SDK version option lets you use different versions of an Apple published SDK, this directs Xamarin.iOS to the compilers, linkers and libraries it should reference during your build.

The Deployment Target setting is used to select the minimum required version of the operating system on which your application will run. This is set in your Project's Info.plist file. You should pick the minimum version that has all the APIs that you need to run your application.

In general, the Xamarin.iOS API exposes all the methods available in the latest version of the SDK, and when necessary, we provide convenience properties that allow you to detect if the functionality is available at runtime (for example, UIDevice.UserInterfaceIdiom and UIDevice.IsMultitaskingSupported always work on Xamarin.iOS, we do all the work behind the scenes).

Linking

See our dedicated page on the Linker to learn more about how the linker helps you reduce the size of your executables and to find out how to use it effectively.

Code Generation Engine

Starting with Xamarin.iOS 4.0, there are two code generation backends to Xamarin.iOS. The regular Mono code generation engine and one based on the LLVM Optimizing Compiler. Each engine has its pros and cons.

Typically, during the development process, you will likely use the Mono code generation engine as it will let you iterate quickly. For release builds and AppStore deployment, you will want to switch to the LLVM code generation engine.

The LLVM optimizing backend engine produces both faster and tighter code than the Mono engine does, at the cost of long compile times.

You can enable these from the Advanced Tab in your iOS Build panel in Xamarin Studio or Visual Studio.

Architecture Support

ARMv6 (Xamarin.iOS discontinued support for ARMv6 with v8.10)

  • iPhone (original), 3G
  • iPod 1st, 2nd generation

ARMv7

  • iPhone 3GS, 4, 4S
  • iPad 1, 2, 3, Mini
  • iPod 3, 4, 5th generation

ARMv7s

  • iPhone 5
  • iPhone 5c
  • iPad 4

ARM64 (Xamarin.iOS started supporting ARM64 in v8.6)

  • iPhone 5s
  • iPhone SE
  • iPhone 6, 6 Plus
  • iPhone 6s, 6s Plus
  • iPhone 7, 7 Plus
  • iPad Air
  • iPad Air 2
  • iPad Mini 2, 3, 4
  • iPad Pro (all)

If you target only the ARMv7s processor, the code generated will be slightly faster, but it will no longer run on ARMv7 or ARMv6 systems unless you compile a fat binary that contains multiple executables in your package.

Note that any builds submitted to the App Store must contain 64 bit support, this is a requirement set by Apple.

ARM Thumb-2 Support

Thumb is a more compact instruction set used by ARM processors. By enabling the Thumb support, you can reduce the size of your executable, at the expense of slower execution times. Thumb is supported on ARMv7 and ARMv7s.

Conditional Framework Usage

If your project wants to leverage some of the features in the newer iOS releases, you may need to conditionally rely on certain new frameworks. A prime example of this is wanting to use iAd when running on iOS 4.0 or greater, but still support 3.x devices. To accomplish this you need to let Xamarin.iOS know that you need to link against the iAd framework "weakly". Weak bindings ensure that the framework is only loaded on demand the first time a class from the framework is required.

To do this you should take the following steps:

  • Open your Project Options and navigate to the iOS Build pane.
  • Add '-gcc_flags "-weak_framework iAd"' to the Additional Options for each configuration you wish to weakly link on:

In addition to this you will need to guard your usage of the types from running on older versions of iOS where they may not exist. There are several methods to accomplish this, but one of which is parsing UIDevice.CurrentDevice.SystemVersion.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.