PC에서 USB 디버깅으로 폰에 APK를 직접 설치하는 방식은?

ADB 설치는 PC에서 USB 디버깅으로 폰에 APK를 직접 설치하는 방식입니다.
Play Protect가 APK 파일 터치 설치를 막을 때, 개발 테스트용으로 가장 많이 쓰는 방법입니다.

1. 전체 흐름

1. 폰에서 개발자 옵션 켜기
2. USB 디버깅 켜기
3. PC와 폰 USB 연결
4. ADB에서 폰 인식 확인
5. 기존 앱 삭제
6. APK 설치
7. 앱 실행 후 권한 허용

 

---

1단계. 폰에서 개발자 옵션 켜기

삼성폰 기준입니다.

설정
→ 휴대전화 정보
→ 소프트웨어 정보
→ 빌드번호 7번 터치
→ 개발자 모드가 켜졌습니다 표시

 

중간에 PIN 또는 패턴 입력을 요구할 수 있습니다.

---

2단계. USB 디버깅 켜기

설정
→ 개발자 옵션
→ USB 디버깅 ON

 

추가로 있으면 아래도 켜면 좋습니다.

USB 디버깅
USB로 설치
USB 디버깅 보안 설정

 

기종에 따라 이름이 조금 다릅니다.

---

3단계. PC와 폰 연결

USB 케이블로 연결합니다.

폰 화면에 아래와 같은 팝업이 나오면 허용합니다.

USB 디버깅을 허용하시겠습니까?
이 컴퓨터에서 항상 허용
[허용]

 

반드시 허용을 눌러야 합니다.

---

4단계. ADB 위치 확인

보통 아래 경로에 있습니다.

 

%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe

 

확인 명령:

 

dir "%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe"

 

또는 Visual Studio Android SDK 경로를 쓰는 경우:

 

dir "C:\Program Files (x86)\Android\android-sdk\platform-tools\adb.exe"

 

---

5단계. 폰 인식 확인

명령 프롬프트에서 실행합니다.

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" devices

 

정상이라면 이렇게 나옵니다.

List of devices attached
R3CNxxxxxxx    device

 

또는 에뮬레이터는 이렇게 나옵니다.

emulator-5554  device

 

unauthorized 라고 나오면

R3CNxxxxxxx    unauthorized

 

이 경우:

1. 폰 화면 잠금 해제
2. USB 디버깅 허용 팝업 확인
3. 허용 누르기

 

그래도 안 되면:

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" kill-server
"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" start-server
"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" devices

 

---

6단계. 기존 앱 삭제

기존에 설치된 eSMS가 있으면 삭제합니다.

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" uninstall com.eplus.esms

 

정상 삭제되면:

Success

 

설치된 앱이 없으면 아래처럼 나올 수 있습니다.

Failure [DELETE_FAILED_INTERNAL_ERROR]

 

또는:

Unknown package

 

이 경우는 무시해도 됩니다.

---

7단계. APK 설치

APK 파일 경로를 확인합니다.

MAUI Release APK는 보통 여기에 있습니다.

C:\eplusC#\eSMS\bin\Release\net9.0-android\publish\com.eplus.esms-Signed.apk

 

설치 명령:

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" install -r "C:\eplusC#\eSMS\bin\Release\net9.0-android\publish\com.eplus.esms-Signed.apk"

 

정상 설치되면:

Success

 

---

8단계. 설치 실패별 해결

1. INSTALL_FAILED_UPDATE_INCOMPATIBLE

기존 앱과 서명키가 다를 때입니다.

해결:

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" uninstall com.eplus.esms

 

다시 설치:

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" install "C:\eplusC#\eSMS\bin\Release\net9.0-android\publish\com.eplus.esms-Signed.apk"

 

---

2. INSTALL_FAILED_VERSION_DOWNGRADE

폰에 설치된 앱보다 APK 버전이 낮을 때입니다.

해결:

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" uninstall com.eplus.esms

 

또는 eSMS.csproj에서 버전코드를 올립니다.

 

<ApplicationVersion>4</ApplicationVersion>
<ApplicationDisplayVersion>1.0.4</ApplicationDisplayVersion>

 

---

3. INSTALL_FAILED_INSUFFICIENT_STORAGE

폰 저장공간 부족입니다.

설정 → 디바이스 케어 → 저장공간 정리

 

후 다시 설치합니다.

---

4. device unauthorized

폰에서 USB 디버깅 허용을 안 한 상태입니다.

폰 화면 잠금 해제
→ USB 디버깅 허용 팝업 확인
→ 이 컴퓨터에서 항상 허용
→ 허용

 

---

5. no devices/emulators found

PC가 폰을 못 찾는 상태입니다.

확인:

USB 케이블 교체
USB 포트 변경
폰 USB 모드 파일 전송으로 변경
삼성 USB 드라이버 설치
개발자 옵션 USB 디버깅 ON 확인

 

---

9단계. 설치 후 권한 허용

설치 후 앱을 한 번 실행합니다.

eSMS는 아래 권한을 허용해야 합니다.

SMS 수신 권한
위치 권한
알림 권한

 

폰 설정에서 직접 확인:

설정
→ 앱
→ 문자메일도우미
→ 권한
→ SMS 허용
→ 위치 허용
→ 알림 허용

 

---

10단계. 문자 수신 테스트

실제 폰은 다른 폰에서 문자를 보내 테스트하면 됩니다.

에뮬레이터는 ADB로 테스트합니다.

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" emu sms send 01012345678 "테스트 문자입니다"

 

금융 조건 테스트:

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" emu sms send 01012345678 "카드 승인 12000원 테스트 결제"

 

위치 포함 테스트:

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" emu sms send 01012345678 "나 어디 있어 위치 확인해줘"

 

---

11단계. 실제 폰 설치용 명령 정리

아래 순서대로 복사해서 실행하면 됩니다.

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" devices

 

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" uninstall com.eplus.esms

 

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" install -r "C:\eplusC#\eSMS\bin\Release\net9.0-android\publish\com.eplus.esms-Signed.apk"

 

---

12단계. APK 다시 만들기

프로젝트 폴더에서 실행합니다.

 

cd /d "C:\eplusC#\eSMS"

 

 

dotnet publish -f net9.0-android -c Release -p:AndroidPackageFormat=apk

 

생성 위치:

C:\eplusC#\eSMS\bin\Release\net9.0-android\publish\

 

설치:

 

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" install -r "C:\eplusC#\eSMS\bin\Release\net9.0-android\publish\com.eplus.esms-Signed.apk"

 

---

가장 추천하는 작업 순서

 

cd /d "C:\eplusC#\eSMS"

dotnet clean

rmdir /s /q bin
rmdir /s /q obj

dotnet publish -f net9.0-android -c Release -p:AndroidPackageFormat=apk

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" devices

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" uninstall com.eplus.esms

"%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe" install -r "C:\eplusC#\eSMS\bin\Release\net9.0-android\publish\com.eplus.esms-Signed.apk"

 

설치가 성공하면 폰에서 문자메일도우미 앱을 실행하고, 설정 저장 후 실제 문자 수신 테스트를 하면 됩니다.