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

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


Для работы (Sisyphus по состоянию 17.03.2017) можно использовать инструкции с сайта microsoft, касающиеся fedora core 24
Платформа .NET Core является кроссплатформенным аналогом .NET Framework на уровне библиотек базовых классов (BCL) .NET Framework. Она реализует спецификацию библиотеки [https://docs.microsoft.com/ru-ru/dotnet/standard/library .NET Standard].


* https://www.microsoft.com/net/core#linuxfedora
Важным отличием от проекта Mono, который направлен на создание свободной среды, совместимой с .NET Framework, является то, что .NET Core не имеет реализации Windows Forms и не реализует API .NET Framework с использованием тех же имён сборок, то есть не позволяет запускать приложения, собранные для .NET Framework.
* пакеты, которые надо установить
 
* libunwind
Для ALT p8 и Sisyphus собран .NET Core 2.0.0, соответствующий спецификации .NET Standard 2.0. Платформа развивается очень быстро, уже готовится версия 3.0, и использование версий 1.0/1.1 не рекомендуется.
* libicu
 
----
В составе SDK поставляется компилятор C# с открытым исходным кодом из состава .NET Compiler Platform — [https://github.com/dotnet/roslyn Roslyn].
== Сама установка ==
 
  curl -sSL -o dotnet.tar.gz https://go.microsoft.com/fwlink/?linkid=843461
В качестве среды разработки удобно использовать [[Visual Studio Code]] (см. подробнее по ссылке), для которого имеется расширение, позволяющее отлаживать приложения, написанные на C# под .NET Core на Linux.
от  root:
 
  mkdir /opt/dotnet
[https://dotnet.github.io/ Welcome to .NET Core] от Microsoft.
  tar xzf dotnet.tar.gz -C /opt/dotnet
 
  ln -s /opt/dotnet/dotnet /usr/local/bin
https://stevedesmond.ca/images/blog/dotnet-dependencies.png
== Проверка ( не от root)==
 
(Желательно иметь в /tmp >2GB free space)
 
== Установка ==
Для установки среды выполнения (CoreCLR) с необходимыми библиотеками установите мета-пакет dotnet:
apt-get install dotnet
Для разработки приложений установите SDK для .NET Core (пакет dotnet-sdk):
apt-get install dotnet-sdk
 
== Создание приложения «Hello, world!» ==
(Необходимо иметь в домашнем каталоге >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


== можно установить Visual studio code ==
=== Вывод команд ===
https://code.visualstudio.com/
<source lang="text">
Устанавливать из .tar.gz для Linux x64
$ dotnet new console -o hwapp
запускать code
 
[[Категория: dotnet]]
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!
</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 года)]
 
== Исходный код ==
* [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').
 
* [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]]

Версия от 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').