Frequently Asked Questions

General Questions

Can I use a Mac VM with Xamarin?

Yes, but only on Mac hardware.

How can I downgrade Xcode?

This guide provides links to access previous versions of Xcode as well as the latest version.

Where can I set my iOS SDK Locations?

For most users these are set to the proper locations automatically. This guide lists the default SDK locations and how to change them if needed.

How can I reenable developer options after updating iOS?

An iOS bug may cause the developer options to disappear after updating iOS versions, this has been observed when switching to iOS 8.x. This guide describes how the options can be reenabled.

User Location not working in iOS 8

This guide tells you how to edit info.plist to enable User Location in iOS 8.

Where can I find the .dSYM file to symbolicate iOS crash logs?

This guide describes basic steps for symbolicating iOS crash logs to help with diagnosing crashes. It also links to additional resources for more advanced symbolication techniques & info on interpreting iOS crash logs.

How do I set Mono Runtime environment variables for iOS projects in Xamarin Studio?

If you need to set any runtime environment variables for Mono, they can be set in the Project Options > Run > General page.

Publishing Questions

Error when submitting to App Store: “Invalid Bundle - Options not allowed to be embedded in bitcode are detected in the submission”

Submitting apps that require bitcode, such as watchOS and tvOS apps, must be done with Xcode 9.

Can I change the output path of the IPA file?

As of Xamarin Cycle 7, you can use customized MSBuild targets to achieve this.

How can I copy IPA output files to the TFS drop folder?

Yes, this guide describes how.

Can I add files to or remove files from an IPA file after building it in Visual Studio?

Yes, it is possible but it will usually require that you re-sign the .app bundle after making the change. Note that modifying the .ipa file is not necessary in normal use. This article is provided purely for informational purposes.

Is it possible to create a .xcarchive archive from Visual Studio?

As of Xamarin 4, it is now possible to create a .xcarchive from Windows by setting the ArchiveOnBuild property to true.

Why does my app submission fail with: "Disallowed paths ( "iTunesMetadata.plist" ) found at ..." ?

This error is the result of a change in Apple's App Store verification process. This specific error is not related to the particular version of Xamarin you have installed, so downgrading will not help. This guide links to more information on how to fix the issue.

Diagnosing Specific Error Messages

iOS Designer Error with RegisterServicePort

Errors with RegisterServicePort and similar error messages like above are commonly an issue with spyware/malware on the computer. This guide details confirming the diagnosis and info on removing the spyware/malware.

Why does my iOS build fail with: no valid iPhone code signing keys found in keychain?

This error message occurs when the project in question is looking for valid code-signing credentials but are unable to find them. Code signing is required for testing and deployments on physical iOS devices; as well as Ad-hoc & App store builds.

Why does my iOS 9 app fail with: System.Exception: Failed to marshal the Objective-C object?

API changes in iOS 9 require that a callback constructor be used when calling unmanaged code, as the underlying API now expects it.

Runtime error: The assembly mscorlib.dll was not found or could not be loaded

This issue occurs when the hidden .monotouch-32 and .monotouch-64 folders are missing from the .xcarchive for signing / IPA creation, triggering the runtime error.



The articles below apply to issues that have been resolved in recent versions of Xamarin. However, if the issue occurs on the latest version of the software, please file a new bug with your full versioning information and full build log output.

IPA file is 0 bytes

There were some known issues in previous versions of Xamarin that could cause the IPA file on Windows to be 0 bytes.

IBTool Error: The operation couldn’t be completed.

Apple fixed this ibtool bug in Xcode 6.1.1, so upgrading to Xcode 6.1.1 or higher is the easiest fix.

Error MT1009: Could not copy the assembly

This affects users running Xamarin.iOS 7.2.6. This issue is due to file permissions needing higher privileges when Xamarin.iOS is installed with a different user account then the developer's main account.

System.Exception AMDeviceNotificationSubscribe returned ...

This message can appear in an error dialog when you first start Visual Studio for Mac, or in the mtbserver.log file. Note that this is an uncommon problem. If Visual Studio is having trouble connecting to the Mac build host, there are other errors that are more likely to appear in the mtbserver.log file.

MDocArchiveToMsxDocConverter.exe not found rver.BaseCommand.OnRequest

This error may appear in the Mac Server Log in Visual Studio.