---
title: Android 11 보안정책에 따른 앱 패키지 등록 안내
category: 업데이트
tags:
- 업데이트
datetime: 2021-12-21T15:00:00.000Z
---
안녕하세요.
포트원 기술지원팀입니다.
Android 11 (SDK 30) 부터 패키지 가시성 정책이 변경되어 기존 사용하시던 로직에서 문제가 발생할 수 있습니다.
2021년 11월부터 구글 플레이 스토어에 새로 등록하거나, 업데이트 되는 앱 모두 targetSdkVersion 30 이상의 반영이 강제되기 때문에 본 가이드를 보시고 조치를 취하시기 바랍니다.
#### 이슈
앱 targetSdkVersion 30 에서 패키지 가시성을 요구하는 함수(queryIntentActivities(), getInstalledApplications(), getInstalledApplications(), resolveActivity() 등) 호출시,패키지 가시성이 확보 되지 않았다면 null 로 return 되어 정상적인 비즈니스 로직을 수행할 수 없음.
#### 조치방안
- Android 에서 포트원 제공 앱 플러그인(SDK) 사용 고객사\
iamport-android, iamport-flutter, iamport-react-native 등
- SDK 내에서 패키지 가시성을 요구하지 않기 때문에 별도의 조치사항이 없습니다.
- Android 에서 포트원 javascript SDK 을 직접 연동하는 고객사\
아래 두가지 방안에서 선택하여 처리하시기 바랍니다.
- WebViewClient shouldOverrideUrlLoading()에서 예외처리 로직 추가 방안\
별도의 앱패키지 리스트 관리가 필요치 않기에 해당 방식을 권장합니다
- 결제앱 설치여부 확인 등을 위해 패키지 정보를 조회하는 경우 해당 로직을 제거합니다.
- queryIntentActivities(), getInstalledApplications(), getInstalledApplications(), resolveActivity() 등의 함수
- 결제앱 설치 여부의 확인은 startActivity() 호출시 ActivityNotFoundException 발생을 catch 하여 앱 미설치 상황이라 간주하고, 앱마켓 이동 등 앱 미설치시 로직을 처리합니다.
- 예시코드
```kotlin
// 예시코드이며 고객사 구현에 따라 다를 수 있습니다.
override fun shouldOverrideUrlLoading(view: WebView?, request: WebResourceRequest?): Boolean {
request?.url?.let {
if (it.scheme == "about") {
return true // 이동하지 않음
}
val urlStr = it.toString()
if (!URLUtil.isNetworkUrl(urlStr) && !URLUtil.isJavaScriptUrl(urlStr)) {
openPaymentApp(urlStr) // 앱이동
return true
}
//..기타로직 중략.. (m_redirect_url 결과 체크 등)
}
return super.shouldOverrideUrlLoading(view, request)
}
fun openPaymentApp(url: String) {
Intent.parseUri(url, Intent.URI_INTENT_SCHEME)?.let { intent: Intent ->
runCatching {
startActivity(intent) // 앱 이동
}.recoverCatching {
// 앱이동에 실패(미설치)시 앱스토어로 이동
val packageName = intent.getPackage()
if (!packageName.isNullOrBlank()) {
startActivity(Intent(Intent.ACTION_VIEW, Uri.parse("market://details?id=$packageName")))
}
}
}
}
```
- AndroidManifest.xml 수정을 통한 패키지 가시성 확보 방안\
사용하는 PG 에 따라 다를 수 있으며, 새로운 결제수단의 추가시 매번 추가하여 새로 배포되어야 합니다.\
아래 패키지 등록시 패키지 가시성이 확보되어 패키지 가시성을 요구하는 함수에서 정상적인 응답을 받을 수 있습니다.
```html
<queries>
<!--간편결제-->
<package android:name="finance.chai.app" /> <!--차이페이-->
<package android:name="com.nhnent.payapp" /> <!--페이코-->
<package android:name="com.lottemembers.android" /> <!--LPAY-->
<package android:name="com.ssg.serviceapp.android.egiftcertificate" /> <!--SSGPAY-->
<package android:name="com.inicis.kpay" /> <!--KPAY-->
<package android:name="com.tmoney.tmpay" /> <!--티머니페이-->
<package android:name="viva.republica.toss" /> <!--토스페이-->
<package android:name="com.samsung.android.spay" /> <!--삼성페이-->
<package android:name="com.kakao.talk" /> <!--카카오페이-->
<package android:name="com.nhn.android.search" /> <!--네이버-->
<package android:name="com.mysmilepay.app" /> <!--스마일페이-->
<!--카드-->
<package android:name="kvp.jjy.MispAndroid320" /> <!--ISP페이북-->
<package android:name="com.kbcard.cxh.appcard" /> <!--KBPay-->
<package android:name="com.kbstar.liivbank" /> <!--리브-->
<package android:name="com.kbstar.reboot" /> <!--리브-->
<package android:name="com.samsung.android.spaylite" /> <!--삼성페이-->
<package android:name="com.nhnent.payapp" /> <!--페이코-->
<package android:name="com.lge.lgpay" /> <!--엘지페이-->
<package android:name="com.hanaskcard.paycla" /> <!--하나-->
<package android:name="kr.co.hanamembers.hmscustomer" /> <!--하나멤버스-->
<package android:name="com.hanaskcard.rocomo.potal" /> <!--하나공인인증-->
<package android:name="com.citibank.cardapp" /> <!--씨티-->
<package android:name="kr.co.citibank.citimobile" /> <!--씨티모바일-->
<package android:name="com.lcacApp" /> <!--롯데-->
<package android:name="kr.co.samsungcard.mpocket" /><!--삼성-->
<package android:name="com.shcard.smartpay" /> <!--신한-->
<package android:name="com.shinhancard.smartshinhan" /> <!--신한(ARS/일반/smart)-->
<package android:name="com.hyundaicard.appcard" /> <!--현대-->
<package android:name="nh.smart.nhallonepay" /> <!--농협-->
<package android:name="kr.co.citibank.citimobile" /> <!--씨티-->
<package android:name="com.wooricard.smartapp" /> <!--우리WON카드-->
<package android:name="com.wooribank.smart.npib" /> <!--우리WON뱅킹-->
<!--백신-->
<package android:name="com.TouchEn.mVaccine.webs" /> <!--TouchEn-->
<package android:name="com.ahnlab.v3mobileplus" /> <!--V3-->
<package android:name="kr.co.shiftworks.vguardweb" /> <!--vguard-->
<!--신용카드 공인인증-->
<package android:name="com.hanaskcard.rocomo.potal" /> <!--하나-->
<package android:name="com.lumensoft.touchenappfree" /> <!--현대-->
<!--계좌이체-->
<package android:name="com.kftc.bankpay.android" /> <!--뱅크페이-->
<package android:name="kr.co.kfcc.mobilebank" /> <!--MG 새마을금고-->
<package android:name="com.kbstar.liivbank" /> <!--뱅크페이-->
<package android:name="com.nh.cashcardapp" /> <!--뱅크페이-->
<package android:name="com.knb.psb" /> <!--BNK경남은행-->
<package android:name="com.lguplus.paynow" /> <!--페이나우-->
<package android:name="com.kbankwith.smartbank" /> <!--케이뱅크-->
<!--해외결제-->
<package android:name="com.eg.android.AlipayGphone" /> <!--페이나우-->
<!--기타-->
<package android:name="com.sktelecom.tauth" /> <!--PASS-->
<package android:name="com.lguplus.smartotp" /> <!--PASS-->
<package android:name="com.kt.ktauth" /> <!--PASS-->
<package android:name="kr.danal.app.damoum" /> <!--다날 다모음-->
</queries>
```
---
#### 주의사항
targetSdkVersion 30 이상 구글 플레이 스토어 배포 전반드시 앱카드 또는 간편결제 App 이동이 이루어지는지 결제 테스트를 해보시기 바라며,특이사항 발생시 아임포트 기술지원으로 문의 주시기 바랍니다.
아임포트기술지원 <support@iamport.kr>
---
참고
- <https://developer.android.com/training/basics/intents/package-visibility?hl=ko>
- [https://docs.tosspayments.com/guides/webview#2-앱-스킴-실행을-위한-코드-추가하기](https://docs.tosspayments.com/guides/webview#2-%EC%95%B1-%EC%8A%A4%ED%82%B4-%EC%8B%A4%ED%96%89%EC%9D%84-%EC%9C%84%ED%95%9C-%EC%BD%94%EB%93%9C-%EC%B6%94%EA%B0%80%ED%95%98%EA%B8%B0)
- [https://docs.tosspayments.com/misc/faq#q-android-11api-수준-30-이상인-앱에서-패키지-공개-상태-관리-대응은-어떻게-하나요](https://docs.tosspayments.com/misc/faq#q-android-11api-%EC%88%98%EC%A4%80-30-%EC%9D%B4%EC%83%81%EC%9D%B8-%EC%95%B1%EC%97%90%EC%84%9C-%ED%8C%A8%ED%82%A4%EC%A7%80-%EA%B3%B5%EA%B0%9C-%EC%83%81%ED%83%9C-%EA%B4%80%EB%A6%AC-%EB%8C%80%EC%9D%91%EC%9D%80-%EC%96%B4%EB%96%BB%EA%B2%8C-%ED%95%98%EB%82%98%EC%9A%94)
- <https://www.inicis.com/blog/archives/127961><https://www.ksnet.co.kr/Bbs/Details/?id=2862&ci=NOTICE>[https://support.eximbay.com/hc/ko/search?utf8=✓\&category=360003524133\&query=안드로이드+11+](https://support.eximbay.com/hc/ko/search?utf8=%E2%9C%93\&category=360003524133\&query=%EC%95%88%EB%93%9C%EB%A1%9C%EC%9D%B4%EB%93%9C+11+)
