Forwards: 2012

Sunday, December 30, 2012

A short guide to the layers of MvvmCross Assemblies

MvvmCross (Mvx) is very modular in design.

It's deliberately made up of lots of small assemblies rather than a few big ones.

The advantages of this are that it keeps the runtime image size smaller, and that it makes the platform more easily extensible.

The disadvantages, however, are that it can make mvvmcross look a little complicated initially, and that adding 'using' namespace statements in code can feel a bit more awkward, especially in environments where tools like resharper are not available.

This article provides some detail on the assemblies used in an MvvmCross application.

If this is too in-depth, then maybe try the Quick Start - http://slodge.blogspot.com/2012/12/an-quick-start-on-creating-mvvmcross.html

The layers of MvvmCross

The layers of mvvmcross are:

Cirrious.MvvmCross - the core mvvm and IOC library.
Cirrious.MvvmCross.Binding - provides binding functionality for platforms which don't have built-in data-binding. Currently this means for all non-xaml platforms.
Cirrious.MvvmCross.Dialog - provides a link between MvvmCross and CrossUI. CrossUI itself is a branch of MonoTouch.Dialog and MonoDroid.Dialog projects - hopefully these will be joined soon by WP.Dialog and WinRT.Dialog.
Cirrious.MvvmCross.AutoView - provides an initial implementation of our cross platform user interface definitions. Currently this is an 'alpha' level of functionality only...
Plugins - each plugin provides functionality for a specific task. e.g. for geolocation, for json parsing, for accelerometer, etc. These plugins are really just a formalisation of how to do cross-platform IoC. Importantly, you can easily build and distribute your own plugins.

Just Mvvm

If you want to build a simple mvvm app, then you can build this just at the first Cirrious.MvvmCross level.

An app built in this way would:

include view models and IOC;
would be able to use data binding in wp and winrt;
in touch and droid, there would be no declarative data-binding, but you would instead be able to use C# code which manipulated the ViewModel and which listened to ViewModel.PropertyChanged events.

To add this level of functionality:

your core app project needs to reference the portable Cirrious.MvvmCross.dll assembly. This portable class library contains the core trace, IOC and mvvm functionality.
your UI projects need each to reference both the portable Cirrious.MvvmCross.dll assembly and the specific implementation for that platform - e.g. the MonoTouch UI needs to reference Cirrious.MvvmCross.Touch.dll

Adding DataBinding

If you want to use data binding in Droid and Touch, then you need to add the Cirrious.MvvmCross.Binding assemblies to your UI projects.

For Droid, this means you must add both Cirrious.MvvmCross.Binding and Cirrious.MvvmCross.Binding.Android
For Touch, this means you must add both Cirrious.MvvmCross.Binding and Cirrious.MvvmCross.Binding.Touch

These assemblies:

enable you to use MvxBind statements in android axml;
enable you to use UIViewController-based data binding in Touch;
include helpers for controls such as android listviews and ios table views.

If you wish to use the image controls within the MvvmCross binding projects, then you will also need to include some plugins within your UI projects - as the image controls rely on Cirrious.MvvmCross.Plugins.File and Cirrious.MvvmCross.Plugins.DownloadCache for downloading and caching image files from http sources.

Adding 'Dialog' UIs

If you want to take advantage of the code-constructed UIs similar (very similar!) to those offered by MonoTouch.Dialog and MonoDroid.Dialog, then you can get this by including both the CrossUI and the Cirrious.MvvmCross.Dialog assemblies.

Further, for the Droid projects, you will need to add the dialog definition files - see an example in https://github.com/slodge/MvvmCross/tree/vnext/Sample%20-%20CustomerManagement/CustomerManagement/CustomerManagement.Droid/Resources/Layout

Adding 'AutoView' UIs

Finally, you can add AutoViews to your app.

This is currently only available for Touch and Droid. And this is only available in Alpha - more testing and more dev is needed.

If you want to define some default dialog or list-based User Interfaces in your ViewModels, and to then let MvvmCross generate the client User Interface - then you can do this using Cirrious.MvvmCross.Autoview assemblies.

Plugins

Plugins are a formalised method for providing cross-platform IoC.

Basically, each plugin comes with a core PCL project/assembly and then individual implementation projects/assemblies for each platform.

They are quite a large topic in their own right.

One introduction to plugins is provided in my answer to: http://stackoverflow.com/questions/12564272/making-mono-cross-platform-support-for-task-intent

Another is provided in this slide deck:

Mvvm cross – going portable from Stuart Lodge

A quick start on creating an mvvmcross application

MvvmCross (Mvx) is very modular in design.

It's deliberately made up of lots of small assemblies rather than a few big ones.

The advantages of this are that it keeps the runtime image size smaller, and that it makes the platform more easily extensible.

The disadvantages, however, are that it can make mvvmcross look a little complicated initially, and that adding 'using' namespace statements in code can feel a bit more awkward, especially in environments where tools like resharper are not available.

One other thing to note: PCL support in the MonoDevelop tools is particularly 'alpha' still right now - so you may find you need to implement 'workarounds' like only using PCLs built in MonoTouch for use on MonoTouch. This situation is slowly improving... but in the meantime, sorry!

This article provides a QuickStart on creating an MvvmCross application.

If this is too shallow, then maybe try the more in-depth guide - http://slodge.blogspot.com/2012/12/a-guide-to-mvvmcross-assemblies.html

A QuickStart...

Before you start - get your development environment ready for Portable Class Libraries - see http://slodge.blogspot.co.uk/2012/12/cross-platform-winrt-monodroid.html

Core

Create a typical mvvmcross 'core' application:

Create a PCL project - named MyApp.Core - make sure it is in the magic 'Profile104'
Add a reference to the assembly - Cirrious.MvvmCross.dll
Add a 'main' App.cs which will own the Services, ViewModels and other classes in the application.
Add a Trace.cs file - so that your application trace is easily identifiable.
Add a StartupApplicationObject.cs class - which identifies which ViewModel will be shown on app startup.
Add a ViewModels folder.
In this folder, place BaseViewModel.cs, derived from MvxViewModel
In this folder, place HomeViewModel.cs, derived from BaseViewModel

This will give you a set of files something like:

	using Cirrious.MvvmCross.Application;
	using Cirrious.MvvmCross.ExtensionMethods;
	using Cirrious.MvvmCross.Interfaces.ServiceProvider;
	using Cirrious.MvvmCross.Interfaces.ViewModels;

	namespace Casino.Core
	{
	public class App
	: MvxApplication
	, IMvxServiceProducer
	{
	public App()
	{
	// set the start object
	var startApplicationObject = new StartApplicationObject();
	this.RegisterServiceInstance<IMvxStartNavigation>(startApplicationObject);
	}
	}
	}

view raw App.cs hosted with ❤ by GitHub

	using Cirrious.MvvmCross.ViewModels;

	namespace Casino.Core.ViewModels
	{
	public abstract class BaseViewModel : MvxViewModel
	{
	}
	}

view raw BaseViewModel.cs hosted with ❤ by GitHub

	using Cirrious.MvvmCross.Platform.Diagnostics;

	namespace Casino.Core
	{
	public static class CasinoTrace
	{
	public const string Tag = "CasinoApp";

	public static void Trace(string message, params object[] args)
	{
	MvxTrace.TaggedTrace(Tag, message, args);
	}
	}
	}

view raw CasinoTrace.cs hosted with ❤ by GitHub

	namespace Casino.Core.ViewModels
	{
	public class HomeViewModel : BaseViewModel
	{
	}
	}

view raw HomeViewModel.cs hosted with ❤ by GitHub

	using Casino.Core.ViewModels;
	using Cirrious.MvvmCross.Interfaces.ViewModels;
	using Cirrious.MvvmCross.ViewModels;

	namespace Casino.Core
	{
	public class StartApplicationObject
	: MvxApplicationObject
	, IMvxStartNavigation
	{
	public void Start()
	{
	RequestNavigate<HomeViewModel>();
	}

	public bool ApplicationCanOpenBookmarks
	{
	get { return false; }
	}
	}
	}

view raw StartApplicationObject.cs hosted with ❤ by GitHub

A WindowsPhone UI

To add a windows phone UI:

Create a WindowsPhone App project - named MyApp.UI.WinPhone
Target 7.1 or 8.0 (or later?!) according to your preferences
Add a reference to the portable Cirrious.MvvmCross.dll, Cirrious.Plugins.Json.dll and Newtonsoft.Json.dll
Add a reference to Cirrious.MvvmCross.WindowsPhone.dll
Add a reference to the Core project in your solution
Change the App.xaml.cs file so that App inherits from
```
IMvxServiceConsumer
```
Change the end of the App.xaml.cs constructor so that it creates a Setup object:

            var setup = new Setup(RootFrame);
            setup.Initialize();

Change the App.xaml.cs file so that ApplicationLaunching looks like:

        private void Application_Launching(object sender, LaunchingEventArgs e)
        {
            RootFrame.Navigating += RootFrameOnNavigating;
        }
 
        private void RootFrameOnNavigating(object sender, NavigatingCancelEventArgs navigatingCancelEventArgs)
        {
            RootFrame.Navigating -= RootFrameOnNavigating;
            navigatingCancelEventArgs.Cancel = true;
            RootFrame.Dispatcher.BeginInvoke(() =>
                                                 {
                                                     var start = this.GetService<IMvxStartNavigation>();
                                                     start.Start();
                                                 });
        }

note that for this code to compile, then you will need to add using statements for:

using Cirrious.MvvmCross.ExtensionMethods;
using Cirrious.MvvmCross.Interfaces.ServiceProvider;
using Cirrious.MvvmCross.Interfaces.ViewModels;

add a Setup.cs file:

	using Cirrious.MvvmCross.Application;
	using Cirrious.MvvmCross.Platform;
	using Cirrious.MvvmCross.WindowsPhone.Platform;
	using Microsoft.Phone.Controls;

	namespace Casino.UI.WinPhone
	{
	public class Setup
	: MvxBaseWindowsPhoneSetup
	{
	public Setup(PhoneApplicationFrame rootFrame)
	: base(rootFrame)
	{
	}

	protected override void InitializeDefaultTextSerializer()
	{
	Cirrious.MvvmCross.Plugins.Json.PluginLoader.Instance.EnsureLoaded(true);
	}

	protected override MvxApplication CreateApp()
	{
	return new Casino.Core.App();
	}

	protected override void AddPluginsLoaders(MvxLoaderPluginRegistry registry)
	{
	base.AddPluginsLoaders(registry);
	}
	}
	}

view raw Setup.cs hosted with ❤ by GitHub

add a Views folder
create a new page in the Views folder - call it HomeView.xaml
change the HomeView.xaml.cs file so that it inherits from a BaseHomeView class which in turn inherits from MvxPhonePage

	using Casino.Core.ViewModels;
	using Cirrious.MvvmCross.WindowsPhone.Views;

	namespace Casino.UI.WinPhone.Views
	{
	public partial class HomeView : BaseHomeView
	{
	public HomeView()
	{
	InitializeComponent();
	}
	}

	public class BaseHomeView : MvxPhonePage<HomeViewModel>
	{
	}
	}

view raw HomeView.xaml.cs hosted with ❤ by GitHub

change HomeView.xaml similarly - so that the page inherits from BaseHomeView

A Droid UI

Note: If you haven't already done so, set up your MonoDroid PCL environment - see http://slodge.blogspot.co.uk/2012/12/cross-platform-winrt-monodroid.html

To add a MonoDroid UI:

Create a new MonoDroid App project - name it MyApp.UI.Droid
Add a reference to the portable Cirrious.MvvmCross.dll, Cirrious.MvvmCross.Binding.dll and NewtonSoft.Json.dll
Add a reference to the android specific libraries of Cirrious.MvvmCross.Droid.dll, Cirrious.MvvmCross.Binding.Android.dll, System.Net.dll and System.Windows.dll
Add a reference to the Core project in your solution
Delete the Activity1.cs file
Add a copy of the MvxBindingAttributes file in Resources/Values folder - from https://github.com/slodge/MvvmCross/blob/vnext/Cirrious/Cirrious.MvvmCross.Binding.Droid/ResourcesToCopy/MvxBindingAttributes.xml - make sure this is marked as an AndroidResource
Add a Setup.cs file a bit like:

	using System.Collections.Generic;
	using Android.Content;
	using Casino.Core;
	using Cirrious.MvvmCross.Application;
	using Cirrious.MvvmCross.Binding.Droid;

	namespace Casino.UI.Droid
	{
	public class Setup
	: MvxBaseAndroidBindingSetup
	{
	public Setup(Context applicationContext)
	: base(applicationContext)
	{
	}

	protected override MvxApplication CreateApp()
	{
	return new App();
	}

	protected override IDictionary<string, string> ViewNamespaceAbbreviations
	{
	get
	{
	var toReturn = base.ViewNamespaceAbbreviations;
	toReturn["Casino"] = "Casino.UI.Droid.Controls";
	return toReturn;
	}
	}
	}
	}

view raw Setup.cs hosted with ❤ by GitHub

Add a SplashScreen activity and /Resources/Layout/SplashScreen.axml file like:

	<?xml version="1.0" encoding="utf-8"?>
	<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:orientation="vertical"
	android:layout_width="fill_parent"
	android:layout_height="fill_parent"
	>
	<TextView
	android:layout_width="fill_parent"
	android:layout_height="wrap_content"
	android:text="Loading...."
	/>
	</LinearLayout>

view raw SplashScreen.xml hosted with ❤ by GitHub

	using Android.App;
	using Cirrious.MvvmCross.Droid.Views;

	namespace Casino.UI.Droid
	{
	[Activity(Label = "Casino", MainLauncher = true, NoHistory = true, Icon = "@drawable/icon")]
	public class SplashScreenActivity
	: MvxBaseSplashScreenActivity
	{
	public SplashScreenActivity()
	: base(Resource.Layout.SplashScreen)
	{
	}
	}
	}

view raw SplashScreenActivity.cs hosted with ❤ by GitHub

Add a Views folder
In the Views folder and in the Resources Layout folder, add a HomeView like

	using Android.App;
	using Casino.Core.ViewModels;
	using Cirrious.MvvmCross.Binding.Droid.Views;

	namespace Casino.UI.Droid.Views
	{
	[Activity(Label = "Casino")]
	public class HomeView : MvxBindingActivityView<HomeViewModel>
	{
	protected override void OnViewModelSet()
	{
	SetContentView(Resource.Layout.Page_HomeView);
	}
	}
	}

view raw HomeView.cs hosted with ❤ by GitHub

	<?xml version="1.0" encoding="utf-8"?>
	<LinearLayout
	xmlns:android="http://schemas.android.com/apk/res/android"
	xmlns:local="http://schemas.android.com/apk/res/Casino.UI.Droid"
	android:orientation="vertical"
	android:layout_width="fill_parent"
	android:layout_height="fill_parent"
	>
	<TextView
	android:layout_width="fill_parent"
	android:layout_height="wrap_content"
	android:text="Welcome to the HomeView"
	/>
	</LinearLayout>

view raw Page_HomeView.xml hosted with ❤ by GitHub

An iOS UI

Note: On the Mac to target iOS, you need a different set of MvvmCross binaries - in the release folders on http://slodge.blogspot.co.uk/p/mvvmcross-binaries_7.html you will generally find 2 sets of binaries - one for using with VS for Droid/RT/WPF/etc and one for MD on the Mac for iOS.

Note: If you haven't already done: You must edit your targets file. See here: http://slodge.blogspot.co.uk/2013/01/if-pcls-will-not-build-for-you-in.html

To add a MonoTouch UI:

Create a new MonoTouch App project - name it MyApp.UI.Touch
Add a reference to the portable Cirrious.MvvmCross.dll, Cirrious.MvvmCross.Binding.dll and Newtonsoft.Json.dll
Add a reference to the Touch specific libraries of Cirrious.MvvmCross.Touch.dll, Cirrious.MvvmCross.Binding.Touch.dll, System.Net.dll and System.Windows.dll
Add a reference to the Core project in your solution.
Add a Setup.cs file a bit like:

	using System;
	using System.Collections.Generic;
	using Cirrious.MvvmCross.Application;
	using Cirrious.MvvmCross.Binding.Touch;
	using Cirrious.MvvmCross.Platform;
	using Cirrious.MvvmCross.Touch.Interfaces;
	using Cirrious.MvvmCross.Touch.Platform;

	namespace MyApp.UI.Touch
	{
	public class Setup
	: MvxBaseTouchBindingSetup
	{
	public Setup(MvxApplicationDelegate applicationDelegate, IMvxTouchViewPresenter presenter)
	: base(applicationDelegate, presenter)
	{
	}

	#region Overrides of MvxBaseSetup

	protected override MvxApplication CreateApp()
	{
	var app = new Core.App();
	return app;
	}

	#endregion
	}
	}

view raw Setup.cs hosted with ❤ by GitHub

Change your AppDelegate.cs so that it looks like:

	using System;
	using System.Collections.Generic;
	using System.Linq;

	using MonoTouch.Foundation;
	using MonoTouch.UIKit;
	using Cirrious.MvvmCross.Touch.Platform;
	using Cirrious.MvvmCross.Interfaces.ServiceProvider;
	using Cirrious.MvvmCross.Touch.Views.Presenters;
	using Cirrious.MvvmCross.ExtensionMethods;
	using Cirrious.MvvmCross.Interfaces.ViewModels;

	namespace MyApp.UI.Touch
	{
	[Register ("AppDelegate")]
	public partial class AppDelegate
	: MvxApplicationDelegate
	, IMvxServiceConsumer
	{
	UIWindow _window;

	public override bool FinishedLaunching (UIApplication app, NSDictionary options)
	{
	_window = new UIWindow (UIScreen.MainScreen.Bounds);

	// initialize app for single screen iPhone display
	var presenter = new MvxTouchViewPresenter(this, _window);
	var setup = new Setup(this, presenter);
	setup.Initialize();

	// start the app
	var start = this.GetService<IMvxStartNavigation>();
	start.Start();

	_window.MakeKeyAndVisible ();

	return true;
	}
	}
	}

view raw AppDelegate.cs hosted with ❤ by GitHub

Add a Views folder:
In the Views folder, add a HomeView using the XIB UIViewController option, but then modify the view controller's inheritance and constructor like:

	public partial class HomeView : MvxBindingTouchViewController<HomeViewModel>
	{
	public HomeView (MvxShowViewModelRequest request) : base (request, "HomeView", null)
	{
	}

	// ...

	}

view raw HomeView.cs hosted with ❤ by GitHub

A WinRT UI

To add a Windows RT UI:

Add a new Windows Store project - Casino.UI.WinRT
Add a reference to the portable Cirrious.MvvmCross.dll, Cirrious.MvvmCross.Plugin.Json.dll and NewtonSoft.Json.dll
Add a reference to the WinRT specific libraries of Cirrious.MvvmCross.WinRT.dll, Cirrious.
Add a reference to the Core project in your solution
Add a file for Setup.cs like:

	using Cirrious.MvvmCross.Application;
	using Cirrious.MvvmCross.WinRT.Platform;
	using Windows.UI.Xaml.Controls;

	namespace Casino.UI.WinRT
	{
	public class Setup
	: MvxBaseWinRTSetup
	{
	public Setup(Frame rootFrame)
	: base(rootFrame)
	{
	}

	protected override MvxApplication CreateApp()
	{
	var app = new Core.App();
	return app;
	}
	}
	}

view raw Setup.cs hosted with ❤ by GitHub

Modify the App.xaml.cs file to provide setup initialisation like:

	using Cirrious.MvvmCross.ExtensionMethods;
	using Cirrious.MvvmCross.Interfaces.ServiceProvider;
	using Cirrious.MvvmCross.Interfaces.ViewModels;
	using Windows.ApplicationModel;
	using Windows.ApplicationModel.Activation;
	using Windows.UI.Xaml;
	using Windows.UI.Xaml.Controls;

	namespace Casino.UI.WinRT
	{
	sealed partial class App : Application
	, IMvxServiceConsumer
	{
	public App()
	{
	this.InitializeComponent();
	this.Suspending += OnSuspending;
	}

	protected override void OnLaunched(LaunchActivatedEventArgs args)
	{
	Frame rootFrame = Window.Current.Content as Frame;

	// Do not repeat app initialization when the Window already has content,
	// just ensure that the window is active
	if (rootFrame == null)
	{
	// Create a Frame to act as the navigation context and navigate to the first page
	rootFrame = new Frame();

	if (args.PreviousExecutionState == ApplicationExecutionState.Terminated)
	{
	//TODO: Load state from previously suspended application
	}

	// Place the frame in the current Window
	Window.Current.Content = rootFrame;
	}

	if (rootFrame.Content == null)
	{
	var setup = new Setup(rootFrame);
	setup.Initialize();

	var start = this.GetService<IMvxStartNavigation>();
	start.Start();
	}

	// Ensure the current window is active
	Window.Current.Activate();
	}

	private void OnSuspending(object sender, SuspendingEventArgs e)
	{
	var deferral = e.SuspendingOperation.GetDeferral();
	//TODO: Save application state and stop any background activity
	deferral.Complete();
	}
	}
	}

view raw App.xaml.cs hosted with ❤ by GitHub

Add a Views folder:
In the Views folder, add a HomeView like:

	using Casino.Core.ViewModels;
	using Casino.UI.WinRT.Common;

	namespace Casino.UI.WinRT.Views
	{
	public sealed partial class HomeView : LayoutAwarePage
	{
	public HomeView()
	{
	this.InitializeComponent();
	}

	public new HomeViewModel ViewModel
	{
	get { return (HomeViewModel)base.ViewModel; }
	set { base.ViewModel = value; }
	}
	}
	}

view raw HomeView.xaml.cs hosted with ❤ by GitHub

In the Common Files folder, edit the LayoutAwarePage.cs file:
- Change it so that it inherits from
```
Cirrious.MvvmCross.WinRT.Views.MvxWinRTPage
```
- Change the OnNavigatedTo method so that it calls the base method
```
base.OnNavigatedTo(e); 
```
- Change the OnNavigatedFrom method so that it calls the base method
```
base.OnNavigatedFrom(e); 
```

A WPF UI

To add a WPF UI:

Add a new WPF project - Casino.UI.Wpf
Add a reference to the portable Cirrious.MvvmCross.dll, Cirrious.MvvmCross.Plugin.Json.dll and NewtonSoft.Json.dll
Add a reference to the Wpf specific library of Cirrious.MvvmCross.Wpf.dll
Add a reference to the Core project in your solution
Add files for Setup.cs, SimplePresenter.cs, and Program.cs
Modify the App.xaml.cs and MainWindow.Xaml.* files

	using System.Windows;
	using Cirrious.MvvmCross.ExtensionMethods;
	using Cirrious.MvvmCross.Interfaces.ServiceProvider;
	using Cirrious.MvvmCross.Interfaces.ViewModels;

	namespace Casino.UI.Wpf
	{
	public partial class App
	: Application
	, IMvxServiceConsumer
	{
	protected override void OnStartup(StartupEventArgs e)
	{
	base.OnStartup(e);
	var start = this.GetService<IMvxStartNavigation>();
	start.Start();
	}
	}
	}

view raw App.xaml.cs hosted with ❤ by GitHub

	<Window x:Class="Casino.UI.Wpf.MainWindow"
	xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
	xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
	Title="MainWindow" Height="350" Width="525">
	<Grid x:Name="TheGrid">
	</Grid>
	</Window>

view raw MainWindow.xaml hosted with ❤ by GitHub

	using System.Windows;

	namespace Casino.UI.Wpf
	{
	/// <summary>
	/// Interaction logic for MainWindow.xaml
	/// </summary>
	public partial class MainWindow : Window
	{
	public MainWindow()
	{
	InitializeComponent();
	}

	public void Present(FrameworkElement toShow)
	{
	TheGrid.Children.Clear();
	TheGrid.Children.Add(toShow);
	}
	}
	}

view raw MainWindow.xaml.cs hosted with ❤ by GitHub

	using System;

	namespace Casino.UI.Wpf
	{
	public class Program
	{
	[STAThread]
	public static void Main()
	{
	var app = new App();
	var ourWindow = new MainWindow();
	var presenter = new SimplePresenter(ourWindow);
	var setup = new Setup(app.Dispatcher, presenter);
	setup.Initialize();
	app.MainWindow.Show();
	app.Run();
	}
	}
	}

view raw Program.cs hosted with ❤ by GitHub

	using System.Windows.Threading;
	using Cirrious.MvvmCross.Application;
	using Cirrious.MvvmCross.Wpf.Interfaces;
	using Cirrious.MvvmCross.Wpf.Platform;

	namespace Casino.UI.Wpf
	{
	public class Setup
	: MvxBaseWpfSetup
	{
	public Setup(Dispatcher dispatcher, IMvxWpfViewPresenter presenter)
	: base(dispatcher, presenter)
	{
	}

	protected override MvxApplication CreateApp()
	{
	return new Core.App();
	}

	protected override void InitializeDefaultTextSerializer()
	{
	Cirrious.MvvmCross.Plugins.Json.PluginLoader.Instance.EnsureLoaded(true);
	}
	}
	}

view raw Setup.cs hosted with ❤ by GitHub

	using System.Windows;
	using Cirrious.MvvmCross.Wpf.Views;

	namespace Casino.UI.Wpf
	{
	public class SimplePresenter : MvxWpfViewPresenter
	{
	private readonly MainWindow _mainWindow;

	public SimplePresenter(MainWindow mainWindow)
	{
	_mainWindow = mainWindow;
	}

	public override void Present(FrameworkElement frameworkElement)
	{
	_mainWindow.Present(frameworkElement);
	}
	}
	}

view raw SimplePresenter.cs hosted with ❤ by GitHub

Add a Views folder
In the Views folder and add a HomeView using 'New User Control' to produce a file like:

	<views:MvxWpfView x:Class="Casino.UI.Wpf.Views.HomeView"
	xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
	xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
	xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
	xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
	xmlns:views="clr-namespace:Cirrious.MvvmCross.Wpf.Views;assembly=Cirrious.MvvmCross.Wpf"
	mc:Ignorable="d"
	d:DesignHeight="300" d:DesignWidth="300">
	<Grid>
	<TextBlock Text="Hello Wpf"></TextBlock>
	</Grid>
	</views:MvxWpfView>

view raw HomeView.xaml hosted with ❤ by GitHub

	using Casino.Core.ViewModels;
	using Cirrious.MvvmCross.Wpf.Views;

	namespace Casino.UI.Wpf.Views
	{
	public partial class HomeView : MvxWpfView
	{
	public HomeView()
	{
	InitializeComponent();
	}

	public new HomeViewModel ViewModel
	{
	get { return base.ViewModel as HomeViewModel; }
	set { base.ViewModel = value; }
	}
	}
	}

view raw HomeView.xaml.cs hosted with ❤ by GitHub

Because we have added an extra Main to our project, go to project properties in Visual Studio and modify the startup application in the Application tab. Set the startup object to Casino.UI.Wpf.Program

Friday, December 21, 2012

DataBinding dynamic Collections/Lists in Monodroid (and beyond)

From http://stackoverflow.com/questions/13987906/cant-bind-a-mvxbindablelistview-in-twoway-mode

The way data-binding works is through an interface called INotifyPropertyChanged

What happens in this interface is that the ViewModel sends the View a message whenever a property changes - e.g.

    FirePropertyChanged("TestList");

With a list, this doesn't help if the contents of the list itself change - e.g. when the list has an item added or removed.

To solve this, the .Net Mvvm implementation includes another interface INotifyCollectionChanged.

A collection - such as a list - can implement INotifyCollectionChanged in order to let the View know when the contents of the collection change.

For example, the collection might fire events containing hints such as:

everything has changed - NotifyCollectionChangedAction.Reset
an item has been added - NotifyCollectionChangedAction.Add
an item has been removed - NotifyCollectionChangedAction.Remove
...

There's a short introduction into this interface about 12:30 into the MvvmCross Xaminar http://www.youtube.com/watch?v=jdiu_dH3z5k

Xaminar

To use this interface for a small in-memory list - e.g. less than 1000 'small' objects - all you have to do is to change your List for an ObservableCollection - the ObservableCollection is a class from the core .Net libraries (from Microsoft or Mono) and it will fire the correct events when you Add/Remove list items.

You can see the source for the Mono ObservableCollection implementation in: https://github.com/mosa/Mono-Class-Libraries/blob/master/mcs/class/System/System.Collections.ObjectModel/ObservableCollection.cs - it is worth taking some time to look at this implementation so that you can understand a bit more about how Mvvm works with INotifyCollectionChanged.

If you use the ObservableCollection class, then your code will become:

    private ObservableCollection<MyType> _testList;
    public ObservableCollection<MyType> TestList
    {
        get { return _testList; }
        set
        {
            _testList = value;
            FirePropertyChanged("TestList");
            // in vNext use RaisePropertyChanged(() => TestList);
        }
    }

with:

 
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    local:MvxBind="{'ItemsSource':{'Path':'TestList'}}"
    local:MvxItemTemplate="@layout/my_item_layout" />

Note:

that the binding is OneWay - this means that binding is still only going from ViewModel to View - there are no updates going from View to ViewModel.
that ObservableCollection is designed to be single-threaded - so make sure all changes to the collection are done on the UI thread - not on a worker thread. If you need to, you can marshall work back onto the UI thread using InvokeOnMainThread(() => { /* do work here */ }) in a ViewModel.
that in Android, the way lists work (through the base AdapterView) means that every time you call any update on the ObservableCollection then the UI List will ignore the action hint (Add, Remove, etc) - it will treat every change as a Reset and this will cause the entire list to redraw.

For larger collections - where you don't want all the items in memory at the same time - you may need to implement some data-store backed list yourself.

There is a brief example of one simple sqlite data-backed store in https://github.com/slodge/MvvmCross/blob/vnext/Sample%20-%20SimpleDialogBinding/SimpleDroidSql.Core/DatabaseBackedObservableCollection.cs

This virtualizing of collection data is common in WP and WPF apps - e.g. see questions and answers like Is listbox virtualized by default in WP7 Mango?

Thursday, December 20, 2012

One awesome thing I forgot to mention.... Flights of Norway MVVM from Jonas Follesø

One of many things I forgot to mention during the recent Xaminar was the Flights of Norway app and tutorial that Jonas Follesø (@follesoe) put together in 2011 - http://jonas.follesoe.no/2011/07/22/cross-platform-mobile-ndc-2011/

You can see the code for this in https://github.com/follesoe/FlightsNorway

It would be a good place to start if you wanted to think about rolling your own Mvvm framework.

It is definitely deserving of:

I wish I'd seen that code and talk before I started MvvmCross...

The video is on http://jonas.follesoe.no/ or embedded below:

Wednesday, December 19, 2012

Cross-Platform, WinRT, MonoDroid, MonoTouch, MonoMac, PCLs and VS2012

I've been asked on Twitter about the latest state of PCLs, VS2012, VSMonoTouch, etc.

There's no way I could do that in 140 characters... so here's a longer answer....

Before you start...

The Productivity tools for VS2012 are essential - install them - tools like 'right-click to edit the csproj file' are incredibly useful!

http://visualstudiogallery.msdn.microsoft.com/d0d33361-18e2-46c0-8ff2-4adea1e34fef

Loading MonoTouch, MonoDroid, WP, WindowsStore, WPF, MonoMac projects in Visual Studio 2012

By Visual Studio 2012, I mean Professional Edition or better - give up on Express as there is no addin support in the free version.

WindowsStore and WPF projects are all supported out of the box by Visual Studio 2012

WP7.1, WP8 can be supported by adding on the WP SDK - http://dev.windowsphone.com/en-us/downloadsdk

MonoDroid projects can be supported by buying (or evaluating) the Mono for Android - http://xamarin.com/monoforandroid

For the best MonoDroid experience, you probably want to get the x86 Android emulator working - see instructions at http://docs.xamarin.com/Android/Guides/Deployment,_Testing,_and_Metrics/Configuring_the_x86_Emulator

Unfortunately I've had a lot of problems getting this running on the same machine as Windows 8/Windows Phone 8/Hyper-V... I hope you have better luck than I do - as a good emulator is a wonderful tool to have.

MonoTouch projects require a little tinkering to make them load - they require VSMonoTouch2012 - a completely unsupported installer for this is available on my SkyDrive account - http://sdrv.ms/U6FKrz - some hint at where it came from are on https://github.com/follesoe/VSMonoTouch/issues/13 - obviously you install this at your own risk.

To complete the install of VSMonoTouch you also need to follow the steps in the readme of https://github.com/follesoe/VSMonoTouch:

"Copy the MonoTouch binaries from your Mac development environment..."
"Add a RedistList-folder ..."

Warning: See section below on some known issues in VSMonoTouch in VS2012.

For MonoMac/Xamarin.Mac I'm not aware of any way to load these in VS2012 at present.

For older targets like Silverlight and WindowsForms I've not tried anything yet.

Some known issues for VSMonoTouch 2012

I have found VSMonoTouch2012 to be *very* slow when VS first loads a new solution/project - eg. it took *hours* to load MvvmCross_All the first time. After this, however, it seems to work quite well.

The way MonoTouch references mscorlib is slightly different to the Microsoft way, so you may find you need to explicitly reference the MonoTouch mscorlib - see http://slodge.blogspot.co.uk/2012/05/if-you-install-visual-studio-11-and.html

There are some arguments that VSMonoTouch and MonoDevelop/MonoTouch have over project files. These especially seem to concern the TargetFramework - the fact that VSMonoTouch is set to 1.0 does confuse things (I think). I have seen some projects where I have had to hack in a build step for "The type or namespace name 'TargetFrameworkAttribute' does not exist" - see http://slodge.blogspot.co.uk/2012/09/the-type-or-namespace-name.html

One very bizarre problem I've had is with one of my System.Windows surrogate DLLs - for some reason this refuses to pick up my MonoTouch references at compile time (it is OK in intellisense). This has only occurred in one place so far - see the HACK_DO_NOT_FORWARD_ICOMMAND in https://github.com/slodge/MvvmCross/blob/vnext/PortableSupport/System.Windows.Touch/System.Windows.Input/ICommand.cs - background to this is in http://stackoverflow.com/questions/13326794/typeforwardedto-refuses-to-work-for-system-windows-input-icommand-in-monotouch

Using PCLs

PCL v2 support is included with VS2012.

This includes support for WindowsStore, WP, XBox, etc.

To add MonoDroid, and VSMonoTouch PCL support, you need to add some files (based on http://jpobst.blogspot.co.uk/2012/04/mono-for-android-portable-libraries-in.html)

Install a file called "MonoAndroid,Version=v1.6+.xml" in "C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETPortable\v4.0\Profile\Profile104\SupportedFrameworks" with content:

	<?xml version="1.0" encoding="utf-8"?>
	<Framework DisplayName="Mono for Android"
	Identifier="MonoAndroid"
	Profile="*"
	MinimumVersion="1.6"
	MaximumVersion="*" />

view raw MonoAndroid,Version=v1.6+.xml hosted with ❤ by GitHub

Install a similar file called "VSMonoTouch,Version=v1.0+.xml" in the same directory and for its content use:

	<?xml version="1.0" encoding="utf-8"?>
	<Framework DisplayName="VS MonoTouch"
	Identifier=".NETFramework"
	Profile="*"
	MinimumVersion="1.0"
	MaximumVersion="1.0" />

view raw VSMonoTouch,Version=v1.0+.xml hosted with ❤ by GitHub

Note: the VSMonoTouch file is slightly hackier than the MonoDroid one - it points the portable tools at Full .Net v1.0 exactly as the VSMonoTouch plugin does - but I think this can cause some tool confusion sometimes.

After creating these xml files, then you should be able to use PCL projects of profile 104 across all platforms.

There are however some small additional problems you may need to solve at build time:

If you share solutions back to the Mac, then MonoDevelop currently only likes Profile1 at Build time. To work around this, you may find you need to force Profile104 across to Profile1 using a conditional statement in your csproj file. Jon Pepper found this solution - thanks - http://slodge.blogspot.co.uk/2012/10/a-temporary-solution-for-profile1-only.html

Note that this problem is marked as solved in bugzilla - see https://bugzilla.xamarin.com/show_bug.cgi?id=7173 - so this fix might be available in an alpha, beta or full release soon.
If you share solutions back to the Mac,and if you have an older MonoDevelop installation, then you may also find that it fails to open .sln files. This bug has been around since May, but is almost fully fixed now. To workaround it you can manually change the .sln to say 11 rather than 12 - see https://bugzilla.xamarin.com/show_bug.cgi?id=4919
To make use of some of the namespaces included in PCL you may need to setup shim assemblies to redirect DLL references. I've done this for System.Net, System.Windows and part of System.Xml.Serialization - see https://github.com/slodge/MvvmCross/tree/vnext/PortableSupport

Note that these projects are quite simple - they just do type redirects from the full .Net assembly names to the Silverlight equivalents (Silverlight/MoonLight is where MonoTouch and MonoDroid started life)

However, also note that there are some quirky things like public key signing and file renaming that we've had to do in order to get round some issues - see https://bugzilla.xamarin.com/show_bug.cgi?id=8035 and http://stackoverflow.com/questions/13028321/portable-class-library-strong-assembly-reference-problems-in-monotouch-monodroid

I hope that these Shim assemblies become standard somewhere sometime soon - my versions are MS-PL and I would love to see someone (MS or Xam) take them and ship them more officially.

For more on why Shim assemblies are needed see - http://stackoverflow.com/questions/10361457/is-it-possible-to-use-a-portable-class-library-that-references-system-net-in-mon

PCLs and Mono for Android

Using PCLs in Mono for Android inside VS2012 is very straight-forward.

You can easily reference Profile104 projects

You can easily reference Profile104 pre-built assemblies.

Sometimes you need to add the shim DLLs to add support for things like System.Net - but this is a solved problem - just reference the shims from the MvvmCross project and you are there.

However... there are two major problems with Mono for Android and PCLs right now - see https://bugzilla.xamarin.com/show_bug.cgi?id=8209:

Sometimes you seem to need to build a solution twice to make it work
You cannot debug (breakpoints, step into, etc) inside a PCL

Neither of these problems occurs currently in VS2010 using PCLs and Mono for Android - so maybe it is better to code there if you can.

PCLs and MonoTouch

Using PCLs in VSMonoTouch inside VS2012 is very straight-forward.

One word of warning - if you want to share PCLs at a binary level - then build these PCLs in the VisualStudio tools - not in MonoDevelop. This I think is because of code signing and reference assembly issues.

PCLs and Playstation Studio

I've briefly tried reusing PCLs with Playstation Studio/PSVita.

Project files wouldn't load in PSS

PCL assembly files could be referenced but I got serious errors at runtime - e.g. trying to use JSON.Net failed with horrible Type Exceptions. See http://stackoverflow.com/questions/10462462/using-portable-class-libaries-in-playstationstudio-projects

PCLs and Xamain.Mac

I've briefly tried reusing PCLs with MonoMac/Xamarin.Mac.

Project files would load in MonoDevelop, but I couldn't reference them across to MonoMac projects.

PCL assembly files could be referenced but in MonoMac projects, but I got errors at compile time - see http://forums.xamarin.com/discussion/599/portable-class-libraries-supported#latest

I have been informed that PCLs should definitely work in .Mac - so will try some more.

PCLs and Async/Await

This is not an area I've touched yet - I'm waiting for MonoTouch/Droid official async/await support - then I will work out how to add it into PCLs....

If you are interested, then here is what I know:

PCL v2 does not support async/await.

You can add async/await support to PCL v2 using a nuget package - http://nuget.org/packages/Microsoft.Bcl.Async

But this nuget package does not like the MonoDroid and VSMonoTouch additions. If you want to add the package then the advice is:

If you've modified your profile to support MonoTouch and MonoDroid, then a NuGet package typically won't install because the package doesn't list those platforms as supported.

The workaround is to quit VS, go to the profiles directory and rename the xml files you added, re-launch VS, and then reference the NuGet package

Daniel Plaisted did lots of work around this for his BUILD talk - http://channel9.msdn.com/Events/Build/2012/3-004 - the resources for this project include a working MonoDroid async/await sample.

Using nuget

nuget does now contain Portable Library support, but there are some limitations to extending this to monotouch and monodroid targets.

From v2.3 nuget will also contain some monodroid, monotouch and monomac support.

However, this support is very early days - I expect the tools will need some more work to make the experience really fly. I personally intend to invest some time in this - maybe in lobbying, but hopefully in coding (nuget is open source). If anyone wants to join this effort, please do.

I believe nuget when fully working across PCLs, MonoMac, Mono for Android and MonoTouch will be *amazing*

Is it worth the effort? Can't I just use file linking?

Yes, you can just use file linking.

Only you can decide if it's worth the effort.

A very good summary of the pro's and con's is in this Q&A - http://stackoverflow.com/questions/13797385/what-is-the-advantage-of-using-portable-class-libraries-instead-of-using-add-as

I personally love PCLs because they have definitely improved my speed of writing and refactoring code. I'm not claiming that progress is easy... but I am loving using them - so thanks to all in MS, in Xam and in the community (VSMonoTouch and beyond!) who are helping make these better. Indeed, much of the input from MS and Xam seems to have come while 'off duty' :)

The future

I've heard ongoing rumours that Xamarin may have a VS plugin for MonoTouch in development. I believe this was even demo'd live in early 2012... but maybe I was imagining it. Certainly Xamarin have some lovely new products lined up for 2013 - I'm hoping this is part of one of them.

Being able to build all of of PCL, WindowsStore, MonoDroid, MonoTouch, WP, WPF and MonoMac projects within one solution is already amazing today.

Making this support more official (without the VSMonoTouch and PCL reference hacking) and then adding full nuget support would be *fabulous* - I'm so looking forwards to doing single machine binary release and publishing.

Honestly I don't expect this future to arrive in the next month or three... so I do expect anyone who wants to build cross-platform solutions to need some patience and to do some considerable swearing... but the progress in the last year has been remarkable - and we are moving forwards.

MvvmCross today is a single solution containing 120 projects from 7 different project types - it builds, it supports refactoring and it offers me a really stable development environment.

I have gone through setup pain in the past, but this work means I can now spend my time coding - which makes me happy :)

Forwards!

Tuesday, December 18, 2012

Still speechless... the Xamarin Showdown win

Huge thanks to Xamarin for choosing Sphero Ball Control as the Grand Prize winner in their first developer showdown.

To win a prize is always great :)

But in this case it's even more special:

because the prize is for code
because the voting was done by a great bunch of developers who I have so much time and respect for; from a team who frequently release totally jaw-dropping awesome software - both in product and in source code form.

To be honest, I hoped I had a shot at winning the Windows Phone prize, but I genuinely thought I had no chance at the big one. Especially when you look at some of the apps I was up against:

Evolve from Bill Holmes - using all 3 Xamarin.Mobile parts on iOS:

Wsh Lst from Jonathan Dick (@Redth) - supporting all 3 platforms, plus web services, plus bar code scanning, plus a website - wow:

Prattle from John Heerman - an Android group messaging app I need (and I love the Darth Vader party invite in the video):

Congratulations to all of the above on their prizes - and more importantly on your great apps and code.

All 3 of the apps above are open source - helping everyone to build apps - check them out:

Today I'm definitely wearing:

Thanks again for the prize!

And while I'm saying thanks.... there's also again to Xamarin for hosting the MvvmCross Xaminar - it's awesome to see them embracing and promoting so many different flavors of C# development.

Today I look at the Xamarin blog and I'm all over it :) Thanks, monkeys!

However.... actually the stuff just off the bottom of the page is much more interesting - check out:

Speeding up asset use in iOS - http://blog.xamarin.com/2012/12/17/handling-large-assets-on-ios/
Using Google maps in your MonoTouch apps again - http://blog.xamarin.com/2012/12/14/google-maps-sdk-for-ios-now-on-monotouch/
C# meet OSX - Xamarin.Mac - http://blog.xamarin.com/2012/12/12/your-app-on-66-million-macs-c-sharp-on-mac/

On with the code!

Monday, December 17, 2012

Getting started with Bluetooth development on WP8

I don't know about you.... but I use the WindowsPhoneGeek website a **lot**

.... so I thought it was time I gave a little back!

To help, here's the first article I've written for them - it's about getting started with Bluetooth:

http://www.windowsphonegeek.com/articles/getting-started-with-bluetooth-in-windows-phone-8

It's mainly based on my BallControl project - but I hope it's a bit easier to follow than the main project - a bit gentler as an introduction into Bluetooth, WP8 and Sphero.

Saturday, December 15, 2012

Sphero under Windows Desktop using WPF

Took about 3 hours to get this running - mainly sorting out lots of MvvmCross plugins - now checked in to http://github.com/slodge/ballcontrol

If anyone with some Xaml skill wants to work it better, then please do :)

A second Node Garden experiment

A second Node Garden experiment...

An experiment in node democracy :)

Friday, December 14, 2012

WPF and MvvmCross

Yesterday there was a question on StackOverflow about PRISM....

http://stackoverflow.com/questions/13863152/mvvmcross-and-prism-combination

Although actually it wasn't really about PRISM - instead it was more about 'Could MvvmCross be used in WPF?' and 'Could MvvmCross support more complicated Composite UIs?'

I was pretty sure MvvmCross could - especially given our PCL base and our presenter-based Show mechanisms.

So I set about providing it....

And a few hours later - I've checked in some code :)

More details in the answer: http://stackoverflow.com/questions/13863152/mvvmcross-and-prism-combination/13864564#13864564

And a video of it in action:

Thursday, December 13, 2012

MvvmCross Video Presentation - Xaminar today

Xaminar today....

Video at:

Slides at:

I didn't say everything I meant to.... but I still overran by 30 minutes (on a 30-40 minute target)... long live the dinosaurs...

Update I've uploaded the middle part in HD to http://youtu.be/-Ghb3sXe9Ks - hope that helps - HD:

Tuesday, December 11, 2012

2 spheros 1 lumia

Wrote this code when I had only one sphero - got together with a friend...

I was so happy when this code just worked :)

Friday, December 07, 2012

async and await were made for Sphero... and for psy #GangnamStyle

Still having fun with Sphero and C#

Today we decided to add some async/await automation... and to let Sphero dance....

Thanks to async/await, the code for dance sequence is easy - it looks like:

        private async Task Dance()
        {
            Stop();
            Color(0,0,0);
            Tail(0);
            await TailTo100Over10();
            await OneSecond();
            PulseWhiteEverySecond(6);
            Color(0,200,0);
            for (var i = 0; i < 5; i++ )
                await ZigZag();
 
            for (var i = 0; i < 3; i++)
                await Sequence1();
            for (var i = 0; i < 3; i++)
                await Sequence2();
            for (var i = 0; i < 20; i++)
            {
                await Sequence1();
                await Sequence2();
            }

We also added multiple Sphero control from the same phone - will show that as soon as the video arrives :) :) :)

Thursday, December 06, 2012

Sphero Ball Control in the Marketplace

Sphero Ball Control now live in the Marketplace

Here's the link:

http://www.windowsphone.com/s?appid=79ffe7ec-0bb2-45e2-804d-8370ccdf68f4

Here's a demo:

And here's one idea for what we might try to do next:

28 Sphero Holiday Dance: Union Square NYC from Sphero on Vimeo.

Wednesday, December 05, 2012

Announcing MvvmCross Badges of Awesomeness

A lot of people are doing awesome things with MvvmCross.

To celebrate, I'm announcing today:

MvvmCross Badges of Awesomeness

I'm keen to award these out to anyone you know has:

developed an awesome app using MvvmCross
githubbed an awesome MvvmCross extension or plugin
blogged an awesome bit of MvvmCross information
presented an awesome session on MvvmCross
done something else Mvvm and/or Crossie which is awesome....

I'll be awarding the first batch of badges in the next week... and I'll be posting about each and every badge award here on the blog - probably on a special page.

I'm hopeful this will help spread the word about awesome things developers can do with MvvmCross and also help customers find skilled contractors too - because we are worth it!

If you think you deserve one or more badges - or if you know someone who does - please let me know! If you think someone is awesome, then they probably are.

Tuesday, December 04, 2012

Sphero Ball Control for Windows Store apps - a nice hack but a sad story :(

I've ported the Sphero Ball Control to Windows Store

However, because Windows Store apps can't access a very full Bluetooth stack, then I had to use a desktop element (a Windows Service) to make the code work.

This means that the app can not currently be submitted to the Windows Store.

If you want to see Sphero in the Windows Store, please write to Microsoft and comment and vote on this thread/issue now:
http://social.msdn.microsoft.com/Forums/en-US/tailoringappsfordevices/thread/6634240b-c042-4e76-a3b0-1f1103ea0ddf

Here was the demo

Monday, December 03, 2012

How Deep Are Your Unit Tests?

This is one of my favorite StackOverflow questions and answers: http://stackoverflow.com/questions/153234/how-deep-are-your-unit-tests

Kent Beck answers:

I get paid for code that works, not for tests, so my philosophy is to test as little as possible to reach a given level of confidence (I suspect this level of confidence is high compared to industry standards, but that could just be hubris). If I don't typically make a kind of mistake (like setting the wrong variables in a constructor), I don't test for it. I do tend to make sense of test errors, so I'm extra careful when I have logic with complicated conditionals. When coding on a team, I modify my strategy to carefully test code that we, collectively, tend to get wrong.

Different people will have different testing strategies based on this philosophy, but that seems reasonable to me given the immature state of understanding of how tests can best fit into the inner loop of coding. Ten or twenty years from now we'll likely have a more universal theory of which tests to write, which tests not to write, and how to tell the difference. In the meantime, experimentation seems in order.

As the first comment says:

The world does not think that Kent Beck would say this! There are legions of developers dutifully pursuing 100% coverage because they think it is what Kent Beck would do! I have told many that you said, in your XP book, that you don't always adhere to Test First religiously. But I'm surprised too.

In case you don't know who Kent Beck is: http://en.wikipedia.org/wiki/Kent_Beck

Sunday, December 02, 2012

Sphero - Ball control - introduction video

Ball Control - hopefully coming soon to the Windows Phone 8 Store :)

Saturday, December 01, 2012

Sphero App submitted to Windows Phone Marketplace

I've submitted :)

My first WP8 app.

Don't know whether it will pass first time!

Below are some screenshots

Stuart

Friday, November 30, 2012

BallControl - an open source Sphero C# controller - WP7, MonoDroid and hopefully MonoTouch (and WinRT?)

Meet my latest open source project - meet BallControl for Sphero:

Here's a first video I made for the project - sorry about the low audio volume!

Xamarin the Native, Sphero the Ball and Lumia the Phone....

After a long week of coding, this experiment in sleep deprivation reaches its inevitable conclusion....

Featuring:
- Xamarin.Mobile Picture capture
- Native voice control
- Native accelerometer control
- Native UI with lots of touch
- Native BlueTooth
- Guest Starring Sphero the ball
- Cross platform Mvvm

Xamarin the Monkey.... because going Native matters

Can I sleep now?

Here's the apps first public outing to a local user group:

Some technical info

The project demonstrates Xamarin.Mobile by using Xamarin.Mobile media picker.... But, beyond that it also extends Xamarin.Mobile tackling some elements of several Xamarin.Mobile requests on uservoice:

The Source

The source is on: https://github.com/slodge/BallControl

Currently, we have:

a working WP8 app
a working (but ugly) MonoDroid app
a non-working Windows Store app - it seems that Windows Store does not yet support BlueTooth SPP devices - which is so bad :(

I will get a MonoTouch app working soon....

I will also post to the WP8 app store soon.

And I will post some more videos soon....

If anyone is interested in how the app was built I did live blog the first 10 hours of coding... see PDF at http://sdrv.ms/V8xdmV (or email me for a Word doc). Sorry I didn't blog the whole lot - but there was a lot of code to write... and I did it in 5 days end-to-end while still holding down the day job too.

That's AmazeBalls! How do I get a Sphero:

If you want a sphero, then try:

If you cannot open your WP7 Project in Visual Studio 2012!

For the last month I've been swearing at the Visual Studio 2102 and WP8 teams...

The reason: because when I open my WindowsPhone 7 solutions, then it shows them as "unavailable" - which makes me very very sad - because I have to use VS2010:

However, last night @dsplaisted asked me if I'd tried right-clicking on them and reloading them.

It worked

I can now open my Windows Phone 7 projects in VS2012 :)

Apparently, the problem was:

I first tried to open this solution before the WP8 SDK was installed
Visual Studio 2012 didn't know about how to open these - so it marked them 'do not open' in my solution options.

I am sooooooooooooo glad I can open all my projects in VS2012 again!

Wednesday, November 28, 2012

If you cannot see WP8 packages in nuget....

Then you need to install a newer version of nuget - http://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c

I just wasted 30 minutes of my life trying to work out where the Phone Toolkit had gone and why I couldn't install it... ah well....

:)

An awesome sample - Wish List from Redth

An awesome sample of using Azure Mobile Services, Azure Web Sites, MvvmCross, ZXing.Net bar code scanning and Xamarin.Mobile too:

Source code is on https://github.com/Redth/WshLst

There might be some blogging on it at Redth.info and some tweeting from @Redth

if I were being critical:

it is currently a bit 'code heavy' in the UI layer,
there are some #if things in the core code
the lack of portability support in Azure Mobile Services and in Xamarin.Mobile has forced it away from PCL which is a shame

but overall:

it's amazeballs - check it out!

Tuesday, November 27, 2012

A simple multitouch view for MonoDroid

I needed a multitouch view for MonoDroid (Mono for Android), so I built one :)

I based it on

http://android-er.blogspot.co.uk/2011/05/detect-multi-touch-on-custom-view.html

It seems to work quite well - to see it in action, just include it in your project and then you can use it in your axml or in your C#

The code:

	using Android.Content;
	using Android.Graphics;
	using Android.Util;
	using Android.Views;

	namespace Cirrious.Sphero.WorkBench.UI.Droid.Controls
	{
	// adapted from http://android-er.blogspot.co.uk/2011/05/detect-multi-touch-on-custom-view.html
	public class TouchView : View
	{
	private const int MaximumTouchCount = 2;

	private readonly Paint _paint = new Paint(PaintFlags.AntiAlias);
	private readonly float[] _x = new float[MaximumTouchCount];
	private readonly float[] _y = new float[MaximumTouchCount];
	private readonly bool[] _isTouch = new bool[MaximumTouchCount];

	public TouchView(Context context)
	: base(context)
	{
	}

	public TouchView(Context context, IAttributeSet attrs)
	: base(context, attrs)
	{
	}

	public TouchView(Context context, IAttributeSet attrs, int defStyle)
	: base(context, attrs, defStyle)
	{
	}

	protected override void OnMeasure(int widthMeasureSpec, int heightMeasureSpec)
	{
	SetMeasuredDimension(MeasureSpec.GetSize(widthMeasureSpec), MeasureSpec.GetSize(heightMeasureSpec));
	}

	protected override void OnDraw(Canvas canvas)
	{
	_paint.StrokeWidth = 1;
	_paint.SetStyle(Paint.Style.Fill);

	if (_isTouch[0])
	{
	_paint.Color = Color.Red;
	canvas.DrawCircle(_x[0], _y[0], 75f, _paint);
	}
	if (_isTouch[1])
	{
	_paint.Color = Color.Blue;
	canvas.DrawCircle(_x[1], _y[1], 75f, _paint);
	}
	}

	public override bool OnTouchEvent(MotionEvent motionEvent)
	{
	var pointerIndex = ((int) (motionEvent.Action & MotionEventActions.PointerIdMask) >>
	(int) MotionEventActions.PointerIdShift);
	var pointerId = motionEvent.GetPointerId(pointerIndex);
	var action = (motionEvent.Action & MotionEventActions.Mask);
	var pointCnt = motionEvent.PointerCount;

	if (pointCnt <= MaximumTouchCount)
	{
	if (pointerIndex <= MaximumTouchCount - 1)
	{
	for (var i = 0; i < pointCnt; i++)
	{
	var id = motionEvent.GetPointerId(i);
	_x[id] = (int) motionEvent.GetX(i);
	_y[id] = (int) motionEvent.GetY(i);
	}

	switch (action)
	{
	case MotionEventActions.Down:
	case MotionEventActions.PointerDown:
	case MotionEventActions.Move:
	_isTouch[pointerId] = true;
	break;
	default:
	_isTouch[pointerId] = false;
	break;
	}
	}
	}
	Invalidate();
	return true;
	}
	}
	}

view raw TouchView.cs hosted with ❤ by GitHub

	<?xml version="1.0" encoding="utf-8"?>
	<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="fill_parent"
	android:layout_height="fill_parent"
	>
	<cirrious.sphero.workbench.ui.droid.controls.TouchView
	android:layout_width="fill_parent"
	android:layout_height="fill_parent"/>
	</FrameLayout>

view raw View.axml hosted with ❤ by GitHub

Monday, November 26, 2012

MvvmCross on the TabletShow :)

Thanks to @MrLacey for this tipoff: http://www.thetabletshow.com/default.aspx?ShowNum=60

What they said (about 30 minutes in):

It's basically an Mvvm framework using the Xamarin tools. It takes it all the way up to the UI layer, so that the only thing you are building is, for example on the Windows 8 side, just the XAML; on the iOS side just the XML that describes the screens; and the same thing on the Android side.

And you're binding - that's it!

Everything else from that UI definition down is all shared code - so you're basically building almost your entire app with shared code. You're just defining the views each time.

There were plenty of "So Cool", "pretty exciting" and "Awesome" comments thrown in - and some inciteful remarks about:

the importance of native UI
how MvvmCross provides you a native UI
how it allows you to swap out views on each platform
how it helps lower the cost of native development
and about how MvvmCross is ideal for business apps

Thanks to John Sonmez and the Tablet Show team for the nice comments about the 'huge potential for cross-platform development' :)

Sunday, November 25, 2012

Happy 1st Birthday to MvvmCross - How hard can it be...?

It's official: MvvmCross is 1 year old this week!

The MvvmCross story started early in November 2011 when I started work on the Star Wars Kinect social app.

I had a plan to technically build that app using WindowsPhone, MonoTouch and Mono for Android, and I had a basic WindowsPhone prototype that I'd hacked together using TweetSharp and some code-behind... but, beyond that, I really didn't know what I was building or how I was going to do it.

Luckily, towards the middle of the month, MonoCross 1.0 was released. I downloaded it eagerly, and also struck up some online conversations with some of the MX guys, especially Kenny Goers who patiently and skillfully dealt with all of my queries.

Over the next week or two I talked, walked and typed through lots of code. There were lots of prototypes written, lots of emails and code exchanges back and forth, and lots and lots of time spent swearing at compilers, debuggers and phones.

I *loved* what the MonoCross guys had done in trying to put down a rigid MVC structure for their apps - in trying to provide a formal structure for sharing code cross-platform. However, I also hit a few problems with the MVC pattern itself, with the way MonoCross memory management was architected and with the static nature of the MX code base.

To try to work around these problems somewhere around the 25th November, I checked in my first Cirrious.MonoCrossExtensions commit - and Kenny and I again exchanged some emails - especially about memory management, about IoC and about charging forwards...

It was also at about this point that we had a technical meeting inside the Star Wars Kinect project... and at some point during that meeting one of myself or John McLoughlin (imaji on Twitter) said something like:

We could just go the whole way with Mvvm. How hard can it be?

That question hung there for a while....

How hard can it be....?

And so... on the 28th November I ended up abandoning Cirrious.MonoCrossExtensions and commiting the first files into Cirrious.MvvmCross

This was the first proper MvvmCross commit - 'OMG! What haz I done?' - just 280 changed files and 60,000 additions...

The rest, as they say, is history :)

Happy Birthday Mvx!

Thursday, November 22, 2012

ThanksGiving post - Thanks for more Portable Class Library/Portable Library Project solutions for MonoTouch/MonoDroid

On this day of ThanksGiving in the US....

Thanks!

I'm really grateful for some of the input I've gotten recently from Microsoft and Xamarin.

Especially:

1. Daniel Plaisted at Microsoft has just heroically supplied a detailed idiot-proof solution to the strong naming issues for ICommand, ObservableCollection, etc.

This solution is:

I think this is what you need to do to get around the type sharing / strong name signing issues for portable libraries on Mono:

-> Extract the public key of System.Windows.dll, and put it in the project directory for the Droid System.Windows project:

 Sn –e "C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETPortable\v4.0\Profile\Profile104\System.Windows.dll" system_windows.snk

-> Modify the Droid system.windows project to delay-sign using the extracted key. Put the following in a PropertyGroup in the csproj file:

<SignAssembly>true</SignAssembly>  <AssemblyOriginatorKeyFile>system_windows.snk</AssemblyOriginatorKeyFile>  <DelaySign>true</DelaySign>

-> Change the assembly version of the Droid System.Windows project (in AssemblyInfo.cs) to:

2.0.5.0

In my testing, I didn't seem to need to disable strong name verification. So I don't think it will present any extra barriers for newbies – once you have these changes made they'll just need to get your code and it will build correctly.

However, if you do run into problems, try running the following from an admin VS command prompt:

 sn -Vr *,7cec85d7bea7798e

Let me know how this works!

I've tested it - it seems to work really, really well :) This solution is now pushed into vNext at https://github.com/slodge/MvvmCross/commit/f6a88048467838e5ac5ca687744dc0b2d1958aa8

It seems to solve:
- http://stackoverflow.com/questions/13028321/portable-class-library-strong-assembly-reference-problems-in-monotouch-monodroid
- http://stackoverflow.com/questions/13197546/mvvmcross-vnext-observablecolletion-is-defined-in-an-assembly-that-is-not-refer

2. The Xamarin team for solving all the issues caused by sln file changes in VS11/VS2012 - https://bugzilla.xamarin.com/show_bug.cgi?id=4919

These changes may sound trivial, but they've been making code sharing very hard since May this year - and it's great that I can now dropbox/skydrive share my projects and solutions again now between Mac and PC :)

3. Michael, Alan, Jeff (and others) within Xamarin for fixing the problems with building the new Profiles - including 104 - https://bugzilla.xamarin.com/show_bug.cgi?id=7173

I hope by naming a few people I haven't upset anyone else who's helped.

I really am grateful to everyone who's helping :)

Now... I'm going back to write some more PCL code... :)

Tuesday, November 20, 2012

Merging vNextDialog back into vNext

Firstly.... apologies if these changes cause you any problems... but I've tidied up the source tree in vNextDialog and I think these changes will have positive benefits for all users. So I'm merging the changes back into vNext.

The key details of the changes are:

Dialogs

I've added a version of Android.Dialog/MonoDroid.Dialog to the source - this is in CrossUI.Droid
I've added a PCL library - CrossUI.Core - which contains the shared Dialog/Menu/List code
I've moved the MT.Dialog code out of MvvmCross Dialog and back into a CrossUI.Dialog class

AutoViews

I've added projects for AutoViews - these aren't finished yet... but are a very good step in the right direction!
I've added an AutoView sample - based on CustomerManagement. This isn't a 'best practice' sample - it's more a 'here's 3 ways of using autoviews' - so may not be easy to follow yet.
AutoViews currently only exist for MonoTouch and MonoDroid

Build Paths

I've changed the build paths so that all the DLLs build into /bin/debug and /bin/release
Importantly this means it should be easier to do a binary release of MvvmCross again soon :)
One side effect of these changes is that you probably won't be able to build both of Droid/Touch at the same time - this is because they will fight over the System.Windows and System.Net Assembly names - but otherwise they should still build individually.

MonoTouch project configurations

The MonoTouch library projects are now switched to simpler Debug/Release only - I'll try to maintain this as we move forwards!

If these changes break your code.... sorry

The main things that will need changing to get you back building are:

If you were using MonoTouch.Dialog, then you will need to add the CrossUI.Core and CrossUI.Dialog projects and you will need to change some Cirrious.MvvmCross.Dialog.Touch.Elements namespaces to CrossUI.Touch.Dialog.Elements
If you were relying on the iPhone/iPhoneSimulator project configurations, then you will need to use the Configuration Manager to adjust these back to simpler Debug/Release dependencies.

Sorry again for making these changes so suddenly... but I was informed today that a new user was having problems building the main tree... and I wanted to fix these problems.

This merge back seemed like the best way to fix them and to provide the best possible platform moving forwards.

Monday, November 19, 2012

Cross Platform .Net Podcast from Jesse Liberty, Jon Galloway and Miguel de Icaza

@JesseLiberty, @jongalloway and @migueldeicaza discuss open source and Mono things including a couple of discussions around MvvmCross and MonoCross :)

Worth a listen - there's lots of good technical info; interesting questions like 'what does Miguel do all day?'; some great phrases like 'the delight of using Native APIs'; an intriguing comment right at the end about a major product launch next year - "a universe of goodness"; plus some interesting background on the relationships between Mono, Ximian, Novell, Xamarin, MonkeySpace, Microsoft and ... of course ... Monkeys :)

For the audio: http://jesseliberty.com/wp-content/media/Show80.mp3

For a background post: http://jesseliberty.com/2012/11/08/yet-another-podcast-80miguel-de-icaza-mono/

Thanks for the mentions :) I really want to know what the product next year is now :)

Saturday, November 17, 2012

AlphaLabs Node Garden - adding speech

My first attempt at a play with the AlphaLabs Node Garden.

I thought using the screen was too much like manual labour - so I thought I'd try voice control.

The verdict - wow, is it simple to add voice control to your apps!

AlphaLabs - Node Garden with Speech from Stuart Lodge

+private async Task StartRecognizeAsync()
+{
+    var speechRecognizer = new SpeechRecognizer();
+    speechRecognizer.Grammars.AddGrammarFromList(
+                "answer",
+                new string[]
+                    {
+                        "Left", "Right", "Up", "Down", "AlphaLabs", "Centre"
+                    });
+    while (true)
+    {
+        var result = await speechRecognizer.RecognizeAsync();
+        if (result.TextConfidence != SpeechRecognitionConfidence.Rejected)
+        {
+            await ProcessResult(result);
+        }
+        else
+        {
+            Debug.WriteLine("No text!");
+        }
+    }
+}
+private async Task ProcessResult(SpeechRecognitionResult result)
+{
+    Debug.WriteLine("Yes! {0}", result.Text);
+    var x = _myNode.X;
+    var y = _myNode.Y;
+    switch (result.Text)
+    {
+        case "Left":
+            x -= 100;
+            break;
+        case "Right":
+            x += 100;
+            break;
+        case "Up":
+            y -= 100;
+            break;
+        case "Down":
+            y += 100;
+            break;
+        case "Centre":
+            x = 240;
+            y = 400;
+            break;
+        case "AlphaLabs":
+            await DoAlphaLabsSequence();
+            x = 240;
+            y = 400;
+            break;
+    }
+    _myNode.SetPosition(x, y);
+}
+private async Task DoAlphaLabsSequence()
+{
+    _myNode.SetPosition(10,10);
+    await Task.Delay(1000);
+    _myNode.SetPosition(10, 790);
+    await Task.Delay(1000);
+    _myNode.SetPosition(470, 790);
+    await Task.Delay(1000);
+    _myNode.SetPosition(470, 10);
+    await Task.Delay(1000);
+    _myNode.SetPosition(110, 210);
+    await Task.Delay(1000);
+    _myNode.SetPosition(110, 590);
+    await Task.Delay(1000);
+    _myNode.SetPosition(370, 590);
+    await Task.Delay(1000);
+    _myNode.SetPosition(370, 210);
+    await Task.Delay(1000);
+}

view raw Added to MainPage.xaml.cs hosted with ❤ by GitHub

+public void SetPosition(double x, double y)
+{
+    if (x < 0)
+        x = 0;
+    if (x > 480)
+        x = 480;
+    if (y < 0)
+        y = 0;
+    if (y > 800)
+        y = 800;
+    this.X = x;
+    this.Y = y;
+    UpdateGardener();
+}
+public void UpdateGardener()
+{
+    this.gardener.UpdateSelfNodePosition(this.X, this.Y);
+}
+// Also remove the Update override
+// public override void Update(Size canvasSize)
+// {
+// }
+// And in the constructor, add:
+public MyVisualNode(Random rand, Canvas mainCanvas, NodeGardenLib.Gardener gardener)
+    : base(rand, mainCanvas)
+{
+    // ...
+    // existing code...
+    // ...
+    this.DisableVirtualMovement = true;
+}

view raw Added to MyVisualNode.cs hosted with ❤ by GitHub

	<Capability Name="ID_CAP_MICROPHONE" />
	<Capability Name="ID_CAP_SPEECH_RECOGNITION" />

view raw In the capabilities, add: hosted with ❤ by GitHub

	// in Update(Size) change:

	if (Math.Abs(this.CurrentX - this.X) > 0.5 && Math.Abs(this.CurrentY - this.Y) > 0.5)

	// to an OR test like:

	if (Math.Abs(this.CurrentX - this.X) > 0.5 \|\| Math.Abs(this.CurrentY - this.Y) > 0.5)

view raw In VisualNode.cs fix hosted with ❤ by GitHub

wp8: speech is off until your new language pack has been installed

If you see the error 'speech is off until your new language pack has been installed'

Then this might just be because you've switched your phone from one language to another.

To get over this problem...

go to Speech in Settings
tap on the language box
choose your language (even if it's your existing language)
you'll then be asked to download it.... (needs WiFi really)
after the download, the phone will need a reboot...

The speech privacy policy was not accepted prior to attempting a speech recognition

If you are trying to use SpeechRecognition and you see this general Exception - "The speech privacy policy was not accepted prior to attempting a speech recognition" - or possibly you see the "The text associated with this error code could not be found."...

Then the answer is http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj662934%28v=vs.105%29.aspx#BKMK_Handlingthespeechprivacypolicyerror

Basically - try pressing and holding the start key - then getting the user to accept the terms and conditions...

Also, in your own app... it seems like maybe you need to be sure you are requsting the speech recognition in an async call on the UI thread?

Some low light pictures taken with a Nokia 920

I took a Nokia 920 out for a run this morning.

It was a real Autumn day... rainy... overcast... gloomy...

Which made it perfect to test out the PureView floating lens in the 920 :)

These photos are just 'snaps' taken on the run... and the deer in Bushy Park weren't being at all friendly... but I'm definite that 'yes, the 920 has a quite nice camera!'

Friday, November 16, 2012

Aviva - Drive.... An MvvmCross Testimonial

Back at the end of the Summer I got this email through from a Solution Designer in Aviva - a very large UK Insurance company:

Thought you'd like to know that we are using MvvmCross in our RateMyDrive app that is currently being Beta tested: http://www.aviva.co.uk/ratemydrive/

There's been a fair amount of press about it, and it's even been on the telly: http://www.bbc.co.uk/iplayer/episode/b01m9396/Click_18_08_2012/ (fast forward to 9:08)
So a big thank you for the major contribution your framework has made to this project. It has allowed us to share the complex algorithms for deriving the driver rating scores between Android, iOS and Console/Test apps. In fact 90% of the code is shared and easily testable.

This project is still ongoing - http://www.aviva.co.uk/drive - and I think the above quotation says everything you need to know about MvvmCross.... :)

If you've been using MvvmCross, and you have any feedback, then please do send it to me :)

Hackery and WitchCraft - First AutoViews running on MonoTouch too

Following on from the MonoDroid work, I've started pushing some MonoTouch changes now for AutoViews too...

And after only a few hours - mostly filled with Reflection swearing - I now have this list view:

and this Dialog view:

These screens generated from the exact same code and JSON as the Droid UIs in Another update on the Default UI work for MvvmCross....

There's still a lot of code to write... and lots of debugging to go... especially when I move to release builds on real devices....

But so far so good :)

Thursday, November 15, 2012

Free icons for ASP.Net, WinRT and WP development...

These are some of the icon sets I've used in the past - generally Creative Commons - and always used with attribution.

For maps:
http://code.google.com/p/google-maps-icons/

For general use:
http://www.famfamfam.com/lab/icons/
http://code.google.com/p/fugue-icons-src/ - preview at: http://p.yusukekamiyamane.com/icons/preview/fugue.png

For WinRT/WP7
https://github.com/Templarian/WindowsIcons

- plus SyncFusion have a free set which is growing big now - http://www.syncfusion.com/downloads/metrostudio

- plus BootStrap from Twitter has some interesting icons built-in