Пишем Dll на C#

Всем привет!

Очень давно я хотел найти способ написания dll для Game Maker на C#. Мне удалось найти два видео урока на эту тему:
Видео 1
Видео 2

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

Для данной статьи я использовал Visual Studio 2015.
Запускаем Visual Studio и создаём новый проект "Библиоткека классов". Назовём её "MyDll".

После создания проекта вы должны увидеть следующий код:

Код:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace MyDll
{
   public class Class1
   {
   }
}

Давайте создадим простенькую функцию на сложение чисел. Она должна быть статичная и публичная. Я назвал её "Add".

Код:

public static double Add(double a, double b)
{
return a + b;
}

Стоить отметить, что Game Maker может получать и передавать только double и string аргументы. (т.е. числа с плавающей точкой или строки)
Чтобы заставить эту функцию работать в Game Maker, нужно установить одно расширение. Для этого, нажмите ПКМ в правой части проекта по вкладке "Ссылки", а затем "Управление пакетами NuGet".

В открывшемся окне, выберите вкладку "Обзор", а затем впишите в строку поиска "Dllexport".
Установите его щёлкнув на маленький квадратик справа около версии расширения или на кнопку "Установить".

После установки пакета, откроется окно конфигурации. В нём мы лишь укажем пространство имён, которое будет использовать данный пакет.
Основываясь на видеоуроке, я использовал такое же как и там:

Код:

System.Runtime.InteropServices

Далее нажимаем "Configurate".

Теперь нужно использовать пакет в проекте. Для этого в верхней части кода допишем строчку:

Код:

using System.Runtime.InteropServices;

Перед нашей функцией нужно будет дописать тоже одну строчку:

Код:

[DllExport("Add", CallingConvention.Cdecl)]

Где первый аргументы это название нашей функции, которая будет экспортироваться, а второй аргумент это тип вызова. (По умолчанию он Cdecl)
Данную строчку кода следует писать перед всеми функциями, которые следует экспортировать. (использовать в Game Maker)
Весь код будет выглядеть так:

Код:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Runtime.InteropServices;

namespace MyDll
{
   public class Class1
   {
   [DllExport("Add", CallingConvention.Cdecl)]
   public static double Add(double a, double b)
   {
   return a + b;
   }
   }
}

Далее следует создать новую конфигурацию проекта. Если я правильно понял из видео урока, то Game Maker работает только с теми dll, которые собраны под x86 (разрядностью платформы?)
Для этого, щёлкните на "Any CPU" на панели инструментов, а затем "Диспетчер конфигураций".

В столбце "Платформа" вновь щёлкните на "Any CPU". В открывшемся окне в графе "Новая платформа" выберите "x86". Затем щёлкните ОК.

После этого, конфигурация должна автоматически установиться на "x86".
Осталось лишь собрать проект. Для этого щёлкните по "Сборка", а затем "Собрать решение".

Если в проекте нет ошибок, то проект успешно соберётся.

Далее подключим dll к проекту Game Maker. Для данного урока я использовал Game Maker Studio 2 (Но и в GMS 1.4 тоже всё работает).
Создадим новый проект и создадим новое расширение.
В открывшемся окне, щёлкните на квадратную кнопку в графе "Files", а затем "Add File".

Добавим нашу dll. По умолчанию, она храниться по этому пути:

Код:

C:\Users\UserName\Documents\Visual Studio 2015\Projects\MyDll\MyDll\bin\x86\Debug

После добавления файла, щёлкните по нему два раза ЛКМ. В открывшемся окне щёлкните на квадратную кнопку в графе "Functions", а затем "Add Function"

Откроется окно в котором нужно прописать вызов функции из нашей dll.

Name - название функции, которая будет использоваться в Game Maker
External Name - название функции внутри dll
Help - подсказка при наборе название функции в коде
ReturnType - что возвращает функция из dll, число или строку (double/string)
Arguments - Количество аргументов в данной функции.

Следует настроить её так:

ReturnType следует указать double, т.к. у нас складывается 2 числа и возвращается результат.
Так же, нужно добавить 2 аргумента типа double, чтобы передать 2 числа для сложения в dll.

Собственно, на этом и всё. Можете проверить данную функцию. Пропишем при нажатии клавиши Enter какого либо объекта небольшой код:

Код:

var sum = add(10, 18);
show_message(sum);

Должно высветиться сообщение с текстом 28.
Всем спасибо за внимание! Надеюсь у всех всё получится.
Если есть какие либо неточности в статье или ошибки, можете меня поправить.

	Автор	Тема: Пишем Dll на C# (Прочитано 33570 раз)
0 Пользователей и 1 Гость смотрят эту тему.