Xamarin.Forms Official Home
Перейти к файлу
Gerald Versluis 78d9f873d3
Allow 1 modifier key to be added on macOS (#14831)
2021-11-05 13:33:14 +01:00
.config Switch build scripts to use dotnet cake (#13691) 2021-02-08 10:30:40 +00:00
.github Backport Bot (#13446) 2021-01-19 01:12:47 +00:00
.nuspec Androidx bumps (#14506) 2021-09-08 13:21:19 +02:00
AndroidNative [All] ScaleX and ScaleY (#1280) 2018-05-07 14:22:56 +02:00
Assets [Housekeeping] More cleanup (#11999) 2020-09-02 17:07:17 +01:00
DualScreen Androidx bumps (#14506) 2021-09-08 13:21:19 +02:00
EmbeddingTestBeds Androidx bumps (#14506) 2021-09-08 13:21:19 +02:00
Nuget Add switches to build Control Gallery using the nuget produced by the build (#8937) 2020-03-11 11:31:24 +00:00
SampleImports Fix props imports (#10718) 2020-05-16 16:15:00 -06:00
Stubs Androidx bumps (#14506) 2021-09-08 13:21:19 +02:00
Xamarin.Forms.Build.Tasks [X] Accept RD.Source with assembly (#13484) 2021-01-22 14:24:03 -06:00
Xamarin.Forms.ControlGallery.Android Fix (date)picker dark theme (#14591) 2021-09-28 10:53:55 +02:00
Xamarin.Forms.ControlGallery.GTK Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.ControlGallery.MacOS [Nuget] Components governance (#11188) 2020-06-25 16:20:13 +01:00
Xamarin.Forms.ControlGallery.Tizen Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.ControlGallery.WPF Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.ControlGallery.WindowsUniversal [Build]Fix certificate UWP (#14377) 2021-06-29 14:23:35 +01:00
Xamarin.Forms.ControlGallery.iOS Fix UI Test 2021-10-14 10:20:39 +02:00
Xamarin.Forms.Controls Automated dotnet-format update (#14643) 2021-09-22 12:36:37 +02:00
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared ListView: avoid that disabling RefreshAllowed cancels refresh indicator on Android, fixes #8384 (#14816) 2021-11-04 13:11:00 +01:00
Xamarin.Forms.Core Fix MultiWindow default brush issue (#14795) 2021-10-27 14:40:06 +02:00
Xamarin.Forms.Core.Android.UITests Fix iOS so if you remove more than one page it's able to remove them successfully (#14383) 2021-07-05 17:42:25 +01:00
Xamarin.Forms.Core.Design Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.Core.UITests.Shared Improve CarouselView UI tests 2021-10-15 13:44:09 +02:00
Xamarin.Forms.Core.UnitTests Route Navigation.(Push/Pop)Modal through Shell Navigation Manager (#14080) 2021-07-07 05:06:47 -05:00
Xamarin.Forms.Core.Windows.UITests Fix iOS so if you remove more than one page it's able to remove them successfully (#14383) 2021-07-05 17:42:25 +01:00
Xamarin.Forms.Core.iOS.UITests Fix iOS so if you remove more than one page it's able to remove them successfully (#14383) 2021-07-05 17:42:25 +01:00
Xamarin.Forms.Core.macOS.UITests Fix iOS so if you remove more than one page it's able to remove them successfully (#14383) 2021-07-05 17:42:25 +01:00
Xamarin.Forms.CustomAttributes Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.DualScreen Androidx bumps (#14506) 2021-09-08 13:21:19 +02:00
Xamarin.Forms.DualScreen.UnitTests Update to latest Nunit3 (#13677) 2021-02-07 01:41:19 +00:00
Xamarin.Forms.Maps Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.Maps.Android Androidx bumps (#14506) 2021-09-08 13:21:19 +02:00
Xamarin.Forms.Maps.GTK Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.Maps.MacOS Update to C# 8.0 (#12115) 2020-09-22 10:51:57 +02:00
Xamarin.Forms.Maps.Tizen Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.Maps.UWP Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.Maps.WPF Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.Maps.iOS Update to C# 8.0 (#12115) 2020-09-22 10:51:57 +02:00
Xamarin.Forms.Material.Android Androidx bumps (#14506) 2021-09-08 13:21:19 +02:00
Xamarin.Forms.Material.Tizen [Tizen] Fix material style slider issue (#12708) 2020-11-05 00:13:47 +00:00
Xamarin.Forms.Material.iOS Fix material colors to match previous version better (#13666) 2021-02-06 09:09:17 -06:00
Xamarin.Forms.Platform Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.Platform.Android ListView: avoid that disabling RefreshAllowed cancels refresh indicator on Android, fixes #8384 (#14816) 2021-11-04 13:11:00 +01:00
Xamarin.Forms.Platform.Android.AppLinks Androidx bumps (#14506) 2021-09-08 13:21:19 +02:00
Xamarin.Forms.Platform.Android.FormsViewGroup [Android] Fix building with Android stable bits (#14608) 2021-09-17 12:28:24 +01:00
Xamarin.Forms.Platform.Android.UnitTests Fix broken Android platform tests (#14590) 2021-09-09 12:47:18 +02:00
Xamarin.Forms.Platform.GTK [GTK] Fix Entry focus behavior (#14165) 2021-04-28 14:05:34 +02:00
Xamarin.Forms.Platform.MacOS Allow 1 modifier key to be added on macOS (#14831) 2021-11-05 13:33:14 +01:00
Xamarin.Forms.Platform.Tizen Automated dotnet-format update (#14279) 2021-05-19 15:45:41 +02:00
Xamarin.Forms.Platform.UAP UWP: Fix: TitleView width is not updated after a page gets visible again after a PushModal and PopModal call. (#14779) 2021-10-25 11:02:45 +02:00
Xamarin.Forms.Platform.UAP.UnitTests Update to latest Nunit3 (#13677) 2021-02-07 01:41:19 +00:00
Xamarin.Forms.Platform.WPF Fix miss font #11789 (#11977) fixes #11789 2020-12-18 11:25:35 +00:00
Xamarin.Forms.Platform.iOS Fix TabBar icon colors for iOS 15 iPad (#14775) 2021-10-22 13:57:08 +02:00
Xamarin.Forms.Platform.iOS.UnitTests fix memory leak (and some crashes) in ItemsViewController (iOS) (#14111) 2021-07-12 10:04:08 +01:00
Xamarin.Forms.Xaml [X] Don't remove enclosing quotes (#12813) fixes #12763 2020-11-12 17:51:56 +00:00
Xamarin.Forms.Xaml.Design Major code format (#12254) 2020-09-29 11:15:44 +01:00
Xamarin.Forms.Xaml.UnitTests Update to latest Nunit3 (#13677) 2021-02-07 01:41:19 +00:00
build Provisioning windows stable (#14711) 2021-10-08 15:51:24 +01:00
.Xamarin.Forms.Android.slnf Force off-main-thread ItemsSource updates to update on main thread (#11235) 2020-07-20 15:47:40 -07:00
.Xamarin.Forms.UAP.slnf update dot files 2019-07-25 15:30:36 -10:00
.Xamarin.Forms.iOS.slnf Cache cell sizes after resize from estimates (#12919) fixes #10842 fixes #10625 2020-12-29 23:39:03 +00:00
.editorconfig Major code format (#12254) 2020-09-29 11:15:44 +01:00
.gitattributes try to avoid merge conflicts in GitInfo.txt (#5715) 2019-04-03 08:49:40 +02:00
.gitconfig try to avoid merge conflicts in GitInfo.txt (#5715) 2019-04-03 08:49:40 +02:00
.gitignore Set environment variables for UWP test results (#11724) 2020-08-11 11:17:44 +01:00
ControlGallery.Build.props Update to C# 8.0 (#12115) 2020-09-22 10:51:57 +02:00
DevopsNuget.config [Build] Fix nuget.config (#13713) 2021-02-09 19:52:43 +00:00
Directory.Build.props Merge branch '4.6.0' into 4.7.0 2020-06-28 14:34:22 +01:00
Directory.Build.targets Remove DualScreen projects from Xamarin.Forms.Sln (#10550) 2020-05-06 12:29:41 +01:00
Environment.Build.props Update to C# 8.0 (#12115) 2020-09-22 10:51:57 +02:00
Git.Build.targets [Nuget] Components governance (#11188) 2020-06-25 16:20:13 +01:00
GitInfo.txt [Build] Update GitInfo 2020-06-27 15:05:52 +01:00
LICENSE Fix license copy 2016-04-29 13:41:50 -04:00
Makefile [docs] use local mdoc (#1321) 2017-12-05 16:37:32 +01:00
Nuget.targets Add switches to build Control Gallery using the nuget produced by the build (#8937) 2020-03-11 11:31:24 +00:00
README.md Update README.md 2021-10-27 16:22:14 +02:00
SECURITY.md Add SECURITY.md (#7373) 2019-09-04 10:03:31 -07:00
SourceLink.Build.props Remove DualScreen projects from Xamarin.Forms.Sln (#10550) 2020-05-06 12:29:41 +01:00
UWP.Build.props Merge branch '4.8.0' into 5.0.0 2020-11-16 13:34:55 -06:00
UWP.Build.targets Bump UWP to 19041 (#11940) 2020-09-01 11:51:37 +01:00
Version.targets Merge branch '4.3.0' into 4.4.0 2019-11-18 11:39:51 +01:00
Xamarin.Forms.DualScreen.sln Remove XFCorePostProcessorCodeInjected (#12096) 2020-09-18 09:13:15 -06:00
Xamarin.Forms.sln Remove XFCorePostProcessorCodeInjected (#12096) 2020-09-18 09:13:15 -06:00
Xamarin.Forms.sln.DotSettings Propagate cleared shell elements correctly (#9615) 2020-02-18 15:25:51 -07:00
azure-pipelines.yml Provisioning windows stable (#14711) 2021-10-08 15:51:24 +01:00
build.cake [Build]Fix certificate UWP (#14377) 2021-06-29 14:23:35 +01:00
build.cmd Make building easier on Windows by setting PowerShell execution policy (attempt 2) (#6755) 2019-07-02 14:36:22 -06:00
build.ps1 Switch build scripts to use dotnet cake (#13691) 2021-02-08 10:30:40 +00:00
build.sh Switch build scripts to use dotnet cake (#13691) 2021-02-08 10:30:40 +00:00
debug.keystore Add missing debug.keystore 2016-03-22 18:07:44 -07:00
xamarin.forms.snk [build] Version and strongname the Build.Tasks (#3118) 2018-06-28 12:04:16 +01:00

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

Azure DevOps

Packages

Platform/Feature Package name Stable Prerelease Nightly Feed Azure (main branch)
Core Xamarin.Forms NuGet NuGet
AppLinks Xamarin.Forms.AppLinks NuGet NuGet
Maps Xamarin.Forms.Maps NuGet NuGet
Maps.GTK Xamarin.Forms.Maps.GTK NuGet NuGet
Maps.WPF Xamarin.Forms.Maps.WPF NuGet NuGet
Pages Xamarin.Forms.Pages NuGet NuGet
Pages.Azure Xamarin.Forms.Pages.Azure NuGet NuGet
Platform.GTK Xamarin.Forms.Platform.GTK NuGet NuGet
Platform.WPF Xamarin.Forms.Platform.WPF NuGet NuGet
Visual.Material Xamarin.Forms.Visual.Material NuGet NuGet

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://aka.ms/xf-nightly/index.json" />
        <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

For both methods underneath you will have to add this NuGet feed for the build to succeed. See this documentation page to find out how.

Windows

Install Visual Studio 2019+

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

  • .NET desktop development
    • Individual Components > .NET > .NET Framework 4.6.1 SDK, .NET Framework 4.6.1 targeting pack, .NET Framework 4.7.2 SDK, .NET Framework 4.7.2 targeting pack.
  • Universal Windows Platform Development
  • Mobile Development with .NET
    • Individual Components > Development Activities > Xamarin Remoted Simulator
    • If you're not using Hyper-V Individual Components > Emulators > Hyper-V Intel Hardware Accelerated Execution Manager (HAXM)
  • Most current SDK version of .NET Core

The Android 10.0 API 29 SDK and Android 9.0 API 28 SDK are required for developing Xamarin.Forms. They can be installed by using the Xamarin Android SDK Manager.

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 2019+ installed, you can verify that these features are installed by modifying the VS 2019+ installation via the Visual Studio Installer.

Provisioning script

If you are getting errors about missing SDKs, you can run our provisioning script. Note that it can take some time to run the whole script. To better understand how the script works, feel free to check out our build.cake file.

  • On CMD

    build.cmd -Target provision
    
  • On Powershell

    ./build.ps1 -Target provision
    

    NOTE: If you encounter an error saying build.ps1 is not digitally signed, open Powershell as an administrator and resolve by running Set-ExecutionPolicy RemoteSigned first.

  • On CMD/Powershell/sh (New! More info here)

    dotnet tool install Cake.Tool -g
    dotnet cake --target=provision
    

Mac

Install Visual Studio for Mac 2019

If you do not already have it installed, instructions to download and setup can be found here.

Because of current Multi-Targeting limitations with Visual Studio for Mac you will need to manually build/restore some projects before you are able to work on the Xamarin Forms solution.

Here are a few different options we've put together to help make this process easier

  • Branches 3.5+ come with a Cake script target that you can use to build and open VSMac

    ./build.sh --target vsmac
    

    OR as mentioned above in the Windows section about provisioning, you can also use the new Cake.Tool

    dotnet tool install Cake.Tool -g
    dotnet cake --target=provision
    
  • When working on an earlier branch that does not have the cake scripts, you can use the following build.sh script

  • If you don't want to run any scripts:

    • Open Xamarin.Forms.sln
    • Wait for VSMAC to finish restoring all projects
    • from the command line run:
      • msbuild Xamarin.Forms.Build.Tasks/Xamarin.Forms.Build.Tasks.csproj
    • Now you should be able to run and deploy everything. The only reason you would need to do this process again is if you clean the solution folder or delete the bin/obj folders that are part of the Xamarin.Forms.Build.Tasks.csproj
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 for the first time, a controlgallery.config file will be generated inside that project, which looks like this:

UWPMapsAuthKey:

If you aren't working with maps, you can ignore this. If you want to work with maps, 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 .NET Core SDK. On macOS you should specify the platform in the msbuild command (/p:Platform=iPhoneSimulator)

msbuild /restore Xamarin.Forms.sln

UI Tests

Run Android UI Tests

Depending on your environment setup, you might need to configure a few things before being able to debug / run UI tests, especially on Windows.

  • If you receive an error about ANDROID_HOME, please make sure to set your environment variable to the Android SDK directory (e.g. C:\Program Files (x86)\Android\android-sdk).
  • If you receive an error about JAVA_HOME, please install the latest Java JDK and set your environment variable to the JDK directory (e.g. C:\Program Files\Java\jdk-13).
  • If you receive an error about a missing ApkFile, please generate an APK file for Xamarin.Forms.ControlGallery.Android. The easiest way to do this is to right click the project and select "Deploy". Note that if you rebuild the solution, you might lose the APK and will need to generate it again.

After these steps are taken care of, you should be good to go. You can see all UI tests in Test Explorer, search them for your own convenience, and quickly run individual 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 Visual Studio for Windows 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.