이 프로젝트가 하는 일
원활한 Android 미러링 및 제어 워크플로는 Windows 데스크톱을 Android 기기의 실시간 인터페이스로 전환합니다. 기기 화면을 크기 조절이 가능한 창에 표시하고, 마우스, 키보드 및 탐색 입력을 실시간으로 Android에 전달합니다.
이 프로젝트는 데스크톱 콘솔, 필요한 종속 항목 및 휴대폰용 컴패니언 구성 요소를 휴대 가능한 설정으로 묶어 제공합니다. 각 종속 항목을 따로 찾아 설치할 필요가 없으며, Android 컴패니언도 앱 스토어에서 수동으로 설치할 필요가 없습니다.
첫 연결 중에 데스크톱 도구는 기기에 작은 에이전트를 전송하고, 비디오 및 입력 채널을 설정한 다음 미러링된 화면을 엽니다. 동일한 연결을 통해 비디오 스트림과 함께 클립보드 데이터, 오디오 및 파일 전송도 처리할 수 있습니다.
주요 기능
- 실시간 화면 미러링: 지연 시간이 짧은 데스크톱 창에서 Android 애니메이션, 스크롤, 앱 및 동영상을 확인합니다.
- 키보드 및 마우스 제어: 클릭을 탭으로, 드래그를 스와이프로, 실제 키보드 입력을 Android 텍스트 입력으로 변환합니다.
- 휴대 가능한 설정: 전체 도구 모음을 하나의 폴더에 보관하고 호환되는 Windows 컴퓨터 간에 이동합니다.
- 유선 및 무선 작동: 설정과 안정성을 위해 USB로 시작한 다음, 신뢰 관계가 설정되면 로컬 네트워크를 사용해 케이블 없이 미러링합니다.
- 유연한 표시 방식: 창 크기를 조절하고, 세로 또는 가로 방향을 사용하며, 화면을 회전하거나 전체 화면 모드로 전환합니다.
- 캡처 및 공유 도구: 스크린샷을 찍고, 세션을 녹화하며, 클립보드 콘텐츠를 공유하고, 파일을 전송합니다.
- 다중 기기 지원: 연결된 각 기기마다 별도의 미러 창을 엽니다.
- 깔끔한 종료: 미러를 닫거나 케이블을 분리하면 휴대폰용 컴패니언이 중지되며, 수동으로 설치한 Android 앱이 남지 않습니다.
요구 사항
시작하기 전에 다음을 준비하세요.
- Windows 10 또는 Windows 11
- PowerShell 5.1 이상
- 활성 네트워크 연결
- Android 휴대폰 또는 태블릿
- 최초 연결을 위한 데이터 전송이 가능한 USB 케이블
관리자 권한은 필요하지 않습니다. PowerShell 5.1은 지원되는 Windows 버전에 이미 포함되어 있습니다.
도구 모음 설치 및 준비
1. 프로젝트 설정 페이지 열기
설정 워크플로에 액세스하려면 저장소의 PowerShell 명령 버튼 페이지를 사용하세요. 미러링 구성 요소를 개별적으로 조합하지 말고 해당 페이지에 표시되는 명령 또는 다운로드 지침을 따르세요.
2. 패키지 함께 보관하기
다운로드했거나 준비한 폴더가 설치 항목으로 사용됩니다. 콘솔이 종속 항목과 Android 측 에이전트를 찾을 수 있도록 포함된 파일을 함께 보관하세요. 설정이 휴대 가능하므로 폴더를 이동식 저장 장치에 복사하고 다른 호환 Windows 컴퓨터에서 실행할 수도 있습니다.
3. 보안 프롬프트에 주의하여 대응하기
보안 제품이 로컬 기기 연결을 생성하는 익숙하지 않은 사전 빌드 도구를 검사하거나 경고할 수 있습니다. 무엇이든 허용하기 전에 파일이 프로젝트 페이지에서 제공된 것인지 확인하세요. README에는 이 패키지가 설명된 미러링 워크플로만 제공하기 위한 것이라고 명시되어 있지만, 조직의 보안 정책도 따라야 합니다.
Android에서 USB 디버깅 활성화
데스크톱 도구는 최초 페어링과 임시 컴패니언 구성 요소 실행을 위해 Android의 디버깅 인터페이스가 필요합니다.
- Android 기기의 설정을 엽니다.
- 개발자 옵션을 활성화합니다. 정확한 경로는 기기와 Android 버전에 따라 다릅니다.
- 개발자 옵션을 열고 USB 디버깅을 활성화합니다.
- 최초 연결 중에는 기기를 켜진 상태와 잠금 해제 상태로 유지합니다.
- 데이터 전송이 가능한 USB 케이블로 기기를 컴퓨터에 직접 연결합니다.
충전 전용 케이블은 필요한 기기 데이터를 전송할 수 없습니다. 휴대폰이 충전되지만 감지되지 않는다면 다른 케이블이나 USB 포트를 사용해 보세요.
첫 미러링 세션 시작
- 도구 모음 실행: 휴대 가능한 폴더에서 데스크톱 콘솔을 시작합니다.
- 기기 연결: 잠금 해제된 Android 기기를 USB로 연결합니다.
- 컴퓨터 인증: Android에 USB 디버깅 프롬프트가 표시되면 내용을 확인하고 허용을 탭합니다. 컴퓨터를 신뢰한다면 기억하도록 선택할 수 있습니다.
- 미러링 대기: 도구가 작은 컴패니언 에이전트를 전송하고 스트림을 협상한 다음 데스크톱 창에 기기 화면을 엽니다.
- 입력 테스트: Android 컨트롤을 클릭하고 창을 가로질러 드래그한 다음 텍스트 필드에 입력하여 데스크톱 입력이 기기에 전달되는지 확인합니다.
최초 핸드셰이크를 수행하려면 실제 기기가 켜져 있고 잠금 해제되어 있어야 합니다. 스트리밍이 시작되면 휴대폰 화면이 어두워질 수 있지만 데스크톱 입력은 계속 작동합니다. 잠긴 Android 기기는 잠금이 해제될 때까지 일반적인 탭 입력을 거부합니다.
기본 데스크톱 컨트롤
미러는 정적인 스크린샷 모음이 아니라 상호 작용이 가능한 보조 화면처럼 작동합니다. 일반적인 상호 작용은 다음과 같이 Android 동작에 자연스럽게 매핑됩니다.
- 탭: 마우스로 항목을 클릭합니다.
- 스와이프: 이동하려는 방향으로 클릭한 채 드래그합니다.
- 스크롤: Android 인터페이스에서 스크롤을 지원하는 위치에서 마우스 휠을 사용합니다.
- 입력: Android 텍스트 필드를 선택하고 Windows 키보드를 사용합니다.
- 탐색: Android 탐색에 매핑된 도구의 하드웨어 키 동작을 사용합니다.
예: 메시지에 답장하기
- 미러링된 창에서 메시지 앱을 클릭합니다.
- 대화를 선택합니다.
- 메시지 입력란을 클릭합니다.
- 데스크톱 키보드로 입력합니다.
- Android 전송 컨트롤을 클릭합니다.
예: 앱 인터페이스 테스트하기
- 미러링된 기기에서 앱을 엽니다.
- 개발 또는 테스트 도구 옆에 배치할 수 있도록 미러 창 크기를 조정합니다.
- 클릭과 드래그를 사용해 탭과 제스처를 테스트합니다.
- 세로 및 가로 레이아웃을 확인할 때 화면을 회전합니다.
- 시연 또는 버그 보고서를 위해 세션을 녹화하거나 스크린샷을 캡처합니다.
디스플레이 및 스트림 조정
작업 공간에 맞게 미러 창 크기를 조정하고, 가상 디스플레이를 회전하거나, 프레젠테이션을 위해 전체 화면으로 전환할 수 있습니다. 연결 상태에 따라 이미지 품질과 응답성의 균형을 조정해야 할 때 비트레이트와 해상도를 변경할 수도 있습니다.
화면 움직임이 흐릿해지거나 끊기면 다음 단계를 시도해 보세요.
- 전원이 공급되지 않는 허브 대신 직접 USB 연결을 사용합니다.
- 지나치게 긴 USB 연장 케이블을 피합니다.
- 대용량 전송이나 기타 대역폭을 많이 사용하는 작업을 종료합니다.
- 연결이 계속 제한되면 스트림 해상도 또는 비트레이트를 낮춥니다.
- 무선 세션이 불안정하면 유선 모드로 돌아갑니다.
대역폭이 제한되면 인코더가 응답성을 높이기 위해 일시적으로 이미지 세부 묘사를 낮출 수 있습니다. 일반적으로 직접 연결되고 안정적인 연결이 가장 선명하고 일관된 출력을 제공합니다.
무선 미러링 사용
무선 모드를 사용하면 로컬 네트워크를 통해 미러링을 계속할 수 있습니다. 초기 유선 설정을 먼저 완료해 신뢰 관계를 설정하세요. 최초 실행 시 케이블이 인증에 사용되며, 컴패니언 설정에도 가장 안정적인 경로를 제공하기 때문입니다.
- USB 미러링 세션을 성공적으로 완료합니다.
- Windows 컴퓨터와 Android 기기가 로컬 네트워크를 통해 통신할 수 있는지 확인합니다.
- 신뢰 관계가 설정된 후 툴킷의 무선 모드를 사용합니다.
- 네트워크 상태로 인해 지연이나 끊김이 발생할 경우를 대비해 USB를 대체 수단으로 사용할 수 있게 유지합니다.
무선 미러링은 방 안을 이동하거나 케이블 없이 발표할 때 편리합니다. 안정성을 극대화하거나 일관된 영상 품질이 필요할 때는 USB가 더 적합합니다.
파일 전송, 텍스트 공유 및 세션 캡처
이 작업 흐름은 휴대폰 화면을 보는 것 이상의 기능을 제공합니다. 컴퓨터와 Android 기기 간에 클립보드 내용과 파일을 전송할 수 있으며, 스크린샷 및 녹화 기능으로 세션을 기록할 수 있습니다.
- 클립보드 공유: Android와 Windows 간에 텍스트를 복사해 다시 입력하지 않아도 됩니다.
- 파일 전송: 데스크톱과 기기 간에 지원되는 파일을 드래그 앤 드롭합니다.
- 스크린샷: 미러링된 디스플레이를 깔끔한 이미지로 캡처합니다.
- 녹화: 시연, 테스트 또는 재현 가능한 버그의 영상을 저장합니다.
정확한 컨트롤은 패키지된 인터페이스에 따라 달라질 수 있습니다. 문서화되지 않은 명령줄 옵션을 추측하지 말고 툴킷에 표시되는 컨트롤을 사용하세요.
여러 Android 기기 사용
이 프로젝트는 연결된 여러 기기의 미러링을 지원합니다. 각 기기가 별도의 창에서 열리므로 레이아웃을 비교하거나 여러 휴대폰에서 하나의 흐름을 시연할 수 있습니다.
- 모든 기기에서 USB 디버깅을 활성화합니다.
- 신뢰할 수 있는 데이터 케이블로 각 기기를 연결합니다.
- 각 Android 화면에서 인증 메시지를 개별적으로 승인합니다.
- 생성된 미러 창을 나란히 배치합니다.
이 설정은 다양한 화면 크기에서 인터페이스를 확인하거나 여러 세대의 기기에서 동작을 비교할 때 유용합니다.
고급 팁
중요한 작업에는 USB 사용
긴 녹화, 시연 또는 안정적인 지연 시간이 중요한 테스트에는 직접 유선 연결을 사용하세요. 무선 모드는 더 유연하지만 성능은 로컬 네트워크 상태에 따라 달라집니다.
포터블 폴더 유지
실행 파일을 함께 제공된 종속 파일과 분리하지 마세요. 설정을 다른 컴퓨터나 USB 드라이브로 옮길 때는 전체 폴더를 복사합니다.
신뢰할 수 있는 컴퓨터만 승인
Android 디버깅 인증은 컴퓨터에 기기에 대한 상당한 접근 권한을 부여합니다. 직접 관리하는 컴퓨터만 승인하고, 필요할 때 Android 개발자 설정에서 저장된 디버깅 인증을 취소하세요.
설정 중에는 기기를 잠금 해제 상태로 유지
최초 핸드셰이크와 인증에는 실제 휴대폰 화면에 대한 접근이 필요합니다. 나중에 입력이 중단된 것처럼 보이면 Android가 기기를 잠갔는지 확인하세요.
반복 가능한 테스트 레이아웃 구성
크기를 조정할 수 있는 미러 창을 로그, 문서 또는 개발 도구 옆에 배치합니다. 반복 세션에서는 이전에 신뢰한 기기를 다시 연결하고 작업 흐름에 가장 적합한 디스플레이 배치를 재사용하세요.
연결 해제 및 정리
세션이 완료되면 미러 창을 닫거나 기기를 분리합니다. 툴킷은 임시 휴대폰 측 컴패니언에 종료 신호를 보내고, Android 앱을 제거하지 않아도 세션을 종료합니다.
다음 세션에서는 신뢰한 기기를 다시 연결하고 툴킷을 다시 실행합니다. README에 따르면 작업 흐름이 환경 설정을 유지하므로 익숙한 세션을 더 적은 설정으로 재개할 수 있습니다.
라이선스
이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 원본 저작권 및 허가 고지를 포함하는 한, 프로젝트를 검토, 수정, 사용하고 다른 워크플로의 일부로 포함하여 재배포할 수 있습니다. 이 소프트웨어는 보증 없이 제공됩니다.
결론
이 포터블 워크플로를 사용하면 별도의 종속 요소를 수동으로 수집하지 않고도 Windows에서 Android 기기를 통합된 방식으로 미러링하고 제어할 수 있습니다. USB 디버깅을 활성화하고 첫 연결을 승인한 후에는 하나의 데스크톱에서 키보드와 마우스로 Android를 조작하고, 디스플레이를 조정하고, 데이터를 전송하고, 세션을 녹화하고, 무선 모드를 사용하고, 여러 기기 창을 관리할 수 있습니다.