Google 정책에 따른 조치사항을 알려드립니다

안녕하세요 휴머스온입니다. Google의 플레이스토어 배포 정책이 변경되어 어플리케이션에 조치가 필요하게 되었습니다. 가이드에 맞게 조치를 하지 않을 경우 특정 조건에 따라 앱이 강제 종료 될 수 있기 때문에 되도록 가이드에 따라 반영하여 주시기 바랍니다.

변경된 플레이스토어 배포 정책

• 2019년 11월 1일부터 기존 앱은 대상 SDK 버전을 28이상으로 설정하여야 합니다.
  • 대상 SDK 버전을 28이상으로 설정하시지 않을 경우 앱을 업데이트 하실 수 없습니다.
  • Google의 입장에 따르면 대상 SDK 버전은 매년 최신 버전을 요구할 계획이라고 합니다.

대상 SDK 버전 변경에 따른 조치사항

1. Apache HTTP 클라이언트 지원 중단

Android 9.0에서 Apache HTTP 클라이언트 지원이 중단되었습니다. 실제로 지원이 중단된 것은 Android 6.0 버전이나 Android 9.0 이상부터는 특정 예외 처리 없이 Apache HTTP 클라이언트를 사용할 경우 NoClassDefFoundError 예외가 발생합니다.

대응하지 않을 경우

이미지가 포함된 푸시를 수신받았을때 앱이 강제 종료됩니다.

적용대상

• 대상 SDK 버전이 28이상으로 설정된 어플리케이션
• Android 9.0이상의 OS가 탑재된 디바이스

해결방법

어플리케이션 AndroidManifest.xml에 다음 사항을 추가하여 주시기 바랍니다.

<uses-library android:name="org.apache.http.legacy" android:required="false"/>

2. 프레임워크 보안 변경사항

Android 9.0에서 TLS를 사용한 통신이 기본값으로 적용되었습니다. 그에따라 별도로 예외처리 하지 않고 TLS를 사용하지 않은 연결을 사용한다면 실패로 처리됩니다.

대응하지 않을 경우

API 호출 시 실패 응답이 떨어집니다. 앱은 강제 종료되지 않습니다.

적용대상

• 대상 SDK 버전이 28이상으로 설정된 어플리케이션
• Android 9.0이상의 OS가 탑재된 디바이스

해결방법

해결 방법은 두가지 방법이 있으며 방법 중 한 가지 방법만 적용하여도 무방합니다.

• 서버에서 TLS 기반 통신망 구축
  • 해당 작업은 서버의 변경이 필요하며 관련 담당자에게 문의하여 주시기 바랍니다.

• 어플리케이션에서 TLS를 사용하지 않도록 통신하도록 예외처리하기

  • 어플리케이션의 src/main/res에 xml 디렉토리를 추가하여 주시기 바랍니다.
  • 
  • 
  • xml 디렉토리에 network_config XML 파일을 생성하여 주시기 바랍니다.
  • 
  • 

  • network_config를 요구사항에 맞게 하나를 선택하여 작성합니다.

    • 특정 도메인을 가진 URL에 대해 TLS를 사용하지 않더라도 동작하도록 허용하게 하기

    <?xml version="1.0" encoding="utf-8"?>
    <network-security-config>
        <domain-config cleartextTrafficPermitted="true">
            <domain includeSubdomains="true">api.pushpia.com</domain>
        </domain-config>
    </network-security-config>

    • 모든 통신에 대해 TLS를 사용하지 않더라도 동작하도록 허용하게 하기

    <?xml version="1.0" encoding="utf-8"?>
    <network-security-config>
        <base-config cleartextTrafficPermitted="true" />
    </network-security-config>

  • AndroidManifest의 application에 작성한 network_config를 적용합니다.

  <application
      ...
      android:networkSecurityConfig="@xml/network_config">
  </application>

3. Android X 전환 대응

Android X 전환이란 Android에서 제공하는 Support Library를 Android X 라이브러리로 일대일 전환하는 것을 의미하며, 최신 버전의 AndroidStudio에서 강제적으로 Android X로의 전환을 강제적으로 요구하는 경우가 확인되었습니다. 이 경우 어플리케이션에서만 Android X 전환 대응을 한다면 ClassNotFoundException이 발생하므로 SDK도 Android X 대응 전용을 사용해야 합니다.

구글 플레이는 대상 SDK 버전 28만을 요구하고 있기 때문에 Android X 전환은 필수 사항이 아니므로 전환 대응을 할지 말지 선택이 필요합니다.

적용대상

• 대상 SDK 버전이 28이상으로 설정된 어플리케이션
• AndroidStudio 버전이 3.4.2 이상인 프로젝트
• 빌드시 다음과 같은 오류가 표시되는 경우

Manifest merger failed : Attribute application@appComponentFactory value=(android.support.v4.app.CoreComponentFactory) from [com.android.support:support-compat:28.0.0] AndroidManifest.xml:22:18-91
    is also present at [androidx.core:core:1.0.0] AndroidManifest.xml:22:18-86 value=(androidx.core.app.CoreComponentFactory).
    Suggestion: add 'tools:replace="android:appComponentFactory"' to <application> element at AndroidManifest.xml:18:5-100:19 to override.

해결방법

• Android X 전환 대응을 하지 않도록 설정할 경우

  • Application 레벨 build.gradle에서 Support Library를 28.0.0으로 설정

  implementation 'com.android.support:appcompat-v7:28.0.0'
  ...

  • Application 레벨 build.gradle에서 FirebaseCloudMessaging Library를 다음과 같이 설정

  implementation 'com.google.firebase:firebase-core:16.0.5'
  implementation 'com.google.firebase:firebase-messaging:17.3.4'
  ...

  • Project 레벨 build.gradle에서 의존성을 다음과 같이 설정

  dependencies {
      classpath 'com.android.tools.build:gradle:3.2.1'
      classpath 'com.google.gms:google-services:4.2.0'
      ...
  }

  • gradle.properties를 다음과 같이 설정

  distributionBase=GRADLE_USER_HOME
  distributionPath=wrapper/dists
  zipStoreBase=GRADLE_USER_HOME
  zipStorePath=wrapper/dists
  distributionUrl=https\://services.gradle.org/distributions/gradle-4.6-all.zip

  • AndroidStudio 상단 메뉴 File/Invalidate Cashes / Restart...를 클릭하여 재시작

• Android X 전환 대응을 할 경우

  • 구글이 제공하는 가이드 라인에 맞춰 Support Library를 Android X용으로 전환
  • Android X 대응 전용 SDK를 사용

  Android X 대응 전용 SDK는 cs_pms@humuson.com로 요청하여 주시기 바랍니다.