Hozzájárulás az MRTK-hoz

Az Mixed Reality Toolkit (MRTK) szívesen fogadja a közösség hozzájárulását. Minden módosítás legyen kicsi vagy nagy, meg kell felelnie az MRTKkódolási szabványának, ezért a fejlesztés során győződjön meg arról, hogy jól ismeri ezeket, hogy elkerülje a módosítás felülvizsgálata során esetleg esetleg késéseket.

Ha kérdése van, lépjen fel a Mixed-reality-toolkit csatornára a Slacken. A Slack-közösséghez az automatikus meghívóküldőn keresztül csatlakozhat.

Beküldési folyamat

Számos olyan útvonalat biztosítunk, amelyek lehetővé teszik a fejlesztők számára, hogy hozzájáruljanak a Mixed Reality Eszközkészlethez, egy új probléma létrehozásával kezdve.

Válassza ki a probléma típusát

Innen a következőt kell berakni:

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

Szolgáltatáskérések javasolás

Új eszközkészlet-Mixed Reality kérésekor fontos dokumentálni a megoldható ügyfél juttatását/problémáját. A beküldött funkciókéréseket a rendszer áttekinti és tárgyalja a GitHub. Javasoljuk az egyes jellemzőjavaslatok nyílt és ösztönző jellegű megvitatását annak biztosítása érdekében, hogy a munka hasznos legyen az ügyfelek nagy szegmense számára.

Annak érdekében, hogy ne kelljen átdolgozni a funkciót, általában azt javasoljuk, hogy a szolgáltatás fejlesztése ne kezdődjék meg a felülvizsgálati fázisban. A közösségi felülvizsgálati folyamat sokszor feltár egy vagy több olyan problémát, amelyek jelentős módosításokat követelhetnek meg a javasolt implementációban.

Megjegyzés

Ha olyan elemet szeretne használni, amely már szerepel a hátralékunkon, ezt a munkaelemet használhatja javaslatként. Mindenképpen fűzze megjegyzést a feladathoz, amely értesíti a karbantartókat arról, hogy ön azon dolgozik, hogy végrehajtsa azt.

Hozzájárulási folyamat

Első lépésként egyszerűen kövesse az alábbi lépéseket:

  1. Fork fork the repository. Kattintson az oldal jobb felső felében található El fork gombra, és kövesse a folyamatot.
  2. Hozzon létre egy ágat az elágazásban (a fő ágon túl), hogy könnyebb legyen elkülöníteni a módosításokat, amíg készen nem állnak a beküldésre. A kiadási stabilizálási időszakban elérhető hibajavításokért keresse meg a legújabb prerelease/* ágat. Az új funkcióknak mindig a hez main kellmennek.

Ha még csak most ismer git-munkafolyamatot, tekintse meg ezt a githubos bevezetőt.

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

  1. Implementálja a hibajavítást vagy a funkciót. Az MRTK építésre és üzembe helyezésére vonatkozó utasítások: Üzembe helyezés Hololens- és WMR-eszközökön. Ne felejtse el követni a kódolási irányelveket.
  2. Ha hozzáad egy funkciót, adjon hozzá egy példa jelenet, amely bemutatja a funkciót.
  3. Kísérleti funkció hozzáadása esetén 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ának és futtatásának utasításai a UnitTests oldalon találhatóak.
  5. Győződjön meg arról, hogy a kód és a funkció(k) dokumentációs irányelvekben leírtak szerint vannak dokumentálva.
  6. Győződjön meg arról, hogy a kód minden platformon a kívántnak megfelelően működik. A támogatott platformok listájáért tekintse meg a kibocsátási megjegyzéseket. Az Windows UWP-projektek esetében a kódnak WACK-kompatibilisnek kell lennie. Ehhez hozzon létre egy Visual Studio, kattintson a jobb gombbal a projektre; TároljaAlkalmazáscsomagok létrehozása. Kövesse az utasításokat, és futtassa a WACK-teszteket. Győződjön meg arról, hogy mind sikeresek.
  7. A lekéréses kérelmek igénylésekor kövesse a lekéréses kérelmekre vonatkozó utasításokat.