With Xcode 7.1.1, Xamarin Studio 22.214.171.12404 and Xamarin.iOS 126.96.36.1994 installed when I create a single view iOS project and build it I get a compiler error:
MTOUCH: error MT0091: This version of Xamarin.iOS requires the iOS 9.3 SDK (shipped with Xcode 7.3) when the managed linker is disabled. Either upgrade Xcode, or enable the managed linker.
Now the fix suggesting to upgrade to Xcode 7.3 is understandable and an easy way to fix the problem. However if I want to stay and use Xcode 7.1 it is not obvious to me what I need to change. If I open the iOS Build Options panel it is not obvious to me, as a non-expert iOS developer, what I need to do to enable the managed linker. To fix the build error I changed the Linker behaviour to "Link Framework SDKs Only". If the error message was something the following I could immediately change the correct setting without having to ask somebody or try different build options:
MTOUCH: error MT0091: This version of Xamarin.iOS requires the iOS 9.3 SDK (shipped with Xcode 7.3) when the managed linker is disabled. Either upgrade Xcode, or enable the managed linker by changing the Linker behaviour to Link Framework SDKs Only.
Seems like a valid request to me, I'll update the message.
Longer term we'll also have the ability to link MT errors to the docs. We could then detail a bit more how exactly users are supposed to change the linker behavior.
+1 and thank you Matt, this was the only thing I could find to help me solve this issue after upgrading.
Fixed in https://github.com/xamarin/xamarin-macios/pull/1453