Öğretici: Visual Studio'da Django web çerçevesiyle çalışma

Bu makale, Visual Studio'da Django ile çalışmayı gösteren beş bölümlü öğretici serisinin ilk Adımıdır. Django hızlı, güvenli ve ölçeklenebilir web geliştirme için tasarlanmış üst düzey bir Python çerçevesidir. Visual Studio, Django tabanlı web uygulamalarının oluşturulmasını kolaylaştırmak için kullanabileceğiniz proje şablonları sağlar. Bu öğretici serisi, Visual Studio proje şablonları bağlamında Django çerçevesini inceler.

Eğitimin 1. Adımında şunları öğreneceksiniz:

• Boş Django Web Projesi şablonunu kullanarak Django web uygulaması projesi oluşturma
• Şablon kodu inceleyin ve uygulamayı çalıştırın
• Django web uygulaması için Git deposu oluşturma
• Git kaynak kodu denetimleriyle çalışma
• Django web uygulaması için sanal ortam oluşturma

Önkoşullar

• Windows'da Visual Studio 2022 veya üzeri, Visual Studio Yükleyicisi'nde aşağıdaki seçenekler seçilidir:

  • İş yükleri sekmesinde Python geliştirme seçeneğini belirleyin. Daha fazla bilgi için bkz. Visual Studio'de Python desteği yükleme.

  • Tek tek bileşenlersekmesindeki Kod araçları'nın altında Windows için Git seçeneğini belirleyin.

Visual Studio'daki Django proje şablonları, Visual Studio için Python Araçları'nın önceki tüm sürümlerine eklenir. Şablon ayrıntıları, özellikle Django web çerçevesinin önceki sürümleri için bu öğretici serisindeki açıklamalardan farklı olabilir.

Mac için Visual Studio desteklenmez. Daha fazla bilgi için bkz. Mac için Visual Studio'da neler oluyor? Windows, Mac ve Linux'ta Visual Studio Code , mevcut uzantılar aracılığıyla Python ile iyi çalışır.

Visual Studio projeleri ve Django projeleri

Django terminolojisinde, bir Django projesinde bir veya daha fazla "uygulama" ile birlikte çeşitli site düzeyinde yapılandırma dosyaları vardır. 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 serisinde, "proje" terimi Visual Studio projesine başvurur. İçerik, web uygulamasının "Django projesi" bölümünü ifade ettiğinde, özellikle bir "Django projesi" anlamına gelir.

Visual Studio projesi ve çözümü oluşturma

Bu öğretici serisinin 1. Adımında, birden çok Django projesi içerecek tek bir Visual Studio çözümü oluşturursunuz. Her proje tek bir Django uygulaması içerir. Visual Studio'da bulunan farklı Django proje şablonlarını kullanarak projeleri oluşturursunuz. Projeleri aynı çözümde tutarak, karşılaştırma için farklı dosyalar arasında kolayca geçiş yapabilirsiniz.

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.

Çözümü ve projeyi oluşturmak için şu yordamı izleyin:

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

   

2. Yeni projenizi ve çözümünüzü yapılandırın:

   1. Visual Studio projesinin AdınıBasicProject olarak ayarlayın. Bu ad Django projesi için de kullanılır.

   2. Visual Studio'nun çözümü ve projeyi kaydedeceği konumu belirtin.

   3. Çözümü ve projeyi aynı dizine yerleştir seçeneğini temizleyin.

   4. Çözüm adınıLearningDjango olarak ayarlayın. Çözüm, bu öğretici serisinde birden çok proje için kapsayıcı görevi görür.

3. Oluştur'i seçin.

4. Bir dakika sonra Visual Studio, "BasicProject" projesinde "requirements.txt" Python paket belirtimi dosyası algılandı" istemini görüntüler:

   

   İletişim kutusu, seçilen şablonun proje için sanal ortam oluşturmak için kullanabileceğiniz bir requirements.txt dosyası içerdiğini gösterir.

5. İstemi kapatmak için sağdaki X işaretini seçin. Bu öğreticinin ilerleyen bölümlerinde sanal ortamı oluşturur ve kaynak denetiminin ortamı dışlamadığından emin olursunuz. (Ortam daha sonra requirements.txt dosyasından her zaman oluşturulabilir.)

Git denetimlerini inceleme

Sonraki yordamda Git kaynak denetimi için Visual Studio desteği hakkında bilgi edineceksiniz.

Önemli

Visual Studio 2019 ve sonraki sürümlerde Git sürüm denetimi deneyimi varsayılan olarak açıktır. Ekip Gezgini ile karşılaştırması hakkında daha fazla bilgi edinmek isterseniz Git ve Takım Gezgini'nin yan yana karşılaştırması sayfasına bakın.

Visual Studio'nun önceki sürümlerinde Takım Gezgini'ni kullanmaya devam etmek istiyorsanız , Araçlar>Seçenekleri>Ortam>Önizleme Özellikleri'ne gidin ve Yeni Git kullanıcı deneyimi onay kutusunu değiştirin.

1. Projeyi yerel kaynak denetiminize işlemek için Visual Studio ana penceresinin sağ alt kısmındaki Kaynak Denetimine Ekle'yi ve ardından Git'i seçin:

   

   Yeni bir depo oluşturup gönderebileceğiniz Git deposu oluştur penceresi açılır.

2. Bir depo oluşturduktan sonra, Visual Studio ana penceresinde sağ altta Git denetimleri çubuğu görüntülenir:

   

   Soldan sağa Git denetim çubuğunda giden/gelen işlemelerin sayısı (oklar #/#), kaydedilmemiş değişikliklerin sayısı (kalem #), geçerli dal adı ve geçerli depo adı gösterilir. Git denetimleri, ana araç çubuğundaki Git menüsünde de kullanılabilir.

3. Git denetimleri çubuğunda değişiklikleri (kalem #) seçerek Git Değişiklikleri penceresini açın. Göster>Git değişiklikleri'ni de seçebilirsiniz (Ctrl+O, Ctrl+G):

   

   Bu pencerede, depolanmış değişiklikler de dahil olmak üzere, kaydedilmemiş değişikliklerle ilgili ayrıntılar gösterilir. Yeni oluşturduğunuz proje zaten otomatik olarak kaynak denetimine işlendiğinden bekleyen hiçbir değişiklik görmezsiniz.

4. Git denetimleri çubuğunda işlemeleri (oklar #/#) ve ardından Tüm İşlemeleri Görüntüle'yi seçin:

   

   Git deposu penceresi açılır. Görüntüle>Git deposu (Ctrl+O, Ctrl+R) seçebilirsiniz:

   

   Bu pencere, sol bölmedeki geçerli depo ayrıntılarını ve sağ bölmede giden/gelen commit'lerle birlikte geçerli dalı gösterir.

   Dosyanın farklılıklar görünümünü görmek için orta bölmede bir işleme tıklayın. Önceki sürüm sol tarafta, düzeltilmiş sürüm ise sağ tarafta gösterilir. Ayrıntılarda değişiklik yazarı, değişiklik işleyicisi ve işleme iletisi de yer alır.

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

Kaynak denetimini baştan kullanma

Projenin başından itibaren kaynak denetimini kullanmanın çeşitli avantajları vardır. Bir projenin başlangıcından itibaren kaynak denetimi kullandığınızda, özellikle de uzak bir depo kullanıyorsanız, projenizin düzenli olarak site dışı yedeğini alırsınız. Bir projenin yalnızca yerel bir dosya sisteminde tutulmasından farklı olarak, kaynak denetimi tam bir değişiklik geçmişi ve tek bir dosyayı veya projenin tamamını önceki bir duruma geri döndürme olanağı da 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ışıyorsa kaynak denetimi önemlidir, çünkü üzerine yazmaları yönetir ve çakışma çözümü sağlar. Kaynak denetimi temelde bir otomasyon biçimidir, derlemeleri otomatikleştirmek, test etmek ve yayın yönetimi için iyi bir şekilde ayarlamanızı sağlar. Bu, proje için Azure DevOps kullanmanın ilk adımıdır ve giriş engelleri çok düşük olduğundan, başlangıçtan itibaren kaynak denetimini kullanmamak için gerçekten bir neden yoktur.

Otomasyon olarak kaynak denetimi hakkında daha fazla bilgi için, MSDN Dergisi'nde 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.

Visual Studio'da projelerin otomatik olarak yüklenmesini engelleme

Visual Studio'nın yeni bir projeyi otomatik olarak işlemesini önlemek için şu adımları izleyin:

1. Araçlar>Seçenekleri bölmesini açın ve Tüm Ayarlar>Kaynak Denetimi>Git Ayarları bölümünü genişletin.

2. Birleştirmeden sonra değişiklikleri varsayılan olarak işle seçeneğini temizleyin.

Sanal ortam oluşturma ve kaynak denetimini dışlama

Projeniz için kaynak denetimini yapılandırdıktan sonra, projenin gerektirdiği gerekli Django paketleriyle sanal ortamı oluşturabilirsiniz. Ardından, ortamın klasörünü kaynak denetiminden dışlamak için Git Değişiklikleri penceresini kullanabilirsiniz.

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

   

2. Ortam ekle iletişim kutusunda Oluştur'u seçerek varsayılan değerleri kabul edin. (İsterseniz sanal ortamın adını değiştirebilirsiniz; bu, alt klasörünün adını değiştirir ancak env standart bir kuraldır.)

   

3. Visual Studio yönetici ayrıcalıkları isterse onayınızı sağlayın. Visual Studio paketleri indirip yüklerken birkaç dakika bekleyin. Django ve bağımlılıkları için işlem, 100'den fazla alt klasörde 1.000'e yakın dosya genişletmeyi gerektirebilir. İlerleme durumunu Visual Studio Çıkış penceresinde görüntüleyebilirsiniz.

4. Git denetimleri çubuğunda, Git Değişiklikleri penceresini açmak için kaydedilmemiş değişiklikleri (artık 99+) seçin:

   

   Sanal ortamın oluşturulması binlerce değişiklik getirir, ancak bunları kaynak denetimine eklemeniz gerekmez. Siz veya projeyi kopyalayan diğer herkes requirements.txt dosyasını kullanarak ortamı her zaman yeniden oluşturabilir.

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

   

   Sanal ortamı dışladıktan sonra, kalan tek değişiklikler proje dosyasında (.py) ve sanal ortam klasörü için ek bir giriş içeren .gitignore dosyasındadır.

   .gitignore dosyasının farklılıklar görünümünü görmek için Git Değişiklikleri penceresinde dosyaya çift tıklayın.

6. Git Değişiklikleri penceresinde, "İlk proje değişiklikleri" gibi bir işleme iletisi girin:

   

7. İşleme açılan menüsünde İşleme Aşamalı ve Gönder'i seçin.

Git Deposu penceresini açabilir ve hazırlanmış işlemelerin geçerli dal için Yerel Geçmiş'te gösterilmesini onaylayabilirsiniz.

Sanal ortamların amacını anlama

Sanal ortam, uygulamanızın tam bağımlılıklarını yalıtmak için harika bir yoldur. Bu yalıtım yöntemi, genel python ortamındaki ç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, kaynak denetimine dahil edilen ortamı açıklayan projenin requirements.txt dosyasını kolayca güncelleştirebilirsiniz. Projeyi derleme sunucuları, dağıtım sunucuları ve diğer geliştirme bilgisayarları gibi diğer bilgisayarlara kopyaladığınızda, ortamı yeniden oluşturmak kolaydır. Ortamı yalnızca requirements.txt dosyasını kullanarak yeniden oluşturabilirsiniz. Bu nedenle ortamın kaynak denetiminde olması gerekmez. Daha fazla bilgi için bkz. Sanal ortamları kullanma.

Kaynak denetimi altında sanal ortamı kaldırma

Sanal ortamı kaynak denetimi altında olduktan sonra kaldırabilirsiniz. Şu adımları izleyin:

1. Klasörü dışlamak için .gitignore dosyanızı düzenleyin:

   1. Dosya>Dosya'yı > seçeneğini seçerek açın.

      Dosyayı Takım Gezgini'nden de açabilirsiniz. Ayarlar sayfasında Depo Ayarları'nı seçin. Öznitelik Dosyalarını Yoksay bölümüne gidin ve .gitignore öğesinin yanındaki Düzenle bağlantısını seçin.

   2. Sonunda açıklama # Python Tools for Visual Studio (PTVS) içeren bölümü bulun.

   3. Bu bölümden sonra sanal ortam klasörü için gibi /BasicProject/envyeni bir satır ekleyin.

2. Bir komut penceresi açın ve env gibi sanal ortam klasörünü içeren klasöre (BasicProject gibi) gidin.

3. git rm -r env Şu anda kaynak denetimi altında olan sanal ortamı kaldırmak için komutunu çalıştırın.

4. Değişikliklerinizi komutuyla git commit -m 'Remove venv' işleyin veya Ekip Gezgini'ninDeğişiklikler sayfasından işleyin.

Kalıp kodu inceleme

Bu bölümde, Visual Studio'nun şablon seçiminize göre oluşturduğu Project dosyasındaki (.py) ortak kodu inceleyebilirsiniz.

Uyarı

Ortak kod, Django şablonundan Visual Studio'da proje oluştururken veya CLI komutunu django-admin startproject <project_name>kullanarak projeyi oluştururken aynıdır.

1. Çözümünüzü ve proje dosyalarınızı görüntülemek için Çözüm Gezgini'ne gidin. İlk proje yalnızca iki dosya içerir: manage.py ve requirements.txt:

   

   requirements.txt dosyası Django paket bağımlılıklarını belirtir. Bu dosyanın varlığı, projeyi ilk oluştururken sizi sanal ortam oluşturmaya davet eder.

   manage.py dosyası, Visual Studio'nın proje başlangıç dosyası olarak otomatik olarak ayarlayan Django komut satırı yönetim yardımcı programıdır. Komut satırında python manage.py <command> [options] komutunu kullanarak aracı çalıştırırsınız.

   Yaygın Django görevleri için Visual Studio kullanışlı menü komutları sağlar. Çözüm Gezgini'nde projeye sağ tıklayın ve komut listesini görmek için Python'ı seçin. Bu öğretici serisinde bu komutlardan birkaçını kullanırsınız.

2. İki dosyaya ek olarak, projenin projeyle aynı ada sahip bir alt klasörü de vardır. Bu klasö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ştirdiğiniz Django projesinin ayarları.
   • urls.py: Web uygulamanızı geliştirirken değiştirdiğiniz Django projesinin içindekiler tablosu.
   • wsgi.py: Projenize hizmet vermek için WSGI uyumlu web sunucularının giriş noktası. Bu dosyayı genellikle as-is olarak bırakırsınız çünkü üretim ortamı web sunucuları için kancalar sağlar.

Paket yüklendikten sonra gereksinimleri oluşturma

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

• Çözüm Gezgini'ndePython Ortamları düğümünü genişletin, sanal ortamınıza sağ tıklayın ve requirements.txtoluştur'a tıklayın.

Ortamı değiştirirken bu komutu düzenli aralıklarla kullanmak iyi bir uygulamadır. requirements.txt dosyanızdaki değişiklikleri kaynak denetimine ve bu ortama bağlı diğer kod değişikliklerine işleyin. 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.

Projeyi çalıştırma

Artık bu yordamı izleyerek projenizi Visual Studio'da çalıştırmaya hazırsınız:

1. Visual StudioHata Ayıklama>Hata Ayıklamayı Başlat (F5) öğesini seçin veya ana araç çubuğunda web sunucusu seçin (gördüğünüz tarayıcı farklılık gösterebilir):

   

2. Her iki komut da Django'da yerleşik web sunucusunu başlatan komutunu manage.py runserver <port>kullanarak sunucuyu çalıştırır.

   Kod, Django geliştirme sunucusu içinde belirtilen bağlantı noktasını kullanarak uygulamayı başlatır.

   Visual Studio hata ayıklayıcı başlatılamadı iletisini gönderip hiçbir başlangıç dosyası bulunamadığını belirtiyorsa Çözüm Gezgini'ndemanage.py dosyasına sağ tıklayın ve Başlangıç Dosyası Olarak Ayarla'yı seçin.

3. Sunucu başlatıldığında, sunucu günlüğünü görüntülemek için bir konsol penceresi açılır. Visual Studio otomatik olarak http://localhost:<port> için bir tarayıcı açar. Django projenizde uygulama olmadığından Django, geçerli kodun beklendiği gibi çalıştığını onaylamak için yalnızca varsayılan bir sayfa gösterir.

   

4. İşiniz bittiğinde, Django geliştirme sunucusunu durduran konsol penceresini kapatın. Ayrıca hata ayıklama>hata ayıklamayı durdurseçebilirsiniz.

Django web sunucusunu ve çerçeveyi kullanma

Django,geliştirme amacıyla kullanabileceğiniz yerleşik bir web sunucusuna sahiptir. Django web uygulamanızı yerel olarak çalıştırdığınızda yerleşik Django web geliştirme sunucusunu kullanırsınız. Bu senaryoya örnek olarak Visual Studio'da Django web uygulamanızda hata ayıklama işlemi yapılır.

Django web uygulamanızı bir web konağına dağıttığınızda, yerleşik Django web sunucusu yerine ana bilgisayarda web sunucusunu kullanırsınız. Django projesindeki wsgi.py modülü, üretim sunucularına bağlanma işlemini üstlenir.

Hata ayıklama komutlarını proje Python komutları ile karşılaştırın,

Hata Ayıkla menü komutlarını kullanma ile projenin Python alt menüsünde listelenen sunucu komutları arasında bir fark vardır.

Hata Ayıklama menüsü komutlarına ve araç çubuğu düğmelerine ek olarak, projenin bağlam menüsünde pythonBaşlangıç sunucusu veya >>Başlat hata ayıklama sunucusu komutlarını kullanarak da sunucuyu başlatabilirsiniz.

Her iki komut da çalışan sunucunun yerel URL'sini (localhost:port) gördüğünüz 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. daha sonra isterseniz çalışan işleme bir hata ayıklayıcı eklemek için Hata Ayıklama>İşleme Ekle komutunu kullanabilirsiniz.

Sonraki adım

2. Adım: Görünümler ve sayfa şablonları içeren bir Django uygulaması oluşturma