컴파일 온라인 사용설명서

이 문서는 ComfilePi와 같은 Linux 환경에서 .NET으로 개발된 프로그램을, 원격 설정을 통해 ComfilePi에서 직접 디버깅하고 실행하는 방법을 설명합니다.
이 방식을 사용하면, Visual Studio가 설치된 개발 PC에서 코드를 수정한 후 바로 ComfilePi에서 실행 결과를 확인하며 빠르게 개발할 수 있습니다.

• 배포, 실행, 디버그 기능을 원격으로 실행해 가며 사용 할 수 있습니다.
• 본문서는 .Net5이상 방법을 설명합니다.
• NET Framework 4.x, Mono로 개발시에 원격모노 디버거 환경설정 방법을 확인하세요.
• 기존의 수동적인 방법 보다 개선된 방식으로, Visual Studio 2022에서 “F5” 키 입력만으로 ComfilePi에서 디버깅을 수행할 수 있습니다.

위 파일을 다운로드한 후 설치합니다. 설치할 때는 Visual Studio가 실행 중이지 않은 상태여야 합니다.

• Windows 10 이상, 64비트
• 비주얼 스튜디오 2022

• SSH Enable / SSH 인증키 발급
• Installed .NET runtime or SDK(설치 방법)
• vsdbg 설치

보안상의 이유로, Windows에 설치된 “OpenSSH”를 이용한 비밀번호 인증은 허용되지 않습니다.
이러한 이유로, Windows 개발 PC와 ComfilePi(Linux PC)는 원격 장치 간에 Public/Private Key 인증을 사용하여 구성해야 합니다.

• Public / Private Key 생성은 OS 이미지 설치 도구인 "Raspberry Pi OS"를 이용하여 매우 쉽게 수행할 수 있습니다.
• ComfilePi Os를 다운로드 받아"Raspberry Pi OS"를 사용하여 Public Key를 생성합니다.
• Public Key가 포함된 OS를 ComfilePi에 설치하여 사용합니다.
• 인증키 생성 시 Private / Public Key는 Windows 개발 PC에 자동 생성되어 저장됩니다

※ 더 많은 내용은 Raspberry Pi's documentation 에서 확인할 수 있습니다.

다음 명령어를 이용하여 개발 PC(Windows Pc)와 ComfilePi(Linux Pc)간의 ssh인증을 확인할 수 있습니다.

원격장치인 ComfilePi(Linux Pc)에는 vsdbg 유틸리티가 설치되 있어야 합니다. 아래와 같이 설치해주세요.

1. Run wget https://aka.ms/getvsdbgsh 설치 스크립트를 다운로드합니다.
2. Run chmod +x getvsdbgsh 스크립트를 실행 가능하게 만듭니다.
3. Run sudo ./getvsdbgsh -v latest -l /opt/Microsoft/vsdbg vsdbg를 설치합니다.

설치 위치는 자유롭게 변경할 수 있으나, 이후 Visual Studio 실행 프로필을 설정할 때 정확한 위치를 기억하고 있어야 합니다.

위 과정을 마친 후,.NET Remote Debugger 실행 구성 프로필을 프로젝트에 추가합니다. 프로필 설정은 “Remote Machine”, “Remote User”, “Path to vsdbg” 만 설정하면 됩니다.

• Remote Machine : ComfilePi의 IP 주소
• Remote User : ComfilePi의 User name “pi”
• Path to vsdbg : vsdbg 실행 파일의 경로여야 하며, 설치 폴더의 경로가 아닙니다. 예를 들어, vsdbg를 “/opt/Microsoft/vsdbg”에 설치한 경우, 실행 파일 경로로는 “/opt/Microsoft/vsdbg/vsdbg”를 입력해야 합니다.

만약 문제가 발생한다면 “Remote .NET Debugger” 확인해 주세요.