Как создать DLL в Unity?

Создание DLL в Unity: Полное руководство

Создание DLL (Dynamic Link Library) в Unity — это мощная техника для организации кода, защиты интеллектуальной собственности, повторного использования библиотек и разделения ответственности между командами.

Основные подходы к созданию DLL в Unity

1. Сборка DLL через Visual Studio / Rider

Самый распространённый метод — создание отдельного проекта Class Library в среде разработки.

Шаги создания:

1. Откройте Visual Studio и создайте новый проект типа Class Library (.NET Framework или .NET Standard)
2. Выберите соответствующую версию .NET, совместимую с вашей версией Unity
3. Напишите ваш код, убедившись, что используются только API, доступные в Unity

Пример структуры проекта:

// MyMathLibrary.cs
namespace MyGame.Libraries
{
    public static class MathUtilities
    {
        public static float CalculateDamage(float baseDamage, float multiplier)
        {
            return baseDamage * multiplier;
        }
        
        public static Vector3 SmoothLerp(Vector3 start, Vector3 end, float t)
        {
            t = t * t * (3f - 2f * t); // Кубическое сглаживание
            return Vector3.Lerp(start, end, t);
        }
    }
}

2. Использование Assembly Definition Files (asmdef)

Более современный подход, специфичный для Unity, — использование Assembly Definition Files, которые создают DLL непосредственно внутри проекта Unity.

Преимущества asmdef:

• Более быстрая компиляция (инкрементальная)
• Лучшая изоляция кода
• Управление зависимостями между сборками
• Совместимость с системой сборки Unity

Создание asmdef:

1. В папке проекта Unity кликните правой кнопкой → Create → Assembly Definition
2. Настройте зависимости в инспекторе:

// MyAssembly.asmdef (файл конфигурации)
{
    "name": "MyGame.Core",
    "references": ["UnityEngine", "MyGame.Utilities"],
    "includePlatforms": [],
    "excludePlatforms": [],
    "allowUnsafeCode": false,
    "overrideReferences": false,
    "precompiledReferences": [],
    "autoReferenced": true,
    "defineConstraints": []
}

Практический пример: Создание и использование DLL

Шаг 1: Создание библиотеки в Visual Studio

// GameAnalytics.cs
using System;
using System.Collections.Generic;

namespace GameAnalyticsSDK
{
    public class AnalyticsManager
    {
        private static AnalyticsManager _instance;
        
        public static AnalyticsManager Instance 
        {
            get { return _instance ?? (_instance = new AnalyticsManager()); }
        }
        
        private List<string> _events = new List<string>();
        
        public void TrackEvent(string eventName, Dictionary<string, object> parameters = null)
        {
            _events.Add(eventName);
            // Здесь будет логика отправки данных
            UnityEngine.Debug.Log($"Event tracked: {eventName}");
        }
        
        public int GetEventCount() => _events.Count;
    }
}

Шаг 2: Компиляция и импорт в Unity

1. Скомпилируйте проект в Visual Studio (Build → Build Solution)
2. Полученный DLL файл поместите в папку Assets/Plugins/ вашего проекта Unity
3. Unity автоматически распознает и импортирует DLL

Шаг 3: Использование в Unity скриптах

// GameController.cs в Unity
using UnityEngine;
using GameAnalyticsSDK; // Импорт нашей DLL

public class GameController : MonoBehaviour
{
    void Start()
    {
        // Использование методов из DLL
        AnalyticsManager.Instance.TrackEvent("GameStarted");
        
        // Пример вызова математической библиотеки
        float damage = MyGame.Libraries.MathUtilities.CalculateDamage(100f, 1.5f);
        Debug.Log($"Calculated damage: {damage}");
    }
}

Важные технические детали

Совместимость версий .NET

• Unity 2021+ использует .NET Standard 2.1 или .NET Framework 4.x
• Старые версии Unity могут требовать .NET 3.5 Equivalent
• Всегда проверяйте Api Compatibility Level в Player Settings

Оптимизация производительности

• Разделение кода на DLL уменьшает время перекомпиляции
• Используйте Assembly Definition References для управления зависимостями
• Избегайте циклических зависимостей между сборками

Работа с зависимостями

// Правильное использование зависимостей
[assembly: System.Runtime.CompilerServices.InternalsVisibleTo("MyGame.Tests")]
// Этот атрибут позволяет тестовой сборке доступ к internal классам

Типичные проблемы и их решения

1. Ошибки совместимости API

   • Убедитесь, что не используете API, недоступные в Unity
   • Проверьте Player Settings → Api Compatibility Level

2. Проблемы с сериализацией

   • Классы из DLL могут не сериализоваться Unity Inspector
   • Используйте [System.Serializable] атрибут и создавайте ScriptableObject обёртки

3. Отладка DLL

   • Добавьте PDB файлы вместе с DLL для отладки
   • Используйте Debug Symbols в настройках импорта DLL в Unity

Лучшие практики

• Организация структуры: Храните DLL в Assets/Plugins/ для нативных библиотек и Assets/Assemblies/ для управляемых
• Версионирование: Используйте семантическое версионирование для библиотек
• Документация: Создавайте XML документацию для публичных API
• Тестирование: Создавайте отдельные тестовые сборки для каждой DLL
• Безопасность: Используйте обфускацию для коммерческих библиотек

Создание DLL в Unity значительно улучшает архитектуру проекта, позволяет эффективно управлять зависимостями и ускоряет процесс разработки за счёт модульности кода. Выбор между внешними DLL и Assembly Definition Files зависит от конкретных требований проекта: используйте внешние DLL для кроссплатформенных библиотек, а asmdef — для внутренней модульности внутри Unity-проекта.