SharePoint Framework (SPFx) Solution Sürüm Yükseltme

SPFx solution doğru bir şekilde güncellemek istediğinizde, config klasöründe yer alan ‘package-solution.json ‘u yükseltmeniz yeterli olmayacaktır. Ek olarak ‘package.json’ dosyasını da ilgili sürüm numarasıyla da yükseltmek faydali olacaktır.

Şimdi buradaki versiyon numaraları ne ifade ediyor ve güncellemelerinizi yaparken nelere dikkat etmeliyiz, göz atalım.

Kod Statüsü	Aşama	Kural	Örnek Versiyon
İlk sürüm	Yeni proje	İlk olarak 1.0.0	1.0.0
Geriye dönük hata düzeltmeleri	Düzeltme eki (Patch Relase)	3. versiyon numarasını arttırınız	1.0.1
Geriye dönük yeni özellikler eklenmesi durumunda	Küçük sürüm (Minor release)	2. versiyon numarasını arttırıp, sağ tarafta yer alan diğer sürüm numarasını sıfırlayın	1.1.0
Geriye dönük uyumluluğu bozan değişiklikler	Büyük sürüm (Major version)	İlk haneyi arttırıp, diğerlerini sıfırlayın	2.0.0

SPFx projeniz içerisinde yer alan paketleri belli aralıklarla güncellemeniz önerilmektedir. (Bug&Fix ya da yeni güncellemeri projeniz içerisinde de kullanmak isteyebilirsiniz.)

Güncel olmayan paketleri kontrol etme

Güncel olmayan paketleri kontrol etmek için aşağıdaki komutu çalıştırınız.

npm outdated

Yukarıda @microsoft-sp ile ilgili sürümler görüntüleniyor olacaktır.

Paket güncelleme

Belirli bir komutun en güncel sürümüne yükseltmek için aşağıdaki komutu çalıştırın.

npm install @microsoft/sp-application-base@latest --save

Yukarıdaki “@microsoft/sp-application-base” paket adını güncellemekteyiz. İhtiyacınıza göre paket adını güncelleyip, versiyonunuzu yükseltebilirsiniz.

Tüm güncellemelerinizi yaptıktan sonra derlemeden aşağıdaki komut ile paketinizi temizleyin.

gulp clean

Paketleri oluşturmak için aşağıdaki komutu çalıştırın.

gulp build

Paket güncellemesi yaparken diğer paketler, TypeScript versiyonları önemlidir. Sürümler çakışabilir ve çalışmayabilir. Bu duruma dikkat edin.

Yeoman Generator versiyon güncelleme

SharePoint Framework Yeoman Generator global olarak kurduysanız, aşağıdaki komutu çalıştırarak güncellenmeye ihtiyacı olup olmadığını öğrenebilirsiniz:

npm outdated -g

Gördüğünüz gibi “@microsoft/generator-sharepoint” paketi “1.6.0” sürümde ve “1.8.0” son sürüm. Aşağıdaki komutu çalıştırarak son süreme yükseltebilirsiniz.

npm install @microsoft/generator-sharepoint@latest -g

Okuduğunuz için teşekkür ederim 🙂