.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.
Перейти к файлу
Stephane Delcroix ea0d55dd0d
[X] resolve event handlers in base generic types (#6194)
* [XamlC] fix Debug harness generation code

* [X] resolve event handlers in base generic types

- fixes #6176
2019-06-26 14:35:54 +02:00
.github Update issue templates 2019-04-09 10:31:33 -07:00
.nuspec add checkbox style to nuspec (#6504) 2019-06-13 13:29:38 -07:00
AndroidNative [All] ScaleX and ScaleY (#1280) 2018-05-07 14:22:56 +02:00
EmbeddingTestBeds Cherry pick Tizen project changes to 4.0.0 and modify SLN changes VS makes (#6396) 2019-06-04 17:48:29 -06:00
PagesGallery Cherry pick Tizen project changes to 4.0.0 and modify SLN changes VS makes (#6396) 2019-06-04 17:48:29 -06:00
Stubs Cherry pick Tizen project changes to 4.0.0 and modify SLN changes VS makes (#6396) 2019-06-04 17:48:29 -06:00
XFCorePostProcessor.Tasks Merge branch '3.6.0' into 4.0.0 2019-04-10 21:59:38 -07:00
Xamarin.Flex Merge branch '3.0.0' into 3.1.0 2018-05-07 10:02:58 +02:00
Xamarin.Forms.Build.Tasks [X] resolve event handlers in base generic types (#6194) 2019-06-26 14:35:54 +02:00
Xamarin.Forms.ControlGallery.Android Merge branch '4.0.0' 2019-05-22 22:32:28 +01:00
Xamarin.Forms.ControlGallery.GTK Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.ControlGallery.MacOS Merge branch '4.0.0' 2019-03-27 17:14:57 -07:00
Xamarin.Forms.ControlGallery.Tizen Cherry pick Tizen project changes to 4.0.0 and modify SLN changes VS makes (#6396) 2019-06-04 17:48:29 -06:00
Xamarin.Forms.ControlGallery.WPF Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.ControlGallery.WindowsUniversal Merge branch '4.0.0' 2019-05-22 22:32:28 +01:00
Xamarin.Forms.ControlGallery.iOS Merge branch '3.6.0' into 4.0.0 2019-06-17 12:15:59 +01:00
Xamarin.Forms.Controls Merge branch '4.0.0' into 4.1.0 2019-06-19 23:49:12 +01:00
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared Merge branch '4.0.0' into 4.1.0 2019-06-20 17:10:59 -07:00
Xamarin.Forms.Core Backport41 (#6651) 2019-06-25 15:20:55 -07:00
Xamarin.Forms.Core.Android.UITests Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.Core.Design Add Intellisense for vertical/horizontal list options in CollectionView (#6537) 2019-06-18 11:20:02 +02:00
Xamarin.Forms.Core.UITests.Shared Merge branch '4.0.0' into 4.1.0 2019-06-19 23:49:12 +01:00
Xamarin.Forms.Core.UnitTests Checkbox (#6232) 2019-05-30 10:32:28 -06:00
Xamarin.Forms.Core.Windows.UITests Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.Core.iOS.UITests Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.Core.macOS.UITests [Build] Update builds, remove submodule, update AssemblyInfo with GitInfo (#6068) 2019-05-22 01:06:59 +01:00
Xamarin.Forms.CustomAttributes Checkbox (#6232) 2019-05-30 10:32:28 -06:00
Xamarin.Forms.Maps Merge branch '4.0.0' 2019-05-22 22:32:28 +01:00
Xamarin.Forms.Maps.Android Merge branch '4.0.0' 2019-05-22 22:32:28 +01:00
Xamarin.Forms.Maps.GTK Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.Maps.MacOS [Build] Update builds, remove submodule, update AssemblyInfo with GitInfo (#6068) 2019-05-22 01:06:59 +01:00
Xamarin.Forms.Maps.Tizen Cherry pick Tizen project changes to 4.0.0 and modify SLN changes VS makes (#6396) 2019-06-04 17:48:29 -06:00
Xamarin.Forms.Maps.UWP Merge branch '4.0.0' 2019-05-22 22:32:28 +01:00
Xamarin.Forms.Maps.WPF Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.Maps.iOS Merge branch '4.0.0' 2019-05-22 22:32:28 +01:00
Xamarin.Forms.Material.Android Merge branch '4.0.0' into 4.1.0 2019-06-20 17:10:59 -07:00
Xamarin.Forms.Material.Tizen Cherry pick Tizen project changes to 4.0.0 and modify SLN changes VS makes (#6396) 2019-06-04 17:48:29 -06:00
Xamarin.Forms.Material.iOS Checkbox (#6232) 2019-05-30 10:32:28 -06:00
Xamarin.Forms.Pages Re-enable "Treat warnings as errors" (#5602) 2019-03-27 18:38:38 +00:00
Xamarin.Forms.Pages.Azure [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Pages.UnitTests [Build] Update builds, remove submodule, update AssemblyInfo with GitInfo (#6068) 2019-05-22 01:06:59 +01:00
Xamarin.Forms.Platform Checkbox (#6232) 2019-05-30 10:32:28 -06:00
Xamarin.Forms.Platform.Android Undo broken change in un-watching empty view observer; 2019-06-24 13:47:46 -06:00
Xamarin.Forms.Platform.Android.AppLinks [Build] Update builds, remove submodule, update AssemblyInfo with GitInfo (#6068) 2019-05-22 01:06:59 +01:00
Xamarin.Forms.Platform.Android.FormsViewGroup Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.Platform.GTK [GTK] Add Alpha support to Frame background (#6092) 2019-05-28 10:55:05 -07:00
Xamarin.Forms.Platform.MacOS Checkbox (#6232) 2019-05-30 10:32:28 -06:00
Xamarin.Forms.Platform.Tizen Cherry pick Tizen project changes to 4.0.0 and modify SLN changes VS makes (#6396) 2019-06-04 17:48:29 -06:00
Xamarin.Forms.Platform.UAP [UWP] fixes hangs ListView when using Narrator (#6431) 2019-06-19 19:27:53 -07:00
Xamarin.Forms.Platform.WPF Fix for layouts in a cell to expand on resize (WPF) Issue #5682 (#6179) 2019-06-17 12:47:26 +01:00
Xamarin.Forms.Platform.iOS Clean up Platform on PlatformRenderer disposal: fixes #4671 (#6636) 2019-06-24 20:01:57 +01:00
Xamarin.Forms.Sandbox remove excess code and clean up sandbox (#6503) 2019-06-12 17:42:25 -06:00
Xamarin.Forms.Sandbox.Android Merge branch '4.0.0' 2019-05-28 18:53:09 -07:00
Xamarin.Forms.Sandbox.UWP [Build] Update builds, remove submodule, update AssemblyInfo with GitInfo (#6068) 2019-05-22 01:06:59 +01:00
Xamarin.Forms.Sandbox.WPF Checkbox (#6232) 2019-05-30 10:32:28 -06:00
Xamarin.Forms.Sandbox.iOS [Build] Update builds, remove submodule, update AssemblyInfo with GitInfo (#6068) 2019-05-22 01:06:59 +01:00
Xamarin.Forms.Xaml Backport41 (#6651) 2019-06-25 15:20:55 -07:00
Xamarin.Forms.Xaml.Design Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Xamarin.Forms.Xaml.UnitTests [X] resolve event handlers in base generic types (#6194) 2019-06-26 14:35:54 +02:00
build Merge branch '3.6.0' into 4.0.0 2019-06-19 23:48:36 +01:00
docs Implemented colored refresh indicator for ListView pull-to-refresh (#2961) 2018-11-29 12:57:57 +00:00
tools/mdoc Add missing mdoc tooling 2016-03-22 17:28:19 -07:00
.Xamarin.Forms.Android.nuget.sln Profiler v11; No man init (#6087) 2019-05-07 10:12:00 -10:00
.Xamarin.Forms.Android.sln remove xamlc xamlg from dot slns (#3274) 2018-07-10 10:51:32 -10:00
.Xamarin.Forms.UAP.nuget.sln remove xamlc xamlg from dot slns (#3274) 2018-07-10 10:51:32 -10:00
.Xamarin.Forms.UAP.sln remove xamlc xamlg from dot slns (#3274) 2018-07-10 10:51:32 -10:00
.Xamarin.Forms.iOS.nuget.sln remove xamlc xamlg from dot slns (#3274) 2018-07-10 10:51:32 -10:00
.Xamarin.Forms.iOS.sln remove xamlc xamlg from dot slns (#3274) 2018-07-10 10:51:32 -10:00
.Xamarin.forms.nuget.sln remove xamlc xamlg from dot slns (#3274) 2018-07-10 10:51:32 -10:00
.Xamarin.forms.sln remove xamlc xamlg from dot slns (#3274) 2018-07-10 10:51:32 -10:00
.create-nuget.bat Profiler v11; No man init (#6087) 2019-05-07 10:12:00 -10:00
.create-stubs.bat Profiler v11; No man init (#6087) 2019-05-07 10:12:00 -10:00
.editorconfig Added the style from .NET Foundation plus variances (#4575) 2018-12-07 00:55:31 +00: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 [Build] Update builds, remove submodule, update AssemblyInfo with GitInfo (#6068) 2019-05-22 01:06:59 +01:00
.xtc-manual-ios.bat Update xtc-manual-ios.bat 2017-11-08 11:25:02 -10:00
Directory.Build.props Merge branch '3.6.0' into 4.0.0 2019-05-22 16:23:05 +01:00
Directory.Build.targets [Build] Update builds, remove submodule, update AssemblyInfo with GitInfo (#6068) 2019-05-22 01:06:59 +01:00
GitInfo.txt Merge branch '4.0.0' 2019-03-27 17:14:57 -07: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
README.md update build script for mac and readme based on vs mac 2019 (#5827) 2019-04-08 09:48:23 -07:00
Version.targets Roll back assembly version to 2.0.0.0 (#6379) 2019-05-31 18:36:34 -07:00
Xamarin.Forms.mdpolicy Add Xamarin.Forms code policy file for XamarinStudio 2016-03-28 15:39:31 +01:00
Xamarin.Forms.sln Merge branch '4.0.0' into 4.1.0 2019-06-05 21:15:41 -07:00
Xamarin.Forms.sln.DotSettings [Shell,iOS,Android] Add Colors, Font, HorizontalAlignment. Keyboard, Focus to SearchHandler (#5810) 2019-05-09 10:42:18 -07:00
Xamarin.Forms.vssettings Update vssettings file to turn on Wrapping_PreserveSingleLine (#115) 2016-04-24 05:56:36 -07:00
azure-pipelines.yml [Build] Fix release variable name 2019-05-25 00:17:24 +01:00
banner.png [README] Add Xamarin.Forms banner (#757) 2017-02-09 22:02:30 +00:00
build.cake update build script for mac and readme based on vs mac 2019 (#5827) 2019-04-08 09:48:23 -07:00
build.ps1 Cake build script (#5074) 2019-02-12 13:05:51 +00:00
build.sh Cake build script (#5074) 2019-02-12 13:05:51 +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 (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
AppLinks Xamarin.Forms.AppLinks 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

Windows

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:

  • .NET desktop development - In the Summary > Optional select .NET Framework 4.7 SDK, .NET Framework 4.7 targeting pack.
  • 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)

The Android 7.0 Nougat API 24 SDK is required for developing Xamarin.Forms. It 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 2017 installed, you can verify that these features are installed by modifying the VS 2017 installation via the Visual Studio Installer.

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
  • When working on an earlier branch that does not have the cake scripts then you can use the following [build.sh] script(https://gist.github.com/PureWeen/92c1e1aff0c257c3decf0bcb8d6e9296)

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

    • 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

If you are on Visual Studio for Mac 2017 you will need to turn off automatic package restore (Visual Studio => Preferences => Nuget => General => uncheck the Package Restore box) before working on the Xamarin.Forms solution. This step is no longer needed with Visual Studio for Mac 2019

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 macOS you should specify the platform in the msbuild command (/p:Platform=iPhoneSimulator)

msbuild /restore 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.