Ana içeriğe atla

DotNet ile Serene Kurulumu

 

Serene'i şununla yükleme:dotnet new

Bu bölüm Visual Studio'yu (Linux / OSX'te) kullanmayan veya kullanamayan kullanıcılar içindir.

Serene (ve StartSharp) Asp.Net Core sürümü, Windows'un yanı sıra Linux ve Mac OSX'i de destekler.

Tüm platformlar için Visual Studio Code'u öneriyoruz ancak Notepad/VIM gibi temel bir metin düzenleyiciyle çalışmak da mümkün. Atom gibi başka güzel seçenekler de var.

.NET SDK'yı yükleyin

Lütfen aşağıdaki adrese gidin ve özel platformunuza yönelik talimatları izleyin:

https://dotnet.microsoft.com/en-us/download

Serenity genellikle .NET SDK'nın en son kararlı sürümüne bağlıdır (yazılı itibariyle 6.0), .NET SDK ile ilgili proje oluşturma sırasında bir hata alırsanız lütfen hata mesajını kontrol edin ve bu belgede olabileceği gibi .NET SDK'nın uygun sürümünü yükleyin. henüz güncellendi.

NodeJS'yi yükleyin

TypeScriptNodeJS'de çalıştırıldığı gibi esbuildNode/NPM'yi şu adresten yüklemeniz gerekir:

https://nodejs.org/en/download/

veya favori paket yöneticinizi kullanarak:

https://nodejs.org/en/download/package-manager/

Şablon Paketini Yükleyin

Not: Serene 6.4.4 itibarıyla eski serinaraç geçerliliğini yitirmiştir ve artık şablon oluşturmayı kullandığımız için yeni Serene projeleri oluşturmak için düzgün çalışmayabilir dotnet new.

Serene.Templatesşablonumuzu içeren bir NuGet paketidir Serenedotnet newKomut satırı aracılığıyla yükleyin :

dotnet new install Serene.Templates

.NET 7 SDK'nız yoksa dotnet new --install Serene.Templatesbunun yerine yazmanız gerekebilir.

Premium müşteriyseniz ve StartSharpbunun yerine bir proje oluşturmak istiyorsanız premium paket kaynağının yapılandırıldığından ve çalıştırıldığından emin olun:

dotnet new install Serenity.Pro.Templates

Yukarıdaki komut Serene.Templates'in (veya Serenity.Pro.Templates) en son sürümünü yüklemeli veya zaten yüklüyse en son sürüme güncellemelidir.

Daha eski bir sürümü yüklemek istiyorsanız bunu şu şekilde belirtin:dotnet new install Serene.Templates:6.4.4

dotnet newDaha fazla bilgi için belgelere bakın :

https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-new

Şablonu Kullanarak Yeni Bir Proje Oluşturma

Örneğin boş bir klasör oluşturun MyProjectve bu klasöre cd yazın:

~/> mkdir MyProject
~/> cd MyProject

Geçerli klasör adı türünün adıyla yeni bir proje oluşturmak için:

~/MyProject> dotnet new serene

Farklı bir ad aktarma bağımsız değişkeni belirtmek istiyorsanız -n:

~/MyProject> dotnet new serene -n MyAnotherProject

Bu durumda projenin adlı bir alt dizinde oluşturulacağını unutmayın MyAnotherProjectcdOluşturduktan sonra bu klasöre girmelisiniz .

dotnet new startsharpStartSharp tabanlı bir proje oluşturmak için kullanın

Dizini klasöre değiştirin MyProject.Web, paketleri kurmak için çalıştırın ve npm installardından projeyi denemek için çalıştırın:dotnet builddotnet run

~/MyProject/MyProject.Web> npm i
~/MyProject/MyProject.Web> dotnet build
~/MyProject/MyProject.Web> dotnet run

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5000

Dotnet new'un bir çözüm dosyası oluşturmayacağını unutmayın. Bu projeyi Visual Studio'da açarsanız, çözümü adlandırmanızı MyProjectve çözüm dosyasını kök klasöre olarak kaydetmenizi MyProject/MyProject.slnöneririz MyProject.Web/MyProject.Web.sln.

Şimdi bir tarayıcı açın ve adresine gidin http://localhost:5000.

Gerçek bağlantı noktası değişebilir. dotnet run komutunu çalıştırdıktan sonra bunu konsolda göreceksiniz .

Proje Oluşturma Sırasında Modülleri / Özellikleri Hariç Tutma

dotnet newHangi modüllerin etkinleştirileceğini/devre dışı bırakılacağını belirlemenizi sağlayan bağımsız değişkenler için komut verir sereneve bunları destekler.startsharp

Bağımsız değişkenleri ve olası değerlerini görmek için dotnet new serene --helpveya yazın .dotnet new startsharp --help

Örneğin , vb. demo modüllerini hariç tutmak için Northwindşunu Basic Samplesyazabilirsiniz:

~/MyProject> dotnet new serene -E

Demo modüllerini hariç tutmak ve StartSharp'taki tüm pro modüllerini yalnızca dahil etmek DataAuditLogve bunların yerine dahil etmek için:OpenIddict

~/MyProject> dotnet new startsharp -E -P DataAuditLog -P OpenIddict

Bu blogdaki popüler yayınlar

Code generetor ile oluşturulan dosyaların açıklamaları

  1. Sunum (Presentation/UI) Katmanı (Kullanıcı arayüzü - HTML, TypeScript, Dialog, Grid) 🔹 XYZPage.ts 📌 Ne İşe Yarar? Kullanıcı arayüzünün TypeScript tarafındaki tanımıdır. Serenity'nin Dialog ve Grid bileşenlerini içeren bir TypeScript sınıfıdır. 📌 Çok Katmanlı Mimarideki Yeri: Sunum Katmanı (Presentation Layer) Kullanıcıdan veri almak ve göstermek için kullanılır. 🔹 XYZGrid.ts 📌 Ne İşe Yarar? Tablo (Grid) yapısını oluşturur ve verileri listeler. Filtreleme, sıralama ve sayfalama işlemleri için kullanılır. columnsKey ile hangi kolonların gösterileceğini belirler. 📌 Çok Katmanlı Mimarideki Yeri: Sunum Katmanı (Presentation Layer) Kullanıcının verileri listelediği ve etkileşimde bulunduğu yerdir. 🔹 XYZDialog.ts 📌 Ne İşe Yarar? CRUD (Create, Read, Update, Delete) işlemlerini yöneten pencere (modal) bileşeni Kullanıcı form aracılığıyla veri ekler, günceller veya siler. XYZForm.cs ile birlikte çalışır. 📌 Çok Katmanlı Mimarideki Yeri: Sunum Katmanı (Presentation Layer) Kull...

Serenity Web Nedir?

   Serenity  , açık kaynak teknolojileri üzerine kurulu bir ASP.NET Core/TypeScript uygulama platformudur. Standart kodlardan kaçınarak, tekrarlanan görevlere harcanan zamanı azaltarak ve en iyi yazılım tasarımı uygulamalarını uygulayarak bakım maliyetlerini düşürürken geliştirmeyi kolaylaştırmayı amaçlamaktadır. Serene  , Serenity platformunu temel alan ücretsiz, açık kaynaklı başlangıç ​​uygulama şablonumuzdur.  Bu dokümantasyon aracılığıyla eğitimimiz ve diğer örnekler için esas olarak Serene'yi kullanacağız. StartSharp  , ücretli müşterilerimize sunduğumuz premium uygulama şablonudur.  Daha gösterişli bir temaya ve bazı ekstra özelliklere  ek olarak Serene'deki her şeyi içerir  .  İkisi de Serenity platformunu temel alıyor. Adında Ne Var Serenity'nin sözlük anlamları  barış  ,  rahatlık  ve  sakinliktir  . Serenity ile bunu başarmaya çalışıyoruz.  Umarız yükledikten ve kullandıktan sonra siz de bu ş...