Give the Visual Studio 2017 Version 15.5 Preview a Try!

With Visual Studio 2017 version 15.4 now stable and sporting some awesome new features, such as Xamarin Live integration, Android Oreo / iOS 11 support, and a smarter, smaller installation, it’s time to turn our attention to the next version of Visual Studio 2017, version 15.5! This upcoming release is now available as a preview which, like all Visual Studio previews, is a separate and sandboxed installation than your stable one. This means it’s completely safe to try without risking your production development environment.

In this blog post we will take a look at some of our favorite new features landing in the Visual Studio 2017 version 15.5 previews. Be sure to give the release a try and let us know how it works for you and your team!

Xamarin Live

Xamarin Live enables developers to continuously deploy, test, and debug their apps directly on iOS and Android devices. After downloading the Xamarin Live Player app from the App Store or Google Play, you can pair your device with Visual Studio and revolutionize the way you build your next app. And with the “Live Run” functionality, you also get a real-time preview of your XAML as you type! In this release we’re adding more integration for Xamarin Live with Visual Studio and enhancements to the Live Run functionality to make building XAML UIs natural and productive.

Live XAML Previewing

We know that developers are looking for easy ways to preview XAML and cut down on long debug-deploy-test cycles. The “Live Run” functionality allows you to preview changes to your XAML in real-time on a device as you type. Once you have entered a live run mode, Visual Studio will automatically re-deploy your XAML whenever the active document changes and render the entire context of the page, including the binding context and the codebehind! There is also a new context menu option (Tools > Xamarin Live Player > Live Run Current View ) and keyboard shortcut to make live running XAML fast and easy.

Check out the improved workflow for Debug and Live Run in Visual Studio 2017 version 15.5 below:


Deeper Integration with Visual Studio

Live Player devices act and feel just like regular emulator and device debug targets. Xamarin Live already supports breakpoints when debugging, and in this release we improved how the overall functionality integrates into Visual Studio. For example, it will now warn you when you attempt to perform an unsupported operation, such as live running an iOS app on an Android device, and suggest actions to resolve the issue. We’ve added a visual indication of the deployment status operation in the status bar as well so you know exactly where the deployment operation stands.

Finally, we’ve integrated Xamarin Live with the Console and Error windows in Visual Studio. If you log any output in your app (such as Console.WriteLine), it will now show in the console output while deployment errors will be surfaced in the Visual Studio Error window.

New Mac Connection Workflow

If you have ever built an iOS app with Xamarin on Windows then you know you must connect to a Mac in order to perform builds. So in this release we have added new functionality that improves the connection workflow so you can start building iOS apps in Visual Studio even faster.

Connection Status Indicator

You should always know the exact status of a connection attempt to the Mac, however previously the only way to know the status was to check for a “lock” icon in the Xamarin Mac Agent or a green icon in the Visual Studio toolbar. This didn’t provide any granularity to the status of a connection attempt so we’ve added a new UI for viewing the connection progress that provides more detail:

New connection workflow for the Xamarin Mac Agent.

Much, much, more!

These are only a few of the new features in Visual Studio 2017 version 15.5. This release contains so much more, including updated Xamarin SDKs for iOS and Android, lots of bug fixes, the integration of the Xamarin Android SDK Manager into the install, and improvements to our extension for accessibility and localization.

To get started with the previews today, download the Visual Studio Preview installer and select the Mobile .NET (Xamarin) workload just as you did for your stable installation. Remember, Visual Studio previews are installed side-by-side your current installation and are sandboxed from your production development environment.

If you decide you no longer want to use the preview, simply use the Visual Studio Installer to uninstall any preview instance. While your stable installation should not be affected by doing this, we do recommend running a “Repair” on your other installation afterwards as a precaution.

There’s so many reasons to try Visual Studio 2017 version 15.5, so give it a try and let us know what you think via Help -> Report a Problem in Visual Studio, on Developer Community, or reach out to me directly on Twitter.

The post Give the Visual Studio 2017 Version 15.5 Preview a Try! appeared first on Xamarin Blog.

CastleSoft adds Bitcoin support

CastleSoft is proud to announce support for Bitcoin payments.

Bitcoin is a worldwide cryptocurrency and digital payment system, and is the first decentralised digital currency.
Our integration allows simple access to the Bitcoin Digital Wallet, avoiding the hassle and costs of Bitcoin exchanges.

With Bitcoin, Alipay, WeChat and all major credit cards.
CastleSoft can provide a payment solution for your business.


CastleSoft adds Alipay and WeChat Pay support

CastleSoft is proud to announce support for Alipay and WeChat Pay.

Digital wallets are the payment method of choice in mobile-first markets like China.
Alipay, counts over 500 million users, while WeChat Pay — claims more than 600 million users.

Both parties dominate the mobile wallet ecosystem in China, with 92% market share between them.

By offering global support for Alipay and WeChat pay, we can help connect businesses in 25-plus countries to the hundreds of millions of Chinese consumers that actively use these payment methods.


CastleSoft now has a NO TIE policy

Inspired by Richard Branson’s dislike for the TIE (see ‘cutting ties’ for more info).

CastleSoft has decided to implement a NO TIE POLICY for the company, and a modern less restrictive dress code.

That’s right !

We believe they limit creative thinking; they are uncomfortable; and add no value other than questionable restrictive and dated fashion rules imposed by legacy businesses and traditions.

We hope the new MODERN and less restrictive dress code will inspire other businesses to do the same.

Augment Reality with Xamarin and iOS 11

One of the showcase features of iOS 11 is ARKit, an augmented-reality mode available on devices powered by A9 and newer chips (basically, 6S and better iPhones, 2017 iPads, and iPad Pros). With ARKit, users hold up the device and view a composite of the video feed and computer-generated imagery (either 2D SpriteKit or 3D SceneKit) that appears “attached” to horizontal surfaces in the real world.

Ultra-brief overview of ARKit

The lion’s share of work in ARKit is done behind-the-scenes on the device. Basically, an ARSession object combines device motion data, the camera’s physical characteristics (focal length, pixel size, etc.), and computational geometry to detect trackable “feature points” in the input video stream, locates them relative to a fixed world coordinate system, and creates ARAnchor objects that can be used to bridge between real-world and computer-generated imagery.

There are limitations. As mentioned previously, ARKit leaves behind older iOS devices. Also, ARKit can only detect horizontal surfaces (ARPlaneDetection is an enumeration that only defines Horizontal, but I have to believe that the limitation is due to some quirky behavior that Apple will fix sooner rather than later). Finally, the computer imagery in an AR scene is rendered above the video and appears above real-world objects that would occlude it.

The five critical concepts in ARKit are:

  • Everything is defined in terms of the world coordinate system, which is initialized soon after the ARSession begins running.
  • Image-processing finds high-contrast points in the real world that are stable from frame-to-frame. These “feature points” are intermediate results that are available to the developer, but mostly inform the system’s detection of ARPlaneAnchor objects. A good number of feature points are necessary for quite a few frames before ARKit detects a plane. Not surprisingly, bright lighting and textured surfaces seem to generate many more trackable feature points than evenly-illuminated matte surfaces.
  • Planes are created, removed, and coalesced as the image-processing continues. Their extent shifts, expands and shrinks, depending on the world-tracking.
  • Computer imagery is anchored to these planes and rendered on the screen as if at that location and orientation in the real world.
  • Because AR processing occurs 60 times per second, for optimal performance you need to be careful about memory and disposing no-longer-needed resources. Xamarin’s Profiler is your friend!

The following two images show these concepts. The first image shows the axes of the world origin “floating in space”, the current feature points as a set of yellow dots, and a small red cube where ARKit placed an ARPlaneAnchor.

The second image shows a conceptual view of the world coordinate system, camera / iOS device, and anchor, as well as showing the plane defined by the ARPlaneAnchor and a piece of 3D SceneKit geometry placed relative to the world coordinate system and the plane.

The Simplest ARKit That Could Work

Developers actually have complete control over rendering in ARKit but many scenarios will use the predefined ARSCNView and ARSKView that provide augmented-reality content based on SceneKit (3D) and SpriteKit (2D) respectively.

The following ARKit program allows you to place a piece of SceneKit geometry (a cube) so that it appears “attached to” a recognized horizontal plane. Before that happens, ARKit has to be initialized and run long enough to recognize a horizontal plane.

I initialize ARKit in two methods: ViewDidLoad and ViewWillAppear. The first to run is ViewDidLoad:

public class ARKitController : UIViewController
	ARSCNView scnView;
	public ARKitController() : base(){ }
	public override bool ShouldAutorotate() => true;
	public override void ViewDidLoad()
		scnView = new ARSCNView()
			Frame = this.View.Frame,
			Delegate = new ARDelegate(),
			DebugOptions = ARSCNDebugOptions.ShowFeaturePoints | ARSCNDebugOptions.ShowWorldOrigin,
			UserInteractionEnabled = true
//... code continues ...

This is a typical iOS UIViewController subclass. It creates a new ARSCNView (the easy-to-use route towards SceneKit 3D geometry), sets its delegate-object to an instance of a class I wrote called ARDelegate (discussed later), turns on some debug visualizations, enables the view to respond to touches, and adds the ARSCNView to the view hierarchy.

The second part of initialization occurs during ViewWillAppear (it may be that this could be done during ViewDidLoad but I am always a little leery of the highly stateful view-initialization process in iOS):

public override void ViewWillAppear(bool animated)
	// Configure ARKit
	var config = new ARWorldTrackingConfiguration();
	config.PlaneDetection = ARPlaneDetection.Horizontal;
	// This method is called subsequent to ViewDidLoad so we know scnView is instantiated
	scnView.Session.Run(config, ARSessionRunOptions.RemoveExistingAnchors);

This simply configures the ARSession of the previously-created ARSCNView and begins its processing.

At this point, ARKit begins background processing. On the screen, the user will see the feed from their camera and, in a second or two, the debug visualizations will begin to show the feature cloud and world-coordinate’s origin (similar to the screenshot image shown previously).

At some point after that, ARKit will hopefully discover enough co-planar feature points to track a horizontal plane. When that happens, ARKit will automatically add an ARPlaneAnchor to its world-tracking. That addition triggers the DidAddNode method on the ARSCNView object’s delegate-object, which in our case is ARDelegate:

public class ARDelegate : ARSCNViewDelegate
	public override void DidAddNode(ISCNSceneRenderer renderer, SCNNode node, ARAnchor anchor)
		if (anchor != null && anchor is ARPlaneAnchor)
			PlaceAnchorNode(node, anchor as ARPlaneAnchor);
	void PlaceAnchorNode(SCNNode node, ARPlaneAnchor anchor)
		var plane = SCNPlane.Create(anchor.Extent.X, anchor.Extent.Z);
		plane.FirstMaterial.Diffuse.Contents = UIColor.LightGray;
		var planeNode = SCNNode.FromGeometry(plane);
		//Locate the plane at the position of the anchor
		planeNode.Position = new SCNVector3(anchor.Extent.X, 0.0f, anchor.Extent.Z);
		//Rotate it to lie flat
		planeNode.Transform = SCNMatrix4.CreateRotationX((float) (Math.PI / 2.0));
		//Mark the anchor with a small red box
		var box = new SCNBox
			Height = 0.1f,
			Width = 0.1f,
			Length = 0.1f
		box.FirstMaterial.Diffuse.ContentColor = UIColor.Red;
		var anchorNode = new SCNNode
			Position = new SCNVector3(0, 0, 0),
			Geometry = box
	public override void DidUpdateNode(ISCNSceneRenderer renderer, SCNNode node, ARAnchor anchor)
		if (anchor is ARPlaneAnchor)
			var planeAnchor = anchor as ARPlaneAnchor;
			System.Console.WriteLine($"The (updated) extent of the anchor is [{planeAnchor.Extent.X} , {planeAnchor.Extent.Y} , {planeAnchor.Extent.Z} ]");

DidAddNode is called any time a node is added to the view, but we are only interested in special processing if it’s an ARPlaneAnchor, indicating that ARKit is adding to its internal model of horizontal planes. We test for that condition and, if true, call this.PlaceAnchorCube. That method, in turn, creates some SceneKit geometry: a node that holds the plane’s geometry and is positioned in the same world coordinate as the anchor, and a small red box as a visual indicator of the ARPlaneAnchor. Note that because SceneKit uses a scene-graph architecture, the anchorNode position of [0,0,0] is relative to its parent’s position — the planeNode, whose position is based on the planeAnchor, whose position, in turn, is in world coordinates.

Once this method is called, the user will see something essentially identical to the screenshot above.


Once at least one plane is detected and tracked, the user can place additional geometry by touching on the screen. Back in the ViewController class:

// This snippet is part of:
public class ARKitController : UIViewController
	//… code shown previously …
	public override void TouchesBegan(NSSet touches, UIEvent evt)
		base.TouchesBegan(touches, evt);
		var touch = touches.AnyObject as UITouch;
		if (touch != null)
			var loc = touch.LocationInView(scnView);
			var worldPos = WorldPositionFromHitTest(loc);
			if (worldPos != null)
	private SCNVector3 PositionFromTransform(NMatrix4 xform)
		return new SCNVector3(xform.M14, xform.M24, xform.M34);
	(SCNVector3, ARAnchor) WorldPositionFromHitTest (CGPoint pt)
		//Hit test against existing anchors
		var hits = scnView.HitTest(pt, ARHitTestResultType.ExistingPlaneUsingExtent);
		if (hits != null && hits.Length > 0)
			var anchors = hits.Where(r => r.Anchor is ARPlaneAnchor);
			if (anchors.Count() > 0)
				var first = anchors.First();
				var pos = PositionFromTransform(first.WorldTransform);
				return (pos, (ARPlaneAnchor)first.Anchor);
		return null;
	private SCNMaterial[] LoadMaterials()
		Func<string, SCNMaterial> LoadMaterial = fname =>
			var mat = new SCNMaterial();
			mat.Diffuse.Contents = UIImage.FromFile(fname);
			mat.LocksAmbientWithDiffuse = true;		return mat;
		var a = LoadMaterial("msft_logo.png");
		var b = LoadMaterial("xamagon.png");
		var c = LoadMaterial("fsharp.png");
		// This demo was originally in F# 🙂
		return new[] { a, b, a, b, c, c };
	SCNNode PlaceCube(SCNVector3 pos)
		var box = new SCNBox
			Width = 0.10f,
			Height = 0.10f,
			Length = 0.10f
		var cubeNode = new SCNNode
			Position = pos,
			Geometry = box
		cubeNode.Geometry.Materials = LoadMaterials();
		return cubeNode;

Skip to the TouchesBegan method and you can see that what we do is pretty straightforward at a high level: we grab the position of the touch and then perform a hit test for horizontal planes. If that hit-test is successful, we return the position on the first such plane as a tuple of type (SCNVector3, ARPlaneAnchor). The hit-testing is done using the built-in ARSceneView.HitTest(SCNVector3, ARHitTestResultType) method, which projects a ray outward into the augmented-reality “world” and returns an array containing anchors on any of the planes that it intersects, ordered nearest-to-furthest. If that array is not empty, we grab the first and return its position as an SCNVector3 (which we extract from the appropriate components of the anchor’s NMatrix4 matrix). (Historical note: During the iOS 11 beta period, the type used for these matrices switched between row-major and column-major in the Xamarin bindings. If you review code written during the beta period, rotations and translations may appear transposed.)

The PlaceCube method just creates a box 10cm on a side and places it in the augmented-reality “world” at pos, whose value is the SCNVector3 returned by WorldPositionFromHitTest as mentioned above.

The result is something like:

Learn More

The #MadeWithARKit hashtag on Twitter has been a great source of inspiration this Summer, with people demo’ing such great concepts as virtual portals, sound nodes located in space, and the combination of ARKit with video filters.

After the iPhone X launch announcement, Apple revealed some new APIs relating to face detection and mapping, including an ARFaceAnchor and ARFaceGeometry.

All the code for this sample is available at Pull-requests and questions welcome! Make sure to also check out the Introduction to iOS 11 guidein the Xamarin Developer Center.

iOS 11 support – Xamarin

By Miguel de Icaza  September 13, 2017 ,

We’ve just updated our iOS 11 support to go along with the Xcode 9 GM Seed release. You can use this build along with the Xcode 9 GM to submit applications that take advantage of the new features in iOS 11, tvOS 11 and watchOS 4 to the Apple AppStore. We also have awesome new sample documentation for iOS 11 features!

Getting Started with iOS 11

Visit our Getting Started with iOS 11 guide to stay up-to-date on installation details, samples and the latest information on what’s new. Here is what you’ll need:

iPhone and iPad showing iOS 11

Augment your apps with iOS 11

iOS 11 brings some exciting new features to the platform. We’ve created a new section in our documentation for iOS 11 to make it as easy as possible to integrate those features into your apps. To get started, visit the Xamarin Developer Center and check out our iOS 11 Samples and Introduction to iOS 11. Here are some of the exciting new samples that are available:

  • ARKit – Create next-generation apps using the camera on the device to augment the world around you.
  • CoreML – Analyze problems directly on the device with new Machine Learning APIs available with CoreML.
  • Drag and Drop – Discover new ways to move images and more across your app or into another app.
  • MapKit – Improvements include a new compass view and easier ways to render custom overlays.
  • SiriKit – SiriKit now has additional intents for Payments, new support for lists, notes and more.
  • Vision – New image processing techniques directly in your apps including face and feature detection for images and videos.

Be sure to follow along with the Xamarin Release Blog for up-to-date information about known issues and other release notes.

Discuss this post in the Xamarin Forums