Share via

Bijdragen aan MRTK2

  • Artikel

Mixed Reality Toolkit (MRTK) verwelkomt bijdragen van de community. Alle wijzigingen, groot of klein, moeten voldoen aan de MRTK-coderingsstandaarden. Zorg ervoor dat u hiermee bekend bent tijdens het ontwikkelen om vertragingen te voorkomen wanneer de wijziging wordt gecontroleerd.

Als u vragen hebt, kunt u contact opnemen via het mixed reality-toolkit-kanaal op Slack. U kunt lid worden van de Slack-community via de automatische afzender van de uitnodiging.

Indieningsprocessen

We bieden verschillende paden waarmee ontwikkelaars kunnen bijdragen aan Mixed Reality Toolkit, allemaal te beginnen met het maken van een nieuw probleem.

Type probleem selecteren

Hier kunt u het volgende doen:

  • Foutenrapport: functionaliteitsprobleem met een van Mixed Reality Toolkit-onderdelen
  • Documentatieprobleem - Probleem met Mixed Reality Toolkit-documentatie
  • Functieaanvraag: voorstel voor een nieuwe functie Mixed Reality Toolkit

Functieaanvragen voorstellen

Wanneer u een nieuwe Mixed Reality Toolkit-functie aanvraagt, is het belangrijk om het voordeel/probleem van de klant te documenteren dat moet worden opgelost. Zodra een functieaanvraag is ingediend, wordt deze beoordeeld en besproken op GitHub. We moedigen een open en constructieve bespreking van elk functievoorstel aan om ervoor te zorgen dat het werk nuttig is voor een groot deel van de klanten.

Om te voorkomen dat de functie opnieuw moet worden bewerkt, is het raadzaam dat de ontwikkeling van de functie niet wordt gestart tijdens de beoordelingsfase. Vaak worden tijdens het beoordelingsproces van de community een of meer problemen aan het licht gebracht die aanzienlijke wijzigingen in de voorgestelde implementatie vereisen.

Notitie

Als u wilt werken aan iets dat al op onze achterstand staat, kunt u dat werkitem gebruiken als uw voorstel. Zorg ervoor dat u ook commentaar geeft op de taak om onderhouders te laten weten dat u eraan werkt om deze te voltooien.

Bijdrageproces

Volg deze stappen om aan de slag te gaan:

  1. Vertak de opslagplaats. Klik op de knop "Fork" rechtsboven op de pagina en volg de stroom.
  2. Maak een vertakking in uw fork (buiten de hoofdbranch) om het gemakkelijker te maken om wijzigingen te isoleren totdat u klaar bent voor verzending. Zoek naar de meest recente prerelease/* vertakking voor oplossingen tijdens een releasestabilisatieperiode. Nieuwe functies moeten altijd worden opgenomen in main.

Als de Git-werkstroom nieuw voor u is, bekijkt u deze inleiding van GitHub.

Wanneer u een bugfix of functie toevoegt, volgt u deze stappen:

  1. Implementeer de foutoplossing of -functie. Instructies voor het bouwen en implementeren van MRTK staan op Implementeren op HoloLens- en WMR-apparaten. Vergeet niet om de coderingsrichtlijnen te volgen.
  2. Als u een functie toevoegt, voegt u ook een voorbeeldscène toe waarin de functie wordt gedemonstreert.
  3. Als u een experimentele functie toevoegt, hoeft u geen tests en documentatie te schrijven. Volg in plaats daarvan de richtlijnen voor experimentele functies.
  4. Voeg tests toe om de foutoplossing/-functie te controleren. Instructies voor het schrijven en uitvoeren van tests vindt u op UnitTests.
  5. Zorg ervoor dat de code en functie(s) zijn gedocumenteerd zoals beschreven in de documentatierichtlijnen.
  6. Zorg ervoor dat de code werkt zoals bedoeld op alle platforms. Zie de opmerkingen bij de release voor de lijst met ondersteunde platforms. Voor Windows UWP-projecten moet code WACK-compatibel zijn. Hiervoor genereert u een Visual Studio-oplossing en klikt u met de rechtermuisknop op het project. Winkel>App-pakketten maken. Volg de aanwijzingen en voer WACK-tests uit. Zorg ervoor dat ze allemaal slagen.
  7. Volg de instructies in Pull-aanvragen bij het maken van een pull-aanvraag.