wicked programmer
helping developers everywhere innovate and learn
  • Home
  • Events
  • Publications
  • Learning
  • About

General/ Learning

Daily Learning – Fix your database project needing a reference to .NET Framework

Wicked ProgrammerSeptember 8, 2018

Recently we were doing some work on ASP.NET Core Identity.  We created a SQL Server database project to contain the database and imported the existing database.  Unfortunately, we kept getting the following error on build.

Read More –

General

Cross Platform Applications using Visual Studio

Wicked ProgrammerAugust 19, 2017

Introduction

This is the first article in a series of articles on how to use Microsoft’s Visual Studio 2017 Enterprise and Visual Studio 2017 for Mac Enterprise to build cross-platform applications that target Windows, Android, iOS, and Mac.

For the purpose of this series, we are going to build an advanced application called “Hello Zoom” which integrates with the Zoom SDK.  Zoom is a platform for building applications that incorporate video, voice, and screen sharing platform.

Along the way, we are going to discuss topics such as building native applications, using native libraries, and dependency injection.

 

Prerequisites

Visual Studio 2017 Enterprise
Visual Studio Enterprise 2017 for Mac
Xcode
Android SDK
Zoom SDK

The holy grail of application development is the ability to write an application once and target multiple platforms simultaneously.  These types of applications are known as cross-platform applications.  They span multiple platforms such as Windows, Mac, iOS and Android and multiple devices such as iPhone, iPad, Android Phones, Laptops, and PCs.  At MILL5 we have extensive experience in building cross-platform applications using a variety of tools and frameworks such as Angular, Ionic, Framework7, PhoneGap, and Visual Studio for Mac.

One of our favorite tools for building cross-platform applications is Visual Studio for Mac (formerly Xamarin Studio).  Visual Studio for Mac is the replacement of Xamarin Studio which was acquired by Microsoft after the purchase of Xamarin.  Visual Studio for Mac gives us the ability to access the full capabilities of the underlying platform as well as running native code on the devices. This eliminates several complaints when building cross-platform applications such as access to platform capabilities (ex. cameras, location, video), native look-and-feel, and performance.  This is especially important for applications that require direct access to platform capabilities such as camera, location, and video.

We will demonstrate building a cross-platform application using Visual Studio using sample application.  We have chosen to build an advanced sample application, called “Hello Zoom”, that targets both desktop and mobile devices on multiple platforms.  In this series of articles, we will create an application that targets Windows, Mac, iOS, and Android.  From there we will look at what needs to be done to share common code, use native libraries on each platform, and build both cross-platform and native user interface components.

So what is “Hello Zoom”?  Zoom is a video conferencing solution from Zoom.  “Hello Zoom” is a sample application that integrates with the Zoom SDK to join a meeting (i.e. video conferencing).  We chose this application because there are many interesting solutions that can be built based on video conferencing and it affords us the opportunity to discuss more advanced topics like native user interfaces and leveraging platform capabilities.

At the time of this article, Zoom does not support the .NET platform directly.  What this means is that Zoom does not provide native .NET libraries.  Instead, they provide libraries which are based on C++, Objective-C, and Java.  These are platform specific languages.  For example, C++ is for Windows, Objective-C for Mac OS X and iOS, and Java for Android.  This represents an interesting challenge of “How do we talk to the Zoom library from .NET?”.  This is a challenge that cross platform developers face often.  If you are lucky, you will find a cross platform component that is published to a package repository like the NuGet gallery.  Even then, you hope that the cross platform component is built in such a way that it is usable for your needs.  In this case, we are not so lucky since there is no cross platform component available.

At this point you might ask “Why would you build an application that is cross platform?  Why not go with native tools such as Xcode and Android Studio?”.  There are so many reasons.

First, is time to market.  If you have ever needed to build an application that targets multiple platforms, you are faced with building an application for each platform.  That means you have to build and test every aspect of that application for each platform you target.  That includes the business logic, user interface, and every other component needed to create the application.  Cross platform applications simplify this effort by offering the ability to reuse code across each platform.

A question that often arises is “How much code can you reuse?”.  For this sample application we will demonstrate reuse of business logic and user interface components.  We would like to see 70% or more reuse before considering cross platform development.  Using Visual Studio for Mac we expect to see much higher code reuse, 70 to 95 percent, in production scenarios.

Second, is consistency.  The application we are about to build is a great example of this.  When you look at the Zoom SDK, you will see that Zoom has taken liberties with their libraries on each platform.  What that means is that there are differences such as naming, method signatures, and even features.  By creating a cross platform component we are able to build the same application across many platforms with a consistent set of capabilities.  This means a common set of features using the exact same API.

Third, is common user interface.  This is a choice.  There are many products and technologies that offer the ability to build common user interfaces.  Each product and technology that offers the ability to create a cross platform user interface has their own advantages and disadvantages.  Most take a least common denominator approach to building user interfaces.  They often leverage technologies that are available on all platforms (ex. HTML) for building user interfaces, but lack the native capabilities of the underlying platform.  Some offer great performance, others do not.  Your choice of a cross-platform user interface technology should be based on the experience you want to create.

You must choose, but choose wisely.  The true Grail will bring you life, the false Grail will take it from you. – Grail Knight

Here at MILL5 we have experience building common user interfaces using a variety of products and technologies.  For our sample application we are going to use Xamarin Forms.  Xamarin Forms offers the best of all worlds, a cross platform user interface  technology with native capabilities, look-and-feel and performance.  To understand this choice, we will discuss a very common set of cross platform user interface technologies:  HTML, CSS, Angular, and JavaScript.

Many of our customers want to build applications using web-based technologies such as HTML, CSS, Angular, and JavaScript.  When it makes sense we are able to build some amazing applications using these technologies.  However, in this situation, we need to build a cross platform application that targets mobile and desktop, target a variety of devices formats such as tablet and phone, and needs access to native capabilities of the underlying platform.  Web-based technologies are not really suited for this broad set of capabilities.

Using HTML, CSS, Angular and JavaScript alone is not enough to build a cross platform user interface.  Often you need to leverage additional libraries and frameworks such as React, Dojo, Framework7, Ionic, Material, Aurelia, Durandal, Sencha Touch, and Kendo UI.  These frameworks layer on top of technologies such as HTML, CSS, Angular, and JavaScript to help you build responsive web-based user interfaces.  This allows you to build a single common user interface that targets multiple devices and platforms while reducing your development time.

One of the big advantages regarding web-based applications is the plethora of choices for libraries and frameworks available to you as a developer.  Having so many choices presents itself with additional challenges such as …

  • “Which libraries and frameworks do you pick?
  • “What is the adoption of each library or framework?”
  • “Are these frameworks truly cross platform or do they just target a subset of devices?”
  • “Can I find developers that know these libraries or frameworks?”
  • “Are these libraries or frameworks supported by the developers that created them?”

These are just some of the questions you need the answers to when building web-based applications.  This is why the plethora of libraries and frameworks available to web developers is also a big disadvantage.  You must be disciplined when choosing the libraries and frameworks available to you so that you can limit yourself to those libraries and frameworks that give you the best adoption, longevity, and support for your application.

Another important requirement is the ability to access native capabilities on the device.  In our case we are accessing a third-party library (i.e. Zoom) that needs access to native capabilities such as video, camera, networking, Bluetooth, and more.  This is not possible with a web-based application unless you leverage more advanced products such as Adobe’s Cordova/PhoneGap or Appcelerator’s Titanium.  These products allow you to build web-based applications that is hosted in a native shell application (i.e. container).  This allows your web-based application to access native capabilities such as cameras, location, accelerometer, and contacts, through a plug-in architecture.  In our situation there is no plug-in that is available to leverage the Zoom SDK from either PhoneGap or Titanium.  We could try and create our own custom plug-in, but unfortunately that too is not possible.  The Zoom SDK’s application programming interface has native user interfaces components for navigation, video, and settings.  Using a web-based application makes integrating with these native user interface components extremely difficult, if not impossible.

Xamarin.Forms has none of these challenges.  A user interface built using Xamarin.Forms is really just a set of views and controls that are mapped to platform-specific native user interface elements.  For example, a Xamarin Forms Entry becomes a UITextView on iOS, an EditText on Android, and a TextBox on Windows.  This is why a user interface using Xamarin.Forms is in fact a native user interfaces and when needed, you can also instantiation and interact with native user interface elements directly.

Summary

In this article, we introduced our sample application called “Hello Zoom”.  This is a video conferencing application that allows us to join a meeting.  We set the premise for building our cross platform application using Visual Studio.  Our sample application will target four platforms: Windows, Mac, iOS, and Android.  We will leverage .Visual Studio, NET and Xamarin.Forms to access the native capabilities of each underlying platform and achieve a significant amount of code reuse.  In the next article, we will start development by creating our solution for building our application using Visual Studio.

General

Here @ MILL5–Part 1

Wicked ProgrammerJune 25, 2017

Back when we started MILL5 I was asked “What are you doing?”  “Are you starting a consulting company?”  “Are you starting a product company?”  “What are you trying to do?”  “Why are you doing this?”

Back then [prior to MILL5] I would have told you that I was tired of unfulfilled promises, being overworked, and being generally taken advantage of.  I was in a situation where I loved what I did, but I always felt like I was being limited in some way.  I knew there was something better awaiting me.

For many years, I had been trying to start a company with my longtime friend, Shri Bhupathi.  Shri and I had made several attempts over 14 years to work together only to have our day jobs get in the way.  In late 2015, it became apparent that we had an opportunity to start MILL5.  That is when we finally jumped at the chance to work with one another again.  This time it was going to be on our terms.

Our goal was simple.  Build a company that we would be happy to work at.  We would build this new company based on a set of core principles.

Principle #1 – Hire good people and treat them like family

Every company says they want to hire good people.  We are no exception.  However, once we hire someone, we invest a lot of effort to ensure that they are treated like family.

You spend one-third or more of your work day with people other than your own family.  You may even spend more time with your work colleagues than your own family.  That is why it is important to us that each and every employee is treated well.

Principle #2 – Hire passionate people

If you are passionate about what you do, then you will always being having fun.  This is such a simple concept, but so true.  Your job is no longer work if you are doing what you love to do.

Principle #3 – Hire constant learners

Learning is engrained in our culture.  People that are improving themselves by constantly learning new things are often on the forefront of technology.  We believe this is the cornerstone of innovation for both our customers and for the products that we build.

Principle #4 – Hire unselfish people

We have seen the negative impact that a bad hire has on a company.  Candidates need to be able to put others first.  Successful candidates should clearly demonstrate that their priorities are company, team, self — in that order.  This helps us weed out the “whiners, empire builders, and self-servers.”

Principle #5 – Empower people through better leadership

True leadership comes when you empower others.  We believe in servant leadership which puts the needs of others first and helps people develop and perform as highly as possible.

Principle #6 – Don’t promise something you cannot deliver on

We have seen the negative impact of promises which are not met.  That is why it is important to us that we deliver on promises that we make.  It is also why we don’t make promises that we believe we cannot deliver on.

Principle #7 – Recognize and reward greatness

We do not believe in rewarding mediocrity.  Showing up and doing your job is a requirement when you come to work.  It is what happens when you, your team, or the company goes above and beyond and achieves greatness.  This is when we want to recognize and reward people.

These principles have helped us build an amazing company in a very short period of time.  In the next post we will cover what we have done to embody these principles.

General

IDisposable and The Finalize Method

Wicked ProgrammerJanuary 1, 2017

I have been working with .NET since 2001.  That is when I joined Microsoft and spent the next 10 years helping customers architect and build amazing applications on the .NET platform.  Often my role is to lead a team of developers helping them build amazing software.  Even though .NET has be around for many years, there are still developers that do not understand the use of IDisposable interface and the Finalize method.  Proper understanding of the IDisposable interface and the Finalize method is critical to creating a good .NET application.

#1 – .NET manages memory for you

.NET provides a feature known as automatic memory management.  Memory allocated by .NET [aka managed memory] does not need to be explicitly released. This frees developers from the tedious and difficult task of releasing memory.

Except for advanced scenarios, you should not be trying to manage memory.  .NET manages memory for you through the use of garbage collection.  The following article has a simple explanation of the garbage collector.

“The .NET garbage collector manages the allocation and release of memory for your application.  Each time you create a new object, the common language runtime allocates memory for that object.  The runtime continues to allocate memory for new objects.  However, memory is not infinite.  Eventually the garbage collector must perform a collection to free some memory.  The garbage collector will determine the best time to perform a collection based on the allocations being made.  That time is nondeterministic.  When a collection occurs, the garbage collector will checks for objects that are no longer being used by your application and performs the necessary operations to reclaim memory.” – Garbage Collection, MSDN

What does this mean for you?  Easy!  You do nothing to manage memory because it is managed for you by the .NET garbage collector.  Hence the term “managed memory”.

#2 – Know thy “unmanaged resource”

For the majority of the objects that you create [in .NET] you can rely on the .NET Framework’s garbage collector to handle memory management.  While .NET manages memory for you, there are situations where you will use resources that are not allocated by .NET.  These resources are referred to as “unmanaged resources”.  Unmanaged resources are not allocated or managed by the .NET runtime.

The most common types of unmanaged resources are objects that wrap operating system resources, such as files, window handles, and network connections.  Another common unmanaged resources used by developers are database connections.  Two classes that use unmanaged resources are SqlConnection and FileStream.  Each time you create and use an instance of either of these classes you are allocating unmanaged resources.

One potential way to identify a class that uses unmanaged resources is if they implement the IDisposable interface.  The IDisposable interface provides a mechanism for releasing unmanaged resources.  Unfortunately a class can use unmanaged resources without implementing IDisposable.  Fortunately most classes in .NET that use unmanaged resources implement the IDisposable interface.

#3 – You are responsible for releasing unmanaged resources

The garbage collector was specifically designed to release managed memory and does not know about unmanaged resources.  That means that anything not controlled by the garbage collector should be explicitly released.

So how does one explicitly release unmanaged resources?

The Common Language Runtime (CLR) provides a mechanism known as the Finalize method.  The Finalize method (aka finalizer) provides a mechanism for objects to free resources and perform other cleanup operations before an object is reclaimed by the garbage collector.  Any object that implements a finalizer is eligible to have their Finalize method called by the garbage collector.  The garage collector will call the finalizer under the following conditions.

  • When an objects is determined to be inaccessible by the garbage collector and the object has not become exempt for finalization by a prior call to the GC.SuppressFinalize method.
  • During the shutdown of an application domain, unless the object is exempt from finalization.  Any object that is accessible will have their Finalize method called at shutdown.

There are many limitations to using the Finalize method (see Object.Finalize for more details).  The biggest limitation is that the time when the Finalize method is called is nondeterministic.  To ensure deterministic release of unmanaged resources you need to provide an implementation of the IDisposable.Dispose method.  When a developer calls your Dispose method it is your responsibility to release any unmanaged resources.

Summary

After reading this post you should come away with three key takeaways.

  • .NET manages memory for you and you do not need to do anything to help the garbage collector or to manage memory.
  • There are resources that are not managed by the .NET runtime.  These resources are referred to as unmanaged resources.
  • It is your responsibility to explicitly release unmanaged resources preferably by calling IDisposable.Dispose from your code.

This is the foundation from which we will build best practices for the proper use and implementation of the IDisposableinterface and Finalize method.  We will cover at least two more articles, “Myths About Garbage Collection” and “Proper Implementation of IDisposable”.

Resources

These articles were used in the creation of this blog post.  I suggest that you read them once you are done reading this series.

  • Dispose Pattern
  • Implementing Finalize and Dispose to Clean Up Unmanaged Resources
  • System.IDisposable
  • Object.Finalize Method()
«‹3456›»







Back to Top

© wicked programmer 2023