Jumpstart Your Xamarin App Development
This guide will help .NET developers get started with making cross-platform mobile apps to thrive in the ecosystem of their choice.
Join the DZone community and get the full member experience.Join For Free
So you want to build a mobile app? Your developer zen will quickly be threatened by the plethora of ways you can go about building a modern, cross-platform mobile app today. The below illustration shows an assortment of just a few of the technologies that you can use and the most common frameworks/platforms used for each.
This is what we have done to ourselves over the last 10 years. Choice is a good thing for developers, except that too much choice can become a little crippling.
On a positive note, the choice of technology stack becomes much easier once you decide to focus on what matters most — your skills and expertise. In today's age, you really want to build truly cross-platform mobile apps from single codebase and preferably have the app be native to each platform. If your developer background is .NET, you'll possibly lean towards using C# with Xamarin.
Xamarin lets you build modern cross-platform mobile apps using your .NET skills. You write C#/XAML and your code gets cross-compiled down to native bits on each platform. This article walks you through some essential tooling that you should have in your arsenal for Xamarin development, as well as how to jumpstart your app with some polished UI.
When it comes to Xamarin development, you get two rich Integrated Development Environments (IDEs) to choose from:
Both IDEs sport some common features for ease of development:
- Rich Intellisense support for code completion;
- Intelligent typing assist for iOS/Android API mappings;
- Built-in Xamarin project templates;
- Easy code navigation and IDE configurations;
- Switchable light and dark themes;
- Choice of various device emulators with varying screen sizes;
- Easy debug options for both emulators/device deployment;
- Publish apps to stores directly from the IDE;
- Integrated version control;
- Robust User Interface Designers for iOS/Android.
Both Visual Studio and Xamarin Studio come in completely free yet feature-rich Community editions. You do have to keep a couple of limitations in mind, though:
- Visual Studio on Windows will need a Mac to act as an iOS build host running XCode – this is an Apple licensing requirement. The Mac could be hard wired to the Windows development machine, somewhere on the network or in the cloud. In fact, with the recent iOS Windows Simulator, you do not ever have to leave the comforts of Visual Studio – the simulator will stream the iOS emulator from the Mac.
- Xamarin Studio on Mac can only target iOS and Android, but not Windows. The app solution from Xamarin Studio could, however, be brought over to Visual Studio on a Windows development machine later to add a Windows-supporting project, while still leveraging the common Portable Class Library (PCL) for code sharing between platforms.
Now, once you have begun your Xamarin app development, you'll want to keep a few tools in your arsenal – these aren't necessary, but often make your life easier. Most are usable within the comforts of your beloved IDE.
- NuGet – As the de facto package manager for the .NET ecosystem, NuGet will faithfully serve your Xamarin projects as well. Bring in your favorite .NET libraries, services and utility wrappers.
- Xamarin Component Store – Your Xamarin app needs awesomeness and you do not need to reinvent the wheel. Augment your app with polished UI components, service SDKs and various cloud/social integrations – all from one component store.
- MVVM Light – Bring some structure and sanity to your Xamarin apps by following the established Model-View-ViewModel (MVVM) pattern and including the MVVM Light framework. You get out-of-the-box features like commanding, messenger, inversion of control (IoC) and INotifyPropertyChanged UI data binding implementations.
- Prism for Xamarin.Forms – Have you used and liked Prism for past XAML development? Now you can bring the Prism fun to Xamarin.Forms development with a NuGet package and an optional Prism Template pack to get you started. You get to leverage built-in MVVM features like commanding, ViewModelLocator, event aggregator, navigation, and IoC with Unity.
- XUnit – This is the perfect open source unit testing framework for your Xamarin apps – both for PCLs and device-specific projects. Simply get a NuGet package in your project, write some unit tests and run them against your app, either through the command line, MSBuild or using the iOS/Android test runners.
- Xamarin WorkBooks – Need a playground as you are building your Xamarin apps? Like experimenting with native API features, want to document a functionality for someone or simply see your tentative code in action? You're in luck with the newly introduced Xamarin Workbooks – a standalone application that allows for building interactive documents with executable live code outside of any apps. You could run code-fenced C# blocks inline or inside iOS/Android simulators. It's perfect to try out or share new features before adding them to your app.
- Xamarin Test Cloud – Your professional Xamarin apps should not be at the mercy of mobile device idiosyncrasies. And let's face it, there are a plethora of devices across various platforms that may run your Xamarin app. The solution is Xamarin Test Cloud. You can automate app testing on 2000+ real devices, all running in the cloud. Increase confidence in your app by testing user interactions on real devices to find bugs, with complete memory and performance analysis. Get polished reports, fix problems and repeat – that's how you ship high quality apps.
- PreBuilt Apps – Jumpstart your Xamarin app development with a polished pre-built app – showcase apps with open source code in GitHub. Peruse unique features or incorporate UI components to give your Xamarin apps a flying start.
Leveraging Open Source
As if the Microsoft acquisition of Xamarin wasn't big enough deal, sweeter news greeted .NET developers in early 2016 – Xamarin was going open source! All of the Xamarin frameworks, namely Xamarin.iOS, Xamarin.Android and Xamarin.Forms are completely open source, as are all the SDKs under a broad MIT license. Everything starts at open.xamarin.com.
The open sourcing of Xamarin has two major repercussions. One is that Xamarin and all of its tooling are now completely free. And two is that there is a true collaborative open source community being now built around Xamarin. You can be a part of it.
Why and How to Build From Source?
Normally, you would just download the Xamarin SDKs and start building your app. But the true developer in you wants to look under the covers – what is the framework doing for you? Now you can look through Xamarin's source code, pull it down and build the SDK/libraries yourself
Let's say you want to look deeper into Xamarin.Forms – all the source is at https://github.com/xamarin/Xamarin.Forms. You can download or clone the whole repository and build it locally. Follow the defined requirements, open the solution in Visual Studio 2015 and fire up the build. Here's a glimpse of the Xamarin.Forms solution and component projects in VS – plenty to look around and learn.
Say you wanted to play around with Xamarin.iOS and Xamarin.Mac – how is your app running inside the glowing fruit devices? Well, you can start at https://github.com/xamarin/xamarin-macios. With compilation for Mono under the covers, Xamarin for iOS/Mac has a few more defined requirements in order to build locally. So get yourself the CLI tools and specific versions of XCode/Xamarin Studio and Mono. Here's what all the project components look like when pulled down:
There are helpful scripts that will install and provision dependencies. Once they are ready, fire up the build and proceed with the local installation:
$ make world $ make install-system
Now that you have been brave enough to look into Xamarin source code and build the tooling/frameworks locally, take the next logical step forward – contribute back. Think you can tweak something to be better or fix a bug or take a stab at a pending to-do item? This is your opportunity to pay back some technical debt and make the world a better place by contributing to open source projects. Xamarin empowers millions of developers though – so there is a process to contributing:
- File a bug and track issues at https://bugzilla.xamarin.com/newbug.
- For design discussions, subscribe to email@example.com or firstname.lastname@example.org.
- Discuss issues in the Gitter chat room.
- Make appropriate code changes following the coding patterns, sign the .NET Foundation's CLA and make a pull request. The rest they say is for legends!
You have started building your dream Xamarin app, picked the IDE of your choice and grabbed the necessary frameworks. Guess what? Your end users do not see any of magic behind the scenes. What they do see is the app UI and the fluidity of user experience that your app provides. You can try reinventing the wheel on UI or go for some well-engineered UI controls out of the box.
Telerik UI for Xamarin
Telerik UI for Xamarin includes elegant, polished and performant native UI widgets for all your Xamarin apps. With UI for Xamarin, you'll get to deliver your Xamarin apps quicker and delight users with beautiful functional UI.
What you get out of the box are UI widgets that are difficult to create by hand – like various charts, a polished ListView, SideDrawer, and much more.
How to Get Started
So how do you incorporate Telerik UI for Xamarin in your Xamarin project? There are several ways you can go about doing that:
NuGet Package – Probably the easiest way to include UI for Xamarin bits in your project is the NuGet route. Simply point your NuGet source to the Telerik feed and you get a one-click install of Telerik UI for Xamarin. It works the same way from Visual Studio and Xamarin Studio, as shown below.
Telerik Control Panel – If you have an existing Telerik account subscription, you can leverage the Telerik Control Panel to download the UI for Xamarin bits. It will show up if you just have UI for Xamarin subscription or the entire DevCraft product suite, as below.
Plain Download – If you are just trying out UI for Xamarin, a simple trial download may be the easiest way to get started. Simply head to the download site and pull down the raw bits. Once downloaded, you'll find examples, templates and binaries specific to each platform and common ones as well. Make sure to check out the documentation for the UI widgets you are using – each has specific requirements to get the references right in your device-specific or shared projects.
Xamarin provides an excellent way for .NET developers to leverage their existing skills and build truly native, cross-platform mobile apps. With an open source foundation, mature tooling, supporting frameworks and polished UI libraries, the world is your oyster. What are you building next?
Published at DZone with permission of Sam Basu, DZone MVB. See the original article here.
Opinions expressed by DZone contributors are their own.
Adding Mermaid Diagrams to Markdown Documents
Why I Prefer Trunk-Based Development
A React Frontend With Go/Gin/Gorm Backend in One Project
Essential Architecture Framework: In the World of Overengineering, Being Essential Is the Answer