[Android] Daum Map SDK 적용하기

다음 맵 SDK를 사용하면서 공식 가이드대로 진행시 일부 안되는 부분들이 있음.

1. 카카오 개발자 사이트 가입

2. 카카오 개발자 사이트에서 앱 생성

3. Android 플랫폼 추가 : 앱 선택 - 설정 - 일반 - 플랫폼 추가 - Android 선택 후 추가

4. 키 해시 등록 : Android 플랫폼 선택 후 키 해시 등록

5. 라이브러리 파일 추가 Android Daum Map 라이브러리 구성  가이드에는 위와 같이 libs 파일에 추가하라고 하지만 이대로 할 경우 오류 발생함. libDaumMapAndroid.jar는 위 위치가 맞고 gradle 에 아래와 같이 추가가 필요함.

   dependencies {
       implementation fileTree(include: ['*.jar'], dir: 'libs')
       implementation files('libs/libDaumMapAndroid.jar')
   }

   armeabi와 armeabi-v7a는 /src/main 디렉토리 아래 jniLibs 디렉토리 생성 후 복사함. 

6. AndroidManifest.xml 에 Permission과 APP Key 추가

   <uses-permission android:name="android.permission.INTERNET">
   </uses-permission>
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION">
   </uses-permission>

   <meta-data android:name="com.kakao.sdk.AppKey" android:value="XXXXXXXXXXXXXXXXXXXXXXXXXXXX"/>

7. 코드 작성

   MapView mapView = new MapView(this);
   ViewGroup mapViewContainer = (ViewGroup) findViewById(R.id.map_view);
   mapViewContainer.addView(mapView);

Android OS 9 Pie 버전부터는 WebView에 일반적인 텍스트로 "http://" URL 접근이 막혔습니다. 

(tagetSdkVersion 28 이상일 경우)

증상 : WebView에서 Webpage not available, net::ERR_CLEARTEXT_NOT_PERMITTED 오류 발생

참고 : https://developer.android.com/training/articles/security-config#CleartextTrafficPermitted

검색해보니 이를 수정하기 위해서는 3가지 방법이 있습니다. 

(https://stackoverflow.com/questions/45940861/android-8-cleartext-http-traffic-not-permitted)

• res/xml/network_security_config.xml 추가

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

  위 파일 추가 후 AndroidManifest.xml 에서 application에 networkSecurityConfig속성 추가

  <?xml version="1.0" encoding="utf-8"?>
  <manifest ...>
      ...
      <application
          ...
          android:networkSecurityConfig="@xml/network_security_config" 

  이 방법은 network_security_config.xml 파일에 앱 내 텍스트로 사용할 URL들이 정의되어 있어야 함.

  cleartextTrafficPermitted 속성이 true일 경우 동작을 함.

• AndroidManifest.xml 에서 application 의 usesClearTextTraffic 속성 수정

  <?xml version="1.0" encoding="utf-8"?>
  <manifest ...>
      ...
      <application
          ...
          android:usesCleartextTraffic="true"

  이 방법은 텍스트 URL 을 무조건 허용하게 됨.

• Android Manifest.xml에서 manifet의 targetSandboxVersion 속성을 사용 중일 경우 관련 내용 : https://developer.android.com/guide/topics/manifest/manifest-element#targetSandboxVersion

  위 관련 내용에 따르면 속성 값이 높을수록 보안 수준이 높아지며, 2일 경우 usesCleartextTraffic의 기본 값이 false가 됨. 그래서 이 속성의 값을 1로 변경해야함. 다만 Android 8.0 (API 26) 이상을 타겟팅하는 Android Instant Apps의 경우 이 속성을 2로 설정해야 함.

  <?xml version="1.0" encoding="utf-8"?>
  <manifest android:targetSandboxVersion="1">
      ...