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ıyı kullanmayı öğreneceksiniz.

Unity betiklerini Visual Studio açın

Visual Studio unity için dış düzenleyici olarakayarlandıktan sonra, unity düzenleyiciden bir betiğe çift tıklanması otomatik olarak başlatılır veya Visual Studio ve seçilen betiği açar.

alternatif olarak, Unity 'de C# Project menüsünü aç > varlıkları seçerek kaynak düzenleyicide açık betik olmadan Visual Studio açabilirsiniz.

Visual Studio C# projesi açın

Mac için Visual Studio C# projesi açın

Unity belge erişimi

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

  • Visual Studio, imleci, hakkında bilgi edinmek istediğiniz Unity apı 'sinin üzerine getirin veya yerleştirin, sonra ctrl + Alt + M, ctrl + H tuşlarına basın
  • KeyBinding yerine, yardım > UNITY API başvurusu menüsünü de kullanabilirsiniz. Visual Studio 'da Unity API başvuru menüsü
  • Mac için Visual Studio, imleci, hakkında bilgi edinmek istediğiniz Unity apı 'sinin üzerine getirin veya yerleştirin, sonra Cmd + ' tuşuna basın
  • KeyBinding yerine, yardım > UNITY API başvurusu menüsünü de kullanabilirsiniz. Mac için Visual Studio 'da Unity apı başvuru menüsü

Unity API Iletileri için IntelliSense

IntelliSense kod tamamlama, tek davranış betiklerine Unity API iletilerinin uygulanmasını kolaylaştırır ve Unity API 'sini öğrenmeye yardımcı olur. Unity iletileri için IntelliSense 'i kullanmak için:

  1. İmleci, ' den türetilen bir sınıfın gövdesinin içine yeni bir satıra yerleştirin MonoBehaviour .

  2. Bir Unity iletisinin adını yazmaya başlayın, örneğin OnTriggerEnter .

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

Visual Studio içinde IntelliSense kullanma

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

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

    • İstenen öğenin üzerine fareyle tıklanarak.

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

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

    • Sekmesine basarak.

    • ENTER tuşuna basarak.

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

Visual Studio içinde IntelliSense 'ten Unity iletisi ekleme

Unity MonoBehavior betik Sihirbazı

Tek davranış Sihirbazı ' nı kullanarak tüm Unity API yöntemlerinin bir listesini görüntüleyebilir ve boş bir tanımı hızlıca uygulayabilirsiniz. Bu özellik özellikle, Yöntem açıklamalarını oluştur seçeneği etkinken, Unity API 'sinde nelerin kullanılabildiğini öğrenseniz yararlı olur.

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

  1. Visual Studio, imleci, yöntemlerin eklenmesini istediğiniz yere konumlandırın, sonra + + monobehavior sihirbazını başlatmak için Ctrl shıft e tuşlarına basın. Mac için Visual Studio ' de Cmd + Shift + e 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 İmlecin konumuna eklenir. Alternatif olarak, ekleme noktası açılır listesinin değerini istediğiniz konuma değiştirerek, sınıfınıza zaten uygulanmış herhangi bir yöntemden sonra bunları eklemeyi seçebilirsiniz.

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

  6. Sihirbazdan çıkmak için Tamam düğmesini seçin ve yöntemleri kodunuza ekleyin.

Visual Studio içindeki MonoBehavior Sihirbazı iletişim kutusu.

Mac için Visual Studio içindeki monobehavior sihirbazı iletişim kutusu.

Unity Project gezgini

unity Project gezgini, unity düzenleyiciyle aynı şekilde tüm unity proje dosyalarınızı ve dizinlerinizi gösterir. bu, Unity betiklerinizde, bunları projeler ve Visual Studio tarafından oluşturulan bir çözüm olarak düzenleyen normal Visual Studio Çözüm Gezgini ile gezinmeden farklıdır.

  • ana Visual Studio menüsünde görünüm > Unity Project gezgini' ni seçin. klavye kısayolu: Alt + Shift + E  , Unity Project gezgin penceresini görüntüleyin.
  • Mac için Visual Studio, bir 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 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şlat

  1. unity 'ye ekle etiketli oynat düğmesine tıklayarak unity 'ye Visual Studio Bağlan veya F5 klavye kısayolunu kullanın. Visual Studio içinde oynat ' ı tıklatın
  1. oynat düğmesine tıklayarak Unity 'ye Visual Studio Bağlan veya Command + Return ya da F5 yazın. Mac için Visual Studio içinde oynat ' ı tıklatın
  1. Unity 'ye geçin ve oyunu düzenleyicide çalıştırmak için Yürüt düğmesine tıklayın.

Windows için Unity 'de oynat ' a tıklayın

MacOS 'ta Unity 'de Yürüt ' e tıklayın

  1. oyun, Visual Studio bağlı durumdayken Unity düzenleyicisinde çalışırken, karşılaştığı herhangi bir kesme noktası oyunun yürütülmesini duraklatır ve oyunun Visual Studio kesme noktasına isabet ettiği kod satırını getirir.

Hata ayıklamayı Durdur

Visual Studio durdur düğmesine tıklayın veya klavye kısayolunun shıft + F5 tuşlarını kullanın. Visual Studio Durdur ' a tıklayın

Mac için Visual Studio durdur düğmesine tıklayın veya shıft + Command + Return tuşlarına basın. Mac için Visual Studio durdur ' a tıklayın

Visual Studio 'de hata ayıklama hakkında daha fazla bilgi için bkz. Visual Studio hata ayıklayıcısınabakın.

Unity 'ye Ekle ve Yürüt

Ek kolaylık sağlamak için Unity 'ye Ekle düğmesini, Unity ve Play moduna eklemek için değiştirebilirsiniz.

  1. Unity 'ye Ekle düğmesinin yanındaki küçük aşağı oka tıklayın.
  2. Unity 'ye Ekle ve açılır menüden Oynat ' ı seçin. Visual Studio iliştirme ve yürütme

Oynat düğmesi, Unity 'ye Ekle ve Yürüt şeklinde etiketlenmiş hale gelir. bu düğmeye tıkladığınızda veya klavye kısayolunun F5 'i kullanmak artık Unity düzenleyicisine otomatik olarak geçer ve Visual Studio hata ayıklayıcıyı eklemenin yanı sıra oyunu düzenleyicide çalıştırır.

unity 'nin hata ayıklamasının başlaması ve unity düzenleyicisi 'nin yürütülmesi, unity 'ye ekle ve çalıştır yapılandırması seçilerek Mac için Visual Studio doğrudan tek bir adımda tamamlanabilir.

Unity 'ye ekle ve Mac için Visual Studio oynat ' ı seçin

Not

Unity 'ye Ekle ve Çalıştır yapılandırmasını kullanarak hata ayıklamaya başladıysanız, Durdur düğmesi de Unity düzenleyicisini durdurur.

<a name="debug-unity-player-builds">Unity oynatıcı Derlemeleriyle hata ayıkla

Visual Studio Unity oynatıcıların geliştirme Derlemeleriyle ilgili hata ayıklaması yapabilirsiniz.

Unity Player 'da betik hata ayıklamasını etkinleştirme

  1. Unity 'de, derleme Ayarlar dosya > build Ayarlar' i seçerek açın.

  2. derleme Ayarlar penceresinde, geliştirme derlemesi ve betik hata ayıklama onay kutularını işaretleyin.

    ![Hata ayıklama için Unity derleme ayarlarını yapılandırın.](../media/vs/vstu-debugging-build-settings.png "vstu_debugging_build_settings")

Hata ayıklayıcıyı iliştirmek için bir Unity örneği seçin

  • Visual Studio, ana menüdeki hata ayıkla > Unity hata ayıklayıcı ekle' yi seçin.

    Unity hata ayıklayıcısını iliştirin.

    Unity örneği Seç iletişim kutusu, bağlandığınız her Unity örneğiyle ilgili bazı bilgileri görüntüler.

    Bağlanılacak Unity örneğini seçin.

    Project

    Unity 'nin bu örneğinde çalışan Unity projesinin adı.

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

    Unity 'in bu örneği Unity Düzenleyicisi 'nin bir parçası olarak çalışıyorsa, tür Düzenleyici ; Bu Unity örneği tek başına bir oynatıcı ise oynatıcı .

    Bağlantı noktası Bu Unity örneğinin iletişim kurduğ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şim kurduğundan, güvenlik duvarınız buna izin vermek için kural gerekebilir. Gerekirse, bir istem görebilirsiniz, bu durumda, VSTU ve Unity 'nin iletişim kurabilmesi için bağlantıyı yetkilendirmeniz gerekir.

  • Mac için Visual Studio, üstteki menüden, işlemek için > çalıştır' ı seçin.
  • Işleme İliştir iletişim kutusunda, alt kısımdaki hata ayıklayıcı açılan menüsünde Unity hata ayıklayıcı 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ştirme işlevlerinin diğer projelerle kolayca paylaşılması için kod bileşenlerini dış dll 'Ler olarak yazıyor. Unity için Visual Studio Araçları, bu dll 'lerdeki kodun, Unity projenizdeki diğer kodla sorunsuz bir şekilde ayıklanabilmesini kolaylaştırır.

Not

şu anda Unity için Visual Studio Araçları yalnızca yönetilen dll 'leri destekler. C++ dilinde yazılmış olanlar gibi yerel kod dll 'Lerinde hata ayıklamayı desteklemez.

Burada açıklanan senaryo kaynak koda sahip olduğunuzu varsayar. Yani, kendi birinci taraf kodunuzu geliştirdiğinizi veya yeniden kullandığınızı veya bir üçüncü taraf kitaplığına kaynak kodu kullandığınızı ve bunu bir DLL olarak Unity projenizde dağıtmayı planladığınızı unutmayın. Bu senaryo, kaynak kodu olmayan bir DLL 'nin hata ayıklamasını tanımlamaz.

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

  1. mevcut 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şenleri içeren yeni bir yönetilen DLL projesi başlatıyorsunuz olabilirsiniz; bu durumda, bunun yerine Visual Studio çözümüne yeni bir yönetilen DLL projesi ekleyebilirsiniz.

    Varolan DLL projenizi çözüme ekleyin.

    her iki Unity için Visual Studio Araçları durumda da, proje başvurusunu ve çözüm dosyalarını yeniden oluşturmak zorunda olsa bile, bu adımları yalnızca bir kez gerçekleştirmeniz gerekir.

  2. DLL projesinde doğru Unity Framework profiline başvurun. Visual Studio ' de, DLL projesinin özelliklerinde, hedef framework özelliğini, kullanmakta olduğunuz Unity çerçevesi sürümüne ayarlayın. Bu, projenizin hedeflediği, Unity Full, mikro veya Web temel sınıf kitaplıkları gibi API uyumluluğuyla eşleşen Unity temel sınıf kitaplığıdır. Bu, DLL 'nizin diğer çerçeveler veya uyumluluk düzeylerinde bulunan ancak kullanmakta olduğunuz Unity çerçevesi sürümünde mevcut olmayan çerçeve yöntemlerini aramasını engeller.

Not

Yalnızca Unity 'nin eski çalışma zamanını kullanıyorsanız, şunlar gereklidir. Yeni Unity çalışma zamanını kullanıyorsanız, bu adanmış 3,5 profillerini artık kullanmanız gerekmez. Unity sürümünüz ile uyumlu bir .NET 4. x profili kullanın.

DLL 'nin hedef çerçevesini Unity çerçevesi olarak ayarlayın.

  1. DLL 'yi Unity projenizin varlık klasörüne kopyalayın. Unity 'de varlıklar, çalışma zamanında yüklenebilmeleri için paketlenmiş ve Unity uygulamanız ile birlikte dağıtılan dosyalardır. Dll 'Ler çalışma zamanında bağlı olduğundan, dll 'Ler varlık olarak dağıtılmalıdır. Bir varlık olarak dağıtılması için Unity Düzenleyicisi, dll 'Lerin Unity projenizdeki varlıklar klasörünün içine yerleştirilmesi gerekir. Bunu iki şekilde yapabilirsiniz:

    • DLL projenizin derleme ayarlarını, çıkış DLL ve PDB dosyalarını, çıktı klasöründen Unity projenizin varlıklar klasörüne kopyalayan bir oluşturma sonrası görevi içerecek şekilde değiştirin.

    • Çıkış klasörünü Unity projenizin varlıklar klasörü olacak şekilde ayarlamak için dll projenizin derleme ayarlarını değiştirin. Hem DLL hem de PDB dosyaları varlıklar klasörüne yerleştirilir.

    DLL 'nin hata ayıklama sembollerini içerdiğinden ve DLL kodunu kaynak kodu formuyla eşlediklerinden, PDB dosyaları hata ayıklama için gereklidir. eski çalışma zamanını hedefliyorsanız Unity için Visual Studio Araçları, eski Unity betik altyapısı tarafından kullanılan hata ayıklama sembol biçimi olan dll. MDB dosyasını oluşturmak için dll ve PDB 'den bilgi kullanacaktır. yeni bir çalışma zamanını hedefliyorsanız ve taşınabilir-PDB kullanıyorsanız, yeni Unity çalışma zamanı yerel olarak taşınabilir-pdb 'leri tüketebileceği için Unity için Visual Studio Araçları herhangi bir sembol dönüştürmesi yapmayı denemeyecektir.

    PDB oluşturma hakkında daha fazla bilgiyi buradabulabilirsiniz. Yeni çalışma zamanını hedefliyorsanız, taşınabilir-PDB ' yi düzgün bir şekilde oluşturmak için "hata ayıklama bilgileri" ın "taşınabilir" olarak ayarlandığından emin olun. Eski çalışma zamanını hedefliyorsanız, "Full" kullanmanız gerekir.

  2. Kodunuzda hata ayıklayın. Artık DLL kaynak kodunuzda, Unity projenizin kaynak kodu ile birlikte hata ayıklama yapabilir ve kesme noktaları ve kod üzerinden atlama gibi tüm hata ayıklama özelliklerini kullanabilirsiniz.

Klavye kısayolları

Visual Studio işlevselliği için Unity araçlarına, klavye kısayollarını kullanarak hızlı bir şekilde erişebilirsiniz. Mevcut kısayolların özeti aşağıda verilmiştir.

Komut Kısayol Kısayol komutu adı
MonoBehavior sihirbazını açın CTRL + SHIFT + A EditorContextMenus. CodeWindow. ImplementMonoBehaviours
Unity Project gezginini açın Alt + SHIFT + E View. Unityprojecbir
Unity belgelerine erişin CTRL + Alt + A, CTRL + H Help. UnityAPIReference
Unity hata ayıklayıcıya (oynatıcı veya düzenleyici) iliştirme Varsayılan değer yok Debug. AttachUnityDebugger

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

Komut Kısayol Kısayol komutu adı
MonoBehavior sihirbazını açın Cmd + SHIFT + A EditorContextMenus. CodeWindow. ImplementMonoBehaviours
Unity belgelerine erişin Cmd + ' Help. UnityAPIReference

Varsayılan ' i beğenmezseniz kısayol tuşu kombinasyonlarını değiştirebilirsiniz. Nasıl değiştirileceği hakkında bilgi için bkz. IDE 'yi Özelleştirme.