.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.
Перейти к файлу
Vincent Dondain 39f6e6325f [README] Add Xamarin.Forms banner (#757)
This banner is similar to what we're using at open.xamarin.com
and to the installer's new splash screen images.

Xamarin.iOS is already using its banner.
2017-02-09 22:02:30 +00:00
.nuget
.nuspec [XamlC] Produce correct mdb files (#699) 2017-02-02 10:57:50 +01:00
AndroidNative/FormsViewGroup Revert "[*] ScaleX and ScaleY" 2017-02-06 15:18:16 +01:00
PagesGallery [Win] Update certs (#460) 2016-10-15 13:35:16 +01:00
Stubs Fix tests on IOS10 [Do not merge] (#373) 2016-10-04 00:45:57 +01:00
Xamarin.Forms.Build.Tasks [XamlC] support portable pdb (#726) 2017-02-06 09:33:18 +01:00
Xamarin.Forms.ControlGallery.Android [iOS] Labels with WordWrap or CharacterWrap will Expand (#529) 2017-01-12 11:48:30 -08:00
Xamarin.Forms.ControlGallery.MacOS Add MacOS gallery and UITest (#721) 2017-01-27 12:52:38 +00:00
Xamarin.Forms.ControlGallery.WP8 Fix potential NRE accessing current application via Page.RealParent (#330) 2016-09-27 14:50:02 +01:00
Xamarin.Forms.ControlGallery.Windows Fix out-of-memory crashes on iOS when creating maps (#467) 2017-01-12 13:43:57 -08:00
Xamarin.Forms.ControlGallery.WindowsPhone Fix out-of-memory crashes on iOS when creating maps (#467) 2017-01-12 13:43:57 -08:00
Xamarin.Forms.ControlGallery.WindowsUniversal Fix out-of-memory crashes on iOS when creating maps (#467) 2017-01-12 13:43:57 -08:00
Xamarin.Forms.ControlGallery.iOS Add MacOS gallery and UITest (#721) 2017-01-27 12:52:38 +00:00
Xamarin.Forms.Controls Revert "[*] ScaleX and ScaleY" 2017-02-06 15:18:16 +01:00
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared [iOS] Fix NavigationPage memory leak when back button title is set (#523) 2017-02-09 16:03:41 +00:00
Xamarin.Forms.Core Revert "[*] ScaleX and ScaleY" 2017-02-06 15:18:16 +01:00
Xamarin.Forms.Core.Android.UITests [UITest] Update to UITest 2.0.5 (#665) 2017-01-05 11:43:58 +00:00
Xamarin.Forms.Core.Design Warnings as Errors in product projects 2016-04-06 10:32:29 -07:00
Xamarin.Forms.Core.UnitTests Update RelativeLayout to make it respond to constraint changes (#425) 2017-02-02 13:55:54 -05:00
Xamarin.Forms.Core.Windows.UITests [All] Basic Accessibility Support (#713) 2017-01-31 11:49:15 -08:00
Xamarin.Forms.Core.iOS.UITests [MacOS] Fixes to ToolbarItems (#728) 2017-01-30 12:29:27 +00:00
Xamarin.Forms.Core.macOS.UITests [MacOS] Fixes to ToolbarItems (#728) 2017-01-30 12:29:27 +00:00
Xamarin.Forms.CustomAttributes Add TextColor Property to Picker, TimePicker, DatePicker (#84) 2016-04-19 00:01:58 -07:00
Xamarin.Forms.Maps MacOS (#650) 2017-01-26 15:33:15 +00:00
Xamarin.Forms.Maps.Android [iOS/Android] Move Map camera to correct region on layout change (#548) 2017-01-03 11:35:54 +00:00
Xamarin.Forms.Maps.Design Warnings as Errors in product projects 2016-04-06 10:32:29 -07:00
Xamarin.Forms.Maps.MacOS MacOS (#650) 2017-01-26 15:33:15 +00:00
Xamarin.Forms.Maps.MacOS.Extra MacOS (#650) 2017-01-26 15:33:15 +00:00
Xamarin.Forms.Maps.UWP [UWP]Track user location when IsShowingUser enabled (#556) 2016-11-22 13:02:12 +00:00
Xamarin.Forms.Maps.WP8 Maps.WP8 warning as error mop up (#79) 2016-04-13 17:15:21 +01:00
Xamarin.Forms.Maps.WinRT.Phone Mop up enabling warnings as errors (#78) 2016-04-12 11:44:30 -07:00
Xamarin.Forms.Maps.WinRT.Tablet Mop up enabling warnings as errors (#78) 2016-04-12 11:44:30 -07:00
Xamarin.Forms.Maps.iOS Add MacOS gallery and UITest (#721) 2017-01-27 12:52:38 +00:00
Xamarin.Forms.Pages fix weakreferences (#558) 2016-11-24 20:34:46 +01:00
Xamarin.Forms.Pages.Azure Azure support (#143) 2016-04-27 14:48:28 -04:00
Xamarin.Forms.Pages.UnitTests [Controls] Update Insights and UITest packages and fix warnings (#361) 2016-09-18 11:24:44 -07:00
Xamarin.Forms.Platform Remove ToolBar from Core; Remove ToolBar renderers and unit tests (#124) 2016-04-25 12:52:48 -04:00
Xamarin.Forms.Platform.Android Revert "[*] ScaleX and ScaleY" 2017-02-06 15:18:16 +01:00
Xamarin.Forms.Platform.Android.AppLinks Fix tests on IOS10 [Do not merge] (#373) 2016-10-04 00:45:57 +01:00
Xamarin.Forms.Platform.Android.FormsViewGroup Set AndroidCodeGenTarget to XAJavaInterop1 (#404) 2016-09-30 12:36:58 -07:00
Xamarin.Forms.Platform.MacOS [macOS] Adds Scrollbars to ListViews and ScrollViews (#740) 2017-02-03 16:25:34 +00:00
Xamarin.Forms.Platform.UAP Fix disappearing ListView text when changing color settings on Windows (#731) 2017-02-03 10:13:53 -08:00
Xamarin.Forms.Platform.WP8 Revert "[*] ScaleX and ScaleY" 2017-02-06 15:18:16 +01:00
Xamarin.Forms.Platform.WinRT Revert "[*] ScaleX and ScaleY" 2017-02-06 15:18:16 +01:00
Xamarin.Forms.Platform.WinRT.Phone [All] Basic Accessibility Support (#713) 2017-01-31 11:49:15 -08:00
Xamarin.Forms.Platform.WinRT.Tablet [All] Basic Accessibility Support (#713) 2017-01-31 11:49:15 -08:00
Xamarin.Forms.Platform.iOS [iOS] Fix NavigationPage memory leak when back button title is set (#523) 2017-02-09 16:03:41 +00:00
Xamarin.Forms.Xaml [Xaml] do not set properties with private setters (#717) 2017-02-02 15:28:59 +01:00
Xamarin.Forms.Xaml.Design Enable warnings as errors in XAML 2016-04-06 23:08:17 -07:00
Xamarin.Forms.Xaml.UnitTests [Xaml] do not set properties with private setters (#717) 2017-02-02 15:28:59 +01:00
Xamarin.Forms.Xaml.Xamlc [XamlC] Produce correct mdb files (#699) 2017-02-02 10:57:50 +01:00
Xamarin.Forms.Xaml.Xamlg Enable warnings as errors in XAML 2016-04-06 23:08:17 -07:00
docs Add TV to TargetIdiom (#738) 2017-02-02 19:25:40 +00:00
tools/mdoc
.editorconfig Added .editorconfig (#192) 2016-05-26 13:39:00 -07:00
.gitattributes
.gitignore Add .bak extension to .gitignore (#388) 2016-09-27 23:15:53 +01:00
LICENSE Fix license copy 2016-04-29 13:41:50 -04:00
Makefile fix mdoc path in Makefile 2016-11-22 15:41:01 +01:00
PULL_REQUEST_TEMPLATE.md Update PULL_REQUEST_TEMPLATE.md 2016-03-23 10:42:54 -07:00
README.md [README] Add Xamarin.Forms banner (#757) 2017-02-09 22:02:30 +00:00
Xamarin.Forms.mdpolicy Add Xamarin.Forms code policy file for XamarinStudio 2016-03-28 15:39:31 +01:00
Xamarin.Forms.sln Add MacOS gallery and UITest (#721) 2017-01-27 12:52:38 +00:00
Xamarin.Forms.sln.DotSettings Creating category constants for UI test categories (#487) 2016-11-15 11:39:23 -08:00
Xamarin.Forms.vssettings Update vssettings file to turn on Wrapping_PreserveSingleLine (#115) 2016-04-24 05:56:36 -07:00
banner.png [README] Add Xamarin.Forms banner (#757) 2017-02-09 22:02:30 +00:00
debug.keystore Add missing debug.keystore 2016-03-22 18:07:44 -07:00
update-docs-windows.bat Evolve feature branch (#117) 2016-04-24 12:25:26 -04:00
update-docs.ps1 Normalize docs (#159) 2016-05-11 15:41:05 +01:00

README.md

Xamarin.Forms banner # 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.