Подключение внешних сборок

Движок скриптов полностью поддерживает подключение внешних сборок — как из файла, так и из NuGet.

Важно: подключение сборок доступно только внутри Script.csx, который является аналогом вашего Program.cs в «обычном» C#.

Через окно Properties

Начиная с новых версий EyeAuras, зависимости можно подключать не только вручную через #r, но и через отдельное окно Script Properties.

Сначала откройте свой скрипт и нажмите кнопку Properties.

После этого откроется окно Script Properties, где во вкладке NuGet можно:

• искать пакеты
• выбирать версию
• устанавливать пакет
• обновлять уже установленный пакет
• удалять ненужные пакеты

Это самый удобный способ для большинства сценариев: не нужно помнить точный синтаксис, вручную редактировать директивы или идти на сайт NuGet, если вы просто хотите быстро подключить библиотеку.

Рядом находится и вкладка References. Она нужна для немного другого сценария: там можно добавить либо уже загруженную сборку из самой EyeAuras, либо внешнюю DLL по пути. Это особенно полезно, если нужной библиотеки просто нет на NuGet.

Как это связано с #r

Под капотом это все тот же механизм ссылок на пакеты. Окно Properties просто дает удобный интерфейс поверх #r "nuget: ...".

То есть:

• если вам удобно пользоваться интерфейсом, можно вообще не трогать директивы руками
• если вы предпочитаете полный контроль, все еще можно писать #r вручную

Оба варианта приводят к одному и тому же результату: EyeAuras скачивает пакет и пытается подключить его зависимости так же, как это обычно делают стандартные инструменты .NET.

По имени пакета — из NuGet

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

#r "nuget: Coroutine, 2.1.5"

Log.Info("Hello, World!"); //you can use Coroutine classes in that script

Если пакет уже подключен, через Properties -> NuGet его будет удобнее обновить или удалить. Ручной режим остается полезным, если вы хотите быстро вставить зависимость прямо в код или переносите уже готовый Script.csx.

По пути к сборке — из файла

Этот вариант позволяет подключать сборки из локальных файлов. Это может быть полезно, если нужная сборка по какой-то причине недоступна в NuGet.

#r "assemblyPath: D:\Work\EAExile\EAExileAgent.Shared.dll"

Log.Info("Hello, World!"); //you can use EAExileAgent classes in that script

По имени сборки — из памяти

Этот способ позволяет ссылаться на сборки, которые:

• уже загружены EyeAuras, но не входят в список сборок, подключаемых по умолчанию
• были загружены через Assembly.Load или любым другим способом, но уже находятся в AssemblyLoadContext/AppDomain
• находятся в GAC

Исторически EyeAuras подключал ОЧЕНЬ много сборок по умолчанию — более 300. Это экономит пользователям время на предварительную настройку зависимостей для каждого C#-действия, BT-ноды и т. д., но в долгосрочной перспективе такой подход не является хорошим решением.

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

#r "assemblyName: Grpc.Net.Client"

Log.Info("Hello, World!"); //you can use Grpc.Net.Client classes in that script

Что выбрать на практике

Обычно логика такая:

• если библиотека есть на NuGet, почти всегда лучше подключать ее именно как NuGet-пакет
• если библиотеки на NuGet нет, можно сослаться на локальную DLL через assemblyPath, в том числе через вкладку Properties -> References
• если файл нужно распространять вместе со скриптом, посмотрите еще на Embedded Resources

Для большинства пользователей оптимальный путь теперь такой:

1. Открыть скрипт.
2. Нажать Properties.
3. Перейти во вкладку NuGet.
4. Найти пакет, выбрать версию и нажать Add Package или Update Package.

Это проще, безопаснее и нагляднее, чем сразу начинать с ручного редактирования Script.csx.

Если же нужного пакета в NuGet нет, откройте соседнюю вкладку References и добавьте внешнюю сборку по пути.