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

Материал из ALT Linux Wiki
Нет описания правки
(→‎ASP.NET: доступ не только с localhost)
(не показано 19 промежуточных версий 2 участников)
Строка 1: Строка 1:
Пока не опакечено. Исходный код: https://github.com/dotnet/coreclr
.NET Core — это универсальная платформа разработки, которая поддерживается корпорацией Майкрософт и сообществом .NET на сайте [https://github.com/dotnet/core GitHub]. Она является кроссплатформенной: поддерживает Windows, Mac OS и Linux. Имеет открытый исходный код: распространяется по лицензиям MIT и Apache 2.


Для работы (p8 по состоянию 22.03.2017) можно использовать инструкции с сайта microsoft, касающиеся '''Fedora 23'''
Платформа .NET Core является кроссплатформенным аналогом .NET Framework на уровне библиотек базовых классов (BCL) .NET Framework. Она реализует спецификацию библиотеки [https://docs.microsoft.com/ru-ru/dotnet/standard/library .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 — [https://github.com/dotnet/roslyn Roslyn].  
 
В качестве среды разработки удобно использовать [[Visual Studio Code]] (см. подробнее по ссылке), для которого имеется расширение, позволяющее отлаживать приложения, написанные на C# под .NET Core на Linux.
 
[https://dotnet.github.io/ Welcome to .NET Core] от Microsoft.
 
https://stevedesmond.ca/images/blog/dotnet-dependencies.png


* https://www.microsoft.com/net/core#linuxfedora


== Установка ==
== Установка ==
Установите дополнительные пакеты:
Для установки среды выполнения (CoreCLR) с необходимыми библиотеками установите мета-пакет dotnet:
  apt-get install libunwind libicu54
  apt-get install dotnet
Для разработки приложений установите SDK для .NET Core (пакет dotnet-sdk):
apt-get install dotnet-sdk


Скачайте саму .NET для '''Fedora 23'''
== Создание приложения «Hello, world!» ==
<source lang="text">curl -SL -o dotnet.tar.gz https://go.microsoft.com/fwlink/?linkid=843457</source>
(Необходимо иметь в домашнем каталоге >2 ГБ свободного места)
от  root:
  mkdir /opt/dotnet
  tar xzf dotnet.tar.gz -C /opt/dotnet
  ln -s /opt/dotnet/dotnet /usr/local/bin
 
== Проверка (не от root)==
(Желательно иметь в /tmp >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">cas@cas dotnet $ dotnet new console -o hwapp
<source lang="text">
$ dotnet new console -o hwapp


Welcome to .NET Core!
Welcome to .NET Core!
Строка 39: Строка 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
Processing post-creation actions...
cas@cas hwapp $ dotnet restore
Running 'dotnet restore' on hwapp/hwapp.csproj...
  Restoring packages for /home/cas/tmp/dotnet/hwapp/hwapp.csproj...
Restore succeeded.
  Generating MSBuild file /home/cas/tmp/dotnet/hwapp/obj/hwapp.csproj.nuget.g.props.
 
  Generating MSBuild file /home/cas/tmp/dotnet/hwapp/obj/hwapp.csproj.nuget.g.targets.
$ cd hwapp
  Writing lock file to disk. Path: /home/cas/tmp/dotnet/hwapp/obj/project.assets.json
$ dotnet run
  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
Hello World!
Hello World!
cas@cas hwapp $</source>
</source>
 
== Основные команды ==
Всё взаимодействие с .NET Core из командной строки осуществляется через команду
$ dotnet
Для запуска приложения:
$ dotnet программа
Для запуска команды управления пакетами [https://docs.microsoft.com/en-us/nuget/tools/nuget-exe-cli-reference NuGet]:
$ dotnet nuget
Для скачивания и подготовки всех необходимых для сборки проекта пакетов:
$ dotnet restore
Для сборки [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
Для запуска тестов [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 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).
 
== Особенности ==
* Поддерживается только 64-битная платформа (x86_64).
 
* В настоящий момент 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/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/porting/ Перенос кода в .NET Core из .NET Framework]
* [https://habr.com/ru/company/raiffeisenbank/blog/451136/ Представлен .NET 5 (релиз в ноябре 2020 года)]


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


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


[[Категория: .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').