ADB(Android Debug Bridge)는 명령줄 인터페이스를 통해 개발 중인 기기와 통신할 수 있게 해주는 필수 도구입니다. 앱 설치, 디버깅 등 다양한 작업에 활용되며, Android Studio에서 앱을 실행할 때 없어서는 안 될 요소입니다. 그런데 Android Studio에서 앱을 실행하려는 도중 "Unable to Locate ADB(ADB를 찾을 수 없음)" 오류 메시지가 나타나면서 시뮬레이션이 중단되는 경우가 있습니다.
이 오류는 Android Studio가 platform-tools 폴더 내의 adb.exe 파일을 찾지 못할 때 발생합니다. 원인은 여러 가지일 수 있는데, 대표적으로 백신 소프트웨어가 오탐(false positive)으로 인해 adb.exe 파일을 삭제하거나 격리하는 경우입니다. 이 외에도 프로젝트 설정 문제나 손상된 플랫폼 도구 파일 등이 원인이 될 수 있습니다. 문제를 정확히 파악하고 해결하기 위해 주요 원인부터 자세히 살펴보겠습니다.
오류의 주요 원인
- 서드파티 백신 프로그램 — 백신 소프트웨어는 오탐으로 인해 시스템에서 파일을 임의로 제거하거나 격리하는 경우가 많습니다. 특히 Avast 백신은 ADB 관련 파일을 자주 바이러스 보관함(Virus Chest)에 가두는 것으로 알려져 있습니다. Avast뿐만 아니라 다른 서드파티 백신도 동일한 문제를 일으킬 수 있으므로, 백신 프로그램의 격리 목록을 반드시 확인해야 합니다.
- 프로젝트 설정 — 경우에 따라 프로젝트 설정이 원인이 되기도 합니다. Android SDK는 기본적으로 프로젝트에 SDK를 자동 할당하지 않기 때문에, 프로젝트 설정에서 직접 SDK를 지정해 주어야 합니다. SDK가 지정되지 않으면 프로젝트가 ADB에 접근할 수 없어 오류가 발생합니다.
- 손상된 Platform Tools — 플랫폼 도구 파일이 손상되었거나 백신 프로그램에 의해 격리된 경우에도 오류가 발생할 수 있습니다. 이 경우 platform-tools 폴더에서 adb.exe 파일이 사라지게 되며, 플랫폼 도구를 재설치해야 문제를 해결할 수 있습니다.
그럼 지금부터 위 문제들을 해결할 수 있는 구체적인 방법들을 하나씩 알아보겠습니다.
1. 백신 프로그램에서 ADB 복원하기
오류가 발생했을 때 가장 먼저 확인해야 할 것은 시스템에 설치된 서드파티 백신 소프트웨어입니다. 백신 프로그램은 종종 전혀 위험하지 않은 파일까지 오탐하여 격리하는 경우가 많습니다. 이 경우 adb.exe 파일이 위협 요소로 판단되어 시스템에서 제거된 것일 가능성이 높습니다.
특히 Avast 백신을 사용 중이라면 바이러스 보관함을 확인하여 해당 파일이 격리되어 있는지 살펴보세요. 만약 격리되어 있다면 파일을 복원한 후 앱을 다시 실행하면 됩니다. 아래 순서대로 진행하세요:
- 먼저 작업표시줄에서 백신 프로그램 아이콘을 마우스 오른쪽 버튼으로 클릭하고, 나타나는 메뉴에서 Virus Chest(바이러스 보관함)를 선택합니다.
- 목록에서 adb.exe 파일이 있는지 확인합니다. 파일이 있다면 해당 파일 앞의 점 세 개(⋮) 아이콘을 클릭합니다.
- 드롭다운 메뉴에서 Restore(복원) 옵션을 선택합니다. 그러면 파일이 바이러스 보관함에서 제거되고 정상적으로 사용할 수 있게 됩니다.
- 또는 Restore and add exception(복원 및 예외 추가) 옵션을 선택하여 향후 같은 파일이 다시 격리되는 것을 방지할 수도 있습니다.
2. 프로젝트 설정 변경하기
백신 프로그램이 원인이 아니라면, 프로젝트 설정 문제일 가능성이 높습니다. 프로젝트에 SDK가 할당되어 있지 않으면 ADB에 접근할 수 없어 해당 오류가 발생합니다. 기본값이 'No SDK'로 설정되어 있는 프로젝트 설정을 변경해야 하며, 이 설정은 Project Structure(프로젝트 구조) 메뉴에서 찾을 수 있습니다. 아래 단계를 따라 진행하세요:
- 먼저 Android Studio가 열려 있는지 확인합니다.
- 상단 메뉴에서 File > Project Structure로 이동합니다. 또는 아래 이미지와 같이 Project Structure 아이콘을 클릭해도 됩니다.
- Project Structure 창이 열리면 Project Settings 아래의 Project를 클릭합니다.
- Project SDK 설정 값을 확인합니다. No SDK로 되어 있다면 드롭다운 메뉴에서 Android API XX Platform으로 변경합니다.
- 만약 드롭다운 메뉴에 선택할 옵션이 없다면 New 버튼을 클릭하고 Android SDK를 선택한 후, Android SDK가 설치된 디렉터리를 지정합니다.
- 이 과정을 마치면 드롭다운 메뉴에서 Android API XX Platform을 선택할 수 있게 됩니다.
- 설정을 마친 후 OK 버튼을 클릭하고, 앱을 실행하여 문제가 해결되었는지 확인합니다.
3. SDK Manager에서 Android SDK 설치하기
시스템에 필요한 Android 버전의 SDK가 설치되어 있지 않아도 동일한 오류가 발생할 수 있습니다. 이 경우 Android Studio에 내장된 SDK Manager에서 해당 Android SDK를 간단히 설치하여 문제를 해결할 수 있습니다. 아래 순서대로 진행하세요:
- Android Studio 창에서 File > Settings로 이동하여 Preferences(환경설정) 창을 엽니다.
- 왼쪽 메뉴에서 Appearance & Behavior > System Settings > Android SDK로 이동합니다.
- SDK Manager에 진입하면 SDK Platforms 탭에서 사용 중인 Android 버전에 맞는 SDK Platform을 설치합니다.
- 설치가 완료되면 앱을 다시 실행하여 오류 메시지가 여전히 나타나는지 확인합니다.
4. Platform Tools 재설치하기
위 방법들을 모두 시도했는데도 오류가 계속된다면, 플랫폼 도구 파일 자체가 손상되었거나 손괴되었을 가능성이 있습니다. 이 경우 시스템에서 platform-tools를 재설치해야 오류를 제거할 수 있습니다. SDK Manager를 통해 몇 번의 클릭만으로 손쉽게 재설치할 수 있습니다. 아래 단계를 따라 진행하세요:
- 먼저 Android Studio를 종료한 후, 작업표시줄을 마우스 오른쪽 버튼으로 클릭하고 메뉴에서 Task Manager(작업 관리자)를 엽니다.
- 작업 관리자 창의 Processes(프로세스) 탭에서 adb.exe 프로세스를 찾아 종료합니다.
- 이후 Android Studio를 다시 실행합니다.
- 이제 SDK Manager를 엽니다. 아래 이미지와 같이 아래 화살표가 있는 상자 아이콘을 클릭하면 됩니다.
- SDK Manager가 열리면 SDK Tools 탭으로 전환합니다.
- SDK Tools 탭에서 아래로 스크롤하여 Android SDK Platform-Tools를 찾습니다. 체크를 해제한 후 OK를 클릭합니다.
- 그러면 IDE에서 platform-tools가 제거됩니다. 제거가 완료될 때까지 기다립니다.
- 제거가 완료되고 Gradle 동기화가 끝나면 다시 SDK Manager를 열고 SDK Tools 탭으로 이동합니다. 여기서 Android SDK Platform-Tools를 다시 체크하고 OK를 클릭한 후, 설치가 완료되기를 기다린 뒤 프로젝트를 동기화합니다.
- 모든 과정이 끝나면 앱을 실행하여 오류 메시지가 더 이상 나타나지 않는지 확인합니다.