Xamarin.Forms official home
C# PowerShell Java Makefile Batchfile HTML
Pull request Compare This branch is 1 commit ahead, 133 commits behind xamarin:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.nuget
.nuspec
AndroidNative/FormsViewGroup Initial import Mar 22, 2016
PagesGallery [Win] Update certs (#460) Oct 15, 2016
Stubs
WinFormsTestApp
Xamarin.Forms.Build.Tasks Xamlc compile data triggers (#648) Dec 23, 2016
Xamarin.Forms.ControlGallery.Android Fix potential NRE in ConditionalFocusLayout (#587) Dec 15, 2016
Xamarin.Forms.ControlGallery.WP8 Fix potential NRE accessing current application via Page.RealParent (#… Sep 27, 2016
Xamarin.Forms.ControlGallery.Windows [Win] Update cert (#579) Nov 30, 2016
Xamarin.Forms.ControlGallery.WindowsPhone [Win] Will arrange native children of custom renderers (opt-in) (#322) Sep 27, 2016
Xamarin.Forms.ControlGallery.WindowsUniversal
Xamarin.Forms.ControlGallery.iOS
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared
Xamarin.Forms.Controls Add sample HanselForms and TwitterDemo to ControlGallery (#651) Dec 16, 2016
Xamarin.Forms.Core.Android.UITests
Xamarin.Forms.Core.Design
Xamarin.Forms.Core.UnitTests Xamlc compile data triggers (#648) Dec 23, 2016
Xamarin.Forms.Core.Windows.UITests Updating UITest package to 2.0.3 Dec 12, 2016
Xamarin.Forms.Core.iOS.UITests
Xamarin.Forms.Core
Xamarin.Forms.CustomAttributes
Xamarin.Forms.Maps.Android Fix tests on IOS10 [Do not merge] (#373) Oct 3, 2016
Xamarin.Forms.Maps.Design
Xamarin.Forms.Maps.UWP
Xamarin.Forms.Maps.WP8
Xamarin.Forms.Maps.WinRT.Phone
Xamarin.Forms.Maps.WinRT.Tablet
Xamarin.Forms.Maps.iOS
Xamarin.Forms.Maps Prepare Preserve attribute usage for removal of InternalsVisibleTo (#121 Apr 26, 2016
Xamarin.Forms.Pages.Azure
Xamarin.Forms.Pages.UnitTests [Controls] Update Insights and UITest packages and fix warnings (#361) Sep 18, 2016
Xamarin.Forms.Pages
Xamarin.Forms.Platform.Android.AppLinks
Xamarin.Forms.Platform.Android.FormsViewGroup Set AndroidCodeGenTarget to XAJavaInterop1 (#404) Sep 30, 2016
Xamarin.Forms.Platform.Android Slider should show user-set value on initial load (#378) Dec 19, 2016
Xamarin.Forms.Platform.UAP
Xamarin.Forms.Platform.WP8
Xamarin.Forms.Platform.WinForms
Xamarin.Forms.Platform.WinRT.Phone [Windows] Fix modal pages being laid out below soft buttons (#395) Dec 17, 2016
Xamarin.Forms.Platform.WinRT.Tablet [WinRT] Fix MDP and TabbedPage Appearing/Disappearing (#387) Oct 11, 2016
Xamarin.Forms.Platform.WinRT
Xamarin.Forms.Platform.iOS
Xamarin.Forms.Platform
Xamarin.Forms.Xaml.Design
Xamarin.Forms.Xaml.UnitTests
Xamarin.Forms.Xaml.Xamlc
Xamarin.Forms.Xaml.Xamlg
Xamarin.Forms.Xaml Xamlc compile data triggers (#648) Dec 23, 2016
docs Remove overload causing backwards compatibility issues Dec 15, 2016
tools/mdoc
.editorconfig
.gitattributes
.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
Platform.WinForms.sln
README.md
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
Xamarin.Forms.vssettings
debug.keystore
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.