Skip to content
This repository has been archived by the owner. It is now read-only.
Go to file

Sample Deprecated & Replaced

This sample has officially been deprecated and replaced with the "My Contacts" sample application that showcases Xamarin.Forms and an ASP.NET Core backend.

This repo is left here for historical purposes, back links, and is read-only.


A simple Xamarin app named Acquaint. The app is a simple list of contacts, each of which can be viewed in a detail screen and modified in an edit screen. It runs on iOS 9+, Android 4.2+, and UWP (mobile and desktop).

##Cross-platform and native The app is implemented in two ways in order to demonstrate the two different approaches to Xamarin app development:

  • Xamarin.Forms cross-platform UI
  • Xamarin native, with platform-specific UI implementations

##Three platforms The app targets three platforms:

  • iOS
  • Android
  • Universal Windows Platform (UWP)
    • UWP currently only in Forms version of app
    • UWP supported only in Visual Studio, not Xamarin Studio

##Integrations Includes integrations such as:

  • getting directions
  • making calls
  • sending text messages
  • email composition


  • Visual Studio 2015 (14.0 or higher) to compile C# 6 langage features (or Xamarin Studio OS X)
  • Xamarin add-ons for Visual Studio (available via the Visual Studio installer)
  • Visual Studio Community Edition is fully supported!

Google Maps API key (Android)

For Android, you'll need to obtain a Google Maps API key:

Insert it in the Android project: ~/Properties/AndroidManifest.xml:

<application ...>
  <meta-data android:name="" android:value="GOOGLE_MAPS_API_KEY" />

Enabling SQLite for UWP

The UWP app requires that you install the SQLite for UWP extension for Visual Studio. You can find the latest version here:

The steps that were taken to implement it in the UWP project can be found in steps 1-3 here:

Platform-specific UI Features (in native version only)

3D Touch Previewing (iOS) Shared View Transitions (Android)


The app has three main screens:

  • a list screen
  • a read-only detail screen
  • an editable detail screen


All images of people in the app come from In accordance with the guidelines, fictitious names have been provided.

Clean and Rebuild

If you see build issues when pulling updates from the repo, try cleaning and rebuilding the solution.


A Xamarin demo app featuring both Xamarin.Forms and native approaches to Xamarin development


You can’t perform that action at this time.