본문 바로가기

Android 14, 15, 16 개발자 옵션: 30초 만에 활성화하기

Pixel, Samsung, Xiaomi에서 개발자 모드 활성화: 설정 > 휴대전화 정보 > 빌드 번호를 7번 탭하고 PIN 입력. USB 및 무선 디버깅 페어링, 빌드 번호가 없을 때 해결 방법.

개발자 옵션이 활성화된 기기에서 Android Studio로 앱 실행하기

설정 > 휴대전화 정보 > 탭 빌드 번호 7번 > 본인의 PIN (또는 패턴)을 입력하세요. 개발자가 되었다는 메시지가 표시됩니다. 다음을 열고 개발자 옵션 켜세요 USB 디버깅 또는 무선 디버깅 필요할 때 adb, Android Studio, 또는 실제 기기에서 Capacitor 실행. 단계는 동일합니다 Android 14, 15, 16; 경로만 다릅니다 빌드 번호 브랜드별 차이(아래 표 참조).

개발자 옵션이 하는 일(그리고 하지 않는 일)

개발자 옵션은 앱 개발자를 위한 숨겨진 설정 메뉴입니다. 활성화 자체로는 아무런 기능이 없으며, 다음과 같은 스위치를 표시할 뿐입니다:

  • USB 디버깅: 신뢰할 수 있는 컴퓨터에서 adb 명령 실행, 빌드 설치, 로그 읽기 가능.
  • 무선 디버깅: Wi-Fi를 통한 동일한 기능(Android 11+).
  • 절전 모드 해제: 충전 중 화면이 꺼지지 않아 테스트 시 유용합니다.
  • 애니메이션 배율: 시스템 애니메이션을 빠르게 하거나 끄는 기능으로, UI 테스트에 유용합니다.
  • 액티비티 유지 안 함: 액티비티를 떠날 때 파괴하여, Capacitor 앱에서 상태 복원을 테스트하는 좋은 방법입니다.
  • 탭 표시 / 포인터 위치: 데모 녹화 및 터치 타겟 확인에 유용합니다.

직접 수행 하지 마세요 브라우저나 파일 관리자에서 APK를 설치하거나, 대부분의 앱을 사용하거나, OTA 업데이트를 받으려면 개발자 옵션이 필요합니다.

브랜드별 개발자 옵션 활성화

브랜드 7번 연속 탭해야 하는 위치 이후 메뉴가 나타나는 위치
Google Pixel / 순정 Android 설정 > 휴대전화 정보 > 빌드 번호 설정 > 시스템 > 개발자 옵션
삼성 (One UI) 설정 > 휴대전화 정보 > 소프트웨어 정보 > 빌드 번호 설정 > 개발자 옵션 (목록 하단)
Xiaomi, Redmi, POCO (HyperOS) 설정 > 휴대전화 정보 > OS 버전 설정 > 추가 설정 > 개발자 옵션
Xiaomi (구형 MIUI) 설정 > 휴대전화 정보 > MIUI 버전 설정 > 추가 설정 > 개발자 옵션
OnePlus (OxygenOS) 설정 > 휴대전화 정보 > 버전 > 빌드 번호 설정 > 시스템 설정 > 개발자 옵션
OPPO / realme (ColorOS / realme UI) 설정 > 휴대전화 정보 > 버전 > 빌드 번호 설정 > 추가 설정 > 개발자 옵션
Motorola 설정 > 휴대전화 정보 > 빌드 번호 설정 > 시스템 > 개발자 옵션
Huawei / Honor (EMUI / MagicOS) 설정 > 휴대전화 정보 > 빌드 번호 설정 > 시스템 및 업데이트 > 개발자 옵션

OS 버전마다 메뉴 위치가 다를 수 있습니다. 빌드 번호를 찾을 수 없다면 설정을 열고 검색창에 “빌드 번호”를 입력해 보세요. 대부분의 Android 기기에서는 검색으로 바로 찾을 수 있습니다.

Google Pixel (Android 14, 15, 16)

  1. 열기 설정 그리고 ...로 스크롤하세요 휴대전화 정보.
  2. 맨 아래로 스크롤한 뒤 다음을 탭하세요 빌드 번호 일곱 번 연속으로 탭합니다. 몇 번 탭하다 보면 카운트다운 토스트 메시지가 나타납니다.
  3. PIN, 패턴 또는 비밀번호를 입력하세요.
  4. …로 돌아가세요 설정 > 시스템 > 개발자 옵션.

삼성 갤럭시

  1. 열기 설정 > 휴대폰 정보 > 소프트웨어 정보.
  2. 탭하세요 빌드 번호 7번 탭하고 PIN으로 확인하세요.
  3. 개발자 옵션 이제 '휴대폰 정보' 아래, 설정 목록 맨 아래에 표시됩니다.

Xiaomi, Redmi, POCO

  1. 열기 설정 > 휴대폰 정보.
  2. 탭하세요 OS 버전 (HyperOS) 또는 MIUI 버전 (구형 기기) 7번 탭하세요.
  3. 다음으로 이동: 설정 > 추가 설정 > 개발자 옵션.

Xiaomi는 개발에 필요한 두 가지 추가 스위치를 제공합니다: USB로 설치하기 및 USB 디버깅(보안 설정). 'USB를 통한 설치'가 없으면 adb install 실패합니다 INSTALL_FAILED_USER_RESTRICTED. 이 설정을 켜려면 Xiaomi 계정에 로그인하고 SIM 카드가 삽입되어 있어야 할 수 있습니다.

OnePlus, OPPO 및 realme

  1. 열기 설정 > 기기 정보 > 버전.
  2. 탭하세요 빌드 번호 7번.
  3. 열기 설정 > 시스템 설정 > 개발자 옵션 (OnePlus) 또는 설정 > 추가 설정 > 개발자 옵션 (OPPO, realme).

Huawei 및 Honor

  1. 열기 설정 > 휴대폰 정보.
  2. 탭하세요 빌드 번호 7번.
  3. 다음으로 이동: 설정 > 시스템 및 업데이트 > 개발자 옵션.

만약 adb USB로 Huawei 기기를 인식하지 못하면, USB 연결 모드를 파일 전송 연결할 때 설정하세요.

빌드 번호 누락 또는 “이 작업은 사용할 수 없습니다”

휴대폰 정보에서 잘못된 항목. 탭하면 Android 버전 또는 보안 패치 수준 개발자 모드를 활성화하지 않습니다. Samsung의 경우 소프트웨어 정보 > 빌드 번호를 사용하세요. Xiaomi의 경우 OS 버전 또는 MIUI 버전를 사용하세요. 상단의 일반 모델 이름이 아닙니다.

워크 프로필 또는 관리되는 기기. 워크 또는 학교 정책에 등록된 기기는 개발자 옵션을 차단하는 경우가 많습니다. 다음 메시지가 표시될 수 있습니다. 이 사용자는 개발자 옵션을 사용할 수 없습니다 또는 이 작업은 사용할 수 없습니다 Build number 항목을 탭할 때. 설정 > 계정 이 화면에 있는지 확인하세요 개인 프로필이며 업무용이 아닙니다. 정책을 우회하는 대신 IT 부서에 테스트 전용 기기를 요청하세요.

게스트 사용자 메인 사용자로 전환하세요: 설정 > 시스템 > 여러 사용자 (경로는 다를 수 있음) 다음에서 로그아웃: 게스트, 그런 다음 소유자 계정에서 7번 탭을 반복하세요.

자녀 보호 기능 및 제한된 프로필. Family Link나 제한된 보조 사용자는 Build number를 숨기거나 잠금 해제 제스처를 차단할 수 있습니다. 제한이 없는 소유자 계정을 사용하세요.

여전히 안 되나요? 재부팅하고 대기 중인 시스템 업데이트를 설치한 뒤, 설정에서 build number를 다시 검색하세요. 중고 기기인데 여전히 잠겨 있다면, 이전 소유자나 통신사가 기업용 제어 설정을 남겨두었을 수 있습니다.

USB 디버깅 켜기

  1. 열기 개발자 옵션 그리고 켜세요 USB 디버깅.
  2. 데이터 전송을 지원하는 USB 케이블로 휴대폰을 연결하세요. 저가형 케이블은 충전 전용인 경우가 많습니다.
  3. 휴대폰에서 다음을 수락하세요 USB 디버깅을 허용하시겠습니까? 대화 상자에서 체크하세요 이 컴퓨터에서 항상 허용 본인 컴퓨터에서
  4. 컴퓨터에서 연결 상태를 확인하세요:
adb devices

다음과 같이 표시되어야 합니다:

List of devices attached
R5CT1234ABC	device

unauthorized 프롬프트를 수락하지 않았다는 의미입니다. offline 보통 케이블이나 포트 불량, 또는 adb 이전 SDK 서버에서

adb Android SDK Platform-Tools와 함께 제공됩니다. Android Studio가 설치되어 있다면 다음 경로에 있습니다: ~/Library/Android/sdk/platform-tools macOS에서는 %LOCALAPPDATA%\Android\Sdk\platform-tools Windows에서는. 해당 폴더를 추가할 위치는 PATH. Android 툴체인이 처음이신가요? 저희 Capacitor 앱을 위한 Android 설정 가이드 에서 다룹니다.

무선 디버깅 켜기 (Android 11 이상)

무선 디버깅을 사용하면 케이블이 필요 없습니다. 컴퓨터와 휴대폰이 같은 Wi-Fi 네트워크에 있어야 하며, 일부 기업용이나 호텔 네트워크는 기기 간 통신을 차단할 수 있습니다.

  1. 다음에서 개발자 옵션, 다음을 켜세요 무선 디버깅 네트워크 프롬프트를 수락하세요.
  2. 탭하세요 무선 디버깅 열려면, 그다음 페어링 code로 기기 페어링. 이 화면을 계속 열어두세요.
  3. 컴퓨터에서 페어링 창에 표시된 IP 주소와 포트로 페어링하세요:
adb pair 192.168.1.42:37145
# Enter pairing code: 482913
  1. 무선 디버깅 메인 화면에 표시된 IP와 포트(페어링 포트와 다름)로 연결하세요:
adb connect 192.168.1.42:41827
adb devices

Android Studio에도 있습니다 Wi-Fi로 기기 페어링 기기 관리자에 무선 디버깅 화면에서 스캔할 QR code가 표시됩니다.

무선 디버깅이 재시작될 때마다 포트가 바뀌므로, 이 과정을 반복하게 됩니다 adb connect 재부팅 후에도 마찬가지입니다. 페어링 자체는 기억됩니다.

Android 10 이하에서는 이전 방법을 사용하세요: USB로 한 번 연결한 뒤 실행하고 adb tcpip 5555케이블을 분리한 다음 adb connect <phone-ip>:5555.

기기에서 Capacitor 앱 실행하기

기기가 목록에 표시되면 adb devices, Capacitor CLI로 직접 빌드 및 설치할 수 있습니다:

bun run build
bunx cap sync android
bunx cap run android --list        # show connected devices and emulators
bunx cap run android --target R5CT1234ABC

개발 루프를 더 빠르게 만들려면, 앱이 네트워크를 통해 dev server를 불러오도록 live reload를 사용하세요:

bunx cap run android -l --external

이 기능이 작동하려면 휴대폰이 컴퓨터의 IP에 접속할 수 있어야 합니다.

앱 실행 중 native logs를 확인하려면:

adb logcat | grep -i -E "capacitor|chromium"

WebView를 디버깅하려면, debug build가 실행 중일 때 desktop Chrome에서 chrome://inspect 를 여세요. Capacitor 앱의 debug build는 기본적으로 WebView debugging이 활성화되어 있습니다.

문제 해결

Build number를 탭해도 아무 반응이 없습니다. 잘못된 항목(예: Build number 대신 Android version)을 탭했거나, 기기가 조직에서 관리되고 있을 수 있습니다. 일부 Xiaomi 기기는 Build number가 아닌 OS version을 탭해야 합니다.

기기 목록에 없음 adb devices.

adb kill-server
adb start-server
adb devices

그다음 다른 케이블을 쓰고, 허브 대신 컴퓨터에 직접 꽂는 포트를 사용해 보세요. USB 모드 알림을 파일 전송.

Windows에서 휴대폰을 인식하지 못합니다. OEM USB 드라이버(Samsung, Xiaomi 등 각 제조사 제공)를 설치하거나, Pixel 기기의 경우 SDK Manager에서 Google USB Driver를 설치하세요.

INSTALL_FAILED_UPDATE_INCOMPATIBLE. 설치된 앱이 다른 키로 서명되어 있습니다(예: Play Store 빌드와 디버그 빌드). 먼저 앱을 제거하세요: adb uninstall com.example.app.

INSTALL_FAILED_USER_RESTRICTED Xiaomi 기기에서. 활성화 USB로 설치하기 개발자 옵션에서.

무선 디버깅이 계속 꺼집니다. Wi-Fi 네트워크를 변경하면 Android가 무선 디버깅을 끕니다. 일부 배터리 절약 기능도 이를 중지시킵니다. 긴 세션 동안에는 휴대폰을 같은 네트워크에 연결한 채 충전해 두세요.

Android Studio 업데이트 후 Unauthorized 오류 adb 키가 ~/.android/adbkey 변경되었습니다. 개발자 옵션에서 USB 디버깅 승인 취소를 누른 뒤 다시 연결하고 prompt를 다시 수락하세요.

개발자 옵션을 끄는 방법

  1. 열기 개발자 옵션.
  2. 토글 개발자 옵션 사용 (또는 개발자 옵션 Samsung의 경우) 상단에서 꺼짐으로 설정하세요.

일부 기기에서는 메뉴가 계속 보일 수 있고, 개발자 옵션이 꺼져 있어도 개별 토글은 마지막 값이 유지될 수 있습니다. 메뉴를 완전히 숨기려면 설정 > 앱 > 설정 > 저장공간 으로 이동해 설정 앱의 저장공간을 비우세요. 다른 설정도 함께 초기화되므로 굳이 할 필요는 거의 없습니다.

테스트용 휴대폰을 다른 사람에게 넘기기 전에 다음도 누르세요. USB 디버깅 승인 취소 기존 컴퓨터가 더 이상 연결되지 않도록 하세요.

보안 유의 사항

  • USB 디버깅은 승인된 컴퓨터가 디버그 가능한 빌드에서 앱을 설치하고 앱 데이터를 읽을 수 있게 합니다. 공공 충전소나 신뢰할 수 없는 컴퓨터에서 RSA 프롬프트를 승인하지 마세요.
  • 일부 은행 및 결제 앱은 개발자 옵션이나 USB 디버깅이 켜져 있으면 실행을 거부합니다. 사용이 끝나면 개인 휴대폰에서 해당 옵션을 꺼 두세요.
  • 릴리스 빌드에 다음을 포함하여 배포하지 마세요: android:debuggable="true". Capacitor 릴리스 빌드는 기본적으로 디버깅할 수 없습니다.

자주 묻는 질문

빌드 번호 없이 개발자 옵션을 활성화하는 방법은 무엇인가요?

모든 Android 스마트폰에는 빌드 번호가 있지만, 일부 브랜드는 이름을 변경하거나 위치를 옮깁니다. Samsung의 경우 설정 > 휴대폰 정보 > 소프트웨어 정보로 이동한 후 빌드 번호를 7번 탭하세요. Xiaomi HyperOS에서는 OS 버전을, 구형 MIUI에서는 MIUI 버전을 탭하세요. 그래도 찾지 못하면 설정 검색창에 '빌드 번호'를 입력하세요. 보기 빌드 번호가 없습니다 업무 프로필 및 제한된 사용자의 경우.

Android 14 또는 15에서 빌드 번호를 몇 번 눌러야 하나요?

7번 연속으로 탭 빌드 번호 (또는 OS 버전 / MIUI 버전 Xiaomi 기기의 경우) 3~4회 탭하면 Android가 카운트다운 토스트를 표시합니다. 프롬프트에 따라 기기 PIN, 패턴 또는 비밀번호를 입력한 후 개발자 옵션 설정에서 열기.

삼성 기기에서 빌드 번호는 어디에 있나요?

설정 > 휴대폰 정보 > 소프트웨어 정보 > 빌드 번호. 7번 탭하고 PIN을 확인한 뒤, 개발자 옵션 메인 설정 목록 하단에서 찾으세요.

무선 디버깅은 어떻게 페어링하나요?

켜기 무선 디버깅 Developer options에서 해당 항목을 열고 선택하세요. 페어링 code로 기기 페어링. 컴퓨터에서 다음 명령어를 실행하세요 adb pair <ip>:<pairing-port>, 6자리 code를 입력한 후, adb connect <ip>:<debug-port> 무선 디버깅 메인 화면에 표시된 주소를 사용하세요 (페어링 포트가 아님).

업무용 휴대폰에서도 개발자 옵션을 켤 수 있나요?

일반적으로 IT 승인 없이는 불가능합니다. 관리되는 기기에서는 빌드 번호 탭 제스처를 차단하거나 다음과 같이 표시합니다. 이 작업은 사용할 수 없습니다. 개인용 또는 테스트 전용 단말기를 adb USB 디버깅에도 사용하세요.

Capacitor 앱용 Live updates

웹 레이어 버그가 라이브 상태라면, 앱 스토어 승인을 며칠씩 기다리지 말고 Capgo를 통해 수정 사항을 배포하세요. 네이티브 변경 사항은 정상 리뷰 절차를 그대로 따르는 반면, 사용자는 백그라운드에서 업데이트를 받습니다.

블로그 최신 글

Capgo는 정말 프로페셔널한 모바일 앱을 만드는 데 필요한 최고의 인사이트를 제공합니다.