212. (TWOK/WORK) [업무 이슈] 안드로이드 apk 앱 설치 파일 설치 수행 시 ' 패키지가 충돌했습니다. ' , ' 앱이 설치되지 않았습니다 ' 메시지 표시 이슈

---

[제 목]

​

주제 : 투케이2K 업무 정리

​

타이틀 : 투케이 / 2k / 업무 정리

​

제목 : [업무 이슈] 안드로이드 apk 앱 설치 파일 설치 수행 시 ' 패키지가 충돌했습니다. ' , ' 앱이 설치되지 않았습니다 ' 메시지 표시 이슈

​

 

---

[내 용]

​

------------------------------------------------------------------------------
[개발 및 테스트 환경]
------------------------------------------------------------------------------

- 제 목 : [업무 이슈] 안드로이드 apk 앱 설치 파일 설치 수행 시 ' 패키지가 충돌했습니다. ' , ' 앱이 설치되지 않았습니다 ' 메시지 표시 이슈


- 테스트 환경 : Mobile / Android / APK


- 사전) 👉 APK (Android Application Package) 파일 간략 설명

  >> APK 는 안드로이드 앱을 설치하기 위한 배포 파일 형식입니다.

    - PC 에서의 .exe, iOS의 .ipa와 같은 역할을 합니다.

  >> APK 파일 하나에 앱 실행에 필요한 모든 것이 포함되어 있습니다.

    - 앱 코드 (Java / Kotlin → DEX)
    - UI 리소스 (XML, 이미지, 문자열)
    - 앱 설정 (AndroidManifest.xml)
    - 서명 정보 (인증서)

  >> APK 내부 구조 (중요) : APK 는 사실상 ZIP 파일입니다. (확장자만 .apk)

    app.apk
    ├─ AndroidManifest.xml : 앱의 기본 정보 (패키지명, 권한, Activity 등)
    ├─ classes.dex : 앱 실행 코드 (Dalvik/ART용 바이트코드)
    ├─ resources.arsc 
    ├─ res/ : 레이아웃, 아이콘, 문자열
    ├─ assets/ : 그대로 사용하는 리소스
    ├─ lib/ : 네이티브 라이브러리 (.so)
    └─ META-INF/ : 서명정보 (매우 중요)

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[이슈 사항]
------------------------------------------------------------------------------

1. 안드로이드 특정 앱에서 ' 출처를 알 수 없는 앱 설치 ' 권한 부여 후 APK 파일 설치 및 업데이트 진행 시 

  ❌ ' 패키지가 충돌했습니다. ' 

  ❌ ' 앱이 설치되지 않았습니다 ' 
  
  메시지가 표시 이슈 문의


2. 사전 앱 조건 설명)

  >> 앱에는 출처를 알 수 없는 앱 설치 권한 부여 된 상태

  >> 기존 APK 파일에서 새로운 버전 앱 파일 업데이트 수행 시 위와 같은 에러 메시지가 표시 되는 이슈

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[원인 파악 및 증상 재현]
------------------------------------------------------------------------------

1. 기존 앱 배포 사이트에 올라가져 있는 APK 파일 다운로드 수행


2. 휴대폰에 APK 파일 설치 진행


3. 앱 배포 사이트에 새로운 신규 버전 앱 파일 업로드 수행


4. 특정 앱 실행 후 자동으로 앱 업데이트 알림 팝업창이 표시 되는 것 확인


5. 앱 업데이트 진행 버튼 클릭


6. 앱 설치 진행 중에 ❌ ' 패키지가 충돌했습니다. '  , ❌ ' 앱이 설치되지 않았습니다 ' 메시지가 표시 되는 것 확인


7. ✅ 변경 된 사항 확인 시 Git 에 업로드 된 소스 코드는 동일하지만 build.gradle 파일에서 release , debug 에 사용 되는 signingConfigs 값이 기존과 다른 것 확인

  >> 기존 앱 파일과 사인 된 값이 달라서 위와 같은 에러 메시지가 표시 되는 것 확인

  >> ✔️ 안드로이드 키툴 (Keytool) 사용해 apk 파일 앱 서명 정보 확인 시 기존 설치 된 APK 파일과 신규로 설치하려는 APK 파일 인증서 지문 정보가 다른 것 확인

------------------------------------------------------------------------------






------------------------------------------------------------------------------
[조치 내용]
------------------------------------------------------------------------------

1. build.gradle 파일에서 앱 빌드 시 사용 된 jks 및 keystore 정보를 기존 앱과 동일하게 설정 수행

  android {
      namespace "com.twok.app"
      compileSdk 35

      defaultConfig {
          applicationId "com.twok.app"
          minSdkVersion 26
          targetSdk 35

          // 코틀린 이슈[minSdkVersion 20 이하 "AndroidX를 사용하지 않는" 경우]
          multiDexEnabled true

          // ----------------------------------------
          // TODO 앱 업데이트 시 해당 값 중요
          // ----------------------------------------
          versionCode = 38 // 해당 값 중요 > 앱 업데이트 판단
          versionName = "2.5.2"
          // ----------------------------------------
      }

      // ✅ 키스토어 설정 정보
      signingConfigs {
          release {
              storeFile file("signature/keystore") // TODO Project >> app >> signature 폴더 >> keystore 파일 첨부 시 경로
              storePassword "twok1234"
              keyAlias "twok2k"
              keyPassword "twok1234"
          }
          debug {
              storeFile file('../keystore') // TODO Project >> keystore 파일 첨부 시 경로
              storePassword "twok1234"
              keyAlias "twok2k"
              keyPassword "twok1234"
          }
      }

  }


2. 앱 프로젝트 build.gradle sync 동기화 수행 후 다시 앱 재빌드 수행 실시


3. 재빌드 된 APK 앱 파일 다시 설치 진행 시 정상적으로 앱이 신규 버전으로 업데이트 되는 것 확인


4. ✅ 추가) ❌ ' 패키지가 충돌했습니다. '  , ❌ ' 앱이 설치되지 않았습니다 ' 메시지가 표시 될 수 있는 추가 상황 정리

  >> ✔️ 이미 기기에 설치된 앱과 지금 설치하려는 APK 서명키가 다른 경우 문제 발생

    - Android 보안 정책상 서명이 다르면 “업데이트” 불가 >> 그래서 “패키지 충돌” 발생

  >> ✔️ Play Store 에 설치된 앱이 있는데, 로컬 APK 설치 시 문제 발생

    - Play Store 앱 → Google App Signing 키 / 개발 PC APK → 로컬 keystore 👉 키가 다르므로 충돌 발생 가능

  >> ✔️ OS 제조사 커스텀 APK 

    - 시스템 앱으로 사전 설치됨 >> 동일 패키지명 앱 설치 시 충돌

------------------------------------------------------------------------------





------------------------------------------------------------------------------
[참고 사이트]
------------------------------------------------------------------------------

▶️ [Android] [출처 알 수 없는 앱 설치 허용] 앱 업데이트 여부 판단 및 앱 업데이트 수행 실시 - vnd.package-archive

https://kkh0977.tistory.com/4842

https://blog.naver.com/kkh0977/223258123850?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 키툴 (Keytool) 사용해 apk 실행 파일 앱 서명 정보 확인 방법]

https://kkh0977.tistory.com/6834

https://blog.naver.com/kkh0977/223550265510?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 apksigner 사용해 특정 apk 파일 jks , keystore 서명 인증 수행]

https://kkh0977.tistory.com/6973

https://blog.naver.com/kkh0977/223582075557?trackingCode=blog_bloghome_searchlist


▶️ [안드로이드 apksigner 사용해 특정 apk 파일 서명 인증 타입 확인 수행 (v1 , v2)]

https://kkh0977.tistory.com/6972

https://blog.naver.com/kkh0977/223582072292?trackingCode=blog_bloghome_searchlist


▶️ [업무 이슈] 안드로이드 apk 파일 빌드 시 필요한 jks 파일 alias 명칭 초기화 및 잊어 버림 이슈

https://kkh0977.tistory.com/7197

https://blog.naver.com/kkh0977/223626175927?trackingCode=blog_bloghome_searchlist


▶️ [업무 이슈] 삼성 갤럭 시 스마트폰 apk 파일 설치 시 보이스 피싱 의심 앱 설치 불가 문의 - 무시하고 설치 버튼 미표시

https://kkh0977.tistory.com/7974

https://blog.naver.com/kkh0977/223828837077?trackingCode=blog_bloghome_searchlist


▶️ [IT 정보] 구글 플레이 프로텍트 (Google Play Protect) 사용 해제 및 apk 파일 무시하고 설치 방법 (알 수 없는 앱 설치)

https://kkh0977.tistory.com/6333

https://blog.naver.com/kkh0977/223469956481?trackingCode=blog_bloghome_searchlist

------------------------------------------------------------------------------

 

---

[참고 사이트]

​

https://kkh0977.tistory.com/4842

36. (TWOK/LOGIC) [Android] [출처 알 수 없는 앱 설치 허용] 앱 업데이트 여부 판단 및 앱 업데이트 수행

---