Bölüm 13 — Konu 64: FFI (Foreign Function Interface) — C Koduna Erişim

#FFI Nedir ve Neden Var?

Bölüm 1'de Dart'ın "native koda derlenebildiğini" (AOT, Bölüm 12 Konu 57) öğrenmiştik. Bazen, Dart'ın kendi kütüphanelerinde olmayan, ama C dilinde yazılmış güçlü, optimize edilmiş kütüphanelere erişmen gerekebilir — örneğin görüntü işleme, kriptografi, veya donanıma yakın işlemler için onlarca yıllık, yüksek performanslı C kütüphaneleri mevcuttur. FFI (Foreign Function Interface), Dart kodundan doğrudan C fonksiyonlarını çağırmanı sağlayan bir köprüdür.

#Ne Zaman FFI Gerekir?

• Var olan, optimize edilmiş bir C/C++ kütüphanesini (örneğin bir görüntü işleme kütüphanesi, bir sıkıştırma algoritması) Dart'tan kullanmak istediğinde.
• İşletim sisteminin native API'lerine (bazı düşük seviyeli sistem çağrıları) erişmen gerektiğinde.
• Performansın son derece kritik olduğu, C'nin sağladığı donanım-yakını kontrolün gerektiği nadir senaryolarda.

Önemli not: Bu, çok nadir ihtiyaç duyacağın bir özelliktir — günlük Flutter geliştirmede, hatta çoğu Dart projesinde FFI'a hiç gerek duymazsın. Ama var olduğunu ve ne işe yaradığını bilmek, "uzman seviye" bir anlayış için önemli.

#Basit Bir FFI Örneği — Kavramsal Bakış

import 'dart:ffi';
import 'dart:io';

// C tarafındaki fonksiyonun Dart'taki "imzası"
typedef CTopla = Int32 Function(Int32 a, Int32 b);
typedef DartTopla = int Function(int a, int b);

void main() {
  // C kütüphanesini (paylaşımlı kütüphane dosyası - .so, .dll, .dylib) yükle
  final DynamicLibrary cKutuphanesi = Platform.isWindows
      ? DynamicLibrary.open('matematik.dll')
      : DynamicLibrary.open('libmatematik.so');

  // C fonksiyonuna bir Dart referansı al
  final DartTopla topla = cKutuphanesi
      .lookupFunction<CTopla, DartTopla>('topla');

  // Artık C fonksiyonunu, sıradan bir Dart fonksiyonu gibi çağırabiliriz!
  print(topla(5, 3)); // 8 (C tarafında hesaplandı)
}

Bu kod, matematik.dll/libmatematik.so adında, C dilinde derlenmiş bir kütüphanenin içindeki topla fonksiyonunu doğrudan Dart'tan çağırıyor. Kavramsal olarak neler oluyor:

1. DynamicLibrary.open(...): İşletim sisteminin, derlenmiş bir C kütüphanesini (paylaşımlı kütüphane — shared library) belleğe yüklemesini sağlar.
2. typedef: Bölüm 5'te öğrendiğimiz fonksiyon tiplerine benzer şekilde, C tarafındaki fonksiyonun imzasını (parametre/dönüş tipleri) Dart'a tanımlıyoruz — biri C'nin kendi tip sistemiyle (Int32 gibi), diğeri Dart'ın tip sistemiyle (int gibi).
3. .lookupFunction<...>(...): Kütüphane içindeki, ismiyle belirtilen fonksiyonu bulur ve Dart'tan çağrılabilir bir referansa dönüştürür.

#C ile Dart Arasındaki Tip Eşleştirmesi

FFI'ın en hassas kısmı, C'nin tip sistemi ile Dart'ın tip sisteminin birbirine doğru eşleştirilmesidir:

// C tipleri -> Dart FFI tipleri
// int (C)      -> Int32 veya Int64
// float (C)    -> Float
// double (C)   -> Double
// char* (C)    -> Pointer<Utf8> (string'ler için özel işlem gerekir)

Bölüm 2'de Dart'ın kendi tip sisteminin (int, double gibi) sound null safety ile nasıl güvenli olduğunu öğrenmiştik — FFI kullanırken, bu güvenliğin sınırına geliyorsun: C tarafındaki tipleri yanlış eşleştirirsen, Dart bunu derleme zamanında yakalayamayabilir, ve bu, çalışma zamanında çökme veya öngörülemez davranışlara yol açabilir. Bu yüzden FFI, Dart'ın normal tip güvenliği garantilerinin dışında kalan bir alandır — dikkatli kullanılması gerekir.

#Pointer — C'nin Bellek Modeline Köprü

C, Dart'ın aksine, işaretçiler (pointers) ile doğrudan bellek adreslerine erişime izin verir — Dart'ın kendi güvenli, garbage-collected bellek modelinden çok farklı bir yaklaşım. FFI, bu farkı köprülemek için Pointer<T> tipini sunar:

import 'dart:ffi';

void main() {
  Pointer<Int32> pointer = calloc<Int32>(); // C tarzı bellek ayırma
  pointer.value = 42;
  print(pointer.value); // 42
  calloc.free(pointer); // ELLE bellek serbest bırakma — GC bunu YAPMAZ!
}

Kritik fark: Bölüm 13 Konu 62'de öğrendiğimiz garbage collection, sadece Dart'ın kendi nesneleri için geçerlidir. FFI ile ayrılan bellek (calloc<Int32>() gibi), C'nin bellek modeline aittir — bu belleği elle serbest bırakman (calloc.free(...)) gerekir, aksi halde bellek sızıntısı oluşur. Bu, Bölüm 13 Konu 62'de "Dart'ta elle bellek yönetimi gerekmez" dediğimiz genel kuralın istisnasıdır — FFI, seni C'nin dünyasına soktuğu için, C'nin kurallarına (elle bellek yönetimi) da uymanı gerektirir.

#Gerçek Dünya Kullanımı — package:ffi ve Kod Üretimi

Pratikte, FFI kodu elle yazmak (yukarıdaki gibi) hataya açık ve zahmetlidir. Bu yüzden Dart ekosisteminde, FFI binding'lerini otomatik üretmeye yardımcı olan araçlar vardır (ffigen gibi) — bu araçlar, bir C header dosyasını (.h) okuyup, karşılık gelen Dart FFI kodunu otomatik olarak üretirler. Bu, Bölüm 12'de bahsettiğimiz build_runner / code generation ekosistemine benzer bir yaklaşımdır (bunu bir sonraki derste tam olarak işleyeceğiz).

#Flutter'da FFI

Flutter uygulamaları da FFI kullanabilir — bu, özellikle platform-spesifik, yüksek performanslı işlemler gerektiğinde (örneğin bir ses işleme kütüphanesi, bir video codec) kullanılır. Ama günlük Flutter geliştirmede, çok nadir karşına çıkacak bir ihtiyaçtır — çoğu zaman, Bölüm 9'da (Flutter müfredatı) göreceğimiz Platform Channels (native Android/iOS koduna erişim için farklı bir mekanizma) daha yaygın kullanılır.

#🎯 Bu Dersten Çıkarılması Gerekenler

• FFI, Dart kodundan doğrudan C fonksiyonlarını çağırmanı sağlayan bir köprüdür; nadir, ama var olan optimize edilmiş C kütüphanelerinden faydalanmak için kullanılır.
• DynamicLibrary.open(), bir C kütüphanesini yükler; lookupFunction(), içindeki bir fonksiyonu Dart'tan çağrılabilir hale getirir.
• C ve Dart'ın tip sistemleri arasında doğru eşleştirme yapılmalıdır — yanlış eşleştirme, Dart'ın normal tip güvenliği dışında kalır ve çalışma zamanı sorunlarına yol açabilir.
• Pointer<T>, C'nin işaretçi (pointer) tabanlı bellek modeline köprü kurar; bu bellek, Dart'ın garbage collector'ı tarafından yönetilmez, elle serbest bırakılmalıdır.
• Pratikte, FFI binding'leri genelde ffigen gibi araçlarla otomatik üretilir; elle yazmak nadirdir ve hataya açıktır.

#📝 Ödevler

• [ ] Kendi cümlelerinle, "FFI ne zaman gerekli olur, ne zaman gereksizdir" sorusunu, bu dersten öğrendiğin kriterlerle açıkla.
• [ ] FFI ile ayrılan belleğin neden garbage collector tarafından yönetilmediğini, Bölüm 13 Konu 62'de öğrendiğin GC modeliyle karşılaştırarak açıkla.
• [ ] typedef kullanarak, hayali bir C fonksiyonunun (örn. int carp(int a, int b)) Dart tarafındaki imza tanımını (CFonksiyon ve DartFonksiyon typedef'leri) yaz (çalıştırmana gerek yok, sadece sözdizimini pratik et).
• [ ] Kendi cümlelerinle, "Pointer ile normal bir Dart nesnesi arasındaki temel fark nedir" sorusunu yanıtla.
• [ ] Flutter'da FFI ile Platform Channels arasındaki farkı (ne zaman hangisinin tercih edileceğini) araştırıp kısaca özetle.

Sıradaki konu: Bölüm 13 — Konu 65: Sunucu Tarafında Dart — dart:io, shelf Paketiyle Basit Bir Backend/CLI Aracı Yazma