Thursday, 13 August 2015

Experiences from using existing projects within VS2015

I've been using VS2015 since an early preview at home but now it's launched I've been trialling it with many of our solutions within work trying to iron out any associated pain before we upgrade every developer (that hasn't already ;)).

One thing I've noticed across a few of our web projects that's caught a few people out is an issue with the new version of IIS Express, and actually if we ever got to deploying to IIS 10.

For many of our web projects we have added additional mimeTypes via the web.config to allow IIS to serve up woff2 files, previously you would have done this via:

        <mimeMap fileExtension=".woff2"mimeType="application/font-woff2" />

However IIS 10, and therefore IIS Express 10, now handles this mimeType automatically. When you run your existing projects via VS2015 you will find all of your websites styling and images suddenly disappear. This can be quite alarming and confusing as the dynamic ASP.Net content loads fine, but all of your static content doesn't.

By using dev tools to investigate the request and response for one of the static resources you will find:
 Failed to load resource: the server responded with a status of 500 (Internal Server Error)
When you then look at the response you find:

HTTP Error 500.19 - Internal Server Error

The requested page cannot be accessed because the related configuration data for the page is invalid.

Config Error   Cannot add duplicate collection entry of type 'mimeMap' with unique key attribute 'fileExtension' set to '.woff2'

This nicely points out the issue, the static file handler already knows about the woff2 mimetype, the trick now is how to solve this for IIS 10 but still maintain the fix for older versions. This is as simple as removing the existing mimemap for the fileExtension before adding it.

        <remove fileExtension=".woff2" /> 
        <mimeMap fileExtension=".woff2" mimeType="application/font-woff2" /> 

This seems a bit mad as I had expected that if an add duplicate would fail wouldnt a removal of a non existing item, but meh it works ;)

So there we have it an odd issue that's actually really simple to resolve. I hope any other issues I find are as easy to fix ;)

Wednesday, 5 August 2015

Developing a Microsoft Band App Using Windows Universal Apps i.e Windows 10

Last week I finally picked myself up a Microsoft Band and instantly started thinking about potential app ideas and that's where they were left, as thoughts :) However unfortunately I also got knocked off my bike last week and ended up with a fractured elbow (at least this is all it was). Today I finally got my sling off and have been given a ton of Physio exercises so I can actually get my arm moving properly again, at the moment it sucks.

These Physio exercises have to be done every hour in order to ensure I regain full mobility of my arm but it's kind of a drag to remember. I started by simply using the Band's Countdown App to remind me to do these, but whilst traveling this afternoon I thought of writing an App that not only reminded me to do these exercises but also logged and could display how many iterations of the exercises I performed and how fast etc. Needless to say tonight I started playing with the Band SDK and decided to start a series of blog posts that outlines how I get on and things I learnt etc.

Stage One - Getting a Windows Universal App up and running.

I started off by getting a new Windows Universal App created and then using Nuget to install the Band SDK Package [Microsoft.Band]. I then looked through the Microsoft Band SDK documentation on how you need to set things up etc. Here's where I noticed that the documentation and infact a lot of the SDK is all targeted at Windows 8.1 but I'm trying to write for the Windows 10 era. So for Universal Windows Apps where in the SDK documentation it talks about "Windows Store Applications Capabilities" you need to do the following:

  1. Open Package.appxmanifest and navigate to the Capabilities tab
  2. Then scroll down to the Proximity checkbox and enable it
  3. Right click your package.appxmanifest within solution explorer and select View Code. Note: if this is still open from the previous step you'll be prompted that the designer will be closed.
  4. Navigate to the Capabilities XML Node and add the following to the bottom:
<DeviceCapability Name="bluetooth.rfcomm">
   <Device Id="any">
    <!-- Used by the Microsoft Band SDK -->
    <Function Type="serviceId:A502CA9A-2BA5-413C-A4E0-13804E47B38F" />
    <!-- Used by the Microsoft Band SDK -->
    <Function Type="serviceId:C742E1A2-6320-5ABC-9643-D206C677E580" />

With this done you can then follow the other code samples within the SDK documentation which I won't document here. What I do want to mention is how on first appearances is quite easy and clear to use. You ensure you have permissions to use a sensor, you start / stop collecting readings and readings are raised via events with some easy to understand structured types, and as you'd expect it's all async. :)

In my next post I'm going to talk about how I've decided to make use of some of the sensor data and how to manage the sheer volume.

Monday, 2 June 2014

My Favourite Visual Studio Features #myVSUK

It's been really interesting to read some of people's submissions for the Visual Studio Features competition. Quite varied.

I thought I'd add my top 5 into the mix, although I've probably missed the deadline :)

1 - Test Explorer

Test Explorer, Docked Left in my Main Window

I really love having Test Explorer baked in, especially when the XUnit runner is installed. Previously I used to use ReSharper's test manager but now I pretty much only use this. The addition of playlists in VS2013 has also helped.

You can run tests automatically after build, search your tests and group in various ways. One of my most used features.

2 -  Navigate To or as I say Ctrl + T

Finding those Test Types are now just one Key Combo away :)

This is another feature I used to use Resharper extensively for, the ability to quickly find a type by name. Just hit Ctrl+, start typing, instant win :)

3 - Server Explorer with Azure Integration

Managing and Viewing Azure Services is now simple
Before I got VS2013 I was often using 3rd party management tools for viewing my Azure resources, be this storage or just general management of what I use, this used to work well but then I started using Server Explorer and everything changed. Its amazing how just having the tight integration within VS means everything feels much quicker, less context switching etc. Everything is presented well and you can easily add / remove services from within VS no more having to login into the portal.

As much as I love this feature it does have a few issues, for me it seems to constantly forget my login details, so if I happen to have VS crash or have rebooted I have to re login, as my account uses 2-Step Authentication (Which everyone's should ;)) it's a bit of a faff.

4 - Editor Extensions

If only VS could do this.... Oh look an extension...

This may seem like an odd feature to include but I think having Extensions within Visual Studio is a game changer. You have always had the ability to install IDE extensions, Resharper etc however they were always "drawn on top" or didn't feel quite native. Now that the IDE has been redesigned to be fully extensible, the editors. test explorer etc, your experience can be greatly enhanced by some simple extension that is fully integrated.

Personally I wouldn't be without Web Essentials, Productivity Power Tools, Chutzpah, XUnit Runner

I even know friends and colleagues who write extensions just to make their lives easier.

5 - Full VS Colour Schemes

Which theme do I use today...

I debated adding this to my list, I know other's have said Intellisense, IntelliTrace etc which are great features however I think its often underestimated the effect changing the VS Theme has.

I've always changed my editor area theme from the default to often something dark, I've blogged about this before, but now having the full IDE change really reduces the clashes and I think looks better and improves the overall integrated feel. I loved blend having the dark theme so now VS has I'm happy ;)

Depending on how I'm feeling, and more often how my eyes are feeling I sometimes switch between blue and dark.

And there we are 5 of my favourite Visual Studio IDE features :)

Friday, 30 May 2014

The importance of all-age user testing and the UIButton Touch Area

Of late I have been getting various users to try out an iOS app I have been building using Xamarin.iOS, and I got some interesting feedback which I thought I'd share.

The app runs on iPod Touch's / iPhone's so a common platform. One of the areas people commented on was Ease of Use. Interestingly most people commented that the app felt natural and looked easy to use, however about 30% of my responses contained "I struggled to accurately tap the response icons", "I kept missing the buttons and began to get frustrated", "Wearing gloves seemed to make it harder to tap the icons".

My first response to this was "really?", The icons by my standards were fairly large and didn't look too small, in fact I deliberately made them slightly larger than Apple's recommended 44x44 [ref:]

So I found out more information from the affected users. Turns out all of my users that struggled to tap the icons were aged 40+ and the majority of which had larger than average hands, note I only did a quick visual, no measurements made :)
The observed problem

This left me with a decision to make, let the users simply get used to the hit area and hope they wont get frustrated and give up, increase the icon sizes further and have to rethink parts of the app design or could I add an error margin on to each icon tap and therefore increase the perceived target area.
The Hit Area I Wanted

I decided simply getting the users to get used to the sizes wasn't an option, so for now I will increase the target area for each icon and leave the visual design alone, I'm sure my designer will thank me later.

This is actually really simple to do.

First of all create a new class that inherits UIButton, I'm calling mine OverhitUIButton, and then override the PointInside method. This method simply takes a point and returns whether the point is within the current UIView (UIButton). I then changed this to see if the point exists within a configurable extended boundary for my UIButton instead of the real boundary. That's it no messing around with the HitTest method or anything, simply test for the point in an extended boundary.

public class OverhitUIButton : UIButton
    private int _errorMargin = 30;

    public override bool PointInside(PointF point, UIEvent uievent)
            var bounds = Bounds.Inset(-_errorMargin, -_errorMargin);
            return bounds.Contains(point);
    public int ErrorMargin
            return _errorMargin;
            _errorMargin = value;
It's worth noting I made the error margin configurable as depending on how the icons are spaced I might not want as large a hit area. From my own testing I noticed if had 1 icon in the middle of the screen I didn't need as large as hit area, however if I had a row of icons the ones at the extreme edges of the screen needed a larger hit area. I also used 30 as my default value just as this felt the most accurate without feeling over extended.
This update is only going into my next beta so I will report back on whether my users found this made touching my icons easier, based upon my own testing I noticed the difference so I am hoping others will. 

Thursday, 15 May 2014

Using LinqPad to replace my "test" console applications

I've used LinqPad since... well forever :) I've had the free version since the early days and then paid for the full thing when I started out on my own a few years ago. At the beginning I was mainly using it for quick testing DB queries and quick idea jottings without thinking about big architectures etc, basically a scratchpad, and it's always worked well for me. Even more so after I started using it to connect to Azure using the Azure Table Storage driver.

Another thing I have always done, even when I have lots of unit tests, is to often have a console app in most of my API projects. Be this WebApi or older ones using MVC or WCF. These exist to test the client libraries for the API's that I have written which integration easier. These console apps mainly have a few methods that allow me to easily and quickly try out my service api's. Be this querying, uploading / downloading files etc.

These console apps aren't instead of unit tests or integration tests but allow me a quick convenient way to test development / stage / live api end points without firing up VS or having to worry about what credentials I need etc.

Today I almost fell into "lets add a console app into a new project" but I had a brainwave. Why not use LinqPad to write these "apps" and then store them in my solution with source control etc? Thus avoiding unnecessary additional projects, compile times etc. LinqPad allows you to save queries as .linq files and if I create several can be opened by anyone with LinqPad and be ran within seconds. No open project, compile, run etc.

The process is dead simple. First I opened LinqPad and created a new query. I then switched the language from C# Expression to either C# Statements or C# Program. I generally find C# Statements is enough but if I'm trying a few thing out programs are sometimes easier to manage.
1 -Change Language Type

2 - Finding Query Properties
I then needed to reference my "client" libraries. It seems no matter how many times I do this after a week off, or sometimes less; I blame lack of sleep / caffeine depending on the day, I always forget how to do this. It's actually DEAD simple. Simply bring up query properties by either pressing F4, bringing up the context menu within the query editor or by choosing query in the menu and choosing the bottom option.

Once this is loaded you can easily add references by either finding the assemblies on disk or even via nuget directly which is very cool. Once the assemblies are referenced click the additional namespace tab and pull in the namespaces you'll want to use in your script. You can do this later but it often saves time to do this once the window is open.
3 - Choose References, even with Nuget

4 - Write the test script and run
With the query properties now set you can then enter your scripts for testing. You can even async/await which is handy as most things now I write are async.

Finally just save the query into your solution and you can open it when ever you need too.

And that's it, So far I find this quick and easy and it will be great to come back at a later date and know replaying things against stage / live will be one click away.

As a bonus point, whilst writing this post I thought what about using HttpClient to try out new third party client rest api's or client libraries. Simply really quick iterations before writing a concrete implementation with the full test suite etc. Something I will explore properly at a later date.

For today this works fantastic for me but I have thought it might be worth looking into ScriptCS as an alternative however I'm not sure if I prefer having the LinqPad IDE with autocompletion etc. I'll to need to investigate but that is for another day.

Hope this helps.