Xamarin.Forms official home
C# PowerShell Java Makefile Batchfile HTML
Permalink
Failed to load latest commit information.
.nuget Initial import Mar 22, 2016
.nuspec .nuspec updates and fixes for X.A.Support 23 -> 25 (#679) Jan 18, 2017
AndroidNative/FormsViewGroup Initial import Mar 22, 2016
PagesGallery [Win] Update certs (#460) Oct 15, 2016
Stubs Fix tests on IOS10 [Do not merge] (#373) Oct 3, 2016
Xamarin.Forms.Build.Tasks [XamlC] compile ListStringTypeConverter (#660) Jan 18, 2017
Xamarin.Forms.ControlGallery.Android [iOS] Labels with WordWrap or CharacterWrap will Expand (#529) Jan 12, 2017
Xamarin.Forms.ControlGallery.WP8 Fix potential NRE accessing current application via Page.RealParent (#… Sep 27, 2016
Xamarin.Forms.ControlGallery.Windows Fix out-of-memory crashes on iOS when creating maps (#467) Jan 12, 2017
Xamarin.Forms.ControlGallery.WindowsPhone Fix out-of-memory crashes on iOS when creating maps (#467) Jan 12, 2017
Xamarin.Forms.ControlGallery.WindowsUniversal Fix out-of-memory crashes on iOS when creating maps (#467) Jan 12, 2017
Xamarin.Forms.ControlGallery.iOS [iOS] Labels with WordWrap or CharacterWrap will Expand (#529) Jan 12, 2017
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared Fix NullReferenceException in VisualElement finalize. (#701) Jan 19, 2017
Xamarin.Forms.Controls [C] new OnPlatform mechanism (#658) Jan 12, 2017
Xamarin.Forms.Core.Android.UITests [UITest] Update to UITest 2.0.5 (#665) Jan 5, 2017
Xamarin.Forms.Core.Design Warnings as Errors in product projects Apr 6, 2016
Xamarin.Forms.Core.UnitTests Fix test failures in Release mode Jan 12, 2017
Xamarin.Forms.Core.Windows.UITests [UITest] Update to UITest 2.0.5 (#665) Jan 5, 2017
Xamarin.Forms.Core.iOS.UITests Pool and reuse MKMapView instances on iOS 9 as well as iOS 10 (#680) Jan 16, 2017
Xamarin.Forms.Core Fix NullReferenceException in VisualElement finalize. (#701) Jan 19, 2017
Xamarin.Forms.CustomAttributes Add TextColor Property to Picker, TimePicker, DatePicker (#84) Apr 19, 2016
Xamarin.Forms.Maps.Android [iOS/Android] Move Map camera to correct region on layout change (#548) Jan 3, 2017
Xamarin.Forms.Maps.Design Warnings as Errors in product projects Apr 6, 2016
Xamarin.Forms.Maps.UWP [UWP]Track user location when IsShowingUser enabled (#556) Nov 22, 2016
Xamarin.Forms.Maps.WP8 Maps.WP8 warning as error mop up (#79) Apr 13, 2016
Xamarin.Forms.Maps.WinRT.Phone Mop up enabling warnings as errors (#78) Apr 12, 2016
Xamarin.Forms.Maps.WinRT.Tablet Mop up enabling warnings as errors (#78) Apr 12, 2016
Xamarin.Forms.Maps.iOS Pool and reuse MKMapView instances on iOS 9 as well as iOS 10 (#680) Jan 16, 2017
Xamarin.Forms.Maps Prepare Preserve attribute usage for removal of InternalsVisibleTo (#121 Apr 26, 2016
Xamarin.Forms.Pages.Azure Azure support (#143) Apr 27, 2016
Xamarin.Forms.Pages.UnitTests [Controls] Update Insights and UITest packages and fix warnings (#361) Sep 18, 2016
Xamarin.Forms.Pages fix weakreferences (#558) Nov 24, 2016
Xamarin.Forms.Platform.Android.AppLinks Fix tests on IOS10 [Do not merge] (#373) Oct 3, 2016
Xamarin.Forms.Platform.Android.FormsViewGroup Set AndroidCodeGenTarget to XAJavaInterop1 (#404) Sep 30, 2016
Xamarin.Forms.Platform.Android .nuspec updates and fixes for X.A.Support 23 -> 25 (#679) Jan 18, 2017
Xamarin.Forms.Platform.UAP [WinRT/UWP] Apply BackgroundColor to Stepper buttons (#581) Jan 3, 2017
Xamarin.Forms.Platform.WP8 [C] new OnPlatform mechanism (#658) Jan 12, 2017
Xamarin.Forms.Platform.WinRT.Phone [C] new OnPlatform mechanism (#658) Jan 12, 2017
Xamarin.Forms.Platform.WinRT.Tablet [C] new OnPlatform mechanism (#658) Jan 12, 2017
Xamarin.Forms.Platform.WinRT [C] new OnPlatform mechanism (#658) Jan 12, 2017
Xamarin.Forms.Platform.iOS [C] new OnPlatform mechanism (#658) Jan 12, 2017
Xamarin.Forms.Platform Remove ToolBar from Core; Remove ToolBar renderers and unit tests (#124) Apr 25, 2016
Xamarin.Forms.Xaml.Design Enable warnings as errors in XAML Apr 7, 2016
Xamarin.Forms.Xaml.UnitTests [XamlC] compile ListStringTypeConverter (#660) Jan 18, 2017
Xamarin.Forms.Xaml.Xamlc [XamlC] Optimize Stloc/Ldloc (#614) Dec 12, 2016
Xamarin.Forms.Xaml.Xamlg Enable warnings as errors in XAML Apr 7, 2016
Xamarin.Forms.Xaml [C] new OnPlatform mechanism (#658) Jan 12, 2017
docs [C] new OnPlatform mechanism (#658) Jan 12, 2017
tools/mdoc Add missing mdoc tooling Mar 23, 2016
.editorconfig Added .editorconfig (#192) May 26, 2016
.gitattributes Initial import Mar 22, 2016
.gitignore Add .bak extension to .gitignore (#388) Sep 27, 2016
LICENSE Fix license copy Apr 29, 2016
Makefile fix mdoc path in Makefile Nov 22, 2016
PULL_REQUEST_TEMPLATE.md Update PULL_REQUEST_TEMPLATE.md Mar 23, 2016
README.md Revert "Update README.md" Dec 14, 2016
Xamarin.Forms.mdpolicy Add Xamarin.Forms code policy file for XamarinStudio Mar 28, 2016
Xamarin.Forms.sln [XamlC] drop ICSharpCode.Decompiler (#586) Dec 5, 2016
Xamarin.Forms.sln.DotSettings Creating category constants for UI test categories (#487) Nov 15, 2016
Xamarin.Forms.vssettings Update vssettings file to turn on Wrapping_PreserveSingleLine (#115) Apr 24, 2016
debug.keystore Add missing debug.keystore Mar 23, 2016
update-docs-windows.bat Evolve feature branch (#117) Apr 24, 2016
update-docs.ps1 Normalize docs (#159) May 11, 2016
verify-nuspecs.ps1 Initial import Mar 22, 2016

README.md

Xamarin.Forms

Xamarin.Forms provides a way to quickly build native apps for iOS, Android, and Windows, completely in C#.

Read more about the platform at https://www.xamarin.com/forms.

Build Status

alt text

alt text

alt text

alt text

alt text

alt text

Getting Started

Install Visual Studio 2015

VS 2015 is required for developing Xamarin.Forms. If you do not already have it installed, you can download it here. VS 2015 Community is completely free. If you are installing VS 2015 for the first time, select the "Custom" installation type and select the following from the features list to install:

  • C#/.NET (Xamarin v4.0.3)
  • Universal Windows App Development Tools
  • Windows 8.1 and Windows Phone 8.0/8.1 Tools

We also recommend installing Microsoft Visual Studio Emulator for Android as well as Emulators for Windows Phone 8.1. If you already have VS 2015 installed, you can verify that these features are installed by modifying the VS 2015 installation via the Control Panel.

Install Additional Features

After installing VS 2015, you will also need to install the following:

  • Bing Maps SDK for Windows 8.1 Store apps -- you can find this in Tools > Extensions and Updates and searching for "bing" in the Online pane.
  • Android SDKs -- you can install these via Tools > Android > Android SDK Manager.
Solution Configuration

Upon opening the Xamarin.Forms solution, you will find that there are a number of errors and warnings under the Error List pane; you can resolve this by changing the filter of Build + IntelliSense to Build Only. At this point, you should be able to successfully build the solution.

By default, the Xamarin.Forms.Controls project does not have a configuration for various API keys to access certain features on each platform (e.g. maps). When building the solution the first time, a controlgallery.config file will be generated inside that project, which looks like this:

Win8MapsAuthKey:
WinPhoneMapsAuthKey:
UWPMapsAuthKey:
InsightsApiKey:
WP8AppId:
WP8AuthToken:

You will have to obtain your own API keys for each of these services, inserted directly after the identifier (e.g. Win8MapsAuthKey:abcdefghijklmnopqrstuvwxyz). You can find out how to obtain each of these as follows:

Due to the way that Android works, the maps API key cannot be injected at runtime. As a result, you will have to add this key to the MapsKey.cs file under Xamarin.Forms.ControlGallery.Android/Properties:

[assembly: Android.App.MetaData("com.google.android.maps.v2.API_KEY", Value = "INSERT_KEY_HERE")]

You can find out how to obtain a Google Maps API key here.

Coding Style

We follow the style used by the .NET Foundation, with two primary exceptions:

  • We do not use the private keyword as it is the default accessibility level in C#.
  • We use hard tabs over spaces. You can change this setting in VS 2015 via Tools > Options and navigating to Text Editor > C# and selecting the "Keep tabs" radio option.

Contributing

Xamarin.Forms Evolution

To discuss this project and participate in the design, we use the Xamarin.Forms Evolution discussion board.

Reporting Bugs

We use Bugzilla to track issues.