VISUAL STUDIO   Windows Mac

Xamarin Live Player Setup

Edit and test apps in real time on your iOS or Android device.

PDF for offline use
Sample Code:
Related Links:

Let us know how you feel about this

Translation Quality


0/250

last updated: 2017-05

Xamarin Live lets you make live edits to your app and have those changes reflected live on the device. Your code runs inside the Xamarin Live Player app - no need to set up emulators or use cables to deploy!

Preview feature

1. Get the App

Xamarin Live Player is available from the iOS App Store and Google Play.

Download from iOS App Store Available on Google Play

2. Get the Visual Studio 2017 Preview on Windows (or for Mac)

Xamarin Live requires:

  • Visual Studio 2017 15.3 Preview with the Xamarin Updater installed to get the latest updates that include Xamarin Live Player support.
  • Visual Studio computer and device on the same WiFi network

3. Using Xamarin Live for the first time

  1. Open Visual Studio 2017 Preview 15.3.
  2. Create or open a Xamarin project (or a sample).
  3. Choose Live Player in the device list:

    Device list includes a Xamarin Live Player option

    • If you have already paired a device, it will be available as an option.
    • Otherwise you'll be prompted to pair a device when required.
  4. Press the Run button, or select one of the following options from the Run or right-click menu:

    • Start Without Debugging – you can edit the app and see the changes occur on the device (app is restarted as changes are made and the file saved).
    • Start Debugging – you can set breakpoints and inspect variables, but code cannot be edited.

    Alternatively, select Tools > Xamarin Live Player > Live Run Current View, which lets you edit the app and see the changes occur on the device. The current view is shown (instead of the application's main screen).

  5. If a device is already paired and the Xamarin Live Player app is running on the device, the code will execute straight away!

    If no device is is paired, a barcode will appear with instructions on how to pair a device:

    Pair a device window

    If the device cannot be contacted for pairing, an error may appear.

2. Get the Visual Studio for Mac Preview (or for Windows)

Xamarin Live requires:

  • OS X 10.11, macOS 10.12, or greater
  • Visual Studio for Mac (Alpha channel preview)
  • Mac and device on the same WiFi network

3. Using Xamarin Live for the first time

  1. Open Visual Studio for Mac.
  2. Create or open a Xamarin project (or a sample).
  3. Choose Xamarin Live Player > Pair Device... in the device list.

    Device list includes a Xamarin Live Player option

    • If you have already paired a device, it will be available as an option.
    • Otherwise you'll be prompted to pair a device when required.
  4. Press the Run button, or select one of the following options from the Run or right-click menu:

    Run menu options

    • Start Without Debugging – you can edit the app and see the changes occur on the device (app is restarted as changes are made and the file saved).
    • Start Debugging – you can set breakpoints and inspect variables, but code cannot be edited.
    • Live Run Current View – you can edit the app and see the changes occur on the device. The current view is shown (instead of the application's main screen).
  5. If a device is already paired and the Xamarin Live Player app is running on the device, the code will execute straight away!

    If no device is is paired, a barcode will appear with instructions on how to pair a device.

    Pair a device window

    If the device cannot be contacted for pairing, an error will appear:

    Cannot connect to device error message

See limitations and troubleshooting if you experience any issues.

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.