Frequently Asked Questions
Installation & Setup
Installing the Android SDK doesn't automatically include all the minimum required packages for developing. While individual developer needs vary, this guide discusses the packages that will generally be required for developing with Xamarin.Android.
This guide describes both the default settings of the Android SDK, which should work for most setups; and how to change these defaults in Visual Studio for Mac or Visual Studio if needed.
This article illustrates how to update the Java Development Kit (JDK) version on Windows and Mac.
Xamarin.Android requires JDK 8 or the Microsoft Mobile OpenJDK. This article lists some common error messages that you may see if JDK 9 or later is installed, along with instructions for checking the JDK version.
How can I manually install the Android Support libraries required by the Xamarin.Android.Support packages?
This guide provides example steps for installing the
Xamarin.Android.Support.v4 support library on Windows & Mac.
To debug on an Android device when developing in Windows; you need to install a compatible USB driver. The Android SDK Manager includes the "Google USB Driver" by default, which adds support for Nexus devices. Other devices require USB drivers published by the device manufacturer. This guide provides information on finding these drivers as well as alternative testing methods.
This guide covers methods when using the Android emulator.
This guide covers steps for setting up an Android NUnit test project, not a Xamarin.UITest project. Xamarin.UITest guides can be found here.
This guide describes how to activate Visual Studio's Intellisense for Android .axml files.
The most common cause of this issue is that the INTERNET permission is automatically included in a debug build, but must be set manually for a release build. This guide describes how to enable the permission on release builds.
Support-v13 can not be used together in the same
app, that is, they are mutually exclusive. This is because
Support-v13 actually contains all of the types and implementation of
Support-v4. If you try and reference both in the same project, you
will encounter duplicate type errors.
This article explains how to resolve a PathTooLongException error that may occur while building a Xamarin.Android project.
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.
This guide was originally written for the Android L preview.Xamarin.Android 4.17 added Android L Preview Support & Xamarin.Android 4.20 added Android Lollipop Support.
Android.Support.v7.AppCompat - No resource found that matches the given name: attr 'android:actionModeShareDrawable'
This error may occur in older versions of Xamarin if some of the required Android SDK packages are missing.
The default memory parameters that are used when starting the
process for the Android designer might be incompatible with some system
configurations. Starting with Xamarin Studio 126.96.36.199 and Xamarin for
Visual Studio 3.9.344 these settings can be customized on a per-project
A bug in Xamarin.Studio 5.1 previously corrupted .csproj files by partially or completely deleting the xml code in the .csproj file. This would cause important parts of the Android build system (such as updating the Android Resource.designer.cs) to fail. As of the 5.1.4 stable release on July 15th, this bug has been fixed; but in many cases the project file has to be repaired manually, as described in this guide.