그래픽 도구에 기여 - MRTK3

아티클
03/21/2023

패키지 업데이트

리포지토리를 포크하고 분기를 만듭니다. 권장되는 분기 이름은 user/username/feature입니다.
Unity에서 GraphicsToolsUnityProject 예제 프로젝트를 복제하고 엽니다.
원하는 대로 변경합니다. 기본적으로 MRTK Graphics Tools 패키지 내의 모든 편집 내용은 그래픽 도구 패키지에 게시됩니다. (샘플을 업데이트하려면 아래 섹션을 참조하세요.)
분기를 포크까지 푸시하고 끌어오기 요청을 만듭니다. 끌어오기 요청에 변경 내용에 대한 설명을 추가합니다. 이미지와 gif는 항상 감사합니다.

패키지 샘플 업데이트

샘플은 Unity의 샘플 권장 사항에 설명된 대로 Samples~ 하위 폴더에 있습니다. '~' 문자는 Unity에서 Samples~ 폴더를 가져오는 것을 방지합니다. 이는 패키지 관리자를 통해 패키지를 포함할 때 이상적입니다. 그러나 패키지 내에서 샘플을 업데이트하려는 경우는 아닙니다.

샘플에 변경 내용을 적용하려면 Unity 프로젝트의 디렉터리 구조를 임시로 로컬로 변경해야 합니다.

Unity에서 GraphicsToolsUnityProject를 엽니다. Samples 폴더는 기본적으로 MRTK Graphics Tools 패키지에 표시되지 않습니다. 샘플을 표시하려면 파일 메뉴 모음에서 Window > Graphics Tools > Show Samples를 선택합니다.
샘플을 원하는 대로 변경합니다.
중요: 작업을 완료하고 변경 내용을 커밋하기 전에 샘플을 숨겨야 합니다. 파일 메뉴 모음에서 Window > 그래픽 도구 > 샘플 표시를 선택합니다.

팁

샘플을 편집한 후 창 > 그래픽 도구 > 샘플 숨기기 메뉴 항목을 호출하지 못하면 git에서 모든 샘플 파일이 변경된 것으로 생각하게 됩니다. 샘플이 숨겨지면 변경된 실제 파일은 git에서 분명해야 합니다.

설명서 업데이트

API 참조 설명서

설명서 주석의 경우 아래 권장 인라인 스타일을 사용합니다.

/// <summary>
/// Class <c>Point</c> models a point in a two-dimensional plane.
/// </summary>
public class Point
{
    /// <summary>
    /// Method <c>Draw</c> renders the point.
    /// </summary>
    void Draw() {...}
}

개념 설명서

개념 설명서를 업데이트하려면 Mixed Reality 설명서 리포지토리로 이동합니다.

팁

그래픽 도구와 관련된 문서는 mixed-reality/mrtk-unity/mrtk3-graphicstools/ 폴더에서 찾을 수 있습니다.

먼저 Microsoft Learn의 설명서에 기여하기 위한 권장 사항과 Mixed Reality 개발자 설명서에 기여하기 위한 가이드를 따르세요.

다음을 통해 공유