How to develop Xamarin.Android applications on Linux with Rider

Please note that Xamarin.Android on Linux is officially unsupported. However, it is possible to manually install Xamarin.Android and configure Rider so that it can build and run Xamarin.Android apps on Linux. This guide has been tested on Ubuntu 16.04.

Install the latest stable Mono


sudo apt-key adv –keyserver hkp:// –recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb xenial main" | sudo tee /etc/apt/sources.list.d/mono-official.list
sudo apt-get update
sudo apt-get install mono-devel

Install JDK

sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer (or sudo apt-get install oracle-java9-installer)
sudo apt-get install default-jdk

Install Android Studio

Download Android Studio
Install Android Studio
Download appropriate Android SDK and NDK

Install Xamarin.Android

Download any stable build:

Choose any oss-xamarin.android_vVERSION_Linux-x86_64_HEAD*.tar.bz2 artifact from

Extract it:

tar xjf ./oss-xamarin.android_v{VERSION}_Linux-x86_64_HEAD{*}.tar.bz2

Goto the unpacked dir:

cd ./oss-xamarin.android_v{VERSION}_Linux-x86_64_HEAD{*}

Make dirs:

sudo mkdir "/usr/lib/"
sudo mkdir "/usr/lib/mono/xbuild/Xamarin/"

Copy dir form extracted files:

sudo cp -a "bin/Debug/lib/" "/usr/lib/"

Delete dirs for next steps:

rm -rf "/usr/lib/mono/xbuild/Xamarin/Android"
rm -rf "/usr/lib/mono/xbuild-frameworks/MonoAndroid"

Make Symlinks:

sudo ln -s "/usr/lib/" "/usr/lib/mono/xbuild/Xamarin/Android"
sudo ln -s "/usr/lib/" "/usr/lib/mono/xbuild-frameworks/MonoAndroid"

Add the next lines to your csproj file:

<PropertyGroup Condition=" '$(OS)' == 'Unix' ">

Make sure that ANDROID_SDK_PATH and ANDROID_NDK_PATH environment variables are set.

Configure SDK and NDK paths in Rider settings

Go to "File | Settings | Build, Execution, Deployment | Xamarin" and set "Android SDK location" and "Android NDK location".

You should now be able to build and run Xamarin.Android applications on Linux with Rider.


Comment actions Permalink

I followed this, created a new Xamarin.Android project but am getting this error at build time. I have the Android_SDK_Path set correctly. An y guidance? 


Also the SDK is set here. I appreciate the help :) 

Edited by Michael
Comment actions Permalink


SDK and NDK location settings on Linux are not always saved correctly, which is a bug. Please try to save them again via Enter, restart Rider, and check the settings again to make sure they have been applied.

Comment actions Permalink

Just can't get this working in Ubuntu 18.04 - It builds fine, but deployment is problematic. I can't launch the x86_64 system image (api 28) with emulator64_x86 - it complains it can't find the kernel, the specific error is:

[Please ensure the file "kernel-qemu" is in the same location as your system image]

I can launch the x86_64 image with emulator, but then the adb deployment command fails saying:

['INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries, res=-113]

I'm guessing that is because the Xamarin build files downloaded from Jenkins are x86_64 not x86?

If I'm not mistaken, the problem is the inability to launch the x86_64 system image using emulator64_x86?

Comment actions Permalink


Add the following line in your *.csproj File for your Android Project inside the PropertyGroup

<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">




It seems that the default "AndroidSupportedAbis" are different than under Visual Studio for MacOS. There I could change the supported ABIs and the new <AndroidSupportedAbis> was created.

I hope that fixes your problem.

I didn't needed the <PropertyGroup Condition=" '$(OS)' == 'Unix' " /> Section.

It's broken anyway because the MonoAndroidToolsDirectory and MonoAndroidBinDirectory directories don't exist.


I face the problem that I cannot launch the Android Project from the context Menu of the Project in the Solution View:

Cannot run project of type XamarinAndroid with a .NET Project run configuration. You can run this project using one of the following configuration types: Xamarin.Android.

Running it from the Toolbar with the correct Run/Debug configuration works though.

Edited by Andreas Go
Comment actions Permalink

Thanks to the excellent support at JetBrains and Andreas Go's help, I'm now up and running.

For anyone interested, I've made a blog post based on the above instructions:

Thanks JetBrains!

Edited by David
Comment actions Permalink

link to Jenkins mono do not work! What I must do? Is your rider usable or VS better

Comment actions Permalink

Thanks for the heads up Gvitaha, just checked it out it seems the CI service is temporarily down, should be up soon - see here (Monday they say):

Comment actions Permalink

I followed all of the Instructions above, but I can't get it to work.


Okay I don't know why it works now...
I just tried to build a sample HelloWorld Project to find out if the culprit is Rider or xamarin-android for linux...

As I followed that guide here ( ) I successfully built the HelloWorld app.

After that I started my Project again, and after a rebuild everything appeared to work as it should.... Strange thing...

Edited by Simon
Comment actions Permalink

Hello everyone I am very disappointed because Xamarin.Android fails for me. How do you get successful? I am very sad because I want build Android apps . :( Because I feel they lie me and don't care my solution. STOP PLEASE DO NOT LIE / SCAM US ! PLEASE MAKE SURE - I HAVE DOWNLOADED Xamarn-Android from Github and compiled successfully. But why Rider mess up if it said Android 9.0 That is WRONG I WANT USE ANDROID 8.1 Oreo

It said always failures. I am very disappointed I have 5 or 6 times = NOOOOOOOOOOOOOOOOOOOOOO SUCCCEESSS!!!

PLEASE SHOW ME VIDEO OF YOUTUBE WITH Xamarin Android from Github and compilation than copy to /usr/lib/mono than Open rider and create Xamarin Android. Please!!!

I have always unsuccessful / failure GRRRR I am very mad because I feel Rider makes shit PLEASE PROMISE US! I WANT BUY SOON IF YOUR RIDER MAKES SHIT THAN I DON'T BUY and I go back MonoDevelop. Please make sure!!!! Sorry I am not harassing just I am very sad and disappointed because I can't get successful compilation :( I really miss to develop with Xamarin Android =(



// EDIT Now I have big problem :(

How do I fix?

I am tried to fix.... I am very disappointed :(

Edited by Jens Eckervogt
Comment actions Permalink

I was having the same issue as @Jens Eckervogt, after some researching about the subject i found out they changed from the msbuild built-in System.Reflection.Metadata to the one that comes with corefx project because it’s much faster.

so i searched nuget for System.Reflection.Metadata ( downloaded the package and opened it in archive manager copying the dll that’s in netstandard 2.0 folder to msbuild directory (Replace the existing file) and also did the same with ( and every thing works fine now :)

Edited by Alarb Alarb
Comment actions Permalink

Hey there :)
Is anyone able to use a Smartphone for USB Debugging ??

I can't get it to work... 

Comment actions Permalink

Followed this guide before but with the latest Rider release it says that it could not

find the Xamarin SDK and that no Xamarin based projects will be loaded.


Is there a workaround?

Comment actions Permalink

Hi Joelsc,

I have instructions for Ubuntu 19.04 here:

And Ubuntu 18.04 based distros here:

Hope that helps.

Comment actions Permalink

It would be more helpful to know what is looking at what. This sort of "follow these steps to a tee" thing is terrible - it falls apart at the first sign of trouble. I don't know what this is supposed to look like, so if I don't want/can't have my setup *exactly* like yours for whatever reason then this is just as helpful as e.g. which is to say, not very.


Why is it that you pay people and eventually they decide things are "not supported" whereas people who aren't paid tend to be like "well you know I don't know but here I'll try and help with that". Where's the service? WTH am I paying for?

Comment actions Permalink

Step 3: is wrong, it should read:

sudo mkdir -p "/usr/lib/"
sudo mkdir -p "/usr/lib/mono/xbuild/Xamarin/"
sudo mkdir -p "/usr/lib/mono/xbuild

Or you know it should just read "Make sure these three directories exist". Don't *ever* recommend a command for a directory unless you're 100% sure it exists... unless it exists as a zipfile file with a known structure you *cannot* rely on "hey run this installer thing from this website" - that's just bad directions.

Comment actions Permalink

This guide is quite a mess...

I have spent 2 days (!!!) and finally I succeded in using xamarin in Rider on Ubuntu 16.04 doing following steps:

After you downloaded xamarin android archive and extracted it

Go in the extracted folder

cd /path/to/

and then do

sudo cp -r bin/Debug/lib/ /usr/lib/mono/xbuild/

sudo cp -r bin/Debug/lib/ /usr/lib/mono/xbuild/

sudo cp -r bin/Debug/lib/ /usr/lib/mono/xbuild-frameworks/

sudo mkdir -p /usr/lib/mono/xamarin-android/bin/

sudo cp -r bin/Debug/bin/* /usr/lib/mono/xamarin-android/bin/

Please notice:

- as said here, if you use mono 5.*, you must use a compatible dotnet core version, 2.2.108, download it here and uninstall other versions of dotnet core!

- as mentioned in a comment above, you need to replace an assembly. Download this nuget package, unzip it, and then copy the file System.Reflection.Metadata.dll from the lib/netstandard2.0 folder over the file found in /usr/lib/mono/msbuild/15.0/bin/

Now Rider should see your xamarin android version.

If you have already messed up, I suggest to unistall dotnet core and mono and restart

Good luck!

Comment actions Permalink


I tried following this guide but the is not reachable so I can't get the xamarin.Android binary which is an important part of this guide If I'm not wrong.

is there anywhere else I can this binary, even an older version would be nice.

I'm running ubuntu 16.04 btw

update: nvm, it's working now :D

Edited by Anas

Please sign in to leave a comment.

Have more questions?

Submit a request