Mac에서 APK 설치하고 Android 디버깅하기 — 터미널을 쓰든, 쓰지 않든

"Mac에서 APK 설치"라는 말 뒤에는 전혀 다른 두 가지 작업이 숨어 있는데, 대부분의 안내 글은 그중 하나만 다룹니다. 이 페이지는 두 가지를 모두 다루고, 그다음 사람들이 실제로 막히는 지점인 logcat 읽기와 macOS가 휴대전화를 아예 인식하지 못하는 문제까지 이어서 설명합니다. 아래의 모든 단계는 순수한 adb 명령만으로도 할 수 있으며, GUI가 정말로 수고를 덜어 주는 부분에서는 그것이 무엇을 해 주고 무엇은 해 주지 못하는지 분명히 밝힙니다. 2026년 8월 업데이트.

먼저 확인: 앱을 Mac에서 돌리고 싶은가요, 휴대전화에 넣고 싶은가요?

이 표현으로 검색하면 결과가 정확히 반으로 갈리는데, 상위에 오는 글들은 그중 한쪽만 다룹니다. "BlueStacks / NoxPlayer / LDPlayer를 설치하세요"라고 답하는 글은 첫 번째 질문, 즉 macOS 자체에서 Android 소프트웨어를 실행하는 쪽에 답하고 있습니다. 그러려면 에뮬레이터가 필요하고, Apple Silicon에서 현실적인 선택지는 Android Studio에 포함된 에뮬레이터(무료, arm64 시스템 이미지)나 Google Play Games 같은 PC용 제품이지 예전 x86 에뮬레이터가 아닙니다.

반대로 책상 위에 휴대전화나 태블릿이 있고 다운로드 폴더에 .apk 파일이 있다면 에뮬레이터는 전혀 필요 없습니다. 필요한 것은 ADB — Android Debug Bridge — 와 케이블뿐입니다. 이 페이지의 나머지 내용은 바로 그 이야기입니다.

1. 앱을 Mac 자체에서 실행하고 싶다 → 에뮬레이터를 쓰세요. 아래 내용은 해당하지 않습니다.
2. 앱을 Mac에 연결한 실제 Android 기기로 보내고 싶다 → 계속 읽으세요.

0단계: USB 디버깅 켜기 (이 부분은 휴대전화에서 합니다)

이 스위치는 어떤 Mac 앱도 대신 켜 줄 수 없습니다. Android는 의도적으로 사용자가 기기에서 직접 켜도록 요구하고, 첫 연결은 반드시 휴대전화 화면에서 확인해야 합니다. 그렇지 않다고 주장하는 프로그램이 있다면 사실이 아닙니다.

Windows와 달리 macOS에는 USB 드라이버가 필요 없습니다. 기기가 나타나지 않는다면 원인은 대부분 충전 전용 케이블, USB 허브, 아니면 아직 확인하지 않은 승인 대화상자입니다.

1. 설정 → 휴대전화 정보 → 빌드 번호를 일곱 번 탭합니다.
2. 다시 설정 → 시스템 → 개발자 옵션으로 들어가 USB 디버깅을 켭니다.
3. 데이터 전송이 되는 케이블로 휴대전화를 Mac에 직접 연결합니다. 허브를 거치지 마세요.
4. 휴대전화에서 "USB 디버깅을 허용하시겠습니까?"를 승인하고 "이 컴퓨터에서 항상 허용"에 체크합니다.

터미널 방식: adb install

이것이 고전적인 방법이고, 결국 GUI를 쓰게 되더라도 알아 둘 가치가 있습니다. Homebrew는 Google이 배포하는 것과 똑같은 platform-tools 바이너리를 설치합니다.

자주 만나는 실패를 있는 그대로 정리하면 이렇습니다. INSTALL_FAILED_UPDATE_INCOMPATIBLE은 같은 패키지 이름의 앱이 이미 설치되어 있지만 다른 키로 서명되었다는 뜻이니 먼저 지워야 합니다. INSTALL_FAILED_VERSION_DOWNGRADE는 -d를 붙이면 해결됩니다. "adb: no devices/emulators found"는 위의 승인 단계가 끝나지 않았다는 뜻입니다.

1. brew install --cask android-platform-tools
2. adb devices — 시리얼 번호가 unauthorized나 offline이 아니라 device로 표시되어야 합니다.
3. adb install -r ~/Downloads/app.apk (-r는 기존 설치본 위에 데이터를 유지한 채 다시 설치합니다).
4. Success가 나오는지 확인하세요. INSTALL_FAILED_로 시작하는 줄이 진짜 오류 메시지입니다.

터미널 없는 방식: APK를 창에 끌어다 놓기

터미널에 붙어 살 생각이 없다면 Homebrew 설치, PATH 수정, cd platform-tools 같은 절차는 전부 군더더기입니다. Super ADB Manager는 adb와 scrcpy 서버를 앱 안에 담고 있어서 따로 설치할 것도, 따로 최신 버전을 챙길 것도 없습니다.

무료이고 계정이 필요 없으며 광고가 없고 텔레메트리는 기본적으로 꺼져 있습니다. 앱은 Apple의 서명과 공증을 받았기 때문에, 다운로드 모음 사이트에서 받은 서명 없는 도구들이 요구하는 우클릭 → 열기 우회 없이 그냥 실행됩니다.

1. DMG를 내려받고 앱을 응용 프로그램 폴더로 끌어다 놓은 뒤 실행합니다.
2. 휴대전화를 연결하고 USB 디버깅 요청을 승인합니다(위와 동일).
3. 기기를 선택하고 앱 탭을 연 다음 APK 설치를 누르거나 .apk 파일을 창에 바로 끌어다 놓습니다.
4. 같은 탭에서 설치된 패키지 목록을 보고, 앱을 실행하거나 APK를 Mac으로 다시 가져오거나 데이터를 지우거나 삭제할 수 있습니다.

Split APK: base.apk와 config 파일들

APKMirror에서 App Bundle로 내려받았거나 SAI로 내보낸 파일은 여러 개로 나뉘어 옵니다 — base.apk에 split_config.arm64_v8a.apk, split_config.xxhdpi.apk, 언어별 split 등이 함께 딸려 옵니다. base.apk만 설치하면 실행하자마자 튕기거나 리소스가 하나도 보이지 않는 앱이 됩니다.

모든 조각은 같은 빌드, 같은 서명에서 나와야 하며 버전을 섞으면 실패합니다. .xapk나 .apks 컨테이너를 갖고 있다면 먼저 압축을 푸세요 — 둘 다 ZIP 압축 파일입니다 — 그런 다음 풀어 낸 조각들을 함께 설치합니다.

1. 터미널: adb install-multiple -r base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
2. GUI: 파일 선택 창에서 모든 조각을 한꺼번에 고르거나 함께 끌어다 놓으면, 앱이 대신 install-multiple을 실행하고 설치 중에 조각 개수를 보여 줍니다.

Android Studio 없이 Mac에서 Logcat 읽기

adb logcat만으로도 충분히 동작하고, 크래시를 빠르게 찾을 때는 명령줄로도 대개 충분합니다. 문제는 오래 들여다볼 때입니다. 가공되지 않은 logcat은 기기의 모든 프로세스에서 분당 수천 줄을 쏟아냅니다.

이 분야의 GUI 상황은 빈약하고 대부분 오래됐습니다. macOS에서 가장 잘 알려진 logcat 뷰어는 10년 된 Objective-C 프로젝트와 그 포크들, Tcl/Tk 도구, 그리고 비교적 최근에 나온 터미널 스타일 Rust 유틸리티 몇 개 정도이고, 유료 상용 제품이 하나 있습니다. 전부 platform-tools는 사용자가 직접 설치하고 관리한다고 전제하며, 대부분 서명이 없어서 macOS 13 이상에서는 한 줄을 보기도 전에 Gatekeeper와 씨름해야 합니다.

Super ADB Manager의 Logcat 탭은 선택한 기기에서 로그를 실시간으로 받아 오며, 우선순위 필터(전체 / Info 이상 / Warning 이상 / Error / Fatal), 크래시·네트워크·시스템·현재 포그라운드 앱용 사전 설정 필터, 자유 텍스트 검색, 색상 구분, 자동 스크롤과 지우기를 제공합니다. 솔직히 밝혀 둘 한계가 하나 있는데, 이 화면은 최근 2000줄만 메모리에 유지합니다. 즉 실시간 디버깅 창이지 긴 세션을 보관하는 아카이브는 아닙니다. 전체 기록이 필요하면 adb logcat 출력을 파일로 넘기세요.

1. adb logcat -v time — 읽기 쉬운 타임스탬프.
2. adb logcat *:E — 오류와 치명적 오류만.
3. adb logcat --pid=$(adb shell pidof -s com.example.app) — 특정 앱의 출력만.
4. adb logcat -c — 버그를 재현하기 전에 버퍼 비우기.
5. adb logcat -v time > ~/Desktop/session.log — 전부 파일로 저장.

Mac이 기기를 인식하지 못할 때

이 문제를 다루는 제대로 된 최신 macOS 전용 문제 해결 문서가 없어서, 실제로 해결되는 순서대로 점검 목록을 정리했습니다. 일부 Samsung, Xiaomi, Honor 기종에서는 알림 창에서 USB 모드를 "충전만"에서 "파일 전송"으로 바꿔야 ADB가 붙습니다.

adb devices에 시리얼 번호가 unauthorized라는 단어와 함께 나온다면 휴대전화는 정상적으로 연결된 상태이고, 확인 대화상자만 뜨지 않았거나 예전에 거부했던 것뿐입니다. 승인을 취소하면 대화상자가 다시 나타납니다.

1. 케이블을 바꿔 보세요. 충전 전용 USB-C 케이블이 단연 가장 흔한 원인입니다.
2. Mac에 직접 연결하세요. 허브, 독, 모니터 포트는 건너뜁니다.
3. adb kill-server 후 adb devices로 데몬을 다시 시작합니다.
4. 개발자 옵션 → USB 디버깅 승인 취소 후 케이블을 뽑았다가 다시 꽂습니다.
5. system_profiler SPUSBDataType | grep -i -A4 android — 여기에 아무것도 나오지 않으면 ADB 문제가 아니라 하드웨어나 케이블 문제입니다.

무선 디버깅과 ADB를 지원하지 않는 기기

Android 11 이상은 여섯 자리 코드로 Wi-Fi 페어링을 지원하는데, USB 포트가 이미 쓰이고 있거나 기기가 테스트 장비에 물려 있을 때 정말 유용합니다. 휴대전화에 표시되는 페어링 포트는 일시적인 것이고 연결 포트와는 다릅니다. 두 기기는 같은 서브넷에 있어야 하며, 클라이언트 격리가 켜진 회사 Wi-Fi에서는 아예 되지 않습니다. 앱에서는 무선 패널이 mDNS로 네트워크를 검색하고 페어링 코드를 입력받으며, 기기가 USB로 연결되어 있는 동안에는 바로가기 → 무선으로 전환으로 한 번에 넘길 수 있습니다.

이와 별개로, 모든 기기가 ADB를 지원하는 것은 아닙니다. Kindle과 상당수 카메라·미디어 플레이어는 MTP로만 저장소를 노출하는데, Google은 여전히 웹 곳곳에서 추천되는 Android File Transfer를 단종했습니다. Super ADB Manager에는 그런 기기의 파일을 ADB 없이 탐색하고 전송하는 MTP 기기 섹션이 있습니다. 주의할 점 하나: 전송 도중 기기를 뽑거나 꺼내면 MTP 세션이 끊길 수 있고, 다시 연결해서 이어서 진행해야 합니다.

요구 사항과 한계를 있는 그대로 적으면 이렇습니다. 버전 0.6.0, Apple Silicon 전용, macOS 13 Ventura 이상, 약 27 MB, 공증 완료. 화면 녹화는 Android의 screenrecord에 의존하기 때문에 일부 HONOR와 Huawei 기기에서는 동작하지 않습니다. 이 앱은 기기 관리와 로그 도구이지 Android Studio 디버거의 대체품이 아닙니다. 중단점이나 변수 검사 같은 기능은 없습니다.

1. 휴대전화: 개발자 옵션 → 무선 디버깅 → 페어링 코드로 기기 페어링.
2. Mac: adb pair 192.168.1.20:41234를 실행한 뒤 여섯 자리 코드를 입력합니다.
3. 일반적인 ADB 작업을 하려면 adb connect 192.168.1.20:5555로 연결합니다.
4. 또는 앱의 무선 패널을 사용합니다. 검색하고, 기기를 누르고, 코드를 입력하면 끝입니다.

자주 묻는 질문

가이드 더 보기