[Appium] 설치 가이드 (Window, Visual Studio Code, Python)

. Appium 및 관련 도구 설치

1-1. Appium 설치

1. Node.js 설치
   • Appium은 Node.js로 작성되었으므로 Node.js를 먼저 설치해야 합니다.
   • Node.js 공식 웹사이트에서 LTS 버전을 다운로드하고 설치합니다.
   • 설치 후, 터미널에서 아래 명령어로 설치 확인:
     node -v
     npm -v
2. Appium 설치

Node.js의 npm을 이용해 Appium을 설치합니다. 터미널에서 실행:

npm install -g appium​

1. • 설치 확인:
      

     appium -v
2. Appium Inspector 설치 (선택 사항)
   • Appium Inspector(https://github.com/appium/appium-inspector/releases)에서 설치 파일을 다운로드하여 설치합니다.
   • Appium Inspector는 UI 요소를 시각적으로 확인할 때 유용합니다.
3. Android Studio(Andriod SDK 설치 위함)

---

1-2. Python 및 패키지 설치

1. Python 설치
   • Python 공식 웹사이트에서 최신 버전을 다운로드하여 설치합니다.
     설치 시 "Add Python to PATH" 옵션을 반드시 체크하세요.
   • 설치 확인:
      

     python --version
2. Appium Python Client 설치
   • Python용 Appium 클라이언트를 설치합니다:
      

     pip install Appium-Python-Client
3. 추가 패키지 설치
   • Selenium 및 필요한 라이브러리를 설치합니다:
      

     pip install selenium

---

2. Visual Studio Code 설정

2-1. VS Code 설치

• VS Code 공식 웹사이트에서 다운로드하고 설치합니다.

2-2. Python 확장 프로그램 설치

1. VS Code를 실행하고, 왼쪽 사이드바에서 Extensions(확장 프로그램) 아이콘 클릭.
2. 검색창에 "Python"을 입력하고 Microsoft의 Python 확장을 설치합니다.

2-3. 환경 설정

1. Python 인터프리터 선택
   • Ctrl+Shift+P를 누르고, "Python: Select Interpreter" 입력 후 실행.
   • 설치한 Python 버전을 선택합니다.
2. 자동 실행 및 코드 형식을 위한 플러그인 설치 (선택 사항)
   • pylint, autopep8 같은 확장을 설치해 코드 품질 및 자동 정리를 활성화.

---

3. Android 환경 설정

3-1. Android Studio 설치

1. Android Studio 공식 웹사이트에서 다운로드 후 설치합니다.
2. 설치 중 Android SDK, SDK Tools, ADB를 포함하여 설치.
3. 설치 확인:
    

   adb version

3-2. Android 디바이스 설정

1. USB 디버깅 활성화
   • 실제 Android 디바이스에서 개발자 옵션을 활성화하고 USB 디버깅을 켭니다.
2. ADB 연결 확인
   • 터미널에서 아래 명령어 실행:
      

     adb devices
   • 디바이스가 나열되면 연결이 완료된 것입니다.

---

4. Appium 서버 시작

1. Appium 서버를 시작하려면 터미널에서 다음 명령어 실행:
   • 성공적으로 시작되면 "Appium server is running" 메시지가 나타납니다. 
     appium
   •  
2. Appium Inspector를 실행해 원하는 디바이스와 앱의 요소를 시각적으로 탐색할 수 있습니다.

---

5. Python으로 Appium 테스트 코드 작성

기본적인 Python 테스트 코드는 아래와 같습니다:

 

from appium import webdriver

desired_caps = {
    "platformName": "Android",
    "deviceName": "emulator-5554",  # 디바이스 이름 (adb devices로 확인)
    "app": "path/to/your/app.apk",  # 테스트할 APK 파일 경로
    "automationName": "UiAutomator2"
}

driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 예: 앱 내 특정 버튼 클릭
element = driver.find_element_by_accessibility_id("button_id")
element.click()

driver.quit()

 

• 환경 변수 설정: Windows에서 환경 변수를 다음과 같이 설정합니다:
  • ANDROID_HOME:
    • 변수 이름: ANDROID_HOME
    • 변수 값: Android SDK 경로 (예: C:\Users\<사용자 이름>\AppData\Local\Android\Sdk)
  • ANDROID_SDK_ROOT:
    • 변수 이름: ANDROID_SDK_ROOT
    • 변수 값: Android SDK 경로와 동일.
• PATH 변수에 추가: 시스템 변수 **Path**에 아래 경로를 추가합니다:
  • %ANDROID_HOME%\platform-tools
  • %ANDROID_HOME%\tools

 

---

6. 테스트 실행

1. Python 파일을 작성하고 저장합니다. (예: test_appium.py)
2. VS Code 터미널에서 아래 명령어로 실행: 
3.  
   python test_appium.py