Xamarin has finally given us the power to develop native iOS, Android, and Mac applications in C#, which is one of our favorite programming languages. There are many advantages of choosing Xamarin to develop mobile applications instead of Java and Objective-C. You can share code between multiple platforms and can be more productive by taking advantage of the advanced language features of C# and the .NET base class libraries. Alternatively, you would have to write the app twice for Android and iOS and lose the benefits of garbage collection in iOS.
Xamarin's tooling works by compiling your C# into a native ARM executable that can be packaged as an iOS or Android application. It bundles a stripped-down version of the Mono runtime with your application that only includes the features of the base class libraries your app uses.
In this chapter, we'll set up everything you need to get started on developing with Xamarin. By the end of the chapter, we'll have all the proper SDKs and tools installed and all the developer accounts needed for app store submission.
In this chapter, we will cover:
An introduction to Xamarin tools and technology
Installing Xcode, Apple's IDE
Setting up all Xamarin tools and software
Setting up the Android emulator
Enrolling in the iOS Developer Program
Registering for Google Play
Xamarin has developed three core products for developing cross-platform applications:Xamarin Studio (formerly MonoDevelop), Xamarin.iOS (formerly MonoTouch), and Xamarin.Android (formerly Mono for Android). These tools allow developers to leverage the native libraries on iOS and Android and are built on the Mono runtime.
Mono, an open source implementation of C# and the .NET framework, was originally developed by Novell to be used on Linux operating systems. Since iOS and Android are similarly based on Linux, Novell was able to develop MonoTouch and Mono for Android as products to target the new mobile platforms. Shortly after their release, another company acquired Novell, and let the Mono team go. Very shortly after, Xamarin was founded to focus completely on these tools for developing with C# on iOS and Android.
Getting a development machine ready for developing cross-platform application development can take some time. And to make matters worse, Apple and Google both have their own requirements for development on their respective platforms. Let's go over what needs to be installed on your machine.
Xcode: Apple's core IDE for developing iOS and Mac applications in Objective-C
Xcode Command Line Tools: These are installed inside Xcode, and provide common Command Line Tools and scripting languages that developers would find useful, such as Subversion or SVN, Git, Perl, Ruby.
The Mono runtime for Mac: This is required for compiling and running C# programs on OS X
Xamarin.iOS: This is Xamarin's core product for iOS development
Android also requires the following software to be installed to get started:
Android SDK: This contains Google's standard SDK, device drivers, and emulators for native Android development
The Mono runtime for Mac: This is required for compiling and running C# programs on OS X
Each of these will take some time to download and install. If you can access a fast internet connection, it will help speed up the installation and set up process. With everything ready to go, let's move ahead step by step, and hopefully, we can skip a few dead ends you might otherwise run into.
It is important to note that Xamarin can also be used on Windows and Visual Studio, even though it is not covered in this book. A Mac is required for iOS development, so Windows developers must connect Visual Studio to a Mac to compile for iOS. Luckily, most of what we learn in this book can be directly applied to using Xamarin on Windows.
To make things progress more smoothly, let's start off by installing Xcode for Mac. Along with Apple's IDE, it will also install the most commonly used developer tools on the Mac. Make sure you have at least OS X 10.8 (Mountain Lion), and locate Xcode in the App Store as shown in the following screenshot:
When that is out of the way, launch Xcode for the first time and progress through the initial startup dialog. Next, navigate to Xcode | Preferencesâ¦ to open Xcode's main settings dialog.
In the Downloads | Components tab, you'll notice several additional packages you can install inside Xcode. Go ahead and install the Command Line Tools. Optionally, you can install older iOS simulators, but we can just use the default one for the content in this book. When you're finished, your Xcode's Components section should look something similar to the following screenshot:
Installing Xcode installs the iOS SDK, which is a requirement for iOS development in general. As a restriction from Apple, the iOS SDK can only run on a Mac. Xamarin has done everything possible to make sure they follow Apple's guidelines for iOS, such as dynamic code generation. Xamarin's tools also leverage features of Xcode wherever possible to avoid reinventing the wheel.
After installing Xcode, there are several other dependencies that need to be installed in order to start developing with Xamarin's tools. Luckily, Xamarin has improved the experience by creating a neat all-in-one installer.
Install the free Xamarin Starter Edition with the following steps:
Go to http://Xamarin.com and click on the large Download Now button.
Fill out some basic information about yourself.
XamarinInstaller.dmgand mount the disk image.
Install Xamarin.appand accept any OS X security warnings that appear.
Progress through the installer, the default options will work fine. You can optionally install Xamarin.Mac, but that topic is not covered in this book.
The Xamarin installer will download and install prerequisites such as the Mono runtime, Java, the Android SDK (including the Android emulator and tools), and everything else you need to be up and running.
You will end up with something similar to what is shown in the following screenshot, and we can move on to conquer bigger topics in cross platform development:
The Android emulator has historically been known to be sluggish compared to developing on a physical device. To help solve this issue, Google has produced a new x86 emulator that supports hardware acceleration on desktop computers. It isn't installed by default in the Android Virtual Device (AVD) Manager, so let's set that up.
Launch Tools | Open Android SDK Managerâ¦.
Scroll down to Extras; install Intel x86 Emulator Accelerator (HAXM).
Scroll to Android 4.2.2 (API 17); install Intel x86 Atom System Image.
Optionally, install any other packages you are interested in. At a minimum, make sure you have everything that the Android SDK Manager selects for you to install by default.
Close the Android SDK Manager and switch back to Xamarin Studio.
Launch Tools | Open AVD Managerâ¦.
Click on Newâ¦.
Enter an AVD name of your choice, such as
Pick a generic device that will be appropriately sized for your display, such as the 4.0 inch WVGA.
As Target, make sure you select Intel x86 Atom System Image.
The emulator will take some time to start up, so it is a good idea to leave the emulator running while performing Android development. Xamarin is using the standard Android tools here, so you would have the same issue while performing Android development with Java. If everything starts properly, you will see an Android boot screen followed by a virtual Android device ready for deploying applications from Xamarin Studio as shown in the following screenshot:
To deploy to an iOS device, Apple requires a membership to its iOS Developer Program. Membership is $99 USD per year and gives you access to deploy 200 devices for development purposes. You also get access to test servers for implementing more advanced iOS features such as in-app purchases, push notifications, and iOS Game Center. Testing your Xamarin.iOS applications on a physical device is important, so I recommend getting an account prior to starting iOS development. Performance is very different in a simulator running on your desktop versus a real mobile device. There are also a few Xamarin-specific optimizations that only occur when running on the device. We'll fully cover the reasons for testing your apps on devices in later chapters.
Click on Enroll Now.
Sign in with an existing iTunes account or create a new one. This can't be changed later, so choose the one that is appropriate for your company.
Enroll either as an individual or a company. Both are priced at $99; but, registering as a company will require paperwork to be faxed to Apple with the assistance of your company's accountant.
Review the developer agreement.
Fill out Apple's survey for developers.
Purchase the $99 developer registration.
Wait for a confirmation e-mail.
You should receive an email that looks something like the following screenshot within two business days:
From here, we can continue setting up your account.
Either click on Login from the e-mail you received or go to https://itunesconnect.apple.com.
Log in with your earlier iTunes account.
Agree to any additional agreements that appear on the home page of your dashboard.
From the iTunes Connect dashboard, go to Contracts, Tax, and Banking.
In this section, you will see three columns for Contact Info, Bank Info, and Tax Info.
Fill out the appropriate information for your account in all of these sections. Assistance from an accountant will most likely be needed for a company account.
When all is said and done, your Contracts, Tax, and Banking section should look something like the following screenshot:
Unlike iOS, deploying your applications to Android devices is free and just requires a few changes in your device settings. A Google Play developer account has only a one-time fee of $25 and doesn't have to be renewed each year. However, just like iOS, you will need a Google Play account to develop in-app purchases, push notifications, or Google Play Game Services. I would recommend setting up an account ahead of time if you inevitably plan on submitting an app to Google Play or need to implement one of these features.
Log in with an existing Google Account, or create a new one. This can't be changed later, so choose the one that is appropriate for your company if needed.
Accept the agreement and enter your credit card information.
If you get everything filled out correctly, you will end up with the following Google Play Developer Console:
If you plan on selling paid apps or in-app purchases, at this point, I would recommend setting up your Google Merchant Account. This will enable Google to pay you the proceeds toward your app sales by applying the appropriate tax laws in your country. If setting this up for your company, I would recommend getting the assistance of your company's accountant or bookkeeper.
The following are the steps to set up a Google Merchant Account:
When done, you will notice that the help tip for setting up a merchant account is now missing from the developer console, as shown in the following screenshot:
At this point, one would think our account would be fully set up, but there is one more crucial step prior to being able to sell apps: we have to enter the banking information.
Go back to the Google Play Developer Console at https://play.google.com/apps/publish.
Click on the Financial Reports section.
Click on the small link titled Visit your merchant account for details.
You should see a warning indicating that you do not have a bank account set up. Click on the Specify a Bank Account link to get started.
Enter your banking information. Again, a company accountant might be needed.
In a few days, look for a small deposit in your account from Google.
Confirm the amount by going to http://checkout.google.com/sell.
Click on the Settings tab, then Financials.
Your Google Merchant Account is also the place where you can cancel or refund customer orders. Google Play is different from the iOS App Store, in that all customer issues are directed to the developers.
In this chapter, we discussed Xamarin's core products for developing Android and iOS applications in C#: Xamarin Studio, Xamarin.iOS, and Xamarin.Android. We installed Xcode and then ran the Xamarin all-in-one installer, which installs Java, the Android SDK, Xamarin Studio, Xamarin.iOS, and Xamarin.Android. We set up the x86 Android Emulator for a faster, more fluid experience when debugging applications. Finally we set up iOS and Google Play developer accounts for distributing our applications.
In this chapter, you should have acquired everything you need to get started on building cross-platform applications with Xamarin. Your development computer should be ready to go and you should have all the native SDKs installed and ready for creating the next great app to take the world by storm.
The concepts in this chapter will set us up for more advanced topics that will require the proper software installed as well as developer accounts with Apple and Google. We will be deploying applications to real devices and implementing more advanced features such as push notifications. In the next chapter, we'll create our first iOS and Android application and cover the basics of each platform.