Android 자동화 테스트를 위한 Appium 환경 구성

Appium은 네이티브, 하이브리드, 모바일 웹 앱을 위한 오픈소스 자동화 프레임워크로, iOS 및 Android 플랫폼에서 동작합니다. 본 문서는 Windows와 macOS 환경에서 Android 자동화를 위한 Appium 세팅 방법을 설명합니다.

Windows 환경 설정

1. JDK 설치 및 환경 변수 구성
   • JDK 8 버전을 공식 사이트에서 다운로드하여 설치합니다 (예: C:\Program Files\Java\jdk1.8.0_301)
   • 시스템 환경 변수에 다음 항목을 추가합니다:
     • JAVA_HOME: JDK 설치 경로 (예: C:\Program Files\Java\jdk1.8.0_301)
     • CLASSPATH: %JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
   • 기존 Path 변수에 아래 경로 추가:
     • %JAVA_HOME%\bin
     • %JAVA_HOME%\jre\bin

   확인 방법: 명령 프롬프트에서 java -version 입력 후 Java 버전 정보가 출력되면 성공입니다.

2. Android SDK 설치 및 ADB 구성
   • Android Studio 또는 독립형 SDK 도구를 설치하고, SDK 경로를 기록합니다 (예: C:\Android\Sdk)
   • 환경 변수 설정:
     • ANDROID_HOME: SDK 루트 경로
     • Path에 %ANDROID_HOME%\platform-tools, %ANDROID_HOME%\tools 추가

   확인 방법: 콘솔에서 adb devices 실행 시 오류 없이 장치 목록이 나타나야 합니다.

3. 안드로이드 에뮬레이터 설정 (Nox Player 기준)
   • Nox Multi-Instance Manager를 통해 Android 5.1.1 기반 가상 장치 생성
   • 에뮬레이터 실행 후 다음 명령어로 ADB 연결:

     adb connect 127.0.0.1:62025
     adb devices

   • 정상적으로 장치가 리스트에 표시되면 연결 완료
4. Appium Desktop 설치
   • GitHub 공식 릴리스 페이지에서 Appium Desktop 설치 파일 다운로드 및 설치
   • 앱 실행 후 서버 시작 여부 확인
5. Python 클라이언트 라이브러리 설치

   명령 프롬프트에서 다음 명령어 실행:

   pip install selenium
   pip install appium-python-client

macOS 환경 설정

1. Homebrew 설치

   터미널에서 다음 스크립트 실행:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Java 설치

   Brew를 사용해 OpenJDK 8 설치:

   brew install openjdk@8

3. Python3 및 패키지 설치

   brew install python
   pip3 install selenium
   pip3 install appium-python-client

4. Android SDK 수동 설치 및 환경 구성
   • SDK ZIP 파일을 다운로드 후 /usr/local/ 위치로 이동
   • 쉘 프로필 파일 수정 (~/.zshrc 또는 ~/.bash_profile):

   export ANDROID_HOME=/usr/local/android-sdk-macosx
   export PATH=$PATH:$ANDROID_HOME/tools
   export PATH=$PATH:$ANDROID_HOME/platform-tools
   export JAVA_HOME=$(/usr/libexec/java_home)
   export PATH=$JAVA_HOME/bin:$PATH
   export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

   적용을 위해 source ~/.zshrc 실행

   검증: 터미널에서 adb devices 명령어로 응답 확인

5. Appium Desktop 설치
   • 공식 GitHub 릴리스 페이지에서 최신 버전 다운로드
   • 설치 후 앱 실행 및 로컬 서버 기동 확인

최종 점검 사항

• ADB가 에뮬레이터 또는 실제 기기를 인식하는지 확인
• Appium 서버가 정상적으로 구동되고 클라이언트 연결이 가능한지 테스트
• Python 스크립트에서 webdriver.Remote() 호출 시 세션 생성 가능 여부 검증