Aracılığıyla paylaş


Unity için Visual Studio Araçları’nı Kullanma

Bu bölümde, Unity için Visual Studio Araçları tümleştirme ve üretkenlik özelliklerini kullanmayı ve Unity geliştirme için Visual Studio hata ayıklayıcısını kullanmayı öğreneceksiniz.

Visual Studio'da Unity betiklerini açma

Visual Studio Unity için dış düzenleyici olarak ayarlandıktan sonra, Unity düzenleyicisinden bir betike çift tıklandığında otomatik olarak başlatılır veya Visual Studio'ya geçiş yapılır ve seçilen betik açılır.

Alternatif olarak, Unity'de Varlıklar > Aç C# Proje menüsünü seçerek kaynak düzenleyicide betik açık olmadan Visual Studio'yu açabilirsiniz.

Screenshot of the Open C# project in Visual Studio.

Screenshot of the Open C# project in Visual Studio for Mac.

Unity belgeleri erişimi

Unity betik oluşturma belgelerine Visual Studio'dan hızla erişebilirsiniz. Unity için Visual Studio Araçları API belgelerini yerel olarak bulamazsa çevrimiçi bulmaya çalışır.

  • Visual Studio'da, imleci öğrenmek istediğiniz Unity API'sinin üzerine getirin veya vurgulayın, ardından Ctrl+Alt+M, Ctrl+H tuşlarına basın
  • Anahtar bağlama yerine Yardım > Unity API Başvurusu menüsünü de kullanabilirsiniz.

Screenshot of the Unity API Reference menu in Visual Studio.

  • Mac için Visual Studio'da imleci, hakkında bilgi edinmek istediğiniz Unity API'sinin üzerine getirin veya vurgulayın, ardından Cmd+ tuşuna basın'
  • Anahtar bağlama yerine Yardım > Unity API Başvurusu menüsünü de kullanabilirsiniz.

Screenshot of the Unity API Reference menu in Visual Studio for Mac.

Unity API İletileri için IntelliSense

Intellisense kod tamamlama, MonoBehaviour betiklerinde Unity API iletilerinin uygulanmasını kolaylaştırır ve Unity API'sini öğrenme konusunda yardımcı olur. Unity iletileri için IntelliSense'i kullanmak için:

  1. İmleci, öğesinden MonoBehaviourtüretilen bir sınıfın gövdesi içinde yeni bir satıra yerleştirin.

  2. Gibi OnTriggerEnterbir Unity iletisinin adını yazmaya başlayın.

  3. "Ontri" harfleri yazıldıktan sonra IntelliSense önerilerinin listesi görüntülenir.

Screenshot of using IntelliSense in Visual Studio.

  1. Listedeki seçim üç şekilde değiştirilebilir:

    • Yukarı ve Aşağı ok tuşlarıyla.

    • fareyle istediğiniz öğeye tıklayarak.

    • İstenen öğenin adını yazmaya devam ederek.

  2. IntelliSense, gerekli parametreler de dahil olmak üzere seçili Unity iletisini ekleyebilir:

    • Sekme tuşuna basarak.

    • Enter tuşuna basarak.

    • Seçili öğeye çift tıklayarak.

Screenshot of the Insert Unity message from IntelliSense in Visual Studio.

Unity MonoBehavior betik oluşturma sihirbazı

MonoBehavior sihirbazını kullanarak tüm Unity API yöntemlerinin listesini görüntüleyebilir ve hızlı bir şekilde boş bir tanım uygulayabilirsiniz. Özellikle Yöntem açıklamaları oluştur seçeneği etkinken bu özellik, Unity API'sinde sunulanları öğrenmeye devam ediyorsanız yararlıdır.

MonoBehavior sihirbazıyla boş MonoBehavior yöntemi tanımları oluşturmak için:

  1. Visual Studio'da, imleci yöntemlerin eklenmesini istediğiniz yere getirin, ardından MonoBehavior sihirbazını başlatmak için Ctrl+Shift M tuşlarına+basın. Mac için Visual Studio Cmd+Shift M tuşlarına+basın.

  2. Betik yöntemleri oluştur penceresinde, eklemek istediğiniz her yöntemin adının yanındaki onay kutusunu işaretleyin.

  3. İstediğiniz sürümü seçmek için Framework sürümü açılan listesini kullanın.

  4. Varsayılan olarak, yöntemler imlecin konumuna eklenir. Alternatif olarak, Ekleme noktası açılan listesinin değerini istediğiniz konuma değiştirerek bunları sınıfınızda zaten uygulanmış olan herhangi bir yöntemden sonra eklemeyi seçebilirsiniz.

  5. Sihirbazın seçtiğiniz yöntemler için açıklama oluşturmasını istiyorsanız, Yöntem açıklamaları oluştur onay kutusunu işaretleyin. Bu açıklamalar, yöntemin ne zaman çağrıldığını ve genel sorumluluklarının ne olduğunu anlamanıza yardımcı olmak içindir.

  6. Sihirbazdan çıkmak ve yöntemleri kodunuz içine eklemek için Tamam düğmesini seçin.

Screenshot of the monobehavior wizard dialog in Visual Studio.

Screenshot of the monobehavior wizard dialog in Visual Studio for Mac.

Unity Proje Gezgini

Unity Proje Gezgini, Unity proje dosyalarınızın ve dizinlerinizin tümünü Unity Düzenleyicisi ile aynı şekilde gösterir. Bu, Unity betiklerinizi normal Visual Studio Çözüm Gezgini ile gezinmekten farklıdır. Bu, bunları projelere ve Visual Studio tarafından oluşturulan bir çözüme göre düzenler.

  • Ana Visual Studio menüsünde Unity Proje Gezgini'ni Görüntüle'yi > seçin. Klavye kısayolu: Alt+Shift E+

Screenshot of the Unity Project Explorer window.

  • Mac için Visual Studio'de, Unity projesi açıldığında Çözüm Bölmesi otomatik olarak bu şekilde davranır.

Unity hata ayıklaması

Unity için Visual Studio Araçları, Visual Studio'nun güçlü hata ayıklayıcısını kullanarak Unity projeniz için hem düzenleyici hem de oyun betiklerinin hatalarını ayıklamanıza olanak tanır.

Unity düzenleyicisinde hata ayıklama

Hata ayıklamayı başlatma

  1. Visual Studio'yu Unity'ye Bağlan için Unity'ye Ekle etiketli Yürüt düğmesi veya F5 klavye kısayolunu kullanın.

Screenshot of the Attach to Unity button in Visual Studio.

  1. Visual Studio'yu Unity'ye Bağlan için Yürüt düğmesi veya Command + Return veya F5 yazın.

Screenshot of the Play button in Visual Studio for Mac.

  1. Unity'ye geçin ve oyunu düzenleyicide çalıştırmak için Oynat düğmesine tıklayın.

Screenshot of the Play button in Unity on Windows.

Screenshot of the Play button in Unity on macOS.

  1. Oyun Visual Studio'ya bağlıyken Unity düzenleyicisinde çalıştırıldığında, karşılaşılan kesme noktaları oyunun yürütülmesini duraklatır ve oyunun Visual Studio'daki kesme noktasına geldiği kod satırını getirir.

Hata ayıklamayı durdurma

Visual Studio'da Durdur düğmesine tıklayın veya Shift + F5 klavye kısayolunu kullanın.

Screenshot of the Stop button in Visual Studio.

Mac için Visual Studio'da Durdur düğmesine tıklayın veya Shift + Command + Return tuşlarına basın.

Screenshot of the Stop button in Visual Studio for Mac.

Visual Studio'da hata ayıklama hakkında daha fazla bilgi edinmek için bkz . Visual Studio Hata Ayıklayıcı...

Unity ve Play'e ekleme

Daha fazla kolaylık sağlamak için Unity'ye Ekle düğmesini Unity ve Play moduna ekle olarak değiştirebilirsiniz.

  1. Unity'ye Ekle düğmesinin yanındaki küçük aşağı oka tıklayın.

  2. Açılan menüden Unity'ye Ekle ve Oynat'ı seçin.

    Screenshot of the Attach and play button in Visual Studio.

Yürüt düğmesi Unity ve Play'e Ekle olarak etiketlenir. Bu düğmeye tıklamak veya F5 klavye kısayolunu kullanmak artık unity düzenleyicisine otomatik olarak geçer ve Visual Studio hata ayıklayıcısını eklemeye ek olarak oyunu düzenleyicide çalıştırır.

Unity düzenleyicisinde hata ayıklamayı başlatma ve yürütme, Unity ve Play'e Ekle yapılandırması seçilerek doğrudan Mac için Visual Studio tek bir adımda tamamlanabilir.

Screenshot of the Attach to Unity and Play button in Visual Studio for Mac.

Dekont

Unity ve Play'e Ekle yapılandırmasını kullanarak hata ayıklamaya başladıysanız, Durdur düğmesi Unity Düzenleyicisi'ni de durdurur.

Unity oynatıcı derlemelerinde hata ayıklama

Visual Studio ile Unity oyuncularının geliştirme derlemelerinde hata ayıklayabilirsiniz.

Unity oynatıcısında betik hata ayıklamasını etkinleştirme

  1. Unity'de, Dosya > Derleme Ayarlar'ni seçerek Derleme Ayarlar açın.

  2. Derleme Ayarlar penceresinde Geliştirme Derlemesi ve Betik Hata Ayıklama onay kutularını işaretleyin.

    Screenshot of the Unity build settings for debugging.

Hata ayıklayıcıyı eklemek için bir Unity örneği seçin

  • Visual Studio'da, ana menüde Unity Hata Ayıklayıcısı Ekleme Hatalarını Ayıkla'yı > seçin.

    Screenshot of the Attach Unity Debugging Window in Visual Studio.

    Unity Örneğini Seç iletişim kutusunda bağlanabileceğiniz her Unity örneği hakkında bazı bilgiler görüntülenir.

    Screenshot of the Choose an instance of Unity to connect to window in Visual Studio.

    Project Bu Unity örneğinde çalışan Unity projesinin adı.

    Makine Bu Unity örneğinin üzerinde çalıştığı bilgisayarın veya cihazın adı.

    Unity'nin bu örneği Unity Düzenleyicisi'nin bir parçası olarak çalışıyorsa Düzenleyici yazın ; Unity'nin bu örneği tek başına bir oyuncuysa oyuncu.

    Bağlantı Noktası Bu Unity örneğinin iletişimde olduğu UDP yuvasının bağlantı noktası numarası.

Önemli

Unity için Visual Studio Araçları ve Unity örneği bir UDP ağ yuvası üzerinden iletişimde olduğundan, güvenlik duvarınızın buna izin vermek için kurala ihtiyacı olabilir. Gerekirse, VSTU ve Unity'nin iletişim kurabilmesi için bağlantıyı yetkilendirmeniz gereken bir istem görebilirsiniz.

Listede görünmeyen bir Unity örneği seçme

Listede görünmeyen bilinen bir Unity Player çalıştırıyorsanız Unity Örneği Seç penceresindeki Giriş IP'sini kullanabilirsiniz. Hata ayıklayıcıyı bağlamak için çalışan Unity Player'ın IP adresini ve bağlantı noktasını girin.

Her seferinde IP'ye ve bağlantı noktasına girmeden bu oynatıcıda hata ayıklamaya devam etmenizi kolaylaştırmak için Unity Genel için Araçlar > Seçenekler > Araçları menüsünde Kayıtlı hata ayıklama hedeflerini kullan ayarını etkinleştirin.>

Screenshot of the Use saved debug targets setting.

Visual Studio, Unity'ye Ekle düğmesinde kaydedilmiş hata ayıklama hedeflerini bir seçenek olarak gösterir.

Screenshot of the Saved debug target setting.

  • Mac için Visual Studio üstteki menüde İşleme Ekle'yi çalıştır'ı >seçin.
  • İşleme Ekle iletişim kutusunda, alttaki Hata Ayıklayıcısı açılan menüsünde Unity Debugger seçeneğini belirleyin.
  • Listeden bir Unity örneği seçin ve Ekle düğmesine tıklayın.

Unity projenizde DLL hatalarını ayıklama

Birçok Unity geliştiricisi, geliştirdikleri işlevselliğin diğer projelerle kolayca paylaşılabilmesi için kod bileşenlerini dış DLL'ler olarak yazıyor. Unity için Visual Studio Araçları, Unity projenizdeki diğer kodlarla bu DLL'lerdeki kodun hatalarını sorunsuz bir şekilde ayıklamayı kolaylaştırır.

Dekont

Şu anda Unity için Visual Studio Araçları yalnızca yönetilen DLL'leri destekler. C++ dilinde yazılanlar gibi yerel kod DLL'lerinde hata ayıklamayı desteklemez.

Burada açıklanan senaryoda kaynak kodunuz olduğu varsayılır; yani kendi birinci taraf kodunuzu geliştirir veya yeniden kullanırsınız ya da kaynak kodunuz üçüncü taraf bir kitaplığa aktarılır ve Unity projenizde DLL olarak dağıtılır. Bu senaryo, kaynak koduna sahip olmadığınız bir DLL'de hata ayıklamayı açıklamaz.

Unity projenizde kullanılan yönetilen DLL projesinde hata ayıklamak için

  1. Var olan DLL projenizi Unity için Visual Studio Araçları tarafından oluşturulan Visual Studio çözümüne ekleyin. Daha az yaygın olarak Unity projenizde kod bileşenlerini içerecek yeni bir yönetilen DLL projesi başlatıyor olabilirsiniz; Bu durumda, bunun yerine Visual Studio çözümüne yeni bir yönetilen DLL projesi ekleyebilirsiniz.

    Screenshot of the Add > Existing Item menu.

    Her iki durumda da, proje ve çözüm dosyalarını yeniden oluşturması gerekse bile Unity için Visual Studio Araçları proje başvuruyu korur, bu nedenle bu adımları yalnızca bir kez gerçekleştirmeniz gerekir.

  2. DLL projesinde doğru Unity çerçeve profiline başvurun. Visual Studio'da, DLL projesinin özelliklerinde Target framework özelliğini kullandığınız Unity framework sürümüne ayarlayın. Bu, Unity tam, mikro veya web temel sınıf kitaplıkları gibi projenizin hedeflediği API uyumluluğuyla eşleşen Unity Temel Sınıf Kitaplığıdır. Bu, DLL'nizin diğer çerçevelerde veya uyumluluk düzeylerinde bulunan ancak kullandığınız Unity framework sürümünde mevcut olmayan çerçeve yöntemlerini çağırmasını engeller.

Dekont

Aşağıdakiler yalnızca Unity'nin eski çalışma zamanını kullanıyorsanız gereklidir. Yeni Unity çalışma zamanını kullanıyorsanız, bu ayrılmış 3.5 profillerini artık kullanmanız gerekmez. Unity sürümünüzle uyumlu bir .NET 4.x profili kullanın.

Screenshot of the selecting target framework for a project in Visual Studio.

  1. DLL'yi Unity projenizin Asset klasörüne kopyalayın. Unity'de varlıklar, çalışma zamanında yüklenebilmeleri için Unity uygulamanızla birlikte paketlenip dağıtılan dosyalardır. DLL'ler çalışma zamanında bağlandığından, DLL'lerin varlık olarak dağıtılması gerekir. Unity Düzenleyicisi, varlık olarak dağıtılması için DLL'lerin Unity projenizdeki Varlıklar klasörüne koyulmalarını gerektirir. Bunu yapmanın iki yolu vardır:

    • DLL projenizin derleme ayarlarını, çıktı DLL'sini ve PDB dosyalarını çıktı klasöründen Unity projenizin Assets klasörüne kopyalayan, yerleşik bir görev içerecek şekilde değiştirin.

    • DLL projenizin derleme ayarlarını değiştirerek çıkış klasörünü Unity projenizin Assets klasörü olarak ayarlayın. Hem DLL hem de PDB dosyaları Varlıklar klasörüne yerleştirilir.

    DLL'nin hata ayıklama simgelerini içerdiğinden ve DLL kodunu kaynak kod formuna eşlediklerinden, hata ayıklama için PDB dosyaları gereklidir. Eski çalışma zamanını hedef alıyorsanız, Unity için Visual Studio Araçları DLL ve PDB'deki bilgileri kullanarak eski Unity betik altyapısı tarafından kullanılan hata ayıklama sembol biçimi olan bir DLL.MDB dosyası oluşturur. Yeni çalışma zamanını hedef alıyorsanız ve Portable-PDB kullanıyorsanız, yeni Unity çalışma zamanı Taşınabilir PDB'leri yerel olarak kullanabildiğinden Unity için Visual Studio Araçları herhangi bir simge dönüştürme işlemi gerçekleştirmeyi denemez.

    PDB oluşturma hakkında daha fazla bilgiyi burada bulabilirsiniz. Yeni çalışma zamanını hedeflediyseniz, Taşınabilir PDB'yi düzgün bir şekilde oluşturmak için "Hata Ayıklama Bilgileri"nin "Taşınabilir" olarak ayarlandığından emin olun. Eski çalışma zamanını hedeflediyseniz "Tam" kullanmanız gerekir.

  2. Kodunuzun hatalarını ayıklayın. Artık DLL kaynak kodunuzun hatalarını Unity projenizin kaynak koduyla birlikte ayıklayabilir ve kesme noktaları ve kodda adımlama gibi alışkın olduğunuz tüm hata ayıklama özelliklerini kullanabilirsiniz.

Klavye kısayolları

Visual Studio için Unity Araçları işlevselliğine klavye kısayollarını kullanarak hızla erişebilirsiniz. Kullanılabilir kısayolların özeti aşağıdadır.

Command Kısayol Kısayol komut adı
MonoBehavior Sihirbazı'nı açma Ctrl+Shift M+ EditorContextMenus.CodeWindow.ImplementMonoBehaviours
Unity Proje Gezgini'ni açma Alt+Shift+E View.UnityProjectExplorer
Unity belgelerine erişme Ctrl+Alt+M, Ctrl H+ Help.UnityAPIReference
Unity hata ayıklayıcısına ekleme (oynatıcı veya düzenleyici) varsayılan yok Debug.AttachUnityDebugger

Varsayılanı beğenmezseniz kısayol tuş bileşimlerini değiştirebilirsiniz. Nasıl değiştirileceği hakkında bilgi için bkz . Visual Studio'da klavye kısayollarını tanımlama ve özelleştirme.

Command Kısayol Kısayol komut adı
MonoBehavior Sihirbazı'nı açma Cmd+Shift+M EditorContextMenus.CodeWindow.ImplementMonoBehaviours
Unity belgelerine erişme Cmd+' Help.UnityAPIReference

Varsayılanı beğenmezseniz kısayol tuş bileşimlerini değiştirebilirsiniz. Değiştirme hakkında bilgi için bkz . IDE'yi özelleştirme.