Android 개발환경에서 ADB를 이용한 포트 포워딩 설정하기

안드로이드 개발 과정에서 에뮬레이터나 실제 디바이스와 통신할 때 포트 포워딩이 필요한 경우가 있습니다. 이번 포스트에서는 ADB(Android Debug Bridge)를 이용한 포트 포워딩 설정 방법과 환경 구성에 대해 알아보겠습니다.

호스트와 게스트 OS의 이해

안드로이드 개발 환경에서는 두 가지 주요 시스템이 존재합니다:

1. 호스트 머신(Host Machine):

   • 개발자가 실제로 사용하는 물리적 컴퓨터
   • Android Studio가 설치되어 있는 환경
   • 에뮬레이터를 구동하는 실제 머신

2. 게스트 OS(Guest OS):

   • 호스트 머신 위에서 실행되는 가상화된 안드로이드 환경
   • 에뮬레이터 내부에서 동작하는 안드로이드 운영체제
   • 실제 안드로이드 앱이 실행되는 환경

ADB 환경변수 설정하기

ADB 명령어를 시스템 어디서나 사용하기 위해서는 환경변수 설정이 필요합니다.

Windows 환경변수 설정 단계

1. 시스템 환경변수 추가:

   • 변수 이름: ANDROID_PLATFORM_TOOLS
   • 변수 값: C:\Users\{사용자}\AppData\Local\Android\Sdk\platform-tools

2. Path 환경변수에 추가:

   • 시스템 환경변수의 Path 변수를 선택
   • %ANDROID_PLATFORM_TOOLS% 추가

환경변수 설정 확인

터미널에서 다음 명령어를 실행하여 ADB가 정상적으로 설정되었는지 확인합니다:

adb version

ADB 포트 포워딩 명령어

기본 포트 포워딩

adb forward tcp:9080 tcp:9080

이 명령어는 호스트의 9080 포트를 게스트(안드로이드 디바이스/에뮬레이터)의 9080 포트로 포워딩합니다.

특정 디바이스에 대한 포트 포워딩

adb -s [device_serial_number] forward tcp:9080 tcp:9080

포트 포워딩 관리 명령어

현재 포워딩된 포트 목록 확인:

adb forward --list

특정 포트 포워딩 제거:

adb forward --remove tcp:9080

모든 포트 포워딩 제거:

adb forward --remove-all

주의사항

1. 포트 충돌을 피하기 위해 사용하지 않는 포트 포워딩은 제거하는 것이 좋습니다.
2. 같은 포트 번호를 다른 용도로 사용하고 있지 않은지 확인하세요.
3. 방화벽 설정에서 해당 포트가 막혀있지 않은지 확인하세요.

이러한 포트 포워딩 설정을 통해 호스트와 게스트 OS 간의 원활한 통신이 가능해지며, 개발 과정에서의 디버깅과 테스트가 더욱 수월해집니다.