LG Smart TV(webOS) 자동화 구축하기 - 전체 과정과 실무 트러블슈팅

2026-10-20T16:46:27.679Z

QA대디

안녕하세요, QA대디입니다.

기존에 제 강의를 수강해 주신 분들께 감사드립니다. 한동안 새로운 강의를 선보이지 못했지만, 그동안 실무에서 경험한 자동화 구축 과정과 문제 해결 방법을 기술 글로 정리해 왔습니다.

이번에는 그중 LG Smart TV(webOS) 자동화 시리즈를 소개하려고 합니다.

일반적인 WEB이나 모바일 자동화와 달리, TV 자동화는 대상 기기의 개발자 모드 설정부터 CLI 설치, 환경 변수, Appium 드라이버, 브라우저 드라이버 호환성까지 여러 요소를 함께 확인해야 합니다.

이번 시리즈에서는 실제 구축 과정에서 필요한 설정과 문제 해결 경험을 정리했습니다. 비슷한 환경에서 자동화를 구축하고 계신 분들께 도움이 되면 좋겠습니다.

1. LG Smart TV 자동화 구축 — 전체 시나리오

TV 자동화를 처음 구축한다면 개별 테스트 코드를 작성하기에 앞서, 어떤 도구를 설치하고 어떤 순서로 환경을 구성해야 하는지 파악하는 것이 중요합니다.

전체적인 구축 과정은 다음과 같습니다.

기존 CLI 제거 (최신 webOS CLI를 설치한 경우에만)
    ↓
LG Smart TV 개발자 모드 설정
    ↓
webOS TV CLI v1.12.4 다운로드 및 설치
    ↓
webOS 환경 변수 설정
    ↓
LG Smart TV 등록
    ↓
LG Smart TV 등록 및 연결 확인
    ↓
LG webOS 앱용 Appium 2.x 드라이버 설치
    ↓
앱 설치 (필요한 경우)
    ↓
Appium으로 자동화 실행

이 과정에서 특히 신경 써야 할 부분은 CLI 버전과 환경 변수 설정입니다.

개발 도구는 최신 버전을 설치하는 것이 항상 최선은 아닙니다. 사용하는 자동화 환경과 호환되는 버전을 확인해야 하며, 기존 CLI가 설치되어 있다면 버전 충돌 가능성도 고려해야 합니다.

환경 변수 역시 단순한 설정 작업으로 넘기기 쉽지만, CLI 명령어가 정상적으로 실행되지 않을 때 먼저 확인해야 할 항목 중 하나입니다.

환경 구성은 한 단계씩 진행하고, 각 단계가 정상적으로 완료됐는지 확인한 뒤 다음 단계로 넘어가는 것을 권장합니다. 초기에 설치와 연결 상태를 정확히 확인해 두면 이후 Appium 실행 단계에서 발생하는 문제의 원인을 좁히기도 쉬워집니다.

전체적인 구축 시나리오와 단계별 설명은 아래 글에 정리했습니다.

🔗LG Smart TV 자동화 구축 #1 — 전체 시나리오

2. webOS CLI 설치와 환경 설정 — 생각보다 놓치기 쉬운 부분

전체 구축 과정에서 사용하는 webOS CLI는 TV와 통신하고 관련 작업을 수행하기 위한 중요한 도구입니다. 그런데 CLI를 설치했다고 해서 모든 준비가 끝나는 것은 아닙니다.

먼저 확인할 것은 현재 설치된 CLI의 버전과 사용할 CLI의 버전입니다. 이미 최신 webOS CLI가 설치된 환경이라면 기존 버전을 정리하고, 구축에 필요한 webOS TV CLI v1.12.4를 설치하는 과정이 필요할 수 있습니다.

그다음에는 환경 변수 설정과 TV 등록 및 연결 확인을 진행해야 합니다.

이 단계에서 문제가 발생했을 때 무작정 명령어를 반복 실행하기보다는 다음 항목을 순서대로 점검하는 편이 좋습니다.

CLI 버전: 구축에 필요한 버전이 설치되어 있는가?
기존 설치 환경: 다른 버전의 CLI가 남아 있어 충돌할 가능성은 없는가?
환경 변수: 설치한 CLI를 정상적으로 찾고 실행할 수 있도록 설정했는가?
TV 등록 및 연결: 개발자 모드 설정을 포함해 TV와 통신할 준비가 완료됐는가?

자동화 구축에서는 도구 설치 자체보다 도구와 실행 환경이 서로 맞는지 확인하는 과정이 중요합니다. 처음에는 번거롭게 느껴질 수 있지만, 이 부분을 꼼꼼하게 점검하면 이후 단계의 문제를 해결하는 데 도움이 됩니다.

실제로 webOS CLI를 사용하면서 마주친 함정과 관련된 내용은 아래 글에서 더 자세히 확인할 수 있습니다.

🔗LG Smart TV 자동화 구축 #2 — webOS CLI 함정편

3. TV의 ChromeDriver, 버전 매칭 — 기본부터 심화까지

LG Smart TV의 브라우저를 대상으로 자동화를 구성할 때는 ChromeDriver의 버전 호환성도 확인해야 합니다.

일반적인 웹 자동화에서도 브라우저와 ChromeDriver의 호환성은 중요한 요소입니다. TV 환경에서는 대상 기기의 브라우저와 드라이버 구성을 함께 고려해야 하므로, PC에서 사용하던 설정을 그대로 적용하기 전에 실제 환경을 확인하는 것이 좋습니다.

버전 매칭 문제를 만났을 때는 다음과 같은 순서로 접근할 수 있습니다.

자동화 대상 TV의 브라우저 환경을 확인합니다.
현재 사용 중인 ChromeDriver의 버전을 확인합니다.
브라우저와 드라이버의 호환성을 점검합니다.
Appium 실행 과정에서 발생하는 오류를 확인하고 원인을 좁혀 갑니다.

중요한 점은 자동화 실행에 실패했을 때 테스트 코드만 의심해서는 안 된다는 것입니다. 코드가 올바르더라도 브라우저와 드라이버 사이의 호환성 문제가 있다면 실행이 정상적으로 이루어지지 않을 수 있습니다.

따라서 테스트 코드, 자동화 도구, 대상 기기의 실행 환경을 구분해 점검하는 습관이 필요합니다.

이 주제는 기본 편과 심화 편으로 나누어 정리했습니다. 두 글을 함께 살펴보면 TV의 ChromeDriver 버전 매칭 문제를 조금 더 깊이 이해하는 데 도움이 될 것입니다.

🔗LG Smart TV 자동화 #3-1 — TV의 ChromeDriver, 버전 매칭?

🔗LG Smart TV 자동화 #3-2 — TV의 ChromeDriver, 버전 매칭? (심화)

마무리

자동화는 단순히 테스트 코드를 작성하는 것으로 끝나지 않습니다. 실제 환경을 구성하고, 도구 사이의 호환성을 확인하고, 예상하지 못한 문제의 원인을 찾아 해결하는 과정까지 모두 자동화 엔지니어의 중요한 업무라고 생각합니다.

저 역시 이런 경험을 기록하면서 문제를 해결하는 방법뿐 아니라, 다음에 같은 문제를 만났을 때 더 빠르게 접근할 수 있는 지식도 쌓을 수 있었습니다.

LG Smart TV 자동화를 준비하고 계시거나, Appium을 활용하면서 환경 설정과 호환성 문제를 겪고 계신다면 이번 내용이 작은 출발점이 되었으면 합니다.

더 자세한 구축 과정과 실제 트러블슈팅 내용은 각 글에 정리해 두었으니, 필요한 부분이 있다면 편하게 참고해 주세요.

감사합니다!

소프트웨어 테스트 QA 자동화 webOS SmartTV

답변 0