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.


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.

- 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.

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:
İmleci, ' den türetilen bir sınıfın gövdesinin içine yeni bir satıra yerleştirin
MonoBehaviour.Bir Unity iletisinin adını yazmaya başlayın, örneğin
OnTriggerEnter."Ontri" harfleri yazıldıktan sonra, bir IntelliSense önerisi listesi görüntülenir.

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.
IntelliSense, gerekli parametreler dahil olmak üzere seçili Unity iletisini ekleyebilir:
Sekmesine basarak.
ENTER tuşuna basarak.
Seçili öğeye çift tıklayarak.

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:
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.
Betik yöntemleri oluştur penceresinde, eklemek istediğiniz her yöntemin adının yanındaki onay kutusunu işaretleyin.
İstediğiniz sürümü seçmek için Framework sürümü açılan listesini kullanın.
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.
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.
Sihirbazdan çıkmak için Tamam düğmesini seçin ve yöntemleri kodunuza ekleyin.


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

- 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
- unity 'ye ekle etiketli oynat düğmesine tıklayarak unity 'ye Visual Studio Bağlan veya F5 klavye kısayolunu kullanın.

- oynat düğmesine tıklayarak Unity 'ye Visual Studio Bağlan veya Command + Return ya da F5 yazın.

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


- 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.

Mac için Visual Studio durdur düğmesine tıklayın veya shıft + Command + Return tuşlarına bası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.
- Unity 'ye Ekle düğmesinin yanındaki küçük aşağı oka tıklayın.
- Unity 'ye Ekle ve açılır menüden Oynat ' ı seçin.

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.

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
Unity 'de, derleme Ayarlar dosya > build Ayarlar' i seçerek açın.
derleme Ayarlar penceresinde, geliştirme derlemesi ve betik hata ayıklama onay kutularını işaretleyin.

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 örneği Seç iletişim kutusu, bağlandığınız her Unity örneğiyle ilgili bazı bilgileri görüntüler.

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
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.

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.
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 '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.
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.