Bölüm 12 — Konu 53: `pubspec.yaml`, pub.dev'den Paket Ekleme

Bölüm 12'ye hoş geldin — bu bölüm, tek dosyalık script'lerden gerçek, çok dosyalı projelere geçişi işliyor. İlk durağımız, Bölüm 1'de kısaca gördüğümüz pubspec.yaml'ı derinlemesine anlamak.

#pubspec.yaml Nedir?

Bölüm 1'de bir Dart projesi oluşturduğumuzda karşımıza çıkan pubspec.yaml, projenin kimlik kartı ve bağımlılık listesidir. Her Dart/Flutter projesinin kök dizininde bulunur.

name: benim_projem
description: Bu benim ilk Dart projem
version: 1.0.0
environment:
  sdk: '>=3.0.0 <4.0.0'

dependencies:
  http: ^1.1.0

dev_dependencies:
  test: ^1.24.0
  lints: ^3.0.0

Temel alanları inceleyelim:

• name: Projenin adı (alt çizgi kullanır, tire değil — Dart paket isimlendirme kuralı).
• description: Projenin kısa açıklaması.
• version: Projenin sürüm numarası (genelde semantic versioning — major.minor.patch formatında).
• environment: Bu projenin hangi Dart SDK sürümleriyle uyumlu olduğunu belirtir.
• dependencies: Uygulamanın çalışması için gereken paketler (örneğin http — API istekleri için).
• dev_dependencies: Sadece geliştirme sırasında gereken paketler (örneğin test — test yazmak için, üretim kodunda gerekmez).

#YAML Formatı — Kısa Bir Not

pubspec.yaml, YAML formatında yazılır — bu, JSON'a benzer ama daha okunabilir bir veri formatıdır, girintiye (indentation) duyarlıdır (tıpkı Python gibi). Bölüm 1'de "Dart girintiye duyarlı değildir, süslü parantez kullanır" demiştik — ama pubspec.yaml, Dart kodu değil, YAML dosyasıdır, bu yüzden farklı kurallara tabidir. Girinti hatası (yanlış boşluk sayısı), YAML dosyalarında gerçek bir hataya yol açar.

#Semantic Versioning (Semver) — ^ İşaretinin Anlamı

dependencies:
  http: ^1.1.0

^1.1.0, "1.1.0 ile başlayan, ama 1.x.x aralığında kalan (2.0.0'a geçmeyen) herhangi bir sürüm" anlamına gelir. Bunun mantığı, semantic versioning kuralına dayanır: sürüm numaraları major.minor.patch şeklindedir ve:

• major (ilk sayı) değişirse: kırıcı (breaking) değişiklikler olabilir.
• minor (ikinci sayı) değişirse: yeni özellikler, geriye dönük uyumlu.
• patch (üçüncü sayı) değişirse: hata düzeltmeleri, geriye dönük uyumlu.

^1.1.0, "1.1.0'dan itibaren, major sürüm değişmeden (yani 2.0.0'a kadar, dahil değil) her güncellemeyi otomatik kabul et" demektir — bu, hata düzeltmelerini ve yeni özellikleri otomatik alırken, kırıcı değişikliklerden korunmanı sağlar.

#Paket Ekleme — pub add Komutu

dart pub add http

Bu komut, http paketini otomatik olarak pubspec.yaml'a ekler ve indirir. Manuel olarak pubspec.yaml'ı düzenleyip sonra dart pub get çalıştırmak yerine, bu komut süreci hızlandırır.

Dev dependency eklemek için:

dart pub add --dev test

--dev bayrağı, paketin dev_dependencies altına eklenmesini sağlar.

#dart pub get — Bağımlılıkları İndirme

dart pub get

Bu komut, pubspec.yaml'da listelenen tüm bağımlılıkları indirir (ve gerekli alt bağımlılıklarını da çözümler). Bir projeyi ilk kez klonladığında (örneğin GitHub'dan indirdiğinde), pub get çalıştırman gerekir — çünkü paket dosyalarının kendisi genelde projeyle birlikte paylaşılmaz, sadece hangi paketlerin gerektiği listelenir.

#pubspec.lock — Kesin Sürümleri Kilitleme

dart pub get çalıştırdığında, otomatik olarak pubspec.lock adında bir dosya da oluşur/güncellenir. Bu dosya, pubspec.yaml'daki ^1.1.0 gibi esnek sürüm aralıklarının, o an tam olarak hangi sürüme çözümlendiğini kaydeder (örneğin 1.2.3). Bu, önemlidir çünkü:

pubspec.lock olmadan: İki farklı geliştirici, aynı pubspec.yaml ile çalışsa bile, ^1.1.0 farklı zamanlarda dart pub get çalıştırdıklarında farklı sürümler (örneğin biri 1.2.0, diğeri 1.3.0) alabilir — bu, "benim bilgisayarımda çalışıyor ama seninkinde çalışmıyor" tarzı sorunlara yol açabilir.

pubspec.lock ile: Herkes, dosyada kayıtlı tam olarak aynı sürümleri kullanır — bu, projenin tutarlı ve tekrarlanabilir (reproducible) olmasını sağlar. pubspec.lock, genelde versiyon kontrol sistemine (Git) dahil edilir (uygulamalar için — paketler/kütüphaneler için farklı bir pratik uygulanır, ama bu ileri bir detay).

#pub.dev — Dart'ın Paket Deposu

pub.dev, Dart/Flutter ekosisteminin resmi paket deposudur — tıpkı JavaScript'in npm'i, Python'un PyPI'ı gibi. Buradan binlerce açık kaynak paket bulabilirsin: HTTP istekleri için http veya dio, tarih işlemleri için intl, yerel depolama için shared_preferences gibi (bunların birçoğunu ileride Flutter tutorial'ında kullanacağız).

Bir paketi pub.dev'de değerlendirirken dikkat edilmesi gerekenler:

• Popularity/Likes: Ne kadar yaygın kullanılıyor?
• Pub Points: Paketin kod kalitesi, dokümantasyonu gibi otomatik değerlendirilen bir puan.
• Son güncelleme tarihi: Terk edilmiş (uzun süredir güncellenmemiş) bir pakete bağımlı olmak risklidir.
• Null safety desteği: Modern bir paket olup olmadığı.

#import ile Kullanma — Bölüm 1'e Bağlantı

import 'package:http/http.dart' as http;

void main() async {
  // http paketini artık kullanabilirsin (Bölüm 5'te API çağrılarında detaylı göreceğiz)
}

pubspec.yaml'a eklenen bir paket, kodunda import 'package:paket_adi/...' şeklinde import edilerek kullanılabilir hale gelir. Bu sözdizimini bir sonraki derste (kütüphane oluşturma, import/export) tam olarak işleyeceğiz.

#🎯 Bu Dersten Çıkarılması Gerekenler

• pubspec.yaml, bir Dart/Flutter projesinin kimliğini ve bağımlılıklarını tanımlayan YAML dosyasıdır.
• dependencies, uygulamanın çalışması için gereken paketleri; dev_dependencies, sadece geliştirme sırasında gereken araçları listeler.
• ^1.1.0 gibi sürüm belirteçleri, semantic versioning kurallarına göre, kırıcı olmayan güncellemeleri otomatik kabul eder.
• dart pub get, bağımlılıkları indirir; dart pub add paket_adi, bir paketi otomatik ekler.
• pubspec.lock, tam sürümleri kilitleyerek projenin farklı ortamlarda tutarlı çalışmasını sağlar.
• pub.dev, Dart'ın resmi paket deposudur; popülerlik, pub points ve güncellik gibi kriterlerle paket seçimi yapılmalıdır.

#📝 Ödevler

• [ ] Yeni bir Dart projesi oluştur (dart create), pubspec.yaml dosyasını incele, her alanın ne işe yaradığını yorum olarak not et.
• [ ] dart pub add ile pub.dev'den bir paket ekle (örn. http veya intl), pubspec.yaml'ın nasıl güncellendiğini gözlemle.
• [ ] pubspec.lock dosyasını aç, pubspec.yaml'daki esnek sürüm belirteçlerinin burada nasıl "kilitlendiğini" incele.
• [ ] pub.dev'e git, bir paket ara, Popularity/Pub Points/son güncelleme tarihi gibi kriterlere bakarak "bu paketi kullanır mıydım" diye değerlendir.
• [ ] --dev bayrağıyla bir geliştirme bağımlılığı ekle (örn. test), dependencies ile dev_dependencies arasındaki farkı pubspec.yaml'da gözlemle.

Sıradaki konu: Bölüm 12 — Konu 54: Kütüphane Oluşturma, import/export, part/part of