Hozzájárulás az MRTK2-höz

  • Cikk

Mixed Reality Toolkit (MRTK) üdvözli a közösség hozzájárulását. A nagy vagy kicsi módosításoknak meg kell felelnie az MRTK kódolási szabványainak. Győződjön meg arról, hogy ismeri ezeket a fejlesztés során, hogy elkerülje a módosítások felülvizsgálatakor bekövetkező késéseket.

Ha kérdése van, lépjen kapcsolatba a Slack mixed-reality-toolkit csatornáján. A Slack-közösséghez az automatikus meghívó küldője segítségével csatlakozhat.

Beküldési folyamatok

Számos olyan útvonalat biztosítunk, amellyel a fejlesztők hozzájárulhatnak Mixed Reality Eszközkészlethez, mindezt egy új probléma létrehozásával kezdve.

Problématípus kiválasztása

Innen a következő fájlt kell beszenvedni:

  • Hibajelentés – Az eszközkészlet Mixed Reality egyik összetevőjével kapcsolatos működési probléma
  • Dokumentációs probléma – A Mixed Reality Toolkit dokumentációjával kapcsolatos probléma
  • Funkciókérés – Javaslat új Mixed Reality eszközkészlet-funkcióra

Javaslattétel funkciókérésekre

Amikor új Mixed Reality Toolkit funkciót kér, fontos dokumentálni az ügyfél előnyét/ a megoldandó problémát. A beküldést követően a githubon áttekintjük és megvitatjuk a funkciókérést. Javasoljuk az egyes funkciójavaslatok nyílt és konstruktív megvitatását annak biztosítása érdekében, hogy a munka előnyös legyen az ügyfelek nagy szegmense számára.

A funkció újradolgozásának elkerülése érdekében javasoljuk, hogy a funkció fejlesztése ne kezdődjön meg a felülvizsgálati fázisban. A közösségi felülvizsgálati folyamat számos alkalommal feltár egy vagy több olyan problémát, amely jelentős változásokat igényelhet a javasolt végrehajtásban.

Megjegyzés

Ha olyan dologon szeretne dolgozni, amely már létezik a teendőlistán, ezt a munkaelemet használhatja javaslatként. Ne felejtse el megjegyzést fűzni a feladathoz, amely értesíti a karbantartókat arról, hogy ön dolgozik a feladat befejezésén.

Hozzájárulási folyamat

A kezdéshez hajtsa végre az alábbi lépéseket:

  1. Az adattár elágazása. Kattintson az oldal jobb felső sarkában található "Elágazás" gombra, és kövesse a folyamatot.
  2. Hozzon létre egy ágat az elágaztatásban (a főágon kívül), hogy könnyebb legyen elkülöníteni a módosításokat, amíg készen nem áll a beküldésre. A kiadásstabilizálási időszak alatti hibajavításokért keresse meg a legújabb prerelease/* ágat. Az új funkcióknak mindig a következőt kell használniuk main: .

Ha még nem ismerkedik a Git-munkafolyamatokkal, tekintse meg ezt a githubos bevezetést.

Hibajavítás vagy szolgáltatás hozzáadásakor kövesse az alábbi lépéseket:

  1. Implementálja a hibajavítást vagy a funkciót. Az MRTK kiépítésére és üzembe helyezésére vonatkozó utasítások a HoloLens- és WMR-eszközökre való üzembe helyezéssel kapcsolatosak. Ne felejtse el követni a kódolási irányelveket.
  2. Ha hozzáad egy funkciót, adjon hozzá egy példajelenetet is, amely bemutatja a funkciót.
  3. Ha kísérleti funkciót ad hozzá, akkor nem szükséges teszteket és dokumentációt írni. Ehelyett kövesse a kísérleti funkciókra vonatkozó irányelveket.
  4. Adjon hozzá teszteket a hibajavítás/funkció ellenőrzéséhez. A tesztek írására és futtatására vonatkozó utasítások a UnitTests helyen találhatók.
  5. Győződjön meg arról, hogy a kód és a szolgáltatás(ok) dokumentálva vannak a dokumentációs útmutatóban leírtak szerint.
  6. Győződjön meg arról, hogy a kód az összes platformon a kívánt módon működik. A támogatott platformok listájáért tekintse meg a kibocsátási megjegyzéseket . Windows UWP-projektek esetén a kódnak WACK-kompatibilisnek kell lennie. Ehhez hozzon létre egy Visual Studio-megoldást, kattintson a jobb gombbal a projektre; Tárolja>Alkalmazáscsomagok létrehozása. Kövesse az utasításokat, és futtassa a WACK-teszteket. Győződjön meg arról, hogy mindegyik sikeres.
  7. A lekéréses kérelmek létrehozásakor kövesse a Lekéréses kérelmek című témakör utasításait.