Inspector Preview 0.3.1

This is the initial preview release of the Xamarin Inspector. It consists of a Xamarin Studio add-in, a Visual Studio extension, and rich clients for Mac and Windows. Xamarin iOS, Android, and Mac apps can be inspected, as well as WPF.

This is an early preview. Give it a try and let us know what you think, or if you run into any bugs!

What does it do?

  1. The Xamarin Studio add-in and the Visual Studio extension inject Inspector Support assemblies into your app when it launches.
  2. A lightweight loop is run in the background of your app, waiting for you to press the Inspect button in the IDE.
  3. Once the Inspect button is pressed, an Inspector agent starts running inside of your app. This agent exposes your visual tree, provides support for evaluating C# code, etc.
  4. The Inspector client app launches and connects to the agent inside your app.

Please note that for iOS apps, we also have to swap in platform assemblies that support System.Reflection.Emit (for use by Mono.CSharp, which powers the C# REPL). This happens even if you don't press the Inspect button.

If you start noticing any odd app behavior, you should disable or uninstall the Inspector add-in (or extension), restart your IDE, do a clean rebuild, and try again. If this fixes it, we'd greatly appreciate a bug report.

Features

  • Browse the visual tree
  • Inspect and modify properties on visual elements
  • Evaluate C# code in your app using the REPL (Read-Eval-Print Loop)
  • 3D exploded view of the screen (Mac client only)

Please check out our documentation to get started.

Known Limitations

  • View selection is only supported on your main display.
  • 3D view is not available on Windows
  • Property grid editing is not available for Mac, and on Windows is limited to a few data types. Use the REPL for more powerful editing.
  • As long as the Inspector addin/extension is installed and enabled in your IDE, we are injecting code into your app every time it starts in Debug mode. If you notice any strange behavior in your app, please try disabling or uninstalling the Inspector addin/extension, restarting the IDE, and rechecking. And please file bugs to let us know!
  • If inspecting a UI element causes it to change in anyway, please let us know, as this may indicate a bug.

Reporting Bugs

Please report bugs to bugzilla, and include log files.

Component Mac Log File Windows Log File
Inspector Client ~/Library/Logs/Xamarin/Inspector/Xamarin Inspector {date}.log %LOCALAPPDATA%\Xamarin\Inspector\logs\Xamarin Inspector {date}.log
Xamarin Studio ~/Library/Logs/XamarinStudio-5.0/Ide.log %LOCALAPPDATA%\XamarinStudio-5.0\Ide.log
Visual Studio Copy the contents of the Output pane (proper logging will be added in a future release)

Requirements

Supported Operating Systems

  • Mac - OS X 10.10 or greater
  • Windows - Windows 7 or greater

Supported IDEs

  • Xamarin Studio 5.10
  • Visual Studio 2013/2015 with Xamarin 4 or later

Supported App Platforms

App Platform IDE Support Notes
Mac (Unified) Only supported in XS on Mac
iOS (Unified) Only supported in XS on Mac
Android Supported in XS and VS
  • Must target Android >= 4.0.3
  • Must have fastdev enabled
  • Must use XAP or VS Android Emulator
WPF Only supported in VS on Windows

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.