#2 - Настройки проекта

Для создания веб проектов под ASP .NET Core можно использовать различный инструментарий. Если вы работаете на платформе Виндовс, то идеальным вариантом среды разработки станет программа Visual Studio. 

Если разрабатываемое ПО заточено под Linux или Mac OS, скорее всего выбор падёт на расширенные редактор Visual Studio Code. При этом ничего не мешает использовать его и в Windows. В пределах данного материала предпочтение отдаём разработке в VS 2017. Достаточный функционал есть и у VS 2015.

Нужная нам программа доступна на официальном сайте VS. Конкретно в этом случае нет принципиальной разницы в версии VS: подойдёт как бесплатная, так и профессиональная или корпоративная. Каждая из перечисленных версий обладает предустановленными средствами для разработки ПО на ASP .NET Core. Мы не будем заморачиваться и воспользуемся бесплатным вариантом - VS 2017 Community.

После скачивания установщика Visual Studio его необходимо установить. Во время первоначальной настройке предлагается добавить несколько опций. Учитывая, что мы планируем работать с ASP .NET Core, предпочтительно выбирать пункт «ASP .NET и разработка веб-приложений».

После одного нажатия на данный пункт, справа показывается меню «Сводка», в котором можем установить некоторые необязательные компоненты. Сейчас можем установить все предложенные дополнения.

Немного ниже описанного пункта есть ещё один, обязательный в нашем случае – «Кроссплатформенная разработка .NET Core»:

Только после указания необходимых дополнений можем начать инсталляцию Visual Studio.

Довольно часто в системе уже есть VS или, возможно, платформа была добавлена в систему когда-то давно. Работать в устаревшей версии Visual Studio – не лучшая идея, поэтому стоит обновить данное ПО до актуального состояния. Ещё рекомендуем произвести установку компонента DK .NET Core 2.1, он позволит использовать самые новые функции ASP .NET Core.

Как только установка завершена (занимает зачастую много времени), время открыть VS 2017. В окне приложения щёлкаем по кнопке File («Файл»), выбираем New («Новый»), а затем – Project («Проект»). Сейчас должно появиться окно, в котором можем создать новый проект. Слева в меню открываем раздел «Web».

Здесь появляется выбор среди двух разновидностей проектов:

• ASP .NET Core Web Application: применяется для программирования приложений для веба на ASP .NET Core;
• ASP .NET Web Application (.NET Framework): этот тип применим для классических проектов: Web Forms, MVC 5, Web Api, основанных на обычном .NET Framework.

Важно! Здесь используем исключительно первый пункт, инструкция актуальна для этого типа проекта.

После выбора нужного варианта нам предлагают указать наименование текущего проекта. Рекомендуем устанавливать «говорящее» название, чтобы при первом взгляде и через 5 лет получилось легко вспомнить, что собой представляет данное приложение. Для примера, мы назовём проект HelloApp, затем нажимаем клавишу «Ок».

Сразу после этого отображается окно, в котором нас просят выбрать подходящий для работы шаблон:

Выбор проектов довольно широк, новичку легко запутаться, поэтому рассмотрим каждый из шаблонов:

• Empty: создаёт чистый шаблон без дополнительных функций. Применяется для написания приложений с чистого листа;
• Web API: проект веб-службы;
• Web Application: в качестве обработчика запросов проект применяет Razor Pages;
• Web Application: проект, построенный на архитектуре модель-вид-контроллер;
• Angular: работает на Angular 2+;
• Reat js: основа - React.JS;
• Reat JS and Redux: строится на React JS и Redux;
• Razor Class Library: проект, заточенный под разработку с Razor.

Помимо перечисленного, здесь же есть возможность ставить желаемую версию ASP .NET Core, она доступна после клика на открывающийся список. Сейчас вполне достаточно версии 2.1, она стоит изначально.

Ещё здесь присутствует возможность указания метода аутентификации и подключения Docker-контейнера.

Обращаем внимание на запись «Configure HTTP», если её активировать весь проект во время отладки и тестов будет работать через SSL-протокол. Для нашего случая нет принципиальной разницы активировать эту функцию или оставить выключенной. Эту настройку можем в любой момент заменить, но это придётся делать посредством свойств проекта.

Нам сейчас подходит проект «Empty», а дополнительные настройки можем оставить в стандартном положении. Последний шаг создания проекта – нажимаем кнопку «Ок».

Структура проекта ASP .NET Core

Для лучшего понимания проекта, мы расскажем о базовых элементах структуры в стандартном примере. У шаблона Empty элементарная структура – это как раз тот минимум, который нужен для пуска любого приложения.

Структура:

• Connected Services: список синхронизированных сервисов Azure;
• Dependencies: все встроенные библиотеки, скрипты или проще – зависимости;
• wwwroot: узел применяется для сохранения файлов-констант, которые не меняются в процессе работы. Сюда относятся JS-скрипты, CSS-файлы, картинки и прочее. Всё перечисленное находится в одноимённой папке. Данный каталог вынесен отдельным элементом в проект для простоты установки уровней доступа к файлам. Таким образом легко разрешить доступ к картинкам сервера, но запретить – к скриптам;
• Program.cs: ключевой файл создаваемого ПО, именно он обрабатывается в первую очередь. Код отсюда выполняет настройку и запуск веб-хоста в пределах приложения;
• Startup.cs: файл для установки класса Startup. В нём обычно размещается логика работы с поступающими запросами.

В полнофункциональном приложении структура значительно шире, но эта база есть практически всегда. После запуска созданного по инструкции проекта, любой веб-обозреватель покажет запись «Hello World!», она отправляется через класс Startup.