Генераторы исток: Завод ИСТОК™ — российский поставщик генераторных установок

Продукция торговой марки ИСТОК™ — уникальный продукт, адаптированный под климатические условия нашей страны и российские стандарты горюче-смазочных материалов, что обеспечивает бесперебойную работу продукции без снижения ресурса.

Оборудование адаптировано к Российскому горючему

Развитая сеть технических центров и техническая поддержка

Собственный отдел разработки спроектирует и реализует любой проект

Доставка в любой регион России без переплат и с гарантией

Реализованные проекты

Смотреть все работы

3 ДГУ мощностью 30 кВт для резервного энергоснабжения

Смотреть проект

20 ДГУ мощностью 16 кВт для автомотрис

Смотреть проект

ДГУ в контейнере УБК-3

Смотреть проект

Приглашаем к партнерству

Став нашим партнером,
Вы получите:

Подробнее об условиях

Возможность работать с качественным оборудованием российского производства.

Отлаженную систему поставок, которая позволит приступить к работе с оборудованием в кратчайшие сроки.

Гарантийные и сервисные возможности, позволят решать любые технические вопросы.

Наличие инжинирингового центра поможет в решении нестандартных задач.

Завод генераторов Исток

ЗАВОД ГЕНЕРАТОРНЫХ УСТАНОВОК

УЗНАТЬ ПОДРОБНЕЕ

Мы стремимся предоставить заказчику стабильно работающее оборудование, высококачественный и современный сервис, грамотные и профессиональные консультации, тем самым показывая, что результат нашей работы — это качественный продукт, довольный заказчик и решенные задачи заказчика. Мы инжиниринговая компания, которая предлагает клиенту готовые решения стоящих перед ним задач.

ПРОДАЖА АРЕНДА СЕРВИС

Мы предлагаем весь спектр поддержки клиента и решение энергетических задач любой сложности. Широкий диапазон мощностей, большой ассортимент двигателей, огромный склад запчастей и расходных материалов. Постоянно расширяющаяся сеть сервисного присутствия обеспечивает гарантийное и сервисное обслуживание как можно ближе к месту эксплуатации оборудования.

СОТРУДНИЧЕСТВО

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

КАДРЫ

Наша основная ценность — люди, участвующие в разработке, обслуживании и продвижении оборудования. Их всех объединяет идея создания полезного продукта, который будет соответствовать и даже превышать ожидания заказчика. Высококвалифицированный персонал всегда готов помочь клиенту по любым вопросам, от помощи в развертывании дистрибуции до авторизации сервисных центров.

ИСТОРИЯ БРЕНДА

История бренда Исток берет свое начало в 2006 году с компании – поставщика генераторов зарубежного производства на рынок Урала, а в дальнейшем на всю территорию РФ.

Сегодня генераторные установки Исток по своим характеристикам, качеству и цене успешно кон- курируют с зарубежными аналогами. Бренд Исток — это инжиниринговый продукт, в котором сочета- ются как стандартные изделия, разработанные под универсальные задачи, так и комплекс продуктов и услуг, учитывающий индивидуальные потребности каждого клиента. Выбирая бренд Исток, клиент гарантированно получает решение стоящих перед ним задач от профессионалов своего дела.

LEARN MORE

Мы предлагаем готовые решения для производителей спецавтотранспорта на базе генераторных установок.

Размещаем генераторные установки в условиях ограниченного пространства. Устанавливаем системы контроля и управления на месте водителя/оператора (выносные пульты управления). Изменяем конструкцию генераторной установки под ваши размеры и задачи. Налаживаем питание от внешнего топливного бака, конструируем выносные глушители и радиаторы (установка на крыше/стенах фургона или кузова.

Для использования в модульных зданиях мы предлагаем генераторные установки стандартного и специального исполнения

Изготавливаем и автоматизируем электростанции на агрегатах мировых производителей (CUMMINS, PERKINS, YANMAR, HONDA), как для обеспечения быстровозводимых поселков электроэнергией, так и для размещения в составе вагон-домов и модульных зданий. Производим мобильные ДГУ на прицепах и салазках, в утепленных контейнерах и шумозащитных кожухах. Специальные комплектации от 1 шт.

Для Российских железных дорог мы предлагаем генераторное оборудование с уникальными комплектациями

Мы производим генераторные установки, сварочные агрегаты и световые мачты с уникальными характеристиками и комплектациями по требованиям структур РЖД, не нуждающихся в последующих доработках при установке и эксплуатации. Наша продукция соответствует высоким стандартам качества, принятым в РЖД.

1

Спец проекты от 1штуки

2

Года гарантии

35

Сервисных центров

14

Акции

Акции

АД16-О230-РПМ15

Дизельгенератор «Проф»

348 000 ₽

1 степень автоматизации

• 16кВт/17,6кВт
• Двигатель YangDong
• Кожух, уровень шума 62дБ
• Исток 6120
• 1460х680х900

Купить!

АД-100-Т400-РПМ25

Дизельгенератор «Стандарт»

758 000 ₽

1 степень автоматизации

• 100кВт/110кВт
• Двигатель Weifang
• Кожух, уровень шума 69дБ
• Исток 6120
• 2750x1090x1450

Купить!

АД-50-Т400-2РМ25

Дизельгенератор «Стандарт»

420 000 ₽

2 степень автоматизации

• 50кВт/55кВт
• Двигатель Weifang
• Открытая на раме
• Исток 6120
• 1900х840х1240

Купить!

1 568 000 РУБ

АД250С-Т400-РМ25

Получить скидку

353 000 РУБ

АД20С-О230-РПМ25

Получить скидку

353 000 РУБ

АД20С-Т400-РПМ25

Получить скидку

399 000 РУБ

АД30С-Т400-РПМ25

Получить скидку

446 000 РУБ

АД40С-Т400-РПМ25

Получить скидку

478 000 РУБ

АД50С-Т400-РПМ25

Получить скидку

517 000 РУБ

АД60С-Т400-РПМ25

Получить скидку

702 000 РУБ

АД75С-Т400-РПМ25

Получить скидку

758 000 РУБ

АД100С-Т400-РПМ25

Получить скидку

813 000 РУБ

АД120С-Т400-РПМ25

Получить скидку

965 000 РУБ

АД150С-Т400-РПМ25

Получить скидку

1 479 000 РУБ

АД200С-Т400-РПМ25

Получить скидку

1 775 000 РУБ

АД250С-Т400-РПМ25

Получить скидку

РЕШЕНИЯ ДЛЯ СПЕЦАВТОТРАНСПОРТА

Салазки для генератора

Внешний топливный бак

Выносной пульт

Выносной глушитель и/или радиатор

РЕШЕНИЯ ДЛЯ модульных домов и коттеджей

ДГУ контейнерного исполнения

Мобильная станция на прицепе

Энерго снабжение поселков

Выносной глушитель и/или радиатор

РЕШЕНИЯ ДЛЯ РЖД

Выносной пульт оператора

Колеса для перекатывания

Для путевого инструмента

Выносное оборудование

Представляем генераторы исходного кода C# — блог .

Филипп Картер

29 апреля 2020 г. 108 1

Мы рады представить первую предварительную версию Source Generators — новой функции компилятора C#, которая позволяет разработчикам C# проверять пользовательский код и создавать новые исходные файлы C#, которые можно добавить в компиляцию. Это делается с помощью нового типа компонента, который мы называем генератором исходного кода.

Чтобы начать работу с генераторами исходного кода, вам необходимо установить последнюю предварительную версию .NET 5 и последнюю предварительную версию Visual Studio. Примечание. Для создания генератора исходного кода в настоящее время требуется Visual Studio. Это изменится в следующей предварительной версии .NET 5.

Что такое генератор источников?

Если вы внимательно не следили за каждым прототипом и предложением, связанным с языком и компилятором C#, то, скорее всего, вы прямо сейчас спрашиваете: «Что такое генератор исходного кода». Генератор исходного кода — это фрагмент кода, который запускается во время компиляции и может проверять вашу программу для создания дополнительных файлов, которые компилируются вместе с остальным кодом.

Генератор исходного кода — это компонент нового типа, который разработчики C# могут написать и который позволяет выполнять две основные функции:

1. Извлекать объект Compilation , представляющий весь компилируемый пользовательский код. Этот объект можно проверить, и вы можете написать код, который работает с синтаксисом и семантическими моделями для компилируемого кода, как и современные анализаторы.
2. Создание исходных файлов C#, которые можно добавить в объект Compilation в ходе компиляции. Другими словами, вы можете предоставить дополнительный исходный код в качестве входных данных для компиляции во время компиляции кода.

В сочетании эти две вещи делают генераторы источников такими полезными. Вы можете проверять пользовательский код со всеми богатыми метаданными, которые компилятор создает во время компиляции, а затем возвращать код C# обратно в ту же компиляцию, основанную на проанализированных вами данных! Если вы знакомы с Roslyn Analyzers, вы можете думать о генераторах исходного кода как об анализаторах, которые могут выдавать исходный код C#.

Генераторы исходного кода запускаются как этап компиляции, представленный ниже:

Генератор исходного кода — это сборка .NET Standard 2.0, загружаемая компилятором вместе с любыми анализаторами. Его можно использовать в средах, где можно загружать и запускать компоненты .NET Standard.

Теперь, когда вы знаете, что такое генератор источников, давайте рассмотрим некоторые сценарии, которые они могут улучшить.

Примеры сценариев, которые могут извлечь выгоду из генераторов исходного кода

Наиболее важным аспектом генератора исходного кода является не то, что он из себя представляет, а то, что он может сделать.

Сегодня существует три основных подхода к проверке пользовательского кода и созданию информации или кода на основе этого анализа, используемого современными технологиями: отражение во время выполнения, объединение IL и жонглирование задачами MSBuild. Генераторы исходного кода могут быть улучшением по сравнению с каждым подходом.

Отражение во время выполнения — это мощная технология, которая была добавлена ​​в .NET уже давно. Существует бесчисленное множество сценариев его использования. Очень распространенный сценарий — выполнить некоторый анализ пользовательского кода при запуске приложения и использовать эти данные для создания вещей.

Например, ASP.NET Core использует отражение при первом запуске вашей веб-службы для обнаружения определенных вами конструкций, чтобы она могла «подключать» такие вещи, как контроллеры и бритвенные страницы. Хотя это позволяет вам писать простой код с мощными абстракциями, это приводит к снижению производительности во время выполнения: когда ваш веб-сервис или приложение запускается впервые, он не может принимать какие-либо запросы, пока не будет завершен весь код отражения во время выполнения, который обнаруживает информацию о вашем коде. Бег! Хотя это снижение производительности не является огромным, это своего рода фиксированная стоимость, которую вы не можете улучшить самостоятельно в своем собственном приложении.

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

Генераторы исходного кода могут повысить производительность способами, которые не ограничиваются отражением во время выполнения для обнаружения типов. Некоторые сценарии включают вызов задачи MSBuild C# (называемой CSC) несколько раз, чтобы они могли проверять данные из компиляции. Как вы можете себе представить, вызов компилятора более одного раза влияет на общее время, необходимое для сборки вашего приложения! Мы изучаем, как можно использовать генераторы исходного кода, чтобы избавиться от необходимости жонглировать задачами MSBuild, поскольку генераторы исходного кода не только предлагают некоторые преимущества в производительности, но также позволяют инструментам работать на нужном уровне абстракции.

Еще одна возможность, которую могут предложить генераторы исходного кода, — отказ от использования некоторых API со «строковой типизацией», например, как работает маршрутизация ASP.NET Core между контроллерами и бритвенными страницами. С генератором исходного кода маршрутизация может быть строго типизирована, а необходимые строки генерируются как детали времени компиляции. Это уменьшит количество случаев, когда ошибочный строковый литерал приводит к тому, что запрос не достигает правильного контроллера.

По мере того, как мы уточняем API и получаем больше опыта в написании генераторов исходного кода, мы ожидаем, что станет очевидным больше сценариев. Мы также планируем работать с командами партнеров, чтобы помочь им внедрить генераторы исходного кода, если это улучшит их основные сценарии.

Генераторы исходного кода и компиляция с опережением времени (AOT)

Еще одна характеристика генераторов исходного кода заключается в том, что они могут помочь устранить основные барьеры для оптимизации компиляции на основе компоновщика и AOT (с опережением времени). Многие фреймворки и библиотеки интенсивно используют отражение или отражение-выдачу, например System.Text.Json , System.Text.RegularExpressions , и такие фреймворки, как ASP.NET Core и WPF, которые обнаруживают и/или выдают типы от пользователя. код во время выполнения.

Мы также определили, что многие из лучших пакетов NuGet активно используют отражение для обнаружения типов во время выполнения. Включение этих пакетов необходимо для большинства приложений .NET, поэтому это сильно влияет на «связываемость» и способность вашего кода использовать оптимизации компилятора AOT. Мы с нетерпением ждем совместной работы с нашим замечательным сообществом OSS, чтобы увидеть, как эти пакеты могут использовать генераторы исходного кода и улучшить общую экосистему .NET.

Hello World, версия Source Generator

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

Цель состоит в том, чтобы пользователи, установившие этот генератор исходного кода, всегда имели доступ к дружественному сообщению «Hello World» и ко всем синтаксическим деревьям, доступным во время компиляции. Они могут вызвать его так:

Со временем мы значительно упростим начало работы с инструментами с шаблонами. А пока вот как это сделать вручную:

1. Создайте проект библиотеки .NET Standard, который выглядит следующим образом:

Ключевым моментом этого является то, что проект может генерировать пакет NuGet, и это зависит от битов, которые включают генераторы исходного кода.

2. Измените или создайте файл C#, в котором указан ваш собственный генератор исходного кода, например:

. Вам потребуется применить атрибут Microsoft.CodeAnalysis.Generator и реализовать интерфейс Microsoft.CodeAnalysis.ISourceGenerator .

3. Добавить в компиляцию сгенерированный исходный код!

4. Добавьте генератор исходного кода из проекта в качестве анализатора и добавьте предварительный просмотр в LangVersion в файл проекта следующим образом:

Если вы ранее писали Roslyn Analyzers, опыт локальной разработки должен быть аналогичным.

Когда вы пишете свой код в Visual Studio, вы увидите, что генератор исходного кода работает и сгенерированный код доступен для вашего проекта. Теперь вы можете получить к нему доступ, как если бы вы создали его самостоятельно:

Примечание. В настоящее время вам потребуется перезапустить Visual Studio, чтобы увидеть IntelliSense и избавиться от ошибок с помощью раннего опыта инструментов

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

• Автоматически реализовывать интерфейсы для классов с прикрепленным к ним атрибутом, например INotifyPropertyChanged
• Создание файлов настроек на основе данных, проверенных из SourceGeneratorContext
• Сериализация значений из классов в строки JSON
• и т. д.

В Поваренной книге генераторов исходных текстов рассматриваются некоторые из этих примеров с некоторыми рекомендуемыми подходами к их решению.

Кроме того, у нас есть набор примеров, доступных на GitHub, которые вы можете попробовать самостоятельно.

Как упоминалось ранее, мы работаем над улучшением опыта создания и использования генераторов исходного кода в таких инструментах, как добавление шаблонов, обеспечение плавного IntelliSense и навигации, отладка и повышение скорости отклика и производительности в Visual Studio при создании исходных файлов.

Генераторы исходного кода находятся в предварительной версии

Как упоминалось ранее в этом сообщении, это первая предварительная версия генераторов исходного кода. Цель выпуска этой первой предварительной версии — позволить авторам библиотек опробовать эту функцию и дать нам отзыв о том, чего не хватает и что нужно изменить. От превью к превью могут быть изменения в API и характеристиках генераторов исходников. Мы намерены поставлять генераторы исходного кода как GA с C# 9., а позже в этом году мы намерены стабилизировать API и предоставляемые им функции.

Обращаемся ко всем разработчикам библиотек C#: попробуйте!

Если у вас есть библиотека .NET, написанная на C#, самое время оценить генераторы исходного кода и посмотреть, подходят ли они вам. Есть хороший шанс, что если ваша библиотека активно использует отражение, вы в некотором роде выиграете.

Чтобы помочь с этим, мы рекомендуем прочитать следующие документы:

• Проектный документ генераторов исходного кода, в котором объясняется API генератора исходного кода и текущие возможности
• Пособие по генераторам исходного кода, в котором приведены примеры различных генераторов исходного кода, которые позволяют использовать различные сценарии

Дайте нам свой отзыв и сообщите нам, что вам нужно! Мы хотели бы узнать больше о том, как, по вашему мнению, генераторы исходного кода могут улучшить ваш код, и что, по вашему мнению, отсутствует или нуждается в изменении.

Что будет дальше с генераторами исходного кода

Этот первый предварительный просмотр именно такой: первый предварительный просмотр. В Visual Studio есть базовые возможности редактирования, но это не то качество, которое мы бы сейчас назвали «качеством 1.0». Мы можем исследовать несколько разных дизайнов, прежде чем остановимся на конкретном. Одной из самых больших областей внимания до выпуска .NET 5 будет улучшение возможностей редактирования для генераторов исходного кода. Кроме того, мы планируем изменить API с учетом отзывов команд партнеров и нашего сообщества OSS.

Кроме того, мы обеспечим хороший опыт распространения генераторов исходного кода. В настоящее время мы разрабатываем их так, чтобы они были очень похожи на анализаторы, которые могут поставляться вместе с пакетом. В настоящее время они используют инфраструктуру Analyzer для настройки инструментов редактора.

Часто задаваемые вопросы

Ниже приведен список вопросов, которые, как мы ожидаем, могут возникнуть у некоторых людей. Мы будем обновлять этот список новыми вопросами по мере их поступления.

Чем отличаются генераторы исходного кода от других функций метапрограммирования, таких как макросы или подключаемые модули компилятора?

Генераторы исходного кода — это форма метапрограммирования, поэтому естественно сравнивать их с аналогичными функциями в других языках, например с макросами. Ключевое отличие состоит в том, что генераторы исходного кода не позволяют вам _переписывать_ пользовательский код. Мы рассматриваем это ограничение как существенное преимущество, поскольку оно делает пользовательский код предсказуемым в отношении того, что он на самом деле делает во время выполнения. Мы понимаем, что переписывание пользовательского кода — очень мощная функция, но вряд ли мы позволим генераторам исходного кода сделать это.

Как генераторы исходного кода сравниваются с поставщиками типов в F#?

Если вы программист F# (или знакомы с этим языком), возможно, вы слышали о поставщиках типов. Генераторы исходного кода были частично вдохновлены поставщиками типов, но есть несколько отличий, которые отличают их. Основное отличие состоит в том, что поставщики типов являются частью собственно языка F# и создают типы, свойства и методы в памяти на основе внешнего источника. Генераторы исходного кода — это функция компилятора, которая анализирует исходный код C#, при необходимости с другими файлами, создает исходный код C# для включения обратно в компиляцию.

Должен ли я удалить весь код отражения?

Нет! Отражение — невероятно полезный инструмент. Рефлексия действительно создает некоторые проблемы с производительностью и «связываемостью», которые можно решить с помощью генераторов исходного кода в некоторых сценариях. Мы рекомендуем тщательно оценить, подходят ли генераторы исходного кода для вашего сценария.

Чем генераторы источников отличаются от анализаторов?

Генераторы исходного кода похожи на анализаторы, поскольку оба являются функциями компилятора, которые позволяют подключаться к компиляции. Ключевое отличие состоит в том, что анализаторы в конечном итоге выдают диагностические данные, которые можно использовать для связи с исправлением кода. Генераторы исходного кода в конечном итоге создают исходный код C#, который добавляется в компиляцию. Есть несколько других отличий, обсуждаемых в проектной документации.

Можно ли изменить/переписать существующий код с помощью генератора исходного кода?

Нет. Как упоминалось ранее, генераторы исходного кода не позволяют переписывать исходный код пользователя. Мы не собираемся допускать их к этому. Они могут только дополнить компиляцию, добавив в нее исходные файлы C#.

Когда генераторы исходного кода перестанут быть доступны для предварительного просмотра?

Мы планируем поставлять генераторы исходного кода с C# 9. Однако, если они не будут готовы вовремя, мы оставим их в предварительной версии и обеспечим, чтобы пользователи согласились на их использование.

Можно ли изменить TFM в генераторе источников?

Технически да. Генераторы исходного кода — это компоненты .NET Standard 2.0, и, как и в любом проекте, вы можете изменить TFM. Однако сегодня они поддерживают загрузку в потребляющие проекты только как компоненты .NET Standard 2.0.

Будут ли генераторы исходного кода доступны для Visual Basic или F#?

Генераторы исходного кода в настоящее время являются функцией только C#. Поскольку это первая предварительная версия, есть много вещей, которые могут измениться между настоящей и выпущенной версией. В настоящее время мы не собираемся добавлять генераторы исходного кода в Visual Basic. Если вы являетесь разработчиком F# и хотите, чтобы эта функция была добавлена, выполните поиск предложений или отправьте новый в репозиторий предложений языка F#.

Создают ли генераторы исходного кода проблемы совместимости для библиотек?

Это зависит от того, как создаются библиотеки. Поскольку в настоящее время VB и F# не поддерживают генераторы исходного кода, авторам библиотек следует избегать разработки своих функций таким образом, чтобы им требовался генератор исходного кода. В идеале у функций есть запасные варианты для отражения во время выполнения и/или выделения отражения. Это то, что авторы библиотек должны тщательно рассмотреть, прежде чем использовать генераторы исходного кода. Мы ожидаем, что большинство авторов библиотек будут использовать генераторы исходного кода для расширения, а не замены существующих возможностей разработчиков C#.

Почему я не получаю IntelliSense для сгенерированного кода? Почему Visual Studio сообщает об ошибке даже при сборке?

Вам потребуется перезапустить Visual Studio после создания генератора исходного кода, чтобы ошибки исчезли, а IntelliSense появился для сгенерированного исходного кода. После того, как вы это сделаете, все будет работать. В настоящее время интеграция Visual Studio находится на очень ранней стадии. Это текущее поведение изменится в будущем, поэтому вам не нужно будет перезапускать Visual Studio.

Можно ли выполнить отладку или перейти к сгенерированному исходному коду в Visual Studio?

Со временем мы добавим навигацию и отладку сгенерированного исходного кода в Visual Studio. На этом раннем этапе предварительного просмотра он еще не поддерживается.

Как отправить собственный генератор источников?

Генераторы исходного кода могут поставляться в виде пакетов NuGet, как сегодня анализаторы. По сути, они используют ту же «сантехнику», что и Анализаторы. Если вы когда-либо поставляли Анализатор, вы можете легко поставить Генератор исходного кода.

Будут ли генераторы исходного кода, созданные Microsoft?

В конце концов, да. Но это все еще первая предварительная версия технологии, и многое может потребоваться изменить, чтобы приспособиться к различным сценариям. В настоящее время нет графика, когда будут доступны генераторы исходного кода, созданные Microsoft.

Почему мне нужно использовать Preview LangVersion для использования генератора исходного кода?

Хотя генераторы исходного кода технически не являются функцией языка C#, они находятся в предварительной версии. Вместо того, чтобы вводить новый параметр только для генераторов исходного кода, мы решили, что будет проще просто использовать существующий переключатель, который включает функции предварительного просмотра языка для компилятора C#.

Удачи и счастливого создания исходников!

Руководство по .NET | Передовой опыт / Генераторы исходного кода

Генераторы исходного кода

Последнее изменение пятница, 30 сентября 2022 г.

Что такое генераторы исходного кода?

id=»какие-есть-источники-генераторы»>

Согласно официальной документации, генератор исходного кода является частью SDK платформы компилятора . NET («Roslyn»), который позволяет разработчикам создавать исходные файлы во время компиляции и добавлять эти файлы в объект компиляции.

Чтобы это стало возможным, генераторы исходного кода могут получить объект компиляции, который содержит весь код, написанный разработчиком. Наиболее распространенным вариантом использования генераторов исходного кода является анализ кода во время компиляции, после чего генерируется дополнительный код и добавляется к объекту компиляции. Он также может сместить фазу обнаружения контроллера с запуска на время компиляции, сократив время запуска. Другое использование генераторов исходного кода может быть в маршрутизации приложений ASP.NET Core, где они могут быть строго типизированы с созданием необходимых строк в качестве деталей времени компиляции. Такой подход может предотвратить ошибочный строковый литерал, который приведет к тому, что запрос не попадет в нужный контроллер.

На изображении ниже показан процесс, который происходит во время компиляции, если разработчик использует генераторы исходного кода.

Использование генераторов исходного кода имеет множество преимуществ, включая более высокую производительность, поскольку генератор исходного кода анализирует код во время компиляции. Альтернативой этому подходу является отражение во время выполнения, которое используется во время запуска приложения и, следовательно, может увеличить время запуска. Еще одним преимуществом является возможность отлавливать ошибки во время компиляции, а не во время выполнения.

Настройка проекта

id=»project-setup»>

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

1. Создайте новый проект библиотеки классов с целевой платформой .NET Standard 2.0

2. Добавить пакеты NuGet Microsoft.CodeAnalysis.Analyzers и Microsoft. CodeAnalysis.CSharp

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

    <Проект Sdk="Microsoft.NET.Sdk">
   <Группа свойств>
       netstandard2.0
   
   <группа элементов>
       
       
       все
       среда выполнения; строить; родной; файлы содержимого; анализаторы; buildtransitive
       
   
   
    

3. Создайте файл ExampleSourceGenerator.cs , реализующий интерфейс Microsoft.CodeAnalysis.ISourceGenerator , и аннотируйте его с помощью Microsoft.CodeAnalysis.GeneratorAttribute

 с помощью Microsoft.CodeAnalysis;
пространство имен SourceGenerator
{
    [Генератор]
    открытый класс ExampleSourceGenerator: ISourceGenerator
    {
        public void Execute (контекст GeneratorExecutionContext)
        {
            // Здесь идет генерация кода
        }
        public void Initialize (контекст GeneratorInitializationContext)
        {
            // Если требуется, здесь идет инициализация
        }
    }
}
 

После этих трех шагов ваш генератор исходников настроен и что-то с ним делать, вам нужно реализовать метод Execute . Реализация метода Initialize необязательна, поскольку не всегда требуется инициализировать исходный генератор.

Отладка

id=»отладка»>

Если вы использовали генераторы исходного кода, то должны знать, что может быть довольно сложно протестировать вывод генератора и выяснить, какую ошибку он выдает.

К счастью, Visual Studio приходит на помощь с возможностью отладки генераторов исходного кода после нескольких простых шагов:

1. Установите .NET Compiler Platform SDK

   В установщике Visual Studio выберите «Изменить версию Visual Studio, в которой есть проект генератора исходного кода», и установите разработку расширения Visual Studio на вкладке «Рабочие нагрузки» > «Другие наборы инструментов».

2. Добавьте свойство IsRoslynComponent в файл проекта исходного генератора:

    <Проект Sdk="Microsoft.NET.Sdk">
       <Группа свойств>
           netstandard2. 0
           true
           включить
           последняя
       
       <группа элементов>
           
           
               все
               среда выполнения; строить; родной; файлы содержимого; анализаторы; buildtransitive
           
       
   
    

3. Добавить ссылку на исходный генератор в проект, который будет его использовать (если он еще не добавлен):

    <Группа элементов>
       
   
    

4. Добавьте конфигурацию отладки, выполнив следующие действия:

   1. Щелкните правой кнопкой мыши проект, содержащий исходный генератор
   2. Нажмите Свойства
   3. Нажмите Отладка
   4. Щелкните Откройте пользовательский интерфейс профилей запуска отладки
   5. Удалить существующие профили
   6. Добавить новый профиль Roslyn Component
   7. Выберите целевой проект из списка проектов
   8. Дополнительно : переименуйте профиль отладки, чтобы его можно было легко найти и использовать позже
   9. Перезапустите Visual Studio и установите проект генератора исходного кода в качестве запускаемого проекта

В конце добавьте несколько точек останова в код генератора исходного кода, запустите проект в режиме отладки, решите проблемы, которые беспокоили вас в первую очередь, или просто изучите, как ваш генератор исходного кода работает в фоновом режиме.