28948d7ef7
* Port from old VSM branch * Add PS and notes * Checkpoint: entry text UWP mostly working, need to check on background colors * Remove irrelevant samples from the EntryDisabledStatesGallery Make Background color work on UWP Entry with VSM * Add platform specific for disabling legacy colors on Android * Add OnPlatform example to visual state manager gallery * Add example OnIdiom in Visual State Manager * Add platform specific for disabling legacy color mode on iOS Entry * Add gallery for Button disabled states Handling legacy colors for Buttons on Android * Split out disabled states galleries; disabled legacy handling for Picker * TimePicker disabled states * DatePicker color management on Android * Color management for pre-AppCompat button * Button legacy color handling on iOS * Consolidate Platform Specifics; legacy colors working for iOS Picker and DatePicker * Fix broken search bar color management SearchBar color management working with VSM Add test page for SearchBar disabled color management Consolidate legacy color management check code into extension method on Android * Legacy color management for Editor on Android * Fix legacy color stuff for SearchBar Cancel button on iOS * C# 7 cleanup * Add colors for Cancel Button * Make sure VisualStateGroup collections set by styles are distinct objects * Validation example * Make common state names consts * Make the Windows VSM and Forms VSM work together * Update galleries for Windows * Make new methods internal * Split gallery classes and add more explanation to validation example * Remove debugging statements * Add a quick code-only example * Make legacy color management work for fast button renderer * Remove old TODO * Update docs * Move RunTimeNamePropertyAttribute to Xamarin.Forms.Xaml namespace * Verify XF namespace when looking for VisualState * Use nameof * Make common states constants public * Cast VisualElement directly so it crashes if the property is set on the wrong type * Collection -> IList for VisualStateManager * Setting fromStyle to true * Remove extraneous `private set` * Seal VSM classes * Use constraints instead of == * Add teardown method; use constraints rather than == * Remove null checking with GetVisualStateGroups * Don't explicitly initialize collections on elements * Actually, turns out that fromStyle:false *was* correct * Direct casts * Use GetIsDefault check in GoToState * Validate parents in FindTypeForVisualState * Validate group and state names on Add * Fixed check for setter collection * Fix issues with "duplicate" names when VisualStateGroups declared directly on VisualElements * Add gallery example for VSGs directly on VisualElements * Update docs * Fix bug where initial TextColor isn't set for FastRenderer Button * Move to explicit VisualStateGroupList in Setter * Fix return types for unit tests * Using string.CompareOrdinal in GetState * Update docs * Add check for null/empty VisualState Name properties |
||
---|---|---|
.nuspec | ||
AndroidNative | ||
EmbeddingTestBeds | ||
PagesGallery | ||
Stubs | ||
Xamarin.Forms.Build@67baac60cf | ||
Xamarin.Forms.Build.Tasks | ||
Xamarin.Forms.ControlGallery.Android | ||
Xamarin.Forms.ControlGallery.GTK | ||
Xamarin.Forms.ControlGallery.MacOS | ||
Xamarin.Forms.ControlGallery.Tizen | ||
Xamarin.Forms.ControlGallery.WPF | ||
Xamarin.Forms.ControlGallery.WindowsUniversal | ||
Xamarin.Forms.ControlGallery.iOS | ||
Xamarin.Forms.Controls | ||
Xamarin.Forms.Controls.Issues/Xamarin.Forms.Controls.Issues.Shared | ||
Xamarin.Forms.Core | ||
Xamarin.Forms.Core.Android.UITests | ||
Xamarin.Forms.Core.Design | ||
Xamarin.Forms.Core.UITests.Shared | ||
Xamarin.Forms.Core.UnitTests | ||
Xamarin.Forms.Core.Windows.UITests | ||
Xamarin.Forms.Core.iOS.UITests | ||
Xamarin.Forms.Core.macOS.UITests | ||
Xamarin.Forms.CustomAttributes | ||
Xamarin.Forms.Maps | ||
Xamarin.Forms.Maps.Android | ||
Xamarin.Forms.Maps.Design | ||
Xamarin.Forms.Maps.GTK | ||
Xamarin.Forms.Maps.MacOS | ||
Xamarin.Forms.Maps.Tizen | ||
Xamarin.Forms.Maps.UWP | ||
Xamarin.Forms.Maps.WPF | ||
Xamarin.Forms.Maps.iOS | ||
Xamarin.Forms.Pages | ||
Xamarin.Forms.Pages.Azure | ||
Xamarin.Forms.Pages.UnitTests | ||
Xamarin.Forms.Platform | ||
Xamarin.Forms.Platform.Android | ||
Xamarin.Forms.Platform.Android.AppLinks | ||
Xamarin.Forms.Platform.Android.FormsViewGroup | ||
Xamarin.Forms.Platform.GTK | ||
Xamarin.Forms.Platform.MacOS | ||
Xamarin.Forms.Platform.Tizen | ||
Xamarin.Forms.Platform.UAP | ||
Xamarin.Forms.Platform.WPF | ||
Xamarin.Forms.Platform.iOS | ||
Xamarin.Forms.Xaml | ||
Xamarin.Forms.Xaml.Design | ||
Xamarin.Forms.Xaml.UnitTests | ||
Xamarin.Forms.Xaml.Xamlc | ||
Xamarin.Forms.Xaml.Xamlg | ||
docs | ||
tools/mdoc | ||
.Xamarin.Forms.Android.sln | ||
.Xamarin.Forms.iOS.sln | ||
.create-nuget.bat | ||
.editorconfig | ||
.gitattributes | ||
.gitignore | ||
.gitmodules | ||
.xtc-manual-ios.bat | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
ISSUE_TEMPLATE.md | ||
LICENSE | ||
Makefile | ||
PULL_REQUEST_TEMPLATE.md | ||
README.md | ||
Xamarin.Forms.mdpolicy | ||
Xamarin.Forms.sln | ||
Xamarin.Forms.sln.DotSettings | ||
Xamarin.Forms.vssettings | ||
banner.png | ||
debug.keystore | ||
global.json | ||
update-docs-windows.bat | ||
update-docs.ps1 |
README.md
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
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:
Win8MapsAuthKey
,WinPhoneMapsAuthKey
, andUWPMapsAuthKey
at https://www.microsoft.com/maps/create-a-bing-maps-key.aspxInsightsApiKey
at https://insights.xamarin.com/WP8AppId
andWP8AuthToken
at https://dev.windows.com/.
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 toText Editor > C#
and selecting the "Keep tabs" radio option. In Visual Studio for Mac it's set via preferences inSource Code > Code Formatting > C# source code
and disabling the checkbox forConvert 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 theDesired file width
to120
.
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.