build_runner ile Kod Üretme

JSON ayrıştırma gibi bazı kodlar tekrarlanan kalıp kodlardan oluşur. Kod oluşturma, açıklamalardan yola çıkarak bu kodu sizin için yazar; böylece doğru ve hızlı kalırsınız. ⚙️

build_runner, Dart'ın projenizde kod oluşturucuları çalıştıran aracıdır. Kaynak dosyalarını okur, açıklamaları bulur ve yeni dosyalar üretir.

build_runner'ı pubspec.yaml içinde dev_dependencies altına eklersiniz; çünkü derleme sırasında çalışır ve uygulamanızla birlikte dağıtılmaz.

Oluşturucular, kardeş bir dosyaya yazar. Dosyaya, adı geleneksel olarak .g.dart ile biten bir part yönergesiyle bağlanırsınız.

Tek seferlik kod oluşturmayı build komutuyla başlatın. Komut, kodunuzu tarar ve tüm .g.dart dosyalarını oluşturur veya günceller.

Geliştirme sırasında watch modu, her kaydettiğinizde dosyaları otomatik olarak yeniden oluşturur. Böylece oluşturulan dosyalar, komutları elle yeniden çalıştırmanıza gerek kalmadan güncel tutulur.

Çıktılar eski dosyalarla çakışırsa --delete-conflicting-outputs seçeneğini ekleyin. Bu seçenek, güncelliğini yitirmiş oluşturulmuş dosyaları temizleyerek yeni derlemenin başarılı olmasını sağlar.

Oluşturucular yalnızca annotate ettiğiniz bildirimler üzerinde işlem yapar. Açıklama, derleyiciye hangi sınıfı işleyeceğini ve hangi kodu üreteceğini bildirir.

Tüm .g.dart dosyalarını read-only kabul edin. Bir sonraki derleme yaptığınız değişikliklerin üzerine yazar; bu nedenle bunun yerine kaynak kodu ve açıklamaları düzenleyin.

Ekipler, oluşturulan dosyaları kaydetmeyi ya da bunları .gitignore dosyasına ekleyip CI ortamında yeniden oluşturmayı seçer. Hangi yolu seçerseniz seçin, tek bir politika belirleyip tutarlı olun.

json_serializable ve freezed gibi birçok paket build_runner'a bağlanır. Hepsi aynı builder işlem hattını paylaşır; böylece tek bir komut tümünü çalıştırır.

Her dosya kaydedildiğinde kodu yeniden oluşturan komut hangisidir?

build_runner, açıklamaları oluşturulmuş .g.dart dosyalarına dönüştürür. Onu dev_dependencies altına ekleyin, build veya watch komutunu çalıştırın ve çıktıyı asla düzenlemeyin. 🎉