Aracılığıyla paylaş


Visual Studio'da Unreal Engine sınıfları, modülleri ve eklentilerini ekleme

Bu makalede, Unreal Engine için Visual Studio Araçları'nı kullanarak şunları yapmayı öğrenin:

Önkoşullar

Aşağıdakiler yüklenmelidir:

Visual Studio'da Unreal Engine modülleri ekleme

Visual Studio'dan Unreal Engine projenize Unreal Engine modüllerini ekleyebilirsiniz. Modül eklemek için artık Gerçek Dışı Altyapı Düzenleyicisi ile Visual Studio arasında geçiş yapmanız veya daha sonra Visual Studio çözümünü Gerçek Dışı Altyapı proje dosyanızla eşitlemeniz gerekmez.

Modüller, kodunuzu Unreal Engine'de düzenlemenin bir yoludur. İlgili sınıfları ve varlıkları birlikte gruplandırmanıza ve kodunuzu çalışma zamanında yüklenip kaldırılabilen bağımsız birimler halinde düzenlemenize yardımcı olur. Yapılandırma dosyalarını düzenlemeyi ve ortak kod eklemeyi gerektirdiği için el ile yaparsanız modül oluşturmak yorucu ve hataya açık olabilir. Visual Studio, süreç boyunca size yol gösteren bir iletişim kutusu sağlayarak, yapılandırmayı yaparak ve sizin için şablon kodu ekleyerek modül oluşturmayı kolaylaştırır.

Visual Studio'da bir Unreal Engine modülü eklemek için, Lyra oyununu indirip derlemek üzere Hızlı Başlangıç: Unreal Engine için Visual Studio Araçları tamamladıktan sonra şu adımları izleyin. Bu adımlarda, LyraStarterGame.sln çözümünün Visual Studio'da açık olduğu varsayılır:

  1. Çözüm Gezgini'nde, yeni modülün gitmesini istediğiniz LyraStarterGamegibi bir proje seçin.
  2. Projeye sağ tıklayın (klasör değil, projenin seçili olduğundan emin olun) ve >Gerçek Dışı Altyapı öğesi ekle... öğesini seçin, Gerçek Dışı Altyapı öğeleri için Yeni Öğe Ekle iletişim kutusunu açın: Yeni Öğe Ekle menüsünün ekran görüntüsü. Boş Gerçek Dışı Altyapı Modülü seçildi.
  3. Gerçek Dışı Altyapı Modülü'nü seçin, Adı alanına bir modül adı girin ve Ekle'yi seçerek Gerçek Dışı Altyapı Modülü Ekle iletişim kutusunu açın:

    Add Unreal Engine Modülü iletişim kutusunun ekran görüntüsü.

    Gerçek Dışı Altyapı Modülü Ekle iletişim kutusunda Modül adı için bir alan, Modül türü (Çalışma zamanı seçili) için açılan menüler ve modül yükleme aşaması (Varsayılan seçilidir) bulunur. Modül yolu, üst bilgi, kaynak ve derleme dosyası yolları listelenir. Unreal Editor araçlarını kullanarak IntelliSense bilgilerini yenileme onay kutusu işaretlidir.

  4. Modül türü ve Modül yükleme aşamasıseçmek için açılan menüleri kullanın.
  5. Modülü projeye eklemek ve Visual Studio çözüm dosyasını güncelleştirmek için tamam seçin.

Modüller yalnızca Kaynak klasöründe veya Plugins klasöründeki bir eklentinin modülü olarak oluşturulabilir.
Derleme yolu, Build.cs dosyasının nerede oluşturulduğunu gösterir. Build.cs dosyası modülün yapılandırma bilgilerini içerir.

Tek bir Unreal Engine modülü oluştur

Modülü ekledikten sonra, Unreal Engine Düzenleyicisi'nde kullanılabilir hale getirmek için derleyin. Projenin tamamını oluşturmak yerine yalnızca modülü oluşturabilirsiniz.

Çözüm Gezgini'nde modül klasörüne sağ tıklayın ve Derleme'ü seçin. Bu, eklentiyi derler ve Unreal Engine Düzenleyicisi'nde kullanılabilir hale getirir.

Modülü derlemek için menünün ekran görüntüsü.

MyModule modül klasörüne sağ tıkladıktan sonra menü seçenekleri görünür. Bu Unreal Engine modülünü derle girişi vurgulanır.

Derleme çıktısı Çıktı penceresinde görüntülenir. Yapı başarılı olursa modül, Unreal Engine Düzenleyicisi'nde kullanılabilir. Derleme başarısız olursa, Çıktı penceresinde hata iletileri görüntülenir.

Visual Studio'da Unreal Engine sınıflarını ekleyin

Artık Visual Studio'dan Gerçek Dışı Altyapı projenize Gerçek Dışı Altyapı sınıfları ekleyebilirsiniz. Artık sınıf eklemek için Unreal Editor ile Visual Studio arasında geçiş yapmanız veya daha sonra Visual Studio çözümünü Unreal Engine proje dosyanızla eşitlemeniz gerekmez.

Visual Studio'da bir Unreal Engine sınıfı eklemek için, önce Hızlı Başlangıç: Visual Studio Araçları for Unreal Engine tamamlanarak Lyra oyununu indirip derlemek adımlarını izleyin. Adımlarda, LyraStarterGame.sln çözümünün Visual Studio'da açık olduğu varsayılır:

  1. Çözüm Gezginibölümünde, yeni sınıfın gitmesini istediğiniz klasörü seçin. LyraStarterGame projesinde, örneğin LyraStarterGame>Source klasörüne yeni bir sınıf ekleyebilirsiniz.
  2. Klasöre sağ tıklayın ve >Gerçek Dışı Altyapı öğesi ekle...'i seçerek Yeni Öğe Ekle iletişim kutusunu açın:

    Yeni Öğe Ekle iletişim kutusunun, Unreal Engine Ortak Sınıfları'nın seçili olduğu ekran görüntüsü.

    Unreal Engine Common Classes (seçili olan), Boş Unreal Engine Modülü ve Unreal Engine Eklentileri ekleme seçeneklerine sahiptir.

  3. Unreal Engine Ortak Sınıflarını seçin ve sonra Ekle'yi seçerek Unreal Engine Sınıfı Ekle iletişim kutusunu açın.

    Yeni Unreal Engine sınıfı ekleme iletişim kutusunun ekran görüntüsü.

    Aktör, Karakter vb. gibi bir temeli seçme seçenekleri görünür. Sınıf adı için bir alan ve sınıfın ekleneceği modül için bir açılan menü vardır. Üst bilgi dosyasının ve kaynak dosyanın yolları listelenir. Unreal Editor araçlarını kullanarak IntelliSense bilgilerini yenilemek için bir onay kutusu seçildi.

  4. Bir Sınıf adıseçin. Ad varolan bir sınıf veya dosyayla çakıyorsa Visual Studio sizi uyarır.
  5. Base sınıfıseçin. Temel sınıfın seçilmesi, bu sınıf türü için doğru üst bilgilerin ve makroların eklenmesini sağlar.
  6. Modül seçin açılır menüsünü kullanarak sınıfınıza eklemek için bir modül seçin. Modül adı, modülü içeren klasörün adıdır.
  7. Visual Studionun IntelliSense bilgilerini güncelleştirmek için Gerçek Dışı Düzenleyici araçlarını kullanıp kullanmadığını seçmek için Gerçek Dışı Düzenleyici araçları kullanarak IntelliSense bilgilerini yenile onay kutusunu seçin. Unreal Build Tool'un Visual Studio solution dosyasını yeniden oluşturmasını sağlamak için bunu seçin.
  8. Yeni sınıf için üst bilgi ve kaynak dosyaları oluşturmak ve bunları Visual Studio çözüm dosyasına eklemek için Tamam'i seçin. Projeyi yeniden yüklemek için görüntülenen istemde yeniden yükle'yi seçin.

Visual Studio'da Unreal Engine eklentileri ekle

Artık Visual Studio'dan Unreal Engine projenize Unreal Engine eklentileri ekleyebilirsiniz. Artık Visual Studio'dan Unreal Editor'a geçiş yapmanıza veya sonrasında Visual Studio çözümünü Unreal Engine proje dosyanızla eşlemenize gerek kalmadan eklenti ekleyebilirsiniz.

Visual Studio'da bir Unreal Engine eklentisi eklemek için, Lyra oyununu indirip derlemek üzere Hızlı Başlangıç: Unreal Engine için Visual Studio Araçları tamamladıktan sonra şu adımları izleyin. Adımlarda, LyraStarterGame.sln çözümünün Visual Studio'da açık olduğu varsayılır:

  1. Çözüm Gezginibölümünde yeni eklentinin gitmesini istediğiniz klasörü seçin. Örneğin, LyraStarterGame projesinde LyraStarterGame>Source klasörüne yeni bir eklenti ekleyebilirsiniz.
  2. Klasöre sağ tıklayın ve >Unreal Engine öğesi ekle...'i seçerek Yeni Öğe Ekle iletişim kutusunu açın:

    Unreal Engine Eklentileri'nin seçili olduğu Yeni Öğe Ekle kutusunun iletişim ekran görüntüsü.

    Unreal Engine Ortak Sınıflar, Boş Unreal Engine Modülü ve Unreal Engine Eklentileri (seçili olan) ekleme seçeneklerine sahiptir.

  3. Unreal Engine Eklentileri'nı seçin ve ardından Ekle'yi seçerek Unreal Engine Eklentisi Ekle iletişim kutusunu açın:

    Yeni Unreal Engine eklentisi ekleme iletişim kutusunun ekran görüntüsü.

    Eklenti türlerinin listesi (Gelişmiş seçilidir) ve eklenti adı, yolu, yazarı, açıklaması ve URL'si için alanlar vardır. Beta aşamasındaki bir eklenti onay kutusu (seçilmemiş) ve Unreal Editor Araçlarını kullanarak IntelliSense bilgilerini yenileme onay kutusu (seçilmiş).

  4. eklentinizin türünü Eklenti türü listesinden seçin.
  5. Eklentisi adını, Eklenti yazarı, Eklenti Açıklamasıve Eklentisi url'sinisağlayın.
  6. Gerektiğinde Beta aşamasındaki eklenti kutusunu işaretleyin.
  7. Unreal Düzenleyici araçlarını kullanarak IntelliSense bilgilerini yenilemek için Unreal Düzenleyici araçlarını Visual Studio'nun kullanıp kullanmayacağını seçmek için onay kutusunu işaretleyin. Bu, Unreal Build Tool'un Visual Studio çözüm dosyasını yeniden oluşturmasına neden olur.
  8. Yeni eklentinin eklenti üst bilgisini ve kaynak dosyalarını oluşturmak ve bunları Visual Studio çözüm dosyasına eklemek için Ekle'yi seçin. Bu, projeyi yeniden yüklemek için bir istemle sonuç alır. Projeyi yeniden yüklemek için Yeniden Yükle'yi seçin.

Tek bir Unreal Engine eklentisi oluşturma

Eklentiyi ekledikten sonra, Bunu Unreal Engine Düzenleyicisi'nde kullanılabilir hale getirmek için derleyin. Projenin tamamını oluşturmak yerine yalnızca eklentiyi oluşturabilirsiniz.

Çözüm Gezginieklenti klasörüne sağ tıklayın ve Bu Unreal Engine eklentisinioluştur seçeneğini belirleyin. Bu, eklentiyi derler ve Unreal Engine Düzenleyicisi'nde kullanılabilir hale getirir.

Eklentiyi oluşturmak için menünün ekran görüntüsü.

MyPlugin eklenti klasörüne sağ tıkladıktan sonra menü seçenekleri görünür. Bu Unreal Engine eklentisini derle girişi vurgulanır.

Derleme başarılı olursa eklenti, Unreal Engine Editor'de kullanılabilir. Derleme başarısız olursa, Çıktı penceresinde hata iletileri görüntülenir.

Unreal Engine için Visual Studio Araçları
Visual Studio'da Gerçek Dışı Altyapı Şemalarını Görüntüleme
Visual Studio'da Unreal Engine günlüğünü görüntüleme
Visual Studio 'de Unreal Engine makrolarını görüntüleme