MRTK2'ye katkıda bulunma

Karma Gerçeklik Araç Seti (MRTK), topluluktan gelen katkıları memnuniyetle karşılar. Büyük veya küçük tüm değişikliklerin MRTK kodlama standartlarına uyması gerekir. Değişiklik gözden geçirilirken gecikmeleri önlemek için geliştirme yaparken lütfen bunları bildiğinizden emin olun.

Sorularınız varsa lütfen Slack'te karma gerçeklik araç seti kanalından ulaşın. Slack topluluğuna otomatik davet gönderen aracılığıyla katılabilirsiniz.

Gönderim işlemleri

Geliştiricilerin yeni bir Sorun oluşturmaya başlayarak Karma Gerçeklik Araç Seti'ne katkıda bulunmalarını sağlamak için çeşitli yollar sunuyoruz.

Buradan şunları dosyalarsını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 talep ederken, çözülecek müşteri avantajını / sorununu belgelemeniz önemlidir. Bir özellik isteği gönderildikten sonra GitHub'da gözden geçirilir ve tartışılır. Çalışmanın büyük bir müşteri kesimi için yararlı olduğundan emin olmak için her özellik teklifinin açık ve yapıcı bir şekilde tartışılmasını öneririz.

Özelliğin yeniden çalışılmasını önlemek için, gözden geçirme aşamasında özelliğin geliştirilmesinin başlamaması önerilir. Topluluk gözden geçirme süreci çoğu zaman önerilen uygulamada önemli değişiklikler gerektirebilecek bir veya daha fazla sorunu ortaya çıkarır.

Not

Kapsamımızda zaten var olan bir şey üzerinde çalışmak istiyorsanız, teklifiniz olarak bu iş öğesini kullanabilirsiniz. Ayrıca, bakımcılara görevi tamamlamak için çalıştığınızı bildiren bir açıklama da yaptığınızdan emin olun.

Katkı süreci

Başlamak için şu adımları izleyin:

1. Deponun çatalını oluşturun. Sayfanın sağ üst kısmındaki "Çatal" düğmesine tıklayın ve akışı izleyin.
2. Değişiklikleri göndermeye hazır olana kadar yalıtmayı kolaylaştırmak için çatalınızda ( ana dal dışında) bir dal oluşturun. Yayın dengeleme döneminde hata düzeltmeleri için en son prerelease/* dalı arayın. Yeni özelliklerin her zaman içine gitmesi maingerekir.

Git iş akışında yeniyseniz GitHub'dan bu girişe göz atın.

Hata düzeltmesi veya özelliği eklerken şu adımları izleyin:

1. Hata düzeltmesini veya özelliğini uygulayın. MRTK oluşturma ve dağıtma yönergeleri HoloLens ve WMR cihazlarına dağıtma başlığı altında verilmiştir. Kodlama Yönergeleri'ni izlemeyi unutmayın.
2. Özellik ekliyorsanız, özelliği gösteren örnek bir sahne de ekleyin.
3. Deneysel bir özellik ekleniyorsa testler ve belgeler yazmak gerekli değildir. Bunun yerine deneysel özellik yönergelerini izleyin.
4. Hata düzeltmesini / özelliğini doğrulamak için testler ekleyin. Test yazma ve çalıştırma yönergeleri UnitTests'tedir.
5. Kod ve özelliklerin Belge Yönergeleri'nde açıklandığı gibi belgelenmiş olduğundan emin olun.
6. Kodun tüm platformlarda amaçlandığı gibi çalıştığından emin olun. Desteklenen platformların listesi için Sürüm notları'na bakın. Windows UWP projeleri için kod WACK uyumlu olmalıdır. Bunu yapmak için bir Visual Studio çözümü oluşturun, projeye sağ tıklayın; Mağazası>Uygulama Paketleri oluşturma. İstemleri izleyin ve WACK testlerini çalıştırın. Hepsinin başarılı olduğundan emin olun.
7. Çekme isteği oluştururken Çekme İstekleri başlığındaki yönergeleri izleyin.