Xamarin.Forms official home
Switch branches/tags
tag-test3 tag-test2 tag-test1 rui-3.0.0 release-3.3.0-rc0 release-3.2.0 release-3.2.0-sr1 release-3.1.0-sr3 release-3.1.0-sr2 release-3.1.0-sr1.1 release-3.1.0-sr1 release-3.1.0-rc1 release-3.0.0-sr4.1 release-3.0.0-sr4 release-3.0.0-sr3 release-3.0.0-sr2 release-3.0.0-sr1 release-3.0.0-rc2 release-3.0.0-rc1 release-2.5.1 release-2.5.1-sr4 release-2.5.1-sr3 release-2.5.1-sr2 release-2.5.1-sr1 release-2.5.0 release-2.5.0-sr5 release-2.5.0-sr4 release-2.5.0-sr3 release-2.5.0-sr2 release-2.5.0-sr1 release-2.4.99-rc1 release-2.4.0 release-2.4.0-sr6 release-2.4.0-sr5 release-2.4.0-sr4 release-2.4.0-sr3 release-2.4.0-sr2 release-2.4.0-sr1 release-2.4.0-rc2 release-2.3.5 release-2.3.4 release-2.3.4-sr6 release-2.3.4-sr5 release-2.3.4-sr4 release-2.3.4-sr3 release-2.3.4-sr2 release-2.3.4-sr1 release-2.3.3 release-2.3.3-sr2 release-2.3.3-sr1.1 release-2.3.3-sr1 release-2.3.3-hf1 release-2.3.2 release-2.3.2-hf1 release-2.3.1 release-2.3.0 release-2.3.0-hf1 release-2.2.0 release-2.2.0-hf1 beta-cycle6buildtest beta-9.99.99-rui beta-9.9.999-rui beta-9.9.99-rui beta-9.9.15.5-rui beta-9.9.9.9-rui beta-9.9.9-rui beta-9.9.8-rui beta-3.4.0-pre1 beta-3.3.0-pre3 beta-3.3.0-pre2 beta-3.3.0-pre1 beta-3.2.0-pre3 beta-3.2.0-pre2 beta-3.2.0-pre1.1 beta-3.2.0-pre1 beta-3.1.0-pre4.1 beta-3.1.0-pre4 beta-3.1.0-pre3 beta-3.1.0-pre2.3 beta-3.1.0-pre2.2 beta-3.1.0-pre2 beta-3.1.0-pre1.2 beta-3.1.0-pre1 beta-3.0.0-rui beta-3.0.0-pre4.4 beta-3.0.0-pre4.3 beta-3.0.0-pre4.2 beta-3.0.0-pre4.1 beta-3.0.0-pre4 beta-3.0.0-pre3 beta-3.0.0-pre2.2 beta-3.0.0-pre2 beta-3.0.0-pre1.2 beta-3.0.0-pre1 beta-2.5.1-pre3 beta-2.5.1-pre2 beta-2.5.1-pre1 beta-2.5.0-pre3 beta-2.5.0-pre2 beta-2.5.0-pre1
Nothing to show
Clone or download
Latest commit 7628737 Oct 23, 2018
Permalink
Failed to load latest commit information.
.nuspec Merge branch '3.3.0' into 3.4.0 Oct 22, 2018
AndroidNative [All] ScaleX and ScaleY (#1280) May 7, 2018
EmbeddingTestBeds housekeeping ended with #3999 (#4105) Oct 18, 2018
PagesGallery [Sample] [Android] Fixed PagesGallery.Droid build (#3999) Oct 16, 2018
Stubs [Tizen] Fix ProjectGuid for Forwarders (#4063) Oct 11, 2018
XFCorePostProcessor.Tasks [Tasks] multitarget the build tasks (#3895) Oct 11, 2018
Xamarin.Flex Merge branch '3.0.0' into 3.1.0 May 7, 2018
Xamarin.Forms.Build @ 8f864cf [iOS] Fix NRE on ContextCell (#3714) fixes #3275 Sep 13, 2018
Xamarin.Forms.Build.Tasks [Xaml] don't swallow exceptions from converters (#4100) Oct 18, 2018
Xamarin.Forms.ControlGallery.Android [Enhancements] Toolbar a11y (#3974) fixes #1742 fixes #3795 Oct 22, 2018
Xamarin.Forms.ControlGallery.GTK [iOS] Restore NativeViewWrapper registration (#2772) May 22, 2018
Xamarin.Forms.ControlGallery.MacOS [iOS] Restore NativeViewWrapper registration (#2772) May 22, 2018
Xamarin.Forms.ControlGallery.Tizen [Controls] Support NativeView to ControlGallery.Tizen (#3079) Jun 21, 2018
Xamarin.Forms.ControlGallery.WPF [WPF] Fix FontFamily Assignment in platform specific project (#3225) f… Aug 7, 2018
Xamarin.Forms.ControlGallery.WindowsUniversal [UWP] Fixes CollectionChanged events in ListView (#3323) Sep 11, 2018
Xamarin.Forms.ControlGallery.iOS [UITests] Update TestCloud.Agent (#4055) Oct 11, 2018
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared Added UI test to B45027 (#4079) Oct 23, 2018
Xamarin.Forms.Controls [Enhancements] Toolbar a11y (#3974) fixes #1742 fixes #3795 Oct 22, 2018
Xamarin.Forms.Core.Android.UITests [UITest] Update Xamarin UITest packages Sep 19, 2018
Xamarin.Forms.Core.Design [build] Version and strongname the Build.Tasks (#3118) Jun 28, 2018
Xamarin.Forms.Core.UITests.Shared Merge branch '3.2.0' into 3.3.0 Sep 20, 2018
Xamarin.Forms.Core.UnitTests Merge branch '3.3.0' Oct 8, 2018
Xamarin.Forms.Core.Windows.UITests [UITest] Update Xamarin UITest packages Sep 19, 2018
Xamarin.Forms.Core.iOS.UITests [UITest] Update Xamarin UITest packages Sep 19, 2018
Xamarin.Forms.Core.macOS.UITests [UITest] Update Xamarin UITest packages Sep 19, 2018
Xamarin.Forms.Core UWP Toolbar dynamic overflow (#4022) Oct 23, 2018
Xamarin.Forms.CustomAttributes MaxLines property on Label (#3318) Aug 16, 2018
Xamarin.Forms.Maps.Android [Android Maps] Make markers available to subclasses (#3751) Sep 17, 2018
Xamarin.Forms.Maps.Design [build] Version and strongname the Build.Tasks (#3118) Jun 28, 2018
Xamarin.Forms.Maps.GTK [GTK] Added Maps project (#1349) Dec 9, 2017
Xamarin.Forms.Maps.MacOS [build] Version and strongname the Build.Tasks (#3118) Jun 28, 2018
Xamarin.Forms.Maps.Tizen [build] Version and strongname the Build.Tasks (#3118) Jun 28, 2018
Xamarin.Forms.Maps.UWP [build] Version and strongname the Build.Tasks (#3118) Jun 28, 2018
Xamarin.Forms.Maps.WPF [WPF] Platform and Maps nuget package (#1445) Dec 21, 2017
Xamarin.Forms.Maps.iOS [build] Version and strongname the Build.Tasks (#3118) Jun 28, 2018
Xamarin.Forms.Maps *.swp: remove temporary vim file(s) (#3377) Jul 23, 2018
Xamarin.Forms.Pages.Azure [All] Move to netstandard2.0 **Breaking change** (#1306) Nov 29, 2017
Xamarin.Forms.Pages.UnitTests [All] Move to netstandard2.0 **Breaking change** (#1306) Nov 29, 2017
Xamarin.Forms.Pages [All] Move to netstandard2.0 **Breaking change** (#1306) Nov 29, 2017
Xamarin.Forms.Platform.Android.AppLinks [Android] remove deprecated AndroidUseLatestPlatformSdk (#3672) Aug 28, 2018
Xamarin.Forms.Platform.Android.FormsViewGroup [Android] remove deprecated AndroidUseLatestPlatformSdk (#3672) Aug 28, 2018
Xamarin.Forms.Platform.Android [Android] Fixes AutomationProperties.Name on Button (#4094) Oct 23, 2018
Xamarin.Forms.Platform.GTK [GTK] Add support for ClickGestureRecognizer (#3971) Oct 17, 2018
Xamarin.Forms.Platform.MacOS Fix #3301 (#4164) Oct 23, 2018
Xamarin.Forms.Platform.Tizen [Tizen] Fix Window alpha update timing (#4119) Oct 18, 2018
Xamarin.Forms.Platform.UAP UWP Toolbar dynamic overflow (#4022) Oct 23, 2018
Xamarin.Forms.Platform.WPF [WPF] Fixes `ControlTemplate` sizing issue (#2656) Oct 19, 2018
Xamarin.Forms.Platform.iOS [iOS] Rapidly clicking span (6 times at least) on UITest 3525 throws … Oct 23, 2018
Xamarin.Forms.Platform Add netstandard1.0 support (#1649) Feb 8, 2018
Xamarin.Forms.Xaml.Design [build] Version and strongname the Build.Tasks (#3118) Jun 28, 2018
Xamarin.Forms.Xaml.UnitTests [Xaml] don't swallow exceptions from converters (#4100) Oct 18, 2018
Xamarin.Forms.Xaml [Xaml] fix Namescope being different than tree (#4089) Oct 16, 2018
docs fixes #1675 May 9, 2018
tools/mdoc Add missing mdoc tooling Mar 23, 2016
.Xamarin.Forms.Android.nuget.sln remove xamlc xamlg from dot slns (#3274) Jul 10, 2018
.Xamarin.Forms.Android.sln remove xamlc xamlg from dot slns (#3274) Jul 10, 2018
.Xamarin.Forms.UAP.nuget.sln remove xamlc xamlg from dot slns (#3274) Jul 10, 2018
.Xamarin.Forms.UAP.sln remove xamlc xamlg from dot slns (#3274) Jul 10, 2018
.Xamarin.Forms.iOS.nuget.sln remove xamlc xamlg from dot slns (#3274) Jul 10, 2018
.Xamarin.Forms.iOS.sln remove xamlc xamlg from dot slns (#3274) Jul 10, 2018
.Xamarin.forms.nuget.sln remove xamlc xamlg from dot slns (#3274) Jul 10, 2018
.Xamarin.forms.sln remove xamlc xamlg from dot slns (#3274) Jul 10, 2018
.create-nuget.bat add comments to .create-nuget.bat Sep 26, 2018
.editorconfig set csharp_space_after_keywords_in_control_flow_statements to true to… Feb 23, 2018
.gitattributes Force git to checkout docs using unix line endings (#766) Feb 15, 2017
.gitignore *.swp: remove temporary vim file(s) (#3377) Jul 23, 2018
.gitmodules Use relative URL to support recursive checkout in VSTS (#1926) Feb 20, 2018
.xtc-manual-ios.bat Update xtc-manual-ios.bat Nov 8, 2017
CODEOWNERS Add CODEOWNERS Oct 3, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Dec 9, 2017
CONTRIBUTING.md Update CONTRIBUTING.md (#2417) Apr 11, 2018
GitInfo.txt update GitInfo Oct 8, 2018
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md Apr 11, 2018
LICENSE Fix license copy Apr 29, 2016
Makefile [docs] use local mdoc (#1321) Dec 5, 2017
PULL_REQUEST_TEMPLATE.md Update PULL_REQUEST_TEMPLATE.md Aug 24, 2018
README.md [UWP] Document in the README.md the steps required to run UI Tests (#… Oct 9, 2018
Xamarin.Forms.mdpolicy Add Xamarin.Forms code policy file for XamarinStudio Mar 28, 2016
Xamarin.Forms.sln [Tasks] multitarget the build tasks (#3895) Oct 11, 2018
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
banner.png [README] Add Xamarin.Forms banner (#757) Feb 9, 2017
debug.keystore Add missing debug.keystore Mar 23, 2016
xamarin.forms.snk [build] Version and strongname the Build.Tasks (#3118) Jun 28, 2018

README.md

Xamarin.Forms banner

Xamarin.Forms

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

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

Build Status

Visual Studio Team Services

Packages

Platform/Feature Package name Stable (3.0.0 branch) Nightly Feed MyGet (master branch)
Core Xamarin.Forms NuGet MyGet
Maps Xamarin.Forms.Maps NuGet MyGet
Pages Xamarin.Forms.Pages NuGet MyGet

If you want to use the latest dev build then you should read this blog post :

  • Add the nightly feed to your nuget sources or add a NuGet.Config to your app (placing it in the same directory where your solution file is) with the following content:

    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
        <packageSources>
            <clear />
            <add key="xamarin-ci" value="https://www.myget.org/F/xamarinforms-ci/api/v2" />
            <add key="NuGet.org" value="https://api.nuget.org/v3/index.json" />
        </packageSources>
    </configuration>

    NOTE: This NuGet.Config should be with your application unless you want nightly packages to potentially start being restored for other apps on the machine.

  • Change your application's dependencies to have a * to get the latest version.

Getting Started

Install Visual Studio 2017

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

  • Universal Windows Platform Development - In the Summary > Optional select the Windows 10 Mobile Emulator.
  • Mobile Development with .NET - In the Summary > Optional select Xamarin Remoted Simulator, Xamarin SDK Manager, Intel Hardware Accelerated Execution Manager (HAXM)

We also recommend installing Xamarin Android Device Manager This will use the HAXM tools installed above and allow you to configure Android Virtual Devices (AVDs) that emulate Android devices. If you already have VS 2017 installed, you can verify that these features are installed by modifying the VS 2017 installation via the Visual Studio Installer.

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:

UWPMapsAuthKey:

You will have to obtain your own API keys for each of these services, inserted directly after the identifier (e.g. UWPMapsAuthKey: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.

Build from the Command line

Make sure you have Nuget.exe 4.0 or above and the latest dotnet core sdk (2.0.3). On OSX you should specify the platform in the msbuild command (/p:Platform=iPhoneSimulator)

 nuget restore Xamarin.Forms.sln
 msbuild Xamarin.Forms.sln

UI Tests

Run UWP UI Tests

To run the UWP UI Tests:

  1. Install and run the Windows Application Driver.
  2. Launch the Xamarin.Forms.ControlGallery.WindowsUniversal project to install the ControlGallery application onto your system.

You should now be able to run any of the UWP UI Tests.

Coding Style

We follow the style used by the .NET Foundation, with a few 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. In Visual Studio for Mac it's set via preferences in Source Code > Code Formatting > C# source code and disabling the checkbox for Convert tabs to spaces.
  • Lines should be limited to a max of 120 characters (or as close as possible within reason). This may be set in Visual Studio for Mac via preferences in Source Code > Code Formatting > C# source code and changing the Desired file width to 120.

Contributing

Reporting Bugs

We use GitHub Issues to track issues. If at all possible, please submit a reproduction of your bug along with your bug report.