.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.
Перейти к файлу
Rui Marinho 3b6eea5632
[Build] Update submodule with XCode 9.3 support
2018-04-13 15:40:27 +01:00
.nuspec [Nuget] Update nuspec's with msft info (#2108) 2018-03-15 13:54:43 +00:00
AndroidNative [A] add building instructions 2017-05-05 11:37:28 +02:00
EmbeddingTestBeds Make bundle identifier pattern for test apps consistent 2018-04-05 09:24:48 -06:00
PagesGallery Make bundle identifier pattern for test apps consistent 2018-04-05 09:24:48 -06:00
Stubs Fix VS errors when loading clean solution; prevent VS rewriting Android project files (#2083) 2018-03-14 11:01:44 +00:00
Xamarin.Flex [Flex] correctly measure images (#2010) 2018-03-06 10:50:07 +01:00
Xamarin.Forms.Build@ac0d396333 [Build] Update submodule with XCode 9.3 support 2018-04-13 15:40:27 +01:00
Xamarin.Forms.Build.Tasks [XamlC] cache ImportReference and ImportMethodReference as they're slow (#2025) 2018-04-11 21:36:11 +02:00
Xamarin.Forms.ControlGallery.Android Fix VS errors when loading clean solution; prevent VS rewriting Android project files (#2083) 2018-03-14 11:01:44 +00:00
Xamarin.Forms.ControlGallery.GTK [GTK] Added Maps project (#1349) 2017-12-09 00:34:51 +00:00
Xamarin.Forms.ControlGallery.MacOS [MacOS] Workaround for 15.6 mac targets issue 2018-03-19 15:22:02 +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 Added WPFLightToolkit ResourceDictionary to WPF Platform project. This prevents the user from having to add it to the resources of their Application. (#1560) 2018-01-12 17:35:02 +00:00
Xamarin.Forms.ControlGallery.WindowsUniversal Merge branch '15-5' into 3.0.0 2018-02-27 10:32:57 -08:00
Xamarin.Forms.ControlGallery.iOS Add 5-tap escape back to main screen 2018-04-05 13:22:50 -06:00
Xamarin.Forms.Controls Fix VS errors when loading clean solution; prevent VS rewriting Android project files (#2083) 2018-03-14 11:01:44 +00:00
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared Merge pull request #2428 from xamarin/fix-gh2369 fixes #2369 2018-04-13 10:59:49 +01:00
Xamarin.Forms.Core set ChangeVisualState to internal protected 2018-04-09 15:47:16 -06:00
Xamarin.Forms.Core.Android.UITests [iOS] ViewDidLayoutSubviews after removing page (#1532) fixes #1426 2018-02-20 12:30:32 +00:00
Xamarin.Forms.Core.Design [Designer] Do not prefix the toolbox images 2018-04-11 17:40:55 +01:00
Xamarin.Forms.Core.UITests.Shared Reorder ToolbarButtons tests so the primary buttons can't be covered 2018-03-22 10:37:48 -07:00
Xamarin.Forms.Core.UnitTests added unit test 2018-04-09 15:45:19 -06:00
Xamarin.Forms.Core.Windows.UITests [iOS] ViewDidLayoutSubviews after removing page (#1532) fixes #1426 2018-02-20 12:30:32 +00:00
Xamarin.Forms.Core.iOS.UITests [iOS] ViewDidLayoutSubviews after removing page (#1532) fixes #1426 2018-02-20 12:30:32 +00:00
Xamarin.Forms.Core.macOS.UITests [iOS] ViewDidLayoutSubviews after removing page (#1532) fixes #1426 2018-02-20 12:30:32 +00:00
Xamarin.Forms.CustomAttributes Implemented MaxLength property on Entry and Editor (#1880) 2018-02-19 14:27:27 -08:00
Xamarin.Forms.Maps Add netstandard1.0 support (#1649) 2018-02-08 18:18:56 +00:00
Xamarin.Forms.Maps.Android Fix VS errors when loading clean solution; prevent VS rewriting Android project files (#2083) 2018-03-14 11:01:44 +00:00
Xamarin.Forms.Maps.Design [Nuspec] Add .Design dll.s back (#1884) 2018-02-15 11:08:16 +00:00
Xamarin.Forms.Maps.GTK [GTK] Added Maps project (#1349) 2017-12-09 00:34:51 +00:00
Xamarin.Forms.Maps.MacOS [MacOS] Workaround for 15.6 mac targets issue 2018-03-19 15:22:02 +00:00
Xamarin.Forms.Maps.Tizen Support Page embedding to Tizen backend (#1506) 2018-01-08 19:19:19 +00:00
Xamarin.Forms.Maps.UWP Add netstandard1.0 support (#1649) 2018-02-08 18:18:56 +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 Add netstandard1.0 support (#1649) 2018-02-08 18:18:56 +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 Add netstandard1.0 support (#1649) 2018-02-08 18:18:56 +00:00
Xamarin.Forms.Platform.Android Merge branch '15-5' into 3.0.0 2018-04-02 10:59:17 +01:00
Xamarin.Forms.Platform.Android.AppLinks Fix VS errors when loading clean solution; prevent VS rewriting Android project files (#2083) 2018-03-14 11:01:44 +00:00
Xamarin.Forms.Platform.Android.FormsViewGroup Fix VS errors when loading clean solution; prevent VS rewriting Android project files (#2083) 2018-03-14 11:01:44 +00:00
Xamarin.Forms.Platform.GTK Implemented MaxLength property on Entry and Editor (#1880) 2018-02-19 14:27:27 -08:00
Xamarin.Forms.Platform.MacOS [MacOS] Workaround for 15.6 mac targets issue 2018-03-19 15:22:02 +00:00
Xamarin.Forms.Platform.Tizen Support CascadeInputTransparent to Tizen (#1916) 2018-02-21 18:03:45 +00:00
Xamarin.Forms.Platform.UAP Fix potential crash when more than two alerts are requested. 2018-04-11 11:00:36 -06:00
Xamarin.Forms.Platform.WPF Implemented MaxLength property on Entry and Editor (#1880) 2018-02-19 14:27:27 -08:00
Xamarin.Forms.Platform.iOS [iOS] Grouped ListView will no longer crash when its ItemSource is cleared (#2323) 2018-04-09 10:14:46 -07:00
Xamarin.Forms.Xaml [Xaml[C]] properly parse nested markups (#2185) 2018-03-26 15:04:52 +02:00
Xamarin.Forms.Xaml.Design [Nuspec] Add .Design dll.s back (#1884) 2018-02-15 11:08:16 +00:00
Xamarin.Forms.Xaml.UnitTests [Xaml[C]] properly parse nested markups (#2185) 2018-03-26 15:04:52 +02:00
Xamarin.Forms.Xaml.Xamlc [build] reduce verbosity of build (#1837) 2018-02-08 14:31:35 +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 Removing docs 2018-03-23 10:39:43 -06: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 Fix IndexOutOfRangeException for iOS ListView (#1463) 2018-01-02 10:58:21 +00:00
.create-nuget.bat Allow arbitrary nuget version 2018-02-08 13:36: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 netstandard1.0 support (#1649) 2018-02-08 18:18:56 +00:00
.gitmodules Use relative URL to support recursive checkout in VSTS (#1926) 2018-02-20 12:23:57 +00: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 Removing docs 2018-03-23 10:39:43 -06:00
Xamarin.Forms.mdpolicy Add Xamarin.Forms code policy file for XamarinStudio 2016-03-28 15:39:31 +01:00
Xamarin.Forms.sln remove reference to APIDocs.shproj 2018-03-26 11:03:13 +02: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
global.json [All] Move to netstandard2.0 **Breaking change** (#1306) 2017-11-29 17:37:06 +00: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

Visual Studio Team Services

Packages

Platform/Feature Package name Stable (2.5.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 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

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.