İçeriğe geç
English
View raw .md

fluttersdk_wind artık wind_kit: FlutterSDK paketlerinin yeni adları ve geçiş rehberi

published
reading
5 dk
lang
tr en
format
markdown

FlutterSDK paketleri artık benim adımla yayında: fluttersdk_wind wind_kit, fluttersdk_dusk tapir, fluttersdk_telescope crumbs, fluttersdk_artisan da dowel oldu; hepsi pub.dev'de 1.x. Eski adlar discontinued. Bağımlılığı ve importu değiştirin; Wind uygulamasında Material importu da material_ui'a geçiyor.

Eski dört fluttersdk paket adını yeni adlarıyla listeleyen koyu bir tarayıcı penceresi; mavi bir çizgiyle açık bir taşınma kutusuna bağlı
On this page

Bugün FlutterSDK paketlerimin nereye taşındığını ve uygulamanızı nasıl geçireceğinizi anlatacağım. Hâlâ bu paketlerden birini kullanan bir projede flutter pub get çalıştırdıysanız şu satırı büyük ihtimalle görmüşsünüzdür:

text
fluttersdk_wind 1.11.2 (discontinued replaced by wind_kit)

Hikâyenin özeti bu satırda. Her paket kodunu korudu, yeni bir ad aldı ve benim adımın altına taşındı: GitHub depoları github.com/anilcancakir altında, paketler pub.dev'de anilcancakir.com yayıncısında, dokümanlar da bu sitede. Eski adlar artık yeni sürüm almıyor.

Bu yazıda şunları bulacaksınız:

  • her paketin yeni adı
  • adların neden değiştiği ve neden yeni bir marka değil de benim adımı taşıdıkları
  • gerçek bir Wind uygulamasının Flutter 3.50 üzerinde geçişi
  • taşınmanın bedeli, açık açık

Hadi başlayalım.

Kısaca#

Eski Yeni Son sürüm
fluttersdk_wind wind_kit 1.12.2
fluttersdk_wind_diagnostics_contracts wind_kit_diagnostics_contracts 1.3.0
fluttersdk_dusk tapir 1.1.0
fluttersdk_telescope crumbs 1.1.1
fluttersdk_artisan ve magic_cli dowel 1.1.0
magic ve eklentileri magic, adlar aynı 1.1.0 (çekirdek)
fluttersdk/magic-starter-laravel (Packagist) anilcancakir/magic-starter-laravel 1.0.3

pub.dev'de eski paketlerin hepsi "discontinued" olarak işaretli ve yeni adını gösteriyor. Yani yukarıdaki pub get uyarısı size zaten yolu tarif ediyor.

Adlar neden değişti?#

Flutter, Google'ın tescilli markası. Google benden markamın, paketlerimin ve profillerimin adından FLUTTER'ı çıkarmamı istedi, ben de kabul ettim. Bence haklı bir istek: FlutterSDK diye bir marka resmi SDK gibi okunuyor, ama değil. Uyumluluğu anlatmak ise serbest; bir paket hâlâ "Flutter için" olduğunu söyleyebilir. Buradaki sayfalar da artık paketleri böyle anlatıyor.

Kısacası adlar gitti, kod kaldı. Ad değişikliği tek başına hiçbir davranışı değiştirmedi; çevresindeki sürümler birkaç şeyi daha değiştirdi, aşağıdaki geçiş adımları bunları da kapsıyor.

Neden yeni bir marka değil de kendi adım?#

Yeni bir şemsiye marka seçebilirdim. Ben tersini yaptım: site, yayıncı ve depolar benim adımı taşıyor. En bilinen iki Flutter paketi de böyle: felangel/bloc da rrousselGit/riverpod da kişisel GitHub hesaplarında duruyor. Marka; anlatılacak, yeniden adlandırılacak, korunacak bir şey daha demek. Benim adım zaten kodun üstünde.

İşin pratik bir tarafı da var. pub.dev'de paket adı kalıcıdır, yayıncı ise sonradan taşınabilir. Bu yüzden kalıcı kararları paket adlarına koydum, taşınabilir olanı kişisel bıraktım. Adlar dört kurala uyuyor:

  • Google markası yok: flutter, dart, firebase geçmiyor.
  • Laravel ürün adı yok. Dusk, Telescope ve Artisan, Laravel'in ürün adlarıydı; onlar da gitti.
  • İngilizce, kısa ve işini söyleyen.
  • Marka öneki yok, böylece ad bir markaya bağlı kalmıyor.

Ortaya tapir (ajanınız uygulamanızda dokuna dokuna ilerliyor), crumbs (ajanınızın okuduğu log, istek ve hata izi) ve dowel (her eklentinin altındaki, CLI'ı bir arada tutan küçük ahşap pim, yani kavela) çıktı. wind_kit ise Wind adını korudu, çünkü pub.dev'de çıplak wind adı alınmış.

Bir Wind uygulamasını taşıyalım#

En çok kullanılan paket Wind, o yüzden ilk ona bakalım. fluttersdk_wind 1.11.2 ile küçük bir uygulama yaptım ve wind_kit'e taşıdım. Üç şey değişiyor: paket, import ve Material importu.

Paketi değiştirin:

bash
flutter pub remove fluttersdk_wind
flutter pub add wind_kit material_ui

Koddaki importu değiştirin:

bash
grep -rl 'package:fluttersdk_wind/' lib test | xargs sed -i.bak 's#package:fluttersdk_wind/fluttersdk_wind.dart#package:wind_kit/wind_kit.dart#'
find lib test -name '*.bak' -delete

wind_kit, package:flutter/material.dart'ın yerini alan material_ui paketinin üzerine kurulu (Flutter 3.50 eski barrel'ı deprecated yaptı). MaterialApp, ThemeData ve Colors sizin tarafta da Wind'inkiyle aynı yerden gelmeli; yoksa çalışırken "No MaterialLocalizations found" hatasını alırsınız. Importları sizin yerinize tek bir komut taşıyor:

bash
dart fix --apply --code=migrate_design_widgets

Benim uygulamam için bu kadar. main.dart artık şöyle başlıyor:

dart
import 'package:material_ui/material_ui.dart';
import 'package:wind_kit/wind_kit.dart';

Hiçbir W* ya da Wind* sınıfı değişmedi, her className eskisi gibi çalışıyor. dart analyze No issues found! diyor, flutter pub deps de tek bir fluttersdk paketi listelemiyor. Hadi bir deneyelim:

Koyu dört satır: her birinin solunda üstü çizili eski fluttersdk paket adı, sağında mavi renkte yeni adı
Taşımadan sonra test uygulaması, wind_kit 1.12.2 ile

wind_kit Dart 3.13 ve Flutter 3.47 istiyor. Daha eski bir SDK'daki uygulama şimdilik fluttersdk_wind 1.11.x'te kalır. Geri kalanı, flutter_localizations delegate'leri dahil, yükseltme rehberinde anlattım.

tapir, crumbs ve dowel#

Bu üçünde paket adından fazlası değişiyor, çünkü eski adlar her yerdeydi: sınıflarda, CLI komutlarında, MCP araçlarında, ortam değişkenlerinde. Kalıp üçünde de aynı:

  • Dusk* sınıfları Tapir*, dusk:* komutları tapir:*, dusk_* MCP araçları tapir_* oldu.
  • Telescope* sınıfları Crumbs*, telescope:* komutları crumbs:*, TELESCOPE_DISABLE de CRUMBS_DISABLE oldu.
  • Artisan* sınıfları Dowel*, bin/fsa bin/dowel, .artisan/ .dowel/ oldu; .mcp.json içindeki fluttersdk sunucusunun adı da artık dowel.

Hiçbiri kendiliğinden taşınmıyor, o yüzden rehberleri sırayla izleyin: önce dowel, sonra tapir. crumbs'taki değişiklikler changelog'unda listeli. Taşımadan sonra MCP istemcinizi yeniden bağlayın; izin listesinde ya da bir prompt'ta kayıtlı dusk_* araç adlarını da değiştirin.

Magic uygulamaları#

Magic adını korudu, yani paket satırınız değişmiyor. Ama Magic 1.0 yeni adlı paketlere geçti: wind_kit ve dowel'a bağımlı, CLI komutu da onunla birlikte değişti:

bash
# Önce
dart run magic:artisan make:controller Todo

# Sonra
dart run magic:dowel make:controller Todo

Backend'inizde Laravel starter'ı kullanıyorsanız Composer paketi artık anilcancakir/magic-starter-laravel, PHP namespace'i de AnilcanCakir\MagicStarter\. Magic 0.0.x'ten 1.x'e geçişte ad değişikliğinden başka kırıcı değişiklikler de var; sürümü yükseltmeden önce changelog'u okuyun.

Başka neler taşındı?#

  • Depolar. Hepsi yıldızları, issue'ları ve geçmişiyle birlikte github.com/anilcancakir altına taşındı. GitHub eski URL'leri şimdilik yönlendiriyor, ama linklerinizi güncelleyin: eski organizasyon kapandığında yönlendirmeler de biter.
  • Dokümanlar. Her paketin sayfası ve dokümanı bu sitede, anilcancakir.com/<paket> adresinde. Eski fluttersdk.com linkleri şimdilik buraya yönleniyor.
  • AI skill'leri. npx skills add anilcancakir/ai komutu Claude Code, Cursor ve diğerleri için skill'leri kuruyor.
  • MCP. tapir, crumbs ve dowel MCP registry'de io.github.anilcancakir/<ad> olarak duruyor; doküman MCP sunucusu da https://mcp.anilcancakir.com.

Bedeli ne?#

Ad değiştirmek bedava değil, bunu açıkça söylemek isterim.

Sayılar sıfırdan başlıyor. Bu yazıyı yazdığım gün fluttersdk_wind'in 32 beğenisi ve son 30 günde 81.959 indirmesi var; wind_kit'in ise 2 beğenisi ve 326 indirmesi. O 82 bin kurulum artık yeni özellik almayan bir paketi çalıştırıyor. İçlerinden biri sizinse, yukarıdaki geçiş birkaç dakikanızı alır.

Eski linkler bugün değil, sonra kırılacak. Eski depoları ve eski siteyi bugün yönlendirmeler kapsıyor, ama sonsuza kadar değil. fluttersdk'ya işaret eden bir README, bir blog yazısı ya da bir yer imi bir gün çalışmayı bırakacak.

Bir de SDK tabanı yükseldi. wind_kit Flutter 3.47 istiyor; eski bir uygulama ya önce Flutter'ı yükseltecek ya da geride kalacak.

Deneyin#

bash
flutter pub add wind_kit material_ui

Paketler anilcancakir.com üzerinde: Wind, Magic, tapir, crumbs ve dowel. Kod aynı, adlar yeni.

Bu kadar. İyi günler.