SharePoint Framework (SPFx) Deployment SharePoint Library

“.sppkg” paketi içerisini kontrol ettiğinizde içerisinde CSS, JavaScript ve diğer assets yer aldığını görüyor olacaksınız. Bu dosyalar genellikle CDN üzerinden dağıtım yapılmaktadır. (Azure CDN ya da Office 365 CDN gibi, bu yöntem ile farklı CDN ortamı içerisinden de veri alabilirsiniz.) Fakat SharePoint ‘e deploy yapmak için CDN kullanmak gibi bir zorunluluk yoktur. Şimdi CDN kullanmadan deploy yapabilmek için neler yapmalıyız bir göz atalım 🙂

CDN yerine kullanacağımız doküman kütüphanesi oluşturma

• Dosyaları yüklemek istediğiniz site açınız.
• Sağ top nav bar içerisinde yer alan “Add an app” butonuna tıklayınız.

• “Document Library” seçiniz.
• Permission üzerinde yetkileri düzenleyiniz. (Everyone yetki verebilirsiniz.)

SharePoint library için solution package ayarları

“config” folder içerisinde yer alan “package-solution.json” dosyasını açınız. “includeClientSideAssets” property “false” olarak güncelleyiniz. Bu durumda asset ‘leri paket içerisine dahil etmeyecektir. Çünkü biz SharePoint library içerisinden çekmesini istiyoruz. 🙂

CDN Path güncelleme

“config” folder içerisinde yer alan “write-manifest.json” dosyasını açınız. “cdnBasePath” içerisine oluşturmuş olduğunuz doküman kütüphanesinin url ile güncelleyiniz.

SharePoint Framework Deploy Süreci

• Aşağıdaki komutu çalıştırınız. “gulp bundle –ship” solution bundle etmenizi etmenizi sağlamaktadır.

gulp bundle --ship

• “temp/deploy” folder içerisine bundle edilmiş dosyaları oluşturmuş olduğunuz kütüphaneye upload ediniz.

• Solution paket haline getirmek için aşağıdaki komutu çalıştırınız. Komut işlemini tamamladıktan sonra config için belirtmiş olduğunuz path içerisine oluşturmaktadır. (solution klasörü)

gulp package-solution --ship

Paket içerisindeki görüntülemek isterseniz “solution/debug” klasörüne gidip, görüntüleyebilirsiniz.

• Paketleme işlemimiz bu kadar, şimdi ilgili “.sppkg” dosyasını SharePoint App Katalog içerisine yükleyiniz.

• Eğer daha önceden aynı isimde bir app mevcut ise size değiştirip değiştirilmeyeceğini soracaktır. “Replace it” butonuna tıklayıp uygulamayı upload ediniz.

• Başarı ile upload ettikten sonra “Deploy” deyiniz. (domain olarak doküman kütüphanesi url olduğuna dikkat ediniz.)

Tüm deploy işlemlerimiz bu kadar 🙂

SharePoint Framework Uygulama Yükleme

• Developer site ya da uygulamanızı kullanmak istediğiniz site collection ‘a gidiniz.
• Sağ üst nav bar üzerinde “Add an app” butonuna tıklayınız.

• Search box üzerinde kendi uygulamanızı aratıp, yükleyiniz.

• Uygulamanızı yükledikten sonra WebPart mevcut ise görüntülemek istediğiniz sayfayı açınız ve WebPart ekleyiniz.

• Local üzerinde node.js çalışmasa bile uygulamanız görüntülenmeye devam edecektir.

• F12 tuşuna basıp kontrol ettiğinizde doküman kütüphanesi üzerinden yüklendiğini göreceksiniz.

Tüm işlemimiz bu kadar, okuduğunuz için teşekkür ederim 🙂