**
**
1. 개요 및 시작
FreeRDP 프로젝트 폴더 생성 및 GitHub 레포 클론:
클론할 때 레포 주소와 깃 브랜치 설명
2. 필수 도구 및 종속성 설치
≥ gcc/g++ 컴파일러, CMake, pkg-config 등
기본 Ubuntu 기준: sudo apt install build-essential cmake pkg-config libssl-dev ...
3. 빌드 디렉터리 설정
소스 디렉터리 바깥에서 build
폴더 생성:
cmake
옵션 설명 (예: -DWITH_SERVER=ON
, -DWITH_CLIENT=ON
)
4. 컴파일 & 설치
Make 수행:
빌드 완료 후 wfreerdp
, xfreerdp
실행까지 일사천리
💡 팁: cmake 옵션을 켤수록 빌드 시간이 길어진다는 점 유의.
**
**
1. CMake 옵션 심층 해설
주요 옵션:
WITH_PULSE
, WITH_FFMPEG
, WITH_CHANNEL_URBDP
등 활성화
cmake-gui
, ccmake
도구를 사용해 설정 디버깅
2. 디버깅 & 에러 처리
build 실행 중 발생 가능한 주요 에러 예시:
의존성 누락, path 문제, 헤더 불일치 등
해결 팁:
/usr/local/include
등 올바른 CMAKE_PREFIX_PATH 추가
ldconfig
실행, cache clear 등
3. 설치 경로 조정
CMAKE_INSTALL_PREFIX=/opt/freerdp
등으로 커스텀 설치 가능
나중에 LD_LIBRARY_PATH
혹은 /etc/ld.so.conf.d/
설정 필요
**
**
1. 기본 연결 테스트
윈도우 서버나 로컬 RDP 대상에 연결 테스트
xfreerdp /v:host /u:user
등 기본 명령어 실행
2. 옵션별 테스트
오디오 리디렉션: +audio /sound:sys:alsa
다이렉트 그래픽: +clipboard +printer
네트워크 성능 튜닝: /network:auto
3. 고급 팁
자동화 스크립트 작성 방법 안내
실행 로그 활성화: --log-level=DEBUG
옵션 설명
단계 | 명령어 예시 | 설명 |
---|---|---|
1. 클론 및 초기 설정 | git clone ... && mkdir build |
소스 준비 |
2. 의존성 설치 | sudo apt ... |
빌드에 필요한 라이브러리 준비 |
3. CMake 구성 | cmake .. -DWITH_... |
옵션 커스터마이징 |
4. 컴파일 & 설치 | make -j && sudo make install |
바이너리 및 라이브러리 생성 |
5. 실행 테스트 | xfreerdp /v:... |
실제 연결 테스트 |