[안드로이드] 갤럭시 S24 앱이 휴대전화와 호환되지 않아서 설치되지 않았습니다.

갤럭시 S24 단말기에서 "앱이 휴대전화와 호환되지 않아서 설치되지 않았습니다." 이슈 발생 시 아래 항목을 점검하시기 바랍니다.

1. targetSdkVersion

 - 갤럭시 S24 단말기는 Android14(SDKVersion 34) OS로 출시된 단말기이며 구글에서는 맬웨어의 위험을 최소화하기 위해. 안드로이드 14부터 구 버전안드로이드를 기반으로 한 앱의 설치를 금지했습니다. 

 - 현재 안드로이드 정책상 안드로이드 14 단말기에서 앱을 동작시키기 위해 최소 targetSdkVersion을 23 이상으로 지정해야 합니다. 기본적으로 compileSdkVersion는 변경할 필요는 없지만 앱이 빌드된 방식과 앱에서 사용하는 플랫폼 기능에 따라 달라질 수 있기 때문에 최소 targetSdkVersion에 맞게 조정하시는 것을 권장합니다. 

[참고문서]

https://developer.android.com/about/versions/14/migration?hl=ko#compat

https://developer.android.com/about/versions/14/behavior-changes-all?hl=ko#minimum-target-api-level

*[AndroidManifest.xml 설정 예시]

<uses-sdk android:minSdkVersion="19" android:targetSdkVersion="33"/>

* [build.gradle 설정 예시]

defaultConfig {
    applicationId "[애플리케이션 id]"
    minSdkVersion 19
    targetSdkVersion 33
    ...
}

*AndroidManifest.xml에 uses-sdk 태그로 관리하게 되는 경우 버전이 변경 되더라도 변경된 정보로 build 되지 않는 경우가 있기 때문에 build.gradle로 적용하시는 것을 권장합니다.

2. 아키텍처

갤럭시 S24 부터 64비트로 생성된 앱만 지원하도록 변경되어 기존의 32비트로 동작하는 앱이 호환성 이슈로 설치되지 않거나 설치되더라도 정상적으로 동작하지 않는 현상이 발생할 수 있습니다.

 - 라이선스 유효기간이 지났거나, 라이선스 파일을 보유하고 있지 않는 경우 기술지원 게시판으로 문의주시기 바랍니다.

 - libs > 아키텍처별 so파일 적용 환경을 확인하시고 64비트 아키텍처가 적용되어있지 않는 경우 아래 내용을 확인하시기 바랍니다.  

[IDE에서 라이선스 적용방법]

IDE > applucation.xml > 라이선스 편집 > 라이선스 선택 > Android CPU Type 체크박스 모두선택

[프로젝트에서 직접 적용방법]

라이선스파일 /licence/lic 파일 > assets/res/lic파일 변경

라이선스 android/[아키텍처폴더] >> libs 경로에 아키텍처 폴더 적용

libmcrypt.so파일이 사용되고 있는 경우 아래 주소에서 아키텍처별 파일을 다운로드 받으실 수 있습니다. 

https://wiki.uracle.co.kr/madp/client/android_ref#h-7-libmcryptso-cpu-type-%EB%B3%84-jni-%ED%8C%8C%EC%9D%BC-%EB%8B%A4%EC%9A%B4%EB%A1%9C%EB%93%9C

3. 휴대전화 설정

휴대전화의 설정에서 "출처를 알 수 없는 앱 설치" 설정을 확인하고 필요하다면 활성화하세요. 기본적으로 이 옵션이 꺼져 있으면 Google Play Store 외부에서 앱을 설치할 수 없습니다.