General Frequently Asked Questions

PDF for offline use

Let us know how you feel about this


0/250

Visual Studio 2017 Release Candidate

Can I use Visual Studio 2017 Release Candidate with Xamarin?

For a description of the current implications of using Xamarin with Visual Studio 2017 Release Candidate (RC) as well as for information on how to install Xamarin in Visual Studio2017 RC.

Portable Class Libraries

How can I view what libraries are supported in a PCL?

This guide lists resources and methods for determining if your existing library is supported by the various PCL target platforms, or can be converted to a PCL profile.

PCL Reflection API

Microsoft developed a new Reflection API for use in Portable Class Libraries. If you have some existing Reflection code that you want to move to a PCL, it might not work.

PCL case study: How can I resolve problems related to System.Diagnostics.Tracing for the Microsoft TPL Dataflow NuGet package?

Xamarin.iOS and Xamarin.Android do not implement 100% of every PCL profile that they allow as references. For practical convenience in Xamarin Studio, Visual Studio, and the NuGet package manager, Xamarin projects allow the use of several profiles that only have incomplete implementations. For example, neither Xamarin.iOS nor Xamarin.Android currently includes a complete implementation of the types in the System.Diagnostics.Tracing PCL namespace. You can work around this by switching the app project to reference the portable-net45+win8+wp8+wpa81 version of the TPL Dataflow library.

NuGet packages & Xamarin Components

How can I update NuGet?

NuGet updates, extensions, and add-ins can be found under the Updates tab in the NuGet Package Manager. Detailed navigation to find the updates in Xamarin Studio & Visual Studio is in this guide.

How do I downgrade a NuGet package?

Xamarin Studio & Visual Studio both have features for selecting older versions of packages and installing them automatically; similar to how updating packages works.

Missing packages error after updating Nuget packages

This issue has mainly been reported on Xamarin.Forms sample app solutions, but the potential for this issue can happen on any project that uses NuGet packages.

Unifying Google Play Services Components and NuGet

There used to be several Google Play Services Components and NuGet packages, but To make things easier for developers, we've now unified our Components and NuGet packages into two. In almost every case, Google Play Services should be used. The only reason to use the (Froyo) package is if you are actively targeting Froyo.

Where are the components stored on my machine?

Whenever you install a Xamarin component into an App project, it gets placed in the two locations listed in this guide.

Troubleshooting

Where can I find my version information and logs?

This guide details where to find most diagnostic information that can be used to troubleshoot Xamarin issues.

When and how should I file a bug report?

This guide provides tips for filing high-quality bug reports, so that our engineers are able to determine the cause (and any potential fixes) for an issue more efficiently.

Why isn't Jenkins supported by Xamarin?

Jenkins is an open-source CI suite; because of this many issues that are directly caused by the Jenkins itself will need to be filed as issues against where you got the code; such as the main Jenkins repo, or the repo for Jenkins.app.

What project settings are required for the debugger?

In order for the debugger to work as expected (hit breakpoints, display debug logs, etc.), developer instrumentation and debug information display must both be enabled. This guide details how to find and activate these settings.

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.