JetBrains Rider
 
2023.1
Shortcuts: Visual Studio 2022 (Windows)
Get JetBrains Rider
You are viewing the documentation for an earlier version of JetBrains Rider.
  1. Languages and frameworks
  2. Xamarin

Languages and frameworks: Xamarin

Last modified: 24 August 2022

JetBrains Rider supports creating and working with Xamarin applications for both Android and iOS. Although currently JetBrains Rider does not provide a designer or a previewer for Xamarin forms, you can still benefit from code analysis, coding assistance, and debugging features in C#, VB.NET, and other languages, as well as from general IDE features, such as the integrated VCS client.

If other tools that Xamarin relies on (for example, Android SDK, Android Emulator) are configured properly, you will be able to build and run your Xamarin application right from the JetBrains Rider IDE.

Xamarin SDK

To develop Xamarin Applications you need to have a Xamarin SDK on your machine. There are two different Xamarin SDKs — for iOS/Mac and for Android.

Xamarin SDK consists of two parts:

  • Assemblies with .NET types for the target platform. For example, a .NET type to represent the base OSX NSObject. Using these assemblies, IDE and compiler resolve and build user code.

  • Tools that transform .NET projects into native applications, which can be deployed and executed on the emulator or a physical device. For example, using these tools .apk packages for Android are built.

JetBrains Xamarin SDK

JetBrains Rider can use different Xamarin SDKs, for example the one from Visual Studio. However, if you do not have Visual Studio on your machine, you can use JetBrains Xamarin SDK prepared and packed by the JetBrains Rider team.

JetBrains Xamarin SDK is a custom build of Xamarin GitHub sources with some improvements and additional code.

Currently JetBrains Xamarin SDK lacks some features compared to Visual Studio Xamarin SDK, but it is in the process of constant improvement.

JetBrains Xamarin SDK is available for Windows and macOS:

There are two JetBrains Xamarin SDK builds available on Windows targeting the following platforms:

Apple platform (iOS, Mac, tvOS, watchOS)

JetBrains Xamarin SDK for iOS development provides a limited feature set on Windows. For example, currently it does not support connecting to a remote Mac and perform full build/deploy.

JetBrains Xamarin SDK for Apple platforms on Windows ships as a .zip file (~ 60Mb) and installs into the JetBrains MsBuild directory:

%LOCALAPPDATA%\JetBrains\BuildTools.

Android

JetBrains Xamarin SDK for Android development provides a solid feature set. However, fast deployment is currently not supported.

JetBrains Xamarin SDK for Android platforms on Windows ships as a .zip file (~ 700Mb) and installs into the JetBrains MsBuild directory:

%LOCALAPPDATA%\JetBrains\BuildTools

Before you start

Xamarin aims to be executed on a variety of different platforms and therefore Xamarin development relies on several different tools for building and running your applications.

On Windows, you can develop Xamarin applications for any platform, but local build and run/debug is limited to Android devices and emulators.

If you use Visual Studio Xamarin SDK, you will be able to build and run your application on iOS and macOS. To do so, configure a Mac agent accessible on the network, and then connect to it (Tools | iOS | Xamarin Mac Agent).

  1. Install a Xamarin SDK for iOS on your machine in one of the following ways.

    • Install Xamarin in Visual Studio. Note that you can use Visual Studio Community, which is free. If you already have Visual Studio installed, you have to add Xamarin support to it.

    • Start installation of Xamarin iOS & Mac on the Environment page of JetBrains Rider settings Ctrl+Alt+S and follow the installation wizard. This way JetBrains Rider will automatically download and install JetBrains Xamarin SDK for iOS & Mac.

    • Alternatively you can clone the Xamarin open-source repo from GitHub, build it and install on the machine. This way is quite complicated and we do not recommend it.

  2. Install Android development tools in one of the following ways:

    • Start installation of Xamarin Android on the Environment page of JetBrains Rider settings Ctrl+Alt+S and follow the installation wizard. This way JetBrains Rider will automatically download and install JetBrains Xamarin SDK for Android.

    • Alternatively, all components that are automatically installed on the the Environment page of JetBrains Rider settings Ctrl+Alt+S, could be also installed manually:

You can check the status of Xamarin tools and install or update them on the Environment page of JetBrains Rider settings Ctrl+Alt+S:

JetBrains Rider: Environment settings

Create and open Xamarin projects

JetBrains Rider supports creating new and working with existing projects. Project templates are available, too.

You can create a new Xamarin project in a new solution using File | New… or add a new Xamarin project to the existing solution by right-clicking the solution or solution folder node in the Solution Explorer, and choosing Add | New Project.

JetBrains Rider: New Solution wizard. Xamarin

Xcode integration on macOS

When developing Xamarin applications on macOS, it is recommended to edit resource files and connect resources to code using Xcode.

You can use context menus of .storyboard, .xib, .plist files or of the Xamarin macios project node to open them in Xcode.

If the file or project has never been opened in Xcode before, JetBrains Rider will generate an Xcode project as follows:

  • xcodeproj project specifications (a project descriptor similar to csproj but for Xcode) is generated

  • Source files for all user types inherited NSObject (forms, delegates, views, controls, and so on) in Objective C are generated

  • All resources (images, designer files) are copied

When the project structure is ready, Xcode will start automatically and you can use it to edit resources. Every time Rider receives focus, it looks for changes (edits in existing files, new files, removed files) and integrates these changes into the Xamarin .NET project. It modifies .designer.cs parts of user types (inherited from NSObject) and copies back all changed resources.

All Xcode-related events are printed in the Xcode console tool window, which appears when you open resources or projects in Xcode:

Xamarin development in JetBrains Rider: Xcode console

Run and debug Xamarin applications

When you create or open a Xamarin project, JetBrains Rider automatically creates run/debug configurations for each Xamarin project in the solution.

If you want to adjust something in the way your application starts and executes, you can edit and create new run/debug configurations. When you start a Xamarin application from the IDE, you can use the corresponding selector on the navigation bar to choose which configuration should be used:

JetBrains Rider: Choosing a run/debug configuration for Xamarin application

Debug a Xamarin project, which was not created with JetBrains Rider

  1. Press Ctrl+Alt+S to open the IDE settings and select Environment.

  2. Enable Xamarin Android and Xamarin iOS & Mac support.

    If you are on Windows and have Xamarin SDK installed via Visual Studio, it will be detected automatically. Otherwise, JetBrains Rider will suggest installing JetBrains Xamarin SDK.

    note

    JetBrains Xamarin SDK cannot be installed alongside with Visual Studio Xamarin SDK.

  3. Once Xamarin SDK is installed, you can create Xamarin-specific run/debug configurations.

  4. Open the Run/Debug Configuration dialog in one of the following ways:

    • Select Run | Edit Configurations from the main menu.

    • With the Navigation bar visible (View | Appearance | Navigation Bar), choose Edit Configurations from the run/debug configuration selector.

    • Press Ctrl+Alt+Shift+R and then press 0.

  5. In the Run/Debug Configuration dialog that opens, press Ctrl+N or click Add, then choose Xamarin.Android, Xamarin.iOS, or Xamarin.Mac from the list.

  6. Specify the target project and other parameters if necessary, then click OK.

  7. Use the newly created configuration to run and debug your Xamarin project.

Webinar recording: Better Xamarin Development with Rider for Mac

You can also watch this webinar recording where Dylan Berry explores the various ways Rider can help you improve your coding speed and quality when developing Xamarin apps.

Webinar agenda:

  • 0:05 – Introduction

  • 1:22 – Tools are important

  • 11:00 – Get started with Rider on Mac

  • 13:43 – Exploring Rider

  • 1:04:46 – Plugins

See also

External Links