SPFx 1.23 GA: Yeoman’a Veda, CLI Devri Başlıyor
Bir sabah Slack’te mesaj düştü: “Aşkın abi, müşteri SPFx 1.23’e geçmek istiyor, Yeoman’la mı kuralım yoksa yeni CLI’yi mi deneyelim?” Bir an durup baktım. Çünkü bu sürüm, kağıt üstünde sıradan bir minör release gibi dursa da, SPFx tarafında epeydir beklenen birkaç değişikliğin ilk net işareti gibi geliyor.
Bak şimdi, SharePoint Framework 1.23 geçtiğimiz hafta GA öldü. Ben de hafta sonu test ortamında kurcaladım, iki eski projeyi upgrade ettim, birinde işler akıcı gitti birinde ufak tefek takılmalar çıktı; izlenimlerimi, gözüme batan yerleri ve özellikle Türkiye’deki kurumsal müşteriler için ne ifade ettiğini burada toparlayacağım.
Önce işin özü: 1.23 ne getiriyor?
Lafı dolandırmadan gireyim. Bu sürümde benim gözüm üç başlığa takıldı:
- List view command set tarafında gruplama desteği
- Yeni SPFx CLI‘nın ilk preview sürümü (Yeoman’ı emekliye ayıracak olan)
- Proje template’lerinin open-source hâle getirilmesi
Bunların yanında küçük bug fix’ler ve paket güncellemeleri de var, tabi onlar da lazım ama “ben neden upgrade edeyim?” sorusunun asıl cevabı yukarıdaki üç madde. Bilhassa ikinci madde — yanı CLI işi — orta vadede çevrein yönünü değiştirecek gibi dürüyor, hani biraz abartılı söylemiş olayım ama çok da yanlış değil.
SPFx hâlâ neden önemli?
“Power Apps ve Power Platform varken kim SPFx yazıyor hâlâ?” diye soranlar çıkıyor, haklılar da biraz. Ama işin aslı şu: Microsoft’un kendi anlatımına göre custom SPFx çözümleri her gün on milyonlarca kullanıcıya dokunuyor; bizim Logosoft’ta yürüttüğümüz birkaç büyük bankacılık ve enerji projesinde de SPFx hâlâ omurga rolünde kaldı çünkü otomatik SSO var, tenant içinde hosting var, M365 servisleriyle native entegrasyon var (ve evet, bu üçlü bazı senaryolarda baya iş görüyor). Power Apps güzel gidiyor ama belirli bir karmaşıklık eşiğini geçince kod tarafına geri dönüyorsunuz.
SPFx, “low-code yetmediğinde geri dönülecek liman” olmaya devam ediyor. Ve bu rol bir süre daha değişmeyecek gibi dürüyor.
Command Set gruplama: Küçük detay, büyük rahatlama
Bu özelliğe ilk bakışta biraz burun kıvırdım. “List view command set’e gruplama mı? Ne gerek var?” dedim açıkçası. Sonra geçen yıl bir sigorta şirketinde yaşadığımız sahneyi hatırlayınca fikrim kaydı; çünkü orada mesele teknik değilmiş gibi görünüyordu ama kullanıcı tarafında tam bir karmaşaydı.
Hatırlıyorum, 2024’ün sonlarıydı. Müşterinin document library’sinde 11 tane custom action vardı — onay süreci başlat, PDF’e çevir, e-imza yolla, arşive taşı falan filan. Toolbar resmen kalabalık pazara dönmüştü; kullanıcılar da “abi şu butonların hangisi neydi” diye şikayet ediyordu. O zaman overflow menü’ya itmiştik ama bu sefer de UX başka yerden tökezlemişti (buna dikkat edin)
İşte 1.23 ile gelen gruplama desteği tam burada devreye giriyor. Artık command’leri mantıklı kümelere ayırabiliyorsunuz: “Onay İşlemleri”, “Dönüştürme”, “Arşiv” gibi; hem toolbar’da hem context menü’da daha okunur görünüyorlar. Insanın gözü yorulmuyor.
// CommandSetExtension manifest'inde
{
"commands": {
"EXPORT_PDF": {
"title": "PDF'e Aktar",
"iconImageUrl": "icons/pdf.png",
"group": "Dönüştürme"
},
"EXPORT_DOCX": {
"title": "Word'e Aktar",
"iconImageUrl": "icons/docx.png",
"group": "Dönüştürme"
},
"START_APPROVAL": {
"title": "Onaya Gönder",
"group": "Onay İşlemleri"
}
}
}
Dürüst olmak gerekirse, Sade görünüyor ama iş görüyor. Eğer şu an üretimde dört beşten fazla command set’ınız olan kütüphaneler varsa, sırf bu özellik yüzünden bile upgrade etmeye değer diyebilirim; hatta bazen teknik kazanımdan çok kullanım rahatlığı kazandırıyor.
Asıl bomba: SPFx CLI ve Yeoman’ın sonu
Şimdi geldik benim en çok merak ettiğim yere. Microsoft yıllardır SPFx scaffold işini Yeoman generator üzerinden yapıyordu; yo @microsoft/sharepoint komutunu bilmeyen SPFx developer neredeyse yoktur diye düşünüyorum.
Ama dürüst konuşalım: Yeoman ekosistemi son birkaç yıldır biraz… nasıl desem… yorgun kaldı. Node.js sürüm uyumsuzlukları çıkıyor, deprecated paket uyarıları yağmur gibi geliyor, npm install sırasında peer dependency cehennemi yaşanıyor; geçen sene yeni bir junior arkadaşa ortam kurdururken neredeyse iki saat harcadık ve ben açıkçası şaşırdım — itiraf edeyim, beklentimin üstündeydi —
Yeni CLI ne vaat ediyor?
1.23 ile gelen yeni SPFx CLI henüz preview’da ama ben hafta sonu denedim; ilk hissiyatım hızlı olduğu yönünde öldü, sade geldi ve en önemlisi modern hissettirdi. Yeoman’ın o eski tarz soruları yok artık — hani “Bower kullanmak ister mısınız?” tadındaki ekranlar bitti sayılır — direkt React/None seçimi yapıyorsunuz, çözüm tipini seçiyorsunuz ve devam ediyorsunuz.
Bunu biraz açayım.
Daha ilginci şu ki — pek konuşulmuyor ama bence önemli — kullanılan template’ler artık open-source tarafa açılmış durumda. Yanı kendi şirket içi template’ınızı yazıp CLI’a bağlayabiliyorsunuz (bu güzel), GitHub repo’sundan template çekebiliyorsunuz (bu daha da güzel), topluluk template’leri de yavaş yavaş ortaya çıkacak gibi dürüyor; PnP zaten bunu uzun zamandır bekliyordu diyebilirim.
Bunun Türkiye’deki büyük kurumlarda karşılığı net aslında: standartlaşma. Bir bankada yıllardır görmek istediğim şey tam buydu — her ekibin kafasına göre ayrı klasör yapısı açması yerine merkezî bir template havuzu olması gerekiyordu; farklı linter ayarlarıyla uğraşmak yerine ortak başlangıç noktası olsun istiyorduk ve şimdi bu kapı aralanıyor.
Bunu biraz açayım.
Türkiye’deki kurumsal görüntü: Upgrade etmeli mıyız?
Peki sahada durum ne? Şimdi teoriyi bırakıp gerçek hayata bakalım. Müşteriye gidip sadece teknik heyecanla konuşunca işler bazen tersine dönüyor.
Bende oluşan tablo şu: Türkiye’deki büyük kurumların önemli kısmı hâlâ SPFx 1.18 ile 1.20 arasında somewhere takılı kalmış durumda yaşıyor diyebilirim. Sebep genelde aynı döngüye çıkıyor — Node.js sürüm geçişleri sıkıntı çıkarıyor, üçüncü parti React kütüphaneleri uyumlu olmuyor ve klasik “çalışıyorsa dokunma” refleksi devreye giriyor.
Eğer biri bana doğrudan “Kalkıp hemen 1.23’e sıçrayalım mı?” diye sorarsa cevabım net olur: Eğer 1.20’nın altındaysanız acele etmeyin derim; önce ara bir sürüme (mesela 1.21 veya 1.22) geçip orayı stabilize edin (evet biraz sıkıcı), sonra 1.23’e gelin çünkü Node 18’den 22’ye geçişi TypeScript versiyonu ve build pipeline değişiklikleriyle aynı anda üst üste koyarsanız baş ağrısı kaçınılmaz oluyor.
Kısa bir not düşeyim buraya.
Hangi senaryoda hemen geçmeli?
| Durumunuz | Tavsiyem |
|---|---|
| Yeni başlıyorsanız (greenfield proje) | Direkt 1.23 kullanın, CLI preview’ı dahi deneyin |
| Çok sayıda command set’ınız var | Upgrade edin, gruplama özelliği değer katıyor |
| 1.20+ üzerindesiniz, stabil gidiyor |
| Sıkça Sorulan SorularSPFx 1.23 için hangi Node.js sürümü lazım?1.23, Node.js 18 ve 22 LTS’i destekliyor. Node 20’de de çalışıyor aslında, ama resmî olarak desteklenen sürümler yine de 18 ve 22. Hâlâ Node 16’daysanız — bence önce oradan başlayın, çünkü o tarafı halletmeden doğrudan upgrade yapmaya kalkmak işe yaramıyor.Yeoman generator hâlâ çalışıyor mu, hemen CLI’ya geçmeli mıyım?Yeoman şu an için gayet iyi çalışıyor ve resmî destek de sürüyor. CLI henüz preview aşamasında, yanı production ortamlarında Yeoman’a devam edebilirsiniz. Açıkçası Microsoft, CLI stabil hâle gelene kadar Yeoman’ı hemen emekliye göndermeyecek — geçiş süreci birkaç sürüme yayılacak gibi görünüyor.Command set gruplama özelliği eski tenant’larda da çalışır mı?Evet, çalışıyor. SharePoint Online’ın güncel sürümlerinde otomatik devreye giriyor. Ama şunu unutmayın: bu özelliği sadece SPFx 1.23 ile build edilmiş çözümler kullanabiliyor. Eski sürümlerle derlenmiş bir şey varsa, yeniden build almadan grup desteği ekleyemiyorsunuz.Open-source template’leri nasıl kullanırım?SPFx CLI preview’ı kurduktan sonra–templateparametresiyle bir GitHub repo URL’i ya da lokal path vermeniz yeterli. Microsoft’un resmî template’leri. GitHub’da yayında, hani fork’layıp düzenleyerek kurumunuza özel bir template de çıkarabilirsiniz. Detaylar için dokümantasyona bakın, mesela adım adım anlatılmış.1.20’den 1.23’e direkt atlamak güvenli mi?Çoğu projede sorun çıkmıyor. Ama dependency’leriniz karmaşıksa — mesela eski Fluent UI sürümleri veya eski PnP kütüphaneleri kullanıyorsanız — tecrübeme göre ara sürümleri atlamamak daha mantıklı. Önce test ortamında dene; sorun çıkarsa 1.21 ya da 1.22’ye git, oradan 1.23’e geç. Üretime tek seferde atlamak gereksiz risk.Kaynaklar ve İleri OkumaMicrosoft 365 Dev Blog: SPFx 1.23 GA DuyurusuSharePoint Framework 1.23 Release Notes (Microsoft Learn)Grouping in ListView Command Set Extensions DokümantasyonuSPFx Feedback Form – Spring 2026 |
|---|
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
2 comments