uno/README.md

121 строка
10 KiB
Markdown
Исходник Обычный вид История

2023-12-20 22:43:06 +03:00
<h1 align=center>
2019-10-15 23:14:52 +03:00
<img align=center width="25%" src="https://raw.githubusercontent.com/unoplatform/styleguide/master/logo/uno-platform-logo-with-text.png" />
</h1>
2019-10-04 23:27:41 +03:00
2021-06-18 15:37:20 +03:00
## Pixel-Perfect. Multi-Platform. C# & Windows XAML. Today.
2019-10-04 23:29:36 +03:00
2019-11-02 00:23:54 +03:00
[![Open Uno in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/unoplatform/uno)
2019-11-05 00:56:15 +03:00
[![Azure DevOps](https://img.shields.io/azure-devops/build/uno-platform/1dd81cbd-cb35-41de-a570-b0df3571a196/5/master?label=master)](https://uno-platform.visualstudio.com/Uno%20Platform/_build?definitionId=5)
2019-10-14 19:22:49 +03:00
[![Twitter Followers](https://img.shields.io/twitter/follow/unoplatform?label=follow%20%40unoplatform&style=flat)](https://twitter.com/unoplatform)
[![GitHub Stars](https://img.shields.io/github/stars/unoplatform/uno?label=github%20stars)](https://github.com/unoplatform/uno/stargazers/)
[![NuGet Downloads](https://img.shields.io/nuget/dt/uno.ui.svg)](https://www.nuget.org/packages/uno.ui)
[![All Contributors](https://img.shields.io/github/contributors/unoplatform/uno.svg)](https://GitHub.com/unoplatform/uno/graphs/contributors)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/unoplatform/uno/blob/master/CONTRIBUTING.md)
2018-05-24 21:53:31 +03:00
2021-06-18 15:37:20 +03:00
# What is the Uno Platform?
2023-11-02 00:57:52 +03:00
The Uno Platform is an Open-source platform for building single codebase native mobile, web, desktop and embedded apps quickly.
2021-06-18 15:37:20 +03:00
It allows C# and WinUI XAML and/or C# code to run on all target platforms while allowing you control of every pixel. It comes with support for Fluent, Material, and Cupertino design systems out of the box. Uno Platform implements a growing number of the WinRT and WinUI APIs, such as **Microsoft.UI.Xaml**, to enable WinUI applications to run on all platforms with native performance.
2018-05-24 21:53:31 +03:00
2023-11-02 00:57:52 +03:00
Use the WinUI tooling from Windows in [Visual Studio](https://www.visualstudio.com/), such as [XAML Hot Reload](https://docs.microsoft.com/en-us/visualstudio/xaml-tools/xaml-hot-reload?view=vs-2019) and [C# Hot Reload](https://learn.microsoft.com/en-us/visualstudio/debugger/hot-reload), build your application as much as possible on Windows, then validate that your application runs on iOS, Android, macOS, and WebAssembly.
2018-05-24 21:53:31 +03:00
Visit [our documentation](doc/articles/intro.md) for more details.
2018-05-24 21:53:31 +03:00
# Getting Started
2018-07-26 06:12:35 +03:00
2023-11-22 18:56:59 +03:00
See the complete [Getting Started](https://platform.uno/docs/articles/get-started.html) guides for starting with Visual Studio, Visual Studio Code, or JetBrains Rider.
For a larger example and features demo:
2021-06-18 15:37:20 +03:00
* Visit the [Uno Gallery](https://github.com/unoplatform/uno.gallery) repository.
* Try the [WebAssembly Uno Playground](https://playground.platform.uno) live in your browser.
2018-07-26 06:12:35 +03:00
2021-06-18 15:37:20 +03:00
# Uno Platform Features
2018-05-24 21:53:31 +03:00
* Supported platforms:
2023-12-21 16:16:01 +03:00
* Windows 10 and Windows 11
2023-11-02 00:57:52 +03:00
* Windows 7 (via Skia+WPF)
* iOS, Mac Catalyst and Android (via [Xamarin](https://www.visualstudio.com/xamarin/) and [.NET](https://dotnet.microsoft.com/))
2021-06-18 15:37:20 +03:00
* WebAssembly through the [.NET Runtime WebAssembly SDK](https://github.com/dotnet/runtime/tree/main/src/mono/wasm)
* Linux through Skia (Gtk and FrameBuffer)
* Dev loop:
2018-05-24 21:53:31 +03:00
* Develop on Windows first using Visual Studio
2021-11-28 23:34:01 +03:00
* [XAML Hot Reload](https://blogs.msdn.microsoft.com/visualstudio/2016/04/06/ui-development-made-easier-with-xaml-edit-continue/) for live XAML edition on each keystroke
2023-11-02 00:57:52 +03:00
* [C# Hot Reload](https://learn.microsoft.com/en-us/visualstudio/debugger/hot-reload) on Windows (VS2022), Linux and macOS (VS Code)
2018-05-24 21:53:31 +03:00
* Validate on other platforms as late as possible
2021-11-28 23:34:01 +03:00
* Develop in VS Code, Codespaces or GitPod
* XAML and/or C# Hot Reload for WebAssembly, Linux, iOS and Android
2019-09-18 21:49:04 +03:00
* [Uno.UITest](https://github.com/unoplatform/Uno.UITest), a library to create Cross-Platform UI Tests for WebAssembly, iOS and Android.
* Cross Platform Controls:
2018-05-24 21:53:31 +03:00
* [Control Templating](https://docs.microsoft.com/en-us/windows/uwp/design/controls-and-patterns/control-templates)
* [Data Templating](https://code.msdn.microsoft.com/Data-Binding-in-UWP-b5c98114)
* [Styling](https://docs.microsoft.com/en-us/windows/uwp/design/controls-and-patterns/xaml-styles)
* [Rich Animations](https://docs.microsoft.com/en-us/windows/uwp/design/motion/xaml-animation)
2021-06-18 15:37:20 +03:00
* UWP/WinUI Code Support:
2023-11-02 00:57:52 +03:00
* [Windows Community Toolkit](https://github.com/CommunityToolkit/Windows)
* [Windows Community Toolkit (Uno Fork)](https://github.com/unoplatform/uno.WindowsCommunityToolkit)
* [MVVM Light Toolkit](https://github.com/unoplatform/uno.mvvmlight)
* [Microsoft XAML Behaviors](https://github.com/unoplatform/uno.XamlBehaviors)
2021-06-18 15:37:20 +03:00
* [Prism](https://github.com/prismlibrary/prism)
* [SkiaSharp](https://github.com/mono/SkiaSharp)
* [SkiaSharp.Extended](https://github.com/mono/SkiaSharp.Extended)
2018-05-24 21:53:31 +03:00
* [MVVMCross](https://www.mvvmcross.com/) (soon)
* [ReactiveUI Official](https://github.com/reactiveui/ReactiveUI/pull/2067)
* [WindowsStateTriggers](https://github.com/unoplatform/uno.WindowsStateTriggers)
* [Xamarin.Forms for UWP](https://github.com/unoplatform/uno.Xamarin.Forms), [NuGet](https://www.nuget.org/packages/ReactiveUI.Uno)
2019-09-18 21:49:04 +03:00
* [Rx.NET](https://github.com/reactiveui/Reactive.Wasm)
* [ColorCode-Universal](https://github.com/unoplatform/uno.ColorCode-Universal)
* [LibVLCSharp](https://github.com/videolan/libvlcsharp)
2023-03-08 19:51:19 +03:00
* [MapsUI](https://github.com/Mapsui/Mapsui)
* [LiveCharts](https://github.com/beto-rodriguez/LiveCharts2)
2018-05-24 21:53:31 +03:00
* Any UWP project
* Responsive Design:
2023-12-20 22:43:06 +03:00
* [Visual State Manager](https://docs.microsoft.com/en-us/uwp/api/Microsoft.UI.Xaml.VisualStateManager)
2018-05-24 21:53:31 +03:00
* [State Triggers](https://blogs.msdn.microsoft.com/mvpawardprogram/2017/02/07/state-triggers-uwp-apps/)
2023-12-20 22:43:06 +03:00
* [Adaptive Triggers](https://docs.microsoft.com/en-us/uwp/api/Microsoft.UI.Xaml.AdaptiveTrigger)
* Platform Specific:
2021-08-07 19:43:23 +03:00
* Native controls and properties via [conditional XAML](doc/articles/platform-specific-xaml.md)
2018-05-24 21:53:31 +03:00
* Any of the existing Xamarin iOS/Android libraries available
* Xamarin.Forms Renderers:
2019-09-18 21:49:04 +03:00
* [Uno Platform WebAssembly Renderers for Xamarin.Forms](https://github.com/unoplatform/Uno.Xamarin.Forms.Platform)
2018-05-24 21:53:31 +03:00
# Live WebAssembly Apps
2018-05-24 21:53:31 +03:00
Here's a list of live apps made with the Uno Platform for WebAssembly.
* The [Uno Platform Playground](https://playground.platform.uno) ([Source](https://github.com/unoplatform/uno.Playground)).
2022-05-18 01:07:23 +03:00
* The [Uno Gallery](https://gallery.platform.uno) demonstrates the use of Fluent and Material guidelines.
2021-11-28 23:34:01 +03:00
* The [NuGet Package Explorer](https://nuget.info) ([Source](https://github.com/NuGetPackageExplorer/NuGetPackageExplorer)).
2021-06-18 15:37:20 +03:00
* The [Uno Calculator](https://calculator.platform.uno), a simple yet powerful iOS/Android/WebAssembly C# port of the calculator that ships with Windows ([Source](https://github.com/unoplatform/calculator)). Also try the [iOS version](https://apps.apple.com/app/id1464736591), the [Android version](https://play.google.com/store/apps/details?id=uno.platform.calculator) and [Linux version](https://snapcraft.io/uno-calculator).
2023-11-02 00:57:52 +03:00
* The [Community Toolkit Labs App](https://toolkitlabs.dev/)
* [SkiaSharp fork for the Uno Platform](https://skiasharp-wasm.platform.uno/), Skia is a cross-platform 2D graphics API for .NET platforms based on Google's Skia Graphics Library ([Source](https://github.com/unoplatform/Uno.SkiaSharp)).
2019-10-14 19:22:49 +03:00
* The [Uno.WindowsCommunityToolkit](https://windowstoolkit-wasm.platform.uno/) ([Source](https://github.com/unoplatform/uno.WindowsCommunityToolkit)).
* The [Uno.Lottie](https://lottie.platform.uno/), a sample that uses the [AnimatedVisualPlayer](https://docs.microsoft.com/en-us/uwp/api/microsoft.ui.xaml.controls.animatedvisualplayer) ([Source](https://github.com/unoplatform/uno.LottieSample)).
* The [Uno.RoslynQuoter](https://roslynquoter-wasm.platform.uno/), a [Roslyn](https://github.com/dotnet/roslyn) based C# analysis tool ([Source](https://github.com/unoplatform/uno.RoslynQuoter)).
* The [Uno.BikeSharing360 App](http://bikerider-wasm.platform.uno/), a Xamarin.Forms app running on top of Uno for WebAssembly ([Source](https://github.com/unoplatform/uno.BikeSharing360_MobileApps)).
* The [Uno.WindowsStateTriggers App](http://winstatetriggers-wasm.platform.uno/), a demo of the [Morten's WindowsStateTriggers](https://github.com/dotMorten/WindowsStateTriggers) ([Source](https://github.com/unoplatform/uno.WindowsStateTriggers)).
* The [SQLite + Entity Framework Core App](https://sqliteefcore-wasm.platform.uno), a demo of the combination of [Roslyn](https://github.com/dotnet/roslyn), [Entity Framework Core](https://docs.microsoft.com/en-us/ef/core/), [SQLite](https://github.com/unoplatform/uno.SQLitePCLRaw.Wasm) and the Uno Platform to manipulate an in-browser database.
2019-10-14 19:22:49 +03:00
* The [Uno.WebSockets App](https://websockets-wasm.platform.uno), a demo of System.Net.WebSocket running from WebAssembly ([Source](https://github.com/unoplatform/uno.Wasm.WebSockets)).
2021-06-18 15:37:20 +03:00
* A [WebAssembly AOT RayTracer](https://raytracer-mono-aot.platform.uno/).
* The [Xaml Controls Gallery](https://xamlcontrolsgallery.platform.uno/) ([Source](https://github.com/unoplatform/uno.Xaml-Controls-Gallery)).
Let us know if you've made your app publicly available, we'll list it here!
2018-05-24 21:53:31 +03:00
2018-07-26 06:12:35 +03:00
# Have questions? Feature requests? Issues?
2018-07-23 16:19:19 +03:00
2021-06-18 15:37:20 +03:00
Make sure to visit our [FAQ](doc/articles/faq.md), [StackOverflow](https://stackoverflow.com/questions/tagged/uno-platform), [create an issue](https://github.com/unoplatform/uno/issues) or [Discord](https://platform.uno/discord) - "Uno-Platform" channel where our engineering and community are.
2018-07-23 16:19:19 +03:00
2018-05-24 21:53:31 +03:00
# Contributing
2022-05-18 01:07:23 +03:00
There are many ways that you can contribute to the Uno Platform, as the WinRT and WinUI APIs are pretty large! Read our [contributing guide](CONTRIBUTING.md) to learn about our development process and how to propose bug fixes and improvements. Come visit us on our [Discord Channel #uno-platform](https://discord.gg/eBHZSKG) for help on how to contribute!
2019-06-27 08:30:19 +03:00
2019-11-02 00:23:54 +03:00
Contribute to Uno in your browser using [GitPod.io](https://gitpod.io), follow [our guide here](doc/articles/features/working-with-gitpod.md).
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/unoplatform/uno)
2019-06-27 08:34:27 +03:00
# Contributors
2022-05-18 01:07:23 +03:00
Thanks go to these wonderful people (List made with [contrib.rocks](https://contrib.rocks)):
2019-06-27 08:30:19 +03:00
[![Uno Platform Contributors](https://contrib.rocks/image?repo=unoplatform/uno)](https://github.com/unoplatform/uno/graphs/contributors)
2022-03-23 14:11:50 +03:00
💖 Thank you.