.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.
Перейти к файлу
E.Z. Hart 77851e6ff7
Update image in GH1613 to valid image we control
2017-12-28 16:46:30 -07:00
.nuspec [WPF] Platform and Maps nuget package (#1445) 2017-12-21 19:40:07 +00:00
AndroidNative [A] add building instructions 2017-05-05 11:37:28 +02:00
EmbeddingTestBeds Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
PagesGallery Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
Stubs Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
Xamarin.Forms.Build@0cee3108a2 Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
Xamarin.Forms.Build.Tasks Stylesheets (#1207) 2017-12-20 10:47:50 +01:00
Xamarin.Forms.ControlGallery.Android Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
Xamarin.Forms.ControlGallery.GTK [GTK] Added Maps project (#1349) 2017-12-09 00:34:51 +00:00
Xamarin.Forms.ControlGallery.MacOS [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.ControlGallery.Tizen Add Xamarin.Forms.ControlGallery.Tizen project (#1389) 2017-12-13 14:31:19 +00:00
Xamarin.Forms.ControlGallery.WPF [WPF] Platform and Maps nuget package (#1445) 2017-12-21 19:40:07 +00:00
Xamarin.Forms.ControlGallery.WindowsUniversal [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.ControlGallery.iOS Revert "[UITest] Update TestCloud agent" 2017-12-06 12:58:00 +00:00
Xamarin.Forms.Controls Replace invalid image URLs with images we control; 2017-12-28 16:23:23 -07:00
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared Update image in GH1613 to valid image we control 2017-12-28 16:46:30 -07:00
Xamarin.Forms.Core Add implicit color conversion to .NET Standard's System.Drawing.Color (#1359) 2017-12-21 10:02:54 +01:00
Xamarin.Forms.Core.Android.UITests [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Core.Design [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Core.UITests.Shared Reinstate test; 2017-12-28 16:24:20 -07:00
Xamarin.Forms.Core.UnitTests Add implicit color conversion to .NET Standard's System.Drawing.Color (#1359) 2017-12-21 10:02:54 +01:00
Xamarin.Forms.Core.Windows.UITests [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Core.iOS.UITests Add delay between scrollTo commands in 40704 test 2017-12-27 14:06:23 -07:00
Xamarin.Forms.Core.macOS.UITests [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.CustomAttributes [All] Implement IFontElement on Picker, DatePicker, and TimePicker (#662) 2017-12-12 14:02:21 +00:00
Xamarin.Forms.Maps [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Maps.Android Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
Xamarin.Forms.Maps.Design [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Maps.GTK [GTK] Added Maps project (#1349) 2017-12-09 00:34:51 +00:00
Xamarin.Forms.Maps.MacOS [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Maps.Tizen Use GlobalAssemblyInfo on tizen backend (#1397) 2017-12-15 09:56:15 +00:00
Xamarin.Forms.Maps.UWP [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Maps.WPF [WPF] Platform and Maps nuget package (#1445) 2017-12-21 19:40:07 +00:00
Xamarin.Forms.Maps.iOS [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Pages [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +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 [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Platform [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Platform.Android Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
Xamarin.Forms.Platform.Android.AppLinks Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
Xamarin.Forms.Platform.Android.FormsViewGroup [Test] Make sure we always test with different Cultures (#1219) 2017-10-24 10:41:33 +02:00
Xamarin.Forms.Platform.GTK [WPF, GTK, TIZEN] Replace obsolete OutlineColor by BorderColor (#1443) 2017-12-21 09:18:07 +01:00
Xamarin.Forms.Platform.MacOS Stylesheets (#1207) 2017-12-20 10:47:50 +01:00
Xamarin.Forms.Platform.Tizen [WPF, GTK, TIZEN] Replace obsolete OutlineColor by BorderColor (#1443) 2017-12-21 09:18:07 +01:00
Xamarin.Forms.Platform.UAP [UWP] Use RawPixelsPerViewPixel for ScalingFactor (#1142) 2017-12-21 23:29:31 +00:00
Xamarin.Forms.Platform.WPF [WPF] Platform and Maps nuget package (#1445) 2017-12-21 19:40:07 +00:00
Xamarin.Forms.Platform.iOS [iOS] Redirect PreferredStatusBarStyle to the Child View Controller (#1175) 2017-12-22 01:14:36 +00:00
Xamarin.Forms.Xaml Stylesheets (#1207) 2017-12-20 10:47:50 +01:00
Xamarin.Forms.Xaml.Design [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
Xamarin.Forms.Xaml.UnitTests Stylesheets (#1207) 2017-12-20 10:47:50 +01:00
Xamarin.Forms.Xaml.Xamlc revert part of #1370. keep the test project out of netstandard for now (#1402) 2017-12-14 13:21:50 +01:00
Xamarin.Forms.Xaml.Xamlg revert part of #1370. keep the test project out of netstandard for now (#1402) 2017-12-14 13:21:50 +01:00
docs Bump submodule and update docs (#1452) 2017-12-21 19:10:25 +00:00
tools/mdoc Add missing mdoc tooling 2016-03-22 17:28:19 -07:00
.Xamarin.Forms.Android.sln Update sln; Revert Android SDK version (#1314) 2017-12-05 16:58:10 -10:00
.Xamarin.Forms.iOS.sln Update sln; Revert Android SDK version (#1314) 2017-12-05 16:58:10 -10:00
.editorconfig Added .editorconfig (#192) 2016-05-26 13:39:00 -07:00
.gitattributes Force git to checkout docs using unix line endings (#766) 2017-02-15 08:43:58 +01:00
.gitignore Add more UWP automated testing capabilities (#1252) 2017-11-10 10:52:25 +00:00
.gitmodules Use Xamarin.Forms.Build (#1092) 2017-08-10 09:50:25 +01:00
.xtc-manual-ios.bat Update xtc-manual-ios.bat 2017-11-08 11:25:02 -10:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2017-12-09 13:29:16 -06:00
CONTRIBUTING.md Update CONTRIBUTING.md 2017-12-09 13:32:58 -06:00
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md 2017-12-07 11:31:52 -08: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
PULL_REQUEST_TEMPLATE.md Update PULL_REQUEST_TEMPLATE.md 2016-03-23 10:42:54 -07:00
README.md Removed reference to Evolution forums 2017-12-05 11:49:18 -06:00
Xamarin.Forms.mdpolicy Add Xamarin.Forms code policy file for XamarinStudio 2016-03-28 15:39:31 +01:00
Xamarin.Forms.sln [WPF] Platform and Maps nuget package (#1445) 2017-12-21 19:40:07 +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
create-nuget.bat Update create-nuget.bat 2017-03-14 07:33:20 -07:00
debug.keystore Add missing debug.keystore 2016-03-22 18:07:44 -07:00
global.json [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00:00
update-docs-windows.bat [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00: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, Windows and macOS, completely in C#.

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

Build Status

OSX Debug Teamcity

Windows Debug Teamcity

Android UI Tests Teamcity

iOS8 UI Tests Teamcity

iOS9 UI Tests Teamcity

iOS10 UI Tests Teamcity

Visual Studio Team Services Windows Debug

Visual Studio Team Services OSX Debug

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 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.