Öğretici: Visual Studio'da Django web çerçevesini kullanmaya başlama

Django hızlı, güvenli ve ölçeklenebilir web geliştirme için tasarlanmış üst düzey bir Python çerçevesidir. Bu öğreticide proje şablonları bağlamında Django çerçevesi incelenmektedir. Visual Studio, Django tabanlı web uygulamalarının oluşturulmasını kolaylaştırmak için proje şablonları sağlar.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

• "Boş Django Web Projesi" şablonunu (1. adım) kullanarak Git deposunda temel bir Django projesi oluşturun.
• Tek sayfalı bir Django uygulaması oluşturun ve bu sayfayı şablon kullanarak işleyin (2. adım).
• Statik dosyalar sunma, sayfa ekleme ve şablon devralmayı kullanma (3. adım).
• Birden çok sayfaya ve duyarlı tasarıma sahip bir uygulama oluşturmak için Django Web Projesi şablonunu kullanın (4. adım).
• Kullanıcıların kimliğini doğrulama (5. adım).

Önkoşullar

• Aşağıdaki seçeneklerle Windows üzerinde Visual Studio 2022:
  • Python geliştirme iş yükü (yükleyicide iş yükü sekmesi). Daha fazla yönerge için bkz . Visual Studio'da Python desteğini yükleme.
  • Kod araçları'nın altındaki Tek tek bileşenler sekmesinde Windows için Git.

Django proje şablonları, Visual Studio için Python Araçları önceki sürümlerini de içerir. Şablon ayrıntıları, bu öğreticide açıklananlardan farklı olabilir (özellikle Django çerçevesinin önceki sürümlerinde farklıdır).

Python geliştirmesi şu anda Mac için Visual Studio'da desteklenmemektedir. Mac ve Linux'ta Visual Studio Code'da Python uzantısını kullanın.

"Visual Studio projeleri" ve "Django projeleri"

Django terminolojisinde bir "Django projesi" bir veya daha fazla "uygulama" ile birlikte çeşitli site düzeyinde yapılandırma dosyalarına sahiptir. Tam bir web uygulaması oluşturmak için bu uygulamaları bir web konağına dağıtabilirsiniz. Bir Django projesi birden çok uygulama içerebilir ve aynı uygulama birden çok Django projesinde olabilir.

Visual Studio projesi, Django projesini ve birden çok uygulamayı içerebilir. Bu öğretici yalnızca bir "projeye" başvurduğunda Visual Studio projesine başvurur. Web uygulamasının "Django projesi" bölümünü ifade ettiğinde, özellikle bir "Django projesi" anlamına gelir.

Bu öğretici boyunca üç ayrı Django projesi içeren tek bir Visual Studio çözümü oluşturacaksınız. Her proje tek bir Django uygulaması içerir. Projeleri aynı çözümde tutarak farklı dosyalar arasında kolayca geçiş yapabilirsiniz.

1-1. Adım: Visual Studio projesi ve çözümü oluşturma

Komut satırından Django ile çalışırken, genellikle komutunu çalıştırarak django-admin startproject <project_name> bir proje başlatırsınız. Visual Studio'da ,"Boş Django Web Projesi" şablonu bir Visual Studio projesi ve çözümünde aynı yapıyı sağlar.

1. Visual Studio'da Dosya>Yeni>Proje'yi seçin, "Django" araması yapın ve Boş Django Web Projesi şablonunu ve ardından İleri'yi seçin.

   

2. Aşağıdaki bilgileri girin ve Oluştur'u seçin:

   • Proje Adı: Visual Studio projesinin adını BasicProject olarak ayarlayın. Bu ad Django projesi için de kullanılır.
   • Konum: Visual Studio çözümünün ve projesinin oluşturulacağı konumu belirtin.
   • Çözüm: Bu denetimi varsayılan Yeni çözüm oluştur seçeneği olarak bırakın.
   • Çözüm adı: Bu öğreticide birden çok proje için kapsayıcı olarak çözüme uygun olan LearningDjango olarak ayarlayın.

1-2. Adım: Git denetimlerini inceleme ve uzak bir depoda yayımlama

Bu adımda, Visual Studio'nun Git denetimleri ve Ekip Gezgini hakkında bilgi edineceksiniz. Ekip Gezgini penceresiyle kaynak denetimiyle çalışacaksınız.

1. Projeyi yerel kaynak denetiminize işlemek için:

   1. Visual Studio ana penceresinin alt köşesindeki Kaynak Denetimine Ekle komutunu seçin.
   2. Ardından Git seçeneğini belirleyin.
   3. Şimdi, yeni bir depo oluşturup gönderebileceğiniz Git deposu oluştur penceresine yönlendirilirsiniz.

   

2. Depo oluşturduktan sonra, alt kısımda bir dizi yeni Git denetimi görüntülenir. Soldan sağa doğru bu denetimler pusuya düşürülmemiş işlemeleri, kaydedilmemiş değişiklikleri, geçerli dalı ve deponun adını gösterir.

   

3. Git değişiklikleri düğmesini seçin. Ardından Visual Studio, Takım Gezgini'nde Git Değişiklikleri sayfasını açar. Yeni oluşturulan proje zaten kaynak denetimine otomatik olarak işlendiğinden bekleyen hiçbir değişiklik görmezsiniz.

   

4. Visual Studio durum çubuğunda, Ekip Gezgini'nde Eşitleme sayfasını açmak için pusuya düşürülmemiş işlemeler düğmesini (2 ile yukarı ok) seçin. Eşitleme sayfası, yerel depoyu farklı uzak depolara yayımlamak için kolay seçenekler sağlar.

   

   Projeleriniz için istediğiniz hizmeti seçebilirsiniz. Bu öğreticide, öğretici için tamamlanmış örnek kodun Microsoft/python-sample-vs-learning-django deposunda tutulduğu GitHub kullanımı gösterilmektedir.

5. Yayımla denetimlerinden herhangi birini seçerken, Takım Gezgini daha fazla bilgi ister. Örneğin, bu öğretici için örneği yayımlarken önce deponun oluşturulması gerekir; bu durumda deponun URL'si ile Uzak Depoya Gönder seçeneği kullanılmıştır.

   

   Mevcut bir deponuz yoksa GitHub'da Yayımla ve Azure DevOps'a Gönder seçenekleri doğrudan Visual Studio'nun içinden bir depo oluşturmanıza olanak verir.

6. Bu öğreticide çalışırken, değişiklikleri işlemek ve göndermek için Visual Studio'daki denetimleri düzenli aralıklarla kullanma alışkanlığına geçin. Bu öğretici size uygun noktaları anımsatır.

İpucu

Ekip Gezgini'nde hızla gezinmek için, kullanılabilir sayfaların açılır menüsünü görmek için üst bilgiyi (yukarıdaki resimlerde Değişiklikler veya Gönder'i okuyan) seçin.

Soru: Projenin başından itibaren kaynak denetimini kullanmanın bazı avantajları nelerdir?

Yanıt: Özellikle uzak bir depo da kullanıyorsanız başlangıçtan itibaren kaynak denetimi, projenizin düzenli bir site dışı yedeklemesini sağlar. Yerel dosya sisteminde bir projenin bakımının aksine, kaynak denetimi tam bir değişiklik geçmişi ve tek bir dosyayı veya projenin tamamını önceki durumuna geri döndürme olanağı sağlar. Değişiklik geçmişi, regresyonların (test hataları) nedenini belirlemeye yardımcı olur. Bir proje üzerinde birden çok kişi çalışırken, kaynak denetimi üzerine yazmayı yönetir ve çakışma çözümü sağlar.

Son olarak, temel olarak bir otomasyon biçimi olan kaynak denetimi, derlemeleri otomatikleştirmek, test etmek ve sürüm yönetimi için sizi ayarlar. Proje için DevOps kullanmanın ilk adımıdır. Giriş engelleri düşük olduğundan kaynak denetimini en baştan kullanmamak için gerçekten bir neden yoktur.

Otomasyon olarak kaynak denetimi hakkında daha fazla bilgi edinmek için msdn dergisinde web uygulamaları için de geçerli olan mobil uygulamalar için yazılmış bir makale olan Gerçeğin Kaynağı: DevOps'taki Depoların Rolü makalesine bakın.

Soru: Visual Studio'nın yeni bir projeyi otomatik olarak almasını engelleyebilir miyim?

Yanıt: Evet. Otomatik komutu devre dışı bırakmak için Takım Gezgini'ndeki Ayarlar sayfasına gidin. Git>Genel ayarları'nı seçin, Birleştirmeden sonra değişiklikleri varsayılan olarak işle etiketli seçeneği temizleyin ve güncelleştir'i seçin.

1-3. Adım: Sanal ortamı oluşturma ve kaynak denetiminden dışlama

Projeniz için kaynak denetimini yapılandırdığınıza göre, proje için gerekli Django paketlerini içeren sanal ortamı oluşturabilirsiniz. Ardından, ortamın klasörünü kaynak denetiminden dışlamak için Takım Gezgini'ni kullanabilirsiniz.

1. Çözüm Gezgini Python Ortamları düğümüne sağ tıklayın ve Ortam Ekle'yi seçin.

   

2. Sanal Ortam Ekle iletişim kutusunda Varsayılanları kabul etmek için Oluştur'u seçin. (İsterseniz sanal ortamın adını değiştirebilirsiniz; bu yalnızca alt klasörünün adını değiştirir, ancak env standart bir kuraldır.)

   

3. İstenirse yönetici ayrıcalıklarına onay ver, ardından Visual Studio paketleri indirip yüklerken birkaç dakika bekleyin. Bu süre boyunca, binlerce dosya birçok alt klasöre aktarılır. İlerleme durumunu Visual Studio Çıkış penceresinde görebilirsiniz. Beklerken, izleyen Soru bölümlerini düşünün.

4. Visual Studio Git denetimlerinde (durum çubuğunda), Takım Gezgini'nde Değişiklikler sayfasını açan değişiklikler göstergesini (99*'ı gösterir) seçin.

   Sanal ortamın oluşturulması binlerce değişiklik getirdi, ancak siz (veya projeyi kopyalayan başka biri) ortamı requirements.txt dosyasından her zaman yeniden oluşturabileceğinden bunların hiçbirini kaynak denetimine eklemeniz gerekmez.

5. Sanal ortamı dışlamak için env klasörüne sağ tıklayın ve Bu yerel öğeleri yoksay'ı seçin.

   

6. Sanal ortamı dışladıktan sonra kalan tek değişiklikler proje dosyasında ve .gitignore dosyasındadır. .gitignore dosyası, sanal ortam klasörü için ek bir girdi içerir. Fark görmek için dosyaya çift tıklayabilirsiniz.

7. Bir işleme iletisi girin ve Tümünü İşle düğmesini seçin, ardından işlemeleri uzak deponuza gönderin.

Soru: Neden sanal ortam oluşturmak istiyorum?

Yanıt: Sanal ortam, uygulamanızın tam bağımlılıklarını yalıtmak için harika bir yoldur. Bu tür bir yalıtım, genel python ortamında çakışmaları önler ve hem test hem de işbirliğine yardımcı olur. Zaman içinde, bir uygulama geliştirirken birçok yararlı Python paketi getirirsiniz. Paketleri projeye özgü bir sanal ortamda tutarak projenin requirements.txt dosyasını kolayca güncelleştirebilirsiniz. requirements.txt dosyası, kaynak denetimine dahil edilen ortamı açıklar. Proje derleme sunucuları, dağıtım sunucuları ve diğer geliştirme bilgisayarları da dahil olmak üzere diğer bilgisayarlara kopyalandığında, ortamı yalnızca requirements.txt kullanarak yeniden oluşturmak kolaydır (bu nedenle ortamın kaynak denetiminde olması gerekmez). Daha fazla bilgi için bkz . Sanal ortamları kullanma.

Soru: Nasıl yaparım? kaynak denetimine önceden kaydedilmiş bir sanal ortamı kaldıralım mı?

Yanıt: İlk olarak klasörü dışlamak için .gitignore dosyanızı düzenleyin. Sonunda açıklamanın # Python Tools for Visual Studio (PTVS) bulunduğu bölümü bulun ve sanal ortam klasörü için gibi /BasicProject/envyeni bir satır ekleyin. (Visual Studio dosyayı Çözüm Gezgini. Dosyayı doğrudan açmak için Dosya Aç>Dosyasına> gidin. Dosyayı Takım Gezgini'nden de açabilirsiniz. Ayarlar sayfasına gidin ve Depo Ayarlar'ni seçin. Şimdi , Öznitelik dosyalarını yoksay bölümüne gidin ve .gitignore öğesinin yanındaki Düzenle bağlantısını seçin.)

İkinci olarak, bir komut penceresi açın, BasicProject gibi bir klasöre gidin. BasicProject klasörü env gibi sanal ortam klasörünü içerir ve komutunu çalıştırıngit rm -r env. Ardından bu değişiklikleri komut satırından (git commit -m 'Remove venv') veya Ekip Gezgini'nin Değişiklikler sayfasından işleyin.

1-4. Adım: Ortak kodu inceleme

Proje oluşturma işlemi tamamlandıktan sonra ortak Django proje kodunu inceleyin (cli komutu django-admin startproject <project_name>tarafından oluşturulan kodla aynıdır).

1. Projenizin kökünde, Visual Studio'nun proje başlangıç dosyası olarak otomatik olarak ayardığı Django komut satırı yönetim yardımcı programı olan manage.py vardır. yardımcı programını kullanarak python manage.py <command> [options]komut satırında çalıştırırsınız. Yaygın Django görevleri için Visual Studio kullanışlı menü komutları sağlar. Çözüm Gezgini'de projeye sağ tıklayın ve listeyi görmek için Python'ı seçin. Bu öğreticinin devamında bu komutlardan bazılarında karşılaşacaksınız.

   

2. Projenizde, projeyle aynı ada sahip bir klasör vardır. Temel Django proje dosyalarını içerir:

   • __init.py: Python'a bu klasörün bir Python paketi olduğunu bildiren boş bir dosya.
   • settings.py: Bir web uygulaması geliştirirken değiştireceğiniz Django projesinin ayarlarını içerir.
   • urls.py: Geliştirme sürecinde de değiştireceğiniz Django projesinin içindekiler tablosunu içerir.
   • wsgi.py: Projenize hizmet vermek için WSGI uyumlu web sunucularının giriş noktası. Bu dosyayı genellikle olduğu gibi bırakırsınız, üretim web sunucuları için kancalar sağlar.

   

3. Daha önce belirtildiği gibi, Visual Studio şablonu projenize Django paket bağımlılığını belirten bir requirements.txt dosyası da ekler. Bu dosyanın varlığı, projeyi ilk oluştururken sizi sanal ortam oluşturmaya davet eder.

Soru: Visual Studio, diğer paketleri yükledikten sonra sanal ortamdan requirements.txt dosyası oluşturabilir mi?

Yanıt: Evet. Python Ortamları düğümünü genişletin, sanal ortamınıza sağ tıklayın ve Gereksinimler oluştur.txt komutunu seçin. Ortamı değiştirirken bu komutu düzenli aralıklarla kullanmak ve requirements.txt dosyasındaki değişiklikleri kaynak denetimine ve bu ortama bağlı diğer kod değişiklikleriyle birlikte işlemek iyi olur. Bir derleme sunucusunda sürekli tümleştirme ayarlarsanız, ortamı her değiştirdiğinizde dosyayı oluşturup değişiklikleri işlemeniz gerekir.

1-5. Adım: Boş Django projesini çalıştırma

1. Visual Studio'da Hata Ayıklama>Başlat Hata Ayıklama 'yı (F5) seçin veya araç çubuğundaki Web Sunucusu düğmesini kullanın (gördüğünüz tarayıcı farklılık gösterebilir):

   

2. Sunucuyu çalıştırmak, Django'nun yerleşik geliştirme sunucusunu başlatan komutunu manage.py runserver <port>çalıştırmak anlamına gelir. Visual Studio başlangıç dosyası olmadığıyla ilgili bir iletiyle hata ayıklayıcı başlatılamadı iletisini veriyorsa, Çözüm Gezgini'da manage.py sağ tıklayın ve Başlangıç Dosyası Olarak Ayarla'yı seçin.

3. Sunucuyu başlattığınızda, sunucu günlüğünü de görüntüleyen bir konsol penceresi açılır. Visual Studio otomatik olarak için http://localhost:<port>bir tarayıcı açar. Django projesinin uygulaması olmadığından, Django şu ana kadar sahip olduğunuz şeyin iyi çalıştığını onaylamak için yalnızca varsayılan bir sayfa gösterir.

   

4. İşiniz bittiğinde, konsol penceresini kapatarak veya Visual Studio'daki Hata Ayıklamayı> Durdur komutunu kullanarak sunucuyu durdurun.

Soru: Django bir web sunucusu ve çerçeve mi?

Yanıt: Evet ve hayır. Django,geliştirme amacıyla kullanılan yerleşik bir web sunucusuna sahiptir. Bu web sunucusu, visual studio'da hata ayıklama gibi web uygulamasını yerel olarak çalıştırdığınızda kullanılır. Ancak bir web konağına dağıttığınızda Django bunun yerine konağın web sunucusunu kullanır. Django projesindeki wsgi.py modülü, üretim sunucularına bağlanma işlemini üstlenir.

Soru: Hata Ayıkla menü komutlarını ve projenin Python alt menüsündeki sunucu komutlarını kullanma arasındaki fark nedir?

Yanıt: Hata ayıklama menüsü komutlarına ve araç çubuğu düğmelerine ek olarak, projenin bağlam menüsünde python>Çalıştırma sunucusu veya Python>Çalıştırma hata ayıklama sunucusu komutlarını kullanarak da sunucuyu başlatabilirsiniz. Her iki komut da çalışan sunucunun yerel URL'sini (localhost:port) göreceğiniz bir konsol penceresi açar. Ancak, bu URL'ye sahip bir tarayıcıyı el ile açmanız gerekir ve hata ayıklama sunucusunu çalıştırmak Visual Studio hata ayıklayıcısını otomatik olarak başlatmaz. İsterseniz, İşleme Hata Ayıklama Ekleme komutunu kullanarak çalışan işleme bir hata ayıklayıcısı>ekleyebilirsiniz.

Sonraki adımlar

Bu noktada, temel Django projesi herhangi bir uygulama içermez. Sonraki adımda bir uygulama oluşturacaksınız. Django uygulamalarıyla Django projesinden daha fazla çalışacağınız için şimdilik ortak dosyalar hakkında daha fazla bilgi sahibi olmanız gerekmez.

Görünümler ve sayfa şablonlarıyla Django uygulaması oluşturma

Daha derine git

• Django proje kodu: İlk Django uygulamanızı yazma, bölüm 1 (docs.djangoproject.com)
• Yönetici istrative yardımcı programı: django-admin ve manage.py (docs.djangoproject.com)
• GitHub'da öğretici kaynak kodu: Microsoft/python-sample-vs-learning-django