MRTK 'a katkıda bulunma

Karma Gerçeklik araç seti (MRTK), topluluk katkılarıyla birlikte gelir. Küçük veya büyük olan tüm değişiklikler, mrtk kodlama standartlarınauymaları gerekir, bu nedenle, değişiklik incelenirken gecikmelerden kaçınmak için geliştirme yaparken lütfen bu adımları tanıdıklarından emin olun.

Herhangi bir sorunuz varsa lütfen bolluk üzerinde Mixed-Reality-Toolkit kanalınaulaşın. Bolluk topluluğuna Otomatik davet göndericiaracılığıyla katılabilmeniz gerekir.

Gönderme işlemi

Geliştiricilerin karma gerçeklik araç setine katkıda bulunmasını sağlamak için çeşitli yollar sunuyoruz. Bu, Yeni bir sorun oluşturmayabaşlar.

Sorun türünü seçin

Buradan dosyanızı:

  • Hata raporu -karma gerçeklik araç seti bileşenlerinden biriyle ilgili işlevsellik sorunu
  • Belge sorunu -karma gerçeklik araç seti belgeleriyle ilgili sorun
  • Özellik isteği -yeni bir karma gerçeklik araç seti özelliği için teklif

Özellik istekleri önerme

Yeni bir karma gerçeklik araç seti özelliği istenirken, müşterinin sağladığı avantajı/sorunu belgelemek önemlidir. Gönderildikten sonra bir özellik isteği gözden geçirilir ve GitHub açıklanacaktır. Çalışmanın büyük bir müşteri segmentine kadar yararlı olduğundan emin olmak için her bir özellik teklifinin açık ve ayrıntılı tartışmasına teşvik ediyoruz.

Özelliği yeniden çalışma gereksiniminden kaçınmak için, bu özellik geliştirmenin, gözden geçirme aşamasında başlamamasına gerek kalmadan genellikle önerilir. Birçok kez, topluluk İnceleme işlemi, önerilen uygulamada önemli değişiklikler gerektirebilecek bir veya daha fazla sorunu kapsamıyor.

Not

Kapsamımızda zaten mevcut olan bir şey üzerinde çalışmak istiyorsanız bu iş öğesini teklifiniz olarak kullanabilirsiniz. Ayrıca, uygulamayı tamamlamak için çalışmakta olduğunuz bakım ve görev hakkında yorum yaptığınızdan emin olun.

Katkı süreci

Başlamak için aşağıdaki adımları izlemeniz yeterlidir:

  1. Depoyu çatalla. Sayfanın sağ üst kısmındaki "çatal" düğmesine tıklayın ve akışı izleyin.
  2. Herhangi bir değişikliği, gönderim için hazırlanana kadar kolaylaştırmak için çatalınızda ( ana daldan kapalı) bir dal oluşturun. Yayın sabitlemesi sırasında hata düzeltmeleri için en son prerelease/* dalı arayın. Yeni özellikler her zaman ' e gitmelidir main .

Git iş akışına yeni çalışıyorsanız, GitHub 'dan bu girişegöz atın.

Bir hata düzeltmesini veya özelliğini eklerken şu adımları izleyin:

  1. Hata düzeltmesini veya özelliğini uygulayın. MRTK oluşturma ve dağıtmaya yönelik yönergeler, HoloLens ve WMR cihazlarına dağıtılmakta. Kodlama yönergeleriniizlemeyi unutmayın.
  2. Özellik ekliyorsanız, özelliği gösteren örnek bir sahne da ekleyin.
  3. Deneysel Özellik ekliyorsanız, test ve belge yazma gerekli değildir. Bunun yerine deneysel Özellik kılavuzlarınıizleyin.
  4. Hata düzeltmesini/özelliğini doğrulamak için testler ekleyin. Testleri yazma ve çalıştırmaya yönelik yönergeler unittests'lardır.
  5. Kod ve özelliklerin, belge yönergeleribölümünde açıklandığı gibi belgelendiğinden emin olun.
  6. Kodun tüm platformlarda istendiği gibi çalıştığından emin olun. Lütfen Desteklenen platformların listesi için sürüm notlarına bakın. Windows UWP projeleri için, kod wack uyumluolmalıdır. bunu yapmak için, bir Visual Studio çözümü oluşturun, projeye sağ tıklayın; MağazaUygulama paketleri oluşturun. İstemleri izleyin ve WACK testlerini çalıştırın. Bunların tümünün başarılı olduğundan emin olun.
  7. Çekme isteği yaparken çekme Isteklerindeki yönergeleri izleyin.