.NET Core: различия между версиями

Материал из ALT Linux Wiki
(→‎ASP.NET: доступ не только с localhost)
(не показано 17 промежуточных версий 2 участников)
Строка 5: Строка 5:
Важным отличием от проекта Mono, который направлен на создание свободной среды, совместимой с .NET Framework, является то, что .NET Core не имеет реализации Windows Forms и не реализует API .NET Framework с использованием тех же имён сборок, то есть не позволяет запускать приложения, собранные для .NET Framework.
Важным отличием от проекта Mono, который направлен на создание свободной среды, совместимой с .NET Framework, является то, что .NET Core не имеет реализации Windows Forms и не реализует API .NET Framework с использованием тех же имён сборок, то есть не позволяет запускать приложения, собранные для .NET Framework.


Для ALT p8 и Sisyphus собран .NET Core 2.0.0 preview1, соответствующий спецификации .NET Standard 2.0. Платформа развивается очень быстро, и использование версий 1.0 не рекомендуется.
Для ALT p8 и Sisyphus собран .NET Core 2.0.0, соответствующий спецификации .NET Standard 2.0. Платформа развивается очень быстро, уже готовится версия 3.0, и использование версий 1.0/1.1 не рекомендуется.


В составе SDK поставляется компилятор C# с открытым исходным кодом из состава .NET Compiler Platform — [https://github.com/dotnet/roslyn Roslyn].  
В составе SDK поставляется компилятор C# с открытым исходным кодом из состава .NET Compiler Platform — [https://github.com/dotnet/roslyn Roslyn].  
Строка 11: Строка 11:
В качестве среды разработки удобно использовать [[Visual Studio Code]] (см. подробнее по ссылке), для которого имеется расширение, позволяющее отлаживать приложения, написанные на C# под .NET Core на Linux.
В качестве среды разработки удобно использовать [[Visual Studio Code]] (см. подробнее по ссылке), для которого имеется расширение, позволяющее отлаживать приложения, написанные на C# под .NET Core на Linux.


Сама по себе платформа .NET Core поддерживает только модель консольных приложений и приложений ASP.NET Core. Для создания графического интерфейса можно смотреть на [https://www.xamarin.com/forms Xamarin Forms].
[https://dotnet.github.io/ Welcome to .NET Core] от Microsoft.
 
https://stevedesmond.ca/images/blog/dotnet-dependencies.png
 


== Установка ==
== Установка ==
Строка 19: Строка 22:
  apt-get install dotnet-sdk
  apt-get install dotnet-sdk


=== Создание приложения «Hello, world!» ===
== Создание приложения «Hello, world!» ==
(Необходимо иметь в домашнем каталоге >2 ГБ свободного места)
(Необходимо иметь в домашнем каталоге >2 ГБ свободного места)
   dotnet new console -o hwapp
   dotnet new console -o hwapp
   cd hwapp
   cd hwapp
   dotnet restore
   dotnet restore
  dotnet build
   dotnet run
   dotnet run


=== Output ===
=== Вывод команд ===
<source lang="text">
<source lang="text">
cas@cas dotnet $ dotnet new console -o hwapp
$ dotnet new console -o hwapp


Welcome to .NET Core!
Welcome to .NET Core!
Строка 43: Строка 47:
-------------------
-------------------
A command is running to initially populate your local package cache, to improve restore speed and enable offline access. This command will take up to a minute to complete and will only happen once.
A command is running to initially populate your local package cache, to improve restore speed and enable offline access. This command will take up to a minute to complete and will only happen once.
Decompressing 100% 6052 ms
Decompressing 100% 7675 ms
Expanding 100% 8288 ms
Expanding 100% 14205 ms
Getting ready...
Getting ready...
Content generation time: 93,9086 ms
The template "Console Application" was created successfully.
The template "Console Application" created successfully.
 
cas@cas dotnet $ cd hwapp


cas@cas hwapp $ dotnet restore
Processing post-creation actions...
  Restoring packages for /home/cas/tmp/dotnet/hwapp/hwapp.csproj...
Running 'dotnet restore' on hwapp/hwapp.csproj...
  Generating MSBuild file /home/cas/tmp/dotnet/hwapp/obj/hwapp.csproj.nuget.g.props.
Restore succeeded.
  Generating MSBuild file /home/cas/tmp/dotnet/hwapp/obj/hwapp.csproj.nuget.g.targets.
  Writing lock file to disk. Path: /home/cas/tmp/dotnet/hwapp/obj/project.assets.json
  Restore completed in 766,84 ms for /home/cas/tmp/dotnet/hwapp/hwapp.csproj.
 
  NuGet Config files used:
      /home/cas/.nuget/NuGet/NuGet.Config
 
  Feeds used:
      https://api.nuget.org/v3/index.json


cas@cas hwapp $ dotnet run
$ cd hwapp
$ dotnet run
Hello World!
Hello World!
</source>
</source>
Строка 73: Строка 66:
Для запуска приложения:
Для запуска приложения:
  $ dotnet программа
  $ dotnet программа
Для запуска nuget:
Для запуска команды управления пакетами [https://docs.microsoft.com/en-us/nuget/tools/nuget-exe-cli-reference NuGet]:
  $ dotnet nuget
  $ dotnet nuget
Для скачивания и подготовки всех необходимых для сборки проекта пакетов:
Для скачивания и подготовки всех необходимых для сборки проекта пакетов:
Строка 79: Строка 72:
Для сборки [https://docs.microsoft.com/ru-ru/dotnet/core/tools/dotnet-msbuild проекта MSBuild] ([https://docs.microsoft.com/ru-ru/visualstudio/msbuild/msbuild-command-line-reference подробнее о MSBuild]):
Для сборки [https://docs.microsoft.com/ru-ru/dotnet/core/tools/dotnet-msbuild проекта MSBuild] ([https://docs.microsoft.com/ru-ru/visualstudio/msbuild/msbuild-command-line-reference подробнее о MSBuild]):
  $ dotnet msbuild
  $ dotnet msbuild
Для сборки [https://docs.microsoft.com/ru-ru/dotnet/core/tools/dotnet-build build]:
Для запуска тестов [https://docs.microsoft.com/en-us/dotnet/core/testing/unit-testing-with-mstest MSTest] или [https://docs.microsoft.com/en-us/dotnet/core/testing/unit-testing-with-dotnet-test xUnit]:
  $ dotnet build
$ dotnet test
 
Об использовании .csproj-файлов вместо устаревших project.json: https://docs.microsoft.com/ru-ru/dotnet/core/tools/cli-msbuild-architecture
 
== Диагностика ==
$ dotnet run --verbosity diag
 
== Desktop-приложения ==
 
Сама по себе платформа .NET Core покрывает и поддерживает только модель консольных приложений и приложений ASP.NET Core. Реализация WPF (Windows Presentation Foundation) [https://www.microsoft.com/net/learn/apps/desktop отсутствует] для платформы Linux.<!--Для создания графического интерфейса можно смотреть на [https://www.xamarin.com/forms Xamarin Forms]. -->
 
В настоящее время (июль 2017) шаги к портированию WPF на .NET Core [https://github.com/dotnet/corefx/issues/5766 заключаются] в обсуждении стандарта [https://github.com/microsoft/xaml-standard XAML Standard], которым описываются UI-элементы, чтобы появилась возможность реализовать System.XAML. После чего возникнет теоретическая возможность портировать/реализовать WPF поверх .NET Core.
 
Основная статья: [[.NET Core GUI]].
 
== ASP.NET ==
Частью ASP.NET Core является кросс-платформенный веб-сервер [https://github.com/aspnet/KestrelHttpServer KestrelHttpServer].
 
* [https://docs.microsoft.com/en-us/aspnet/core/getting-started Начинаем работать с ASP.NET Core].
* [https://habrahabr.ru/company/microsoft/blog/275561/ ASP.NET 5 мёртв — представляем ASP.NET Core 1.0 и .NET Core 1.0]
 
Установить пакет dotnet-aspnetcore
apt-get install dotnet-aspnetcore
 
Тестовое веб-приложение:
$ mkdir aspnetcoreapp
$ cd aspnetcoreapp
$ dotnet new web
  $ dotnet run
Проверяем http://localhost:5000
 
Если требуется доступ отовсюду, то запускаем так
$ dotnet run --urls "http://*:5000;https://*:5001"
Однако, по рекомендации MS, если приложение смотрит в Интернет, нужно использовать обратный прокси-сервер (IIS, Nginx или Apache).


== Особенности ==
== Особенности ==
Строка 87: Строка 113:
* В настоящий момент nuget нормально не поддерживает работу в оффлайн-режиме (с предварительно подготовленным кэшем), и даже с использованием локального репозитория есть проблемы.
* В настоящий момент nuget нормально не поддерживает работу в оффлайн-режиме (с предварительно подготовленным кэшем), и даже с использованием локального репозитория есть проблемы.


== ARM ==
* https://stevedesmond.ca/blog/net-core-on-arm


== Ссылки ==
== Ссылки ==
* [https://docs.microsoft.com/ru-ru/dotnet/standard/components Архитектурные компоненты .NET]
* [https://docs.microsoft.com/ru-ru/dotnet/core/ .NET Core]
* [https://docs.microsoft.com/ru-ru/dotnet/core/ .NET Core]
* [https://docs.microsoft.com/ru-ru/dotnet/core/tutorials/using-with-xplat-cli .NET Cli для начинающих]
* [https://docs.microsoft.com/ru-ru/dotnet/core/tutorials/using-with-xplat-cli .NET Cli для начинающих]
* [https://docs.microsoft.com/ru-ru/dotnet/core/tools/dotnet-publish публикация приложения]
* [https://docs.microsoft.com/ru-ru/dotnet/core/tools/dotnet-publish публикация приложения]
* [https://docs.microsoft.com/ru-ru/dotnet/core/porting/ Перенос кода в .NET Core из .NET Framework]
* [https://habr.com/ru/company/raiffeisenbank/blog/451136/ Представлен .NET 5 (релиз в ноябре 2020 года)]


== Исходный код ==
== Исходный код ==
Строка 99: Строка 130:
* [https://github.com/dotnet/cli dotnet/cli repo] — исходный код команд, касающихся сборки проекта (таких, как 'dotnet build', 'dotnet restore' и 'dotnet publish').
* [https://github.com/dotnet/cli dotnet/cli repo] — исходный код команд, касающихся сборки проекта (таких, как 'dotnet build', 'dotnet restore' и 'dotnet publish').


* [https://github.com/dmetzgar/corewf corewf] — неофициальный порт Windows Workflow Foundation на .NET (без XAML не работает) ([https://github.com/dotnet/corefx/issues/2394 состояние портирования])
* [https://github.com/Microsoft/referencesource referencesource] — исходный код части модулей .NET Framework 4.7 (для сверки)


[[Категория: .NET]]
[[Категория: .NET]]

Версия от 09:01, 6 августа 2019

.NET Core — это универсальная платформа разработки, которая поддерживается корпорацией Майкрософт и сообществом .NET на сайте GitHub. Она является кроссплатформенной: поддерживает Windows, Mac OS и Linux. Имеет открытый исходный код: распространяется по лицензиям MIT и Apache 2.

Платформа .NET Core является кроссплатформенным аналогом .NET Framework на уровне библиотек базовых классов (BCL) .NET Framework. Она реализует спецификацию библиотеки .NET Standard.

Важным отличием от проекта Mono, который направлен на создание свободной среды, совместимой с .NET Framework, является то, что .NET Core не имеет реализации Windows Forms и не реализует API .NET Framework с использованием тех же имён сборок, то есть не позволяет запускать приложения, собранные для .NET Framework.

Для ALT p8 и Sisyphus собран .NET Core 2.0.0, соответствующий спецификации .NET Standard 2.0. Платформа развивается очень быстро, уже готовится версия 3.0, и использование версий 1.0/1.1 не рекомендуется.

В составе SDK поставляется компилятор C# с открытым исходным кодом из состава .NET Compiler Platform — Roslyn.

В качестве среды разработки удобно использовать Visual Studio Code (см. подробнее по ссылке), для которого имеется расширение, позволяющее отлаживать приложения, написанные на C# под .NET Core на Linux.

Welcome to .NET Core от Microsoft.

https://stevedesmond.ca/images/blog/dotnet-dependencies.png


Установка

Для установки среды выполнения (CoreCLR) с необходимыми библиотеками установите мета-пакет dotnet:

apt-get install dotnet

Для разработки приложений установите SDK для .NET Core (пакет dotnet-sdk):

apt-get install dotnet-sdk

Создание приложения «Hello, world!»

(Необходимо иметь в домашнем каталоге >2 ГБ свободного места)

  dotnet new console -o hwapp
  cd hwapp
  dotnet restore
  dotnet build
  dotnet run

Вывод команд

$ dotnet new console -o hwapp

Welcome to .NET Core!
---------------------
Learn more about .NET Core @ https://aka.ms/dotnet-docs. Use dotnet --help to see available commands or go to https://aka.ms/dotnet-cli-docs.

Telemetry
--------------
The .NET Core tools collect usage data in order to improve your experience. The data is anonymous and does not include command-line arguments. The data is collected by Microsoft and shared with the community.
You can opt out of telemetry by setting a DOTNET_CLI_TELEMETRY_OPTOUT environment variable to 1 using your favorite shell.
You can read more about .NET Core tools telemetry @ https://aka.ms/dotnet-cli-telemetry.

Configuring...
-------------------
A command is running to initially populate your local package cache, to improve restore speed and enable offline access. This command will take up to a minute to complete and will only happen once.
Decompressing 100% 7675 ms
Expanding 100% 14205 ms
Getting ready...
The template "Console Application" was created successfully.

Processing post-creation actions...
Running 'dotnet restore' on hwapp/hwapp.csproj...
Restore succeeded.

$ cd hwapp
$ dotnet run
Hello World!

Основные команды

Всё взаимодействие с .NET Core из командной строки осуществляется через команду

$ dotnet

Для запуска приложения:

$ dotnet программа

Для запуска команды управления пакетами NuGet:

$ dotnet nuget

Для скачивания и подготовки всех необходимых для сборки проекта пакетов:

$ dotnet restore

Для сборки проекта MSBuild (подробнее о MSBuild):

$ dotnet msbuild

Для запуска тестов MSTest или xUnit:

$ dotnet test

Об использовании .csproj-файлов вместо устаревших project.json: https://docs.microsoft.com/ru-ru/dotnet/core/tools/cli-msbuild-architecture

Диагностика

$ dotnet run --verbosity diag

Desktop-приложения

Сама по себе платформа .NET Core покрывает и поддерживает только модель консольных приложений и приложений ASP.NET Core. Реализация WPF (Windows Presentation Foundation) отсутствует для платформы Linux.

В настоящее время (июль 2017) шаги к портированию WPF на .NET Core заключаются в обсуждении стандарта XAML Standard, которым описываются UI-элементы, чтобы появилась возможность реализовать System.XAML. После чего возникнет теоретическая возможность портировать/реализовать WPF поверх .NET Core.

Основная статья: .NET Core GUI.

ASP.NET

Частью ASP.NET Core является кросс-платформенный веб-сервер KestrelHttpServer.

Установить пакет dotnet-aspnetcore

apt-get install dotnet-aspnetcore

Тестовое веб-приложение:

$ mkdir aspnetcoreapp
$ cd aspnetcoreapp
$ dotnet new web
$ dotnet run

Проверяем http://localhost:5000

Если требуется доступ отовсюду, то запускаем так

$ dotnet run --urls "http://*:5000;https://*:5001"

Однако, по рекомендации MS, если приложение смотрит в Интернет, нужно использовать обратный прокси-сервер (IIS, Nginx или Apache).

Особенности

  • Поддерживается только 64-битная платформа (x86_64).
  • В настоящий момент nuget нормально не поддерживает работу в оффлайн-режиме (с предварительно подготовленным кэшем), и даже с использованием локального репозитория есть проблемы.

ARM

Ссылки

Исходный код

  • dotnet/coreclr — содержит .NET Core runtime, называемый CoreCLR и базовую библиотеку (mscorlib) с низкоуровневыми классами и базовыми типами данных.
  • dotnet/corefx — исходный код большинства классов .NET Framework library.
  • dotnet/core-setup — исходный код команды dotnet и policy logic для запуска базового кода (hostfxr, hostpolicy), которые позволяют запустить программу через dotnet <программа>.
  • dotnet/cli repo — исходный код команд, касающихся сборки проекта (таких, как 'dotnet build', 'dotnet restore' и 'dotnet publish').