Unity'de Bağımlılık Enjeksiyonu: Zenject Rehberi

Modern yazılım geliştirme, karmaşık sistemlerin yönetilebilir, test edilebilir ve sürdürülebilir olmasını gerektirir. Özellikle Unity gibi oyun motorlarında, bileşenler arası bağımlılıklar hızla çığ gibi büyüyebilir. İşte tam bu noktada, yazılım tasarım desenlerinden biri olan **Bağımlılık Enjeksiyonu (Dependency Injection - DI)** devreye girer. Bu makalede, Bağımlılık Enjeksiyonu'nun ne olduğunu, neden önemli olduğunu ve Unity projelerinizde popüler bir DI çerçevesi olan **Zenject (şimdiki adıyla Extenject)** ile nasıl kullanılabileceğini detaylıca inceleyeceğiz.

Bağımlılık Enjeksiyonu (DI) Nedir?

Bağımlılık Enjeksiyonu, bir nesnenin ihtiyaç duyduğu bağımlılıkları (diğer nesneleri veya servisleri) doğrudan kendisinin oluşturması veya bulması yerine, dışarıdan sağlanması prensibine dayanır. Bu, **Kontrolün Tersine Çevrilmesi (Inversion of Control - IoC)** prensibinin özel bir uygulamasıdır. Geleneksel yaklaşımlarda bir sınıf, bağımlılıklarını kendi içinde yaratır veya bir Service Locator aracılığıyla arar. DI ise bu sorumluluğu sınıfın üzerinden alarak, dışarıdan (genellikle bir IoC kapsayıcısı tarafından) enjekte edilmesini sağlar.

DI Neden Önemlidir?

• Gevşek Bağlantı (Loose Coupling): Sınıflar, bağımlılıklarını doğrudan oluşturmadıkları için birbirlerine sıkı sıkıya bağlı olmazlar. Bu, bir bileşendeki değişikliğin diğer bileşenleri daha az etkilemesini sağlar.
• Test Edilebilirlik: Bağımlılıklar dışarıdan enjekte edildiği için, bir sınıfı test ederken gerçek bağımlılıklar yerine sahte (mock) veya taklit (stub) nesneler enjekte edilebilir. Bu, birim testlerini çok daha kolay ve güvenilir hale getirir.
• Yeniden Kullanılabilirlik: Gevşek bağlı bileşenler, farklı bağlamlarda veya projelerde daha kolay yeniden kullanılabilir.
• Bakım Kolaylığı: Kod tabanı daha modüler ve anlaşılır hale gelir, bu da hata ayıklamayı ve yeni özellikler eklemeyi kolaylaştırır.
• Esneklik: Uygulamanın farklı ortamlar (geliştirme, test, üretim) için farklı bağımlılıklarla çalışması gerektiğinde, enjeksiyon mekanizması kolayca adapte edilebilir.

Unity'de Bağımlılık Enjeksiyonu'nun Önemi

Unity, bileşen tabanlı bir mimariye sahiptir. `MonoBehaviour` sınıfları, genellikle `Awake()` veya `Start()` metodlarında diğer bileşenlere veya servislere erişmek için `GetComponent()`, `FindObjectOfType()` gibi yöntemler kullanır. Bu yaklaşımlar, özellikle büyük ve karmaşık projelerde birtakım sorunlara yol açabilir:

• Sıkı Bağlantı: Bir `MonoBehaviour`'ın belirli bir bileşene veya servise doğrudan bağımlı olması, o bileşenin değiştirilmesini veya yerine başka bir şey konulmasını zorlaştırır.
• Test Zorluğu: `MonoBehaviour`'ların yaşam döngüsü Unity'ye sıkıca bağlı olduğu için, bunları izole bir şekilde test etmek zordur. Bağımlılıklar manuel olarak ayarlanmalı veya sahne hiyerarşisine göre bulunmalıdır.
• GameObject Hiyerarşisi Bağımlılığı: Bağımlılıkları bulmak için `FindObjectOfType()` veya `GetComponentInParent()` gibi metodlar kullanmak, kodunuzu sahne yapısına bağımlı hale getirir ve hata yapma olasılığını artırır.
• Singletons: Genellikle bağımlılık sorunlarını çözmek için kullanılan Singleton desenleri, global duruma yol açabilir, test edilebilirliği azaltabilir ve kodun esnekliğini kısıtlayabilir. DI, genellikle Singleton'lara daha temiz bir alternatif sunar.

Zenject gibi bir DI çerçevesi kullanarak, bu sorunların üstesinden gelebilir ve Unity projelerinizde daha temiz, daha esnek ve daha test edilebilir bir mimari oluşturabilirsiniz.

Zenject (Extenject) Nedir?

Zenject, Unity için tasarlanmış, açık kaynaklı ve güçlü bir Bağımlılık Enjeksiyonu çerçevesidir. Zenject'in orijinal geliştiricisi projeyi bırakınca, topluluk tarafından geliştirilmeye devam eden çatalına **Extenject** adı verilmiştir. Günümüzde Extenject, Zenject'in güncel ve bakımı yapılan versiyonu olarak kabul edilir ve Unity Asset Store'da mevcuttur. Extenject, bir IoC kapsayıcısı sağlayarak, nesnelerin oluşturulmasını ve bağımlılıklarının otomatik olarak enjekte edilmesini kolaylaştırır.

Zenject (Extenject) Kurulumu

Extenject'i projenize eklemek oldukça basittir:

1. Unity Asset Store: Unity Asset Store'dan 'Extenject' aratıp paketi indirip projenize aktarabilirsiniz.
2. Git ile Kurulum: Unity Package Manager'ı açın (`Window > Package Manager`). Sol üstteki '+' ikonuna tıklayın ve 'Add package from git URL...' seçeneğini seçin. `https://github.com/Extenject/Extenject.git` adresini yapıştırın.

Kurulum tamamlandığında, projenizde `Extenject` (veya `Zenject`) klasörü belirecektir.

Zenject Temelleri: Binding ve Enjeksiyon

Zenject'in iki ana kavramı **Binding (Bağlama)** ve **Injection (Enjeksiyon)**'dur.

1. Binding (Bağlama)

Binding, Zenject kapsayıcısına belirli bir tür istendiğinde hangi somut örneğin (instance) sağlanacağını bildirme işlemidir. Bu işlem genellikle `Installer` adını verdiğimiz özel sınıflar içinde yapılır.

Bir `Installer` sınıfı oluşturmak için `MonoInstaller` veya `ScriptableObjectInstaller`'dan türetmeniz gerekir:

using Zenject;

public class GameInstaller : MonoInstaller
{
    public override void InstallBindings()
    {
        // IPlayerService istendiğinde PlayerService sınıfının tek bir örneğini sağla
        Container.Bind<IPlayerService>().To<PlayerService>().AsSingle();

        // GameSettings sınıfının bir örneğini enjekte et
        Container.Bind<GameSettings>().AsSingle();

        // PlayerController'ın kendisini enjekte et
        Container.Bind<PlayerController>().FromNewComponentOnNewGameObject().AsSingle();
    }
}

Bu `GameInstaller`'ı bir GameObject'e eklemeli ve sahnenizin `SceneContext`'ine referans vermelisiniz (veya `ProjectContext`'e global bağımlılıklar için).

Yaygın Binding Türleri:

• `Container.Bind().To().AsSingle();`: `T` arayüzü istendiğinde `U` sınıfının tek bir örneğini oluştur ve her zaman aynı örneği döndür.
• `Container.Bind().AsTransient();`: `T` istendiğinde her seferinde yeni bir örnek oluştur.
• `Container.Bind().FromInstance(instance);`: Mevcut bir örneği enjekte et.
• `Container.Bind().FromComponentInHierarchy();`: Sahnede mevcut bir GameObject'in üzerindeki bileşeni bul ve enjekte et.
• `Container.Bind().FromNewComponentOnNewGameObject();`: Yeni bir GameObject oluşturup üzerine `T` bileşenini ekleyerek enjekte et.

using Zenject;

public class PlayerService : IPlayerService
{
    private readonly GameSettings _settings;

    [Inject]
    public PlayerService(GameSettings settings)
    {
        _settings = settings;
    }

    public void DoSomething()
    {
        UnityEngine.Debug.Log($"Player service doing something with setting: {_settings.PlayerSpeed}");
    }
}

using UnityEngine;
using Zenject;

public class PlayerController : MonoBehaviour
{
    [Inject]
    private IPlayerService _playerService;

    [Inject]
    private GameSettings _gameSettings;

    void Start()
    {
        _playerService.DoSomething();
        Debug.Log($"Player speed from settings: {_gameSettings.PlayerSpeed}");
    }
}

using Zenject;

public class EnemyAI
{
    private IPlayerService _playerService;

    [Inject]
    public void Initialize(IPlayerService playerService)
    {
        _playerService = playerService;
    }

    public void AttackPlayer()
    {
        _playerService.DoSomething(); // Örnek kullanım
    }
}