Task - YunByungKwan/Fundamental GitHub Wiki

• 과제 API 레벨 범위: 21 ~ 29
• MIN SDK: 21
• Target SDK: 29
• [ 버전명 / 버전 / API레벨 ]
  • 롤리팝(버전 5) 21 ~ 22
  • 마시멜로(버전 6) 23
  • 누가(버전 7) 24 ~ 25
  • 오레오(버전 8) 26 ~ 27
  • 파이(버전 9) 28
  • 퀸 케이크(버전 10) 29
  • 레드벨벳 케이크(버전 11) 30

먼저 크게 data, di, ui, util로 나뉩니다.
프로젝트 구조는 안드로이드 공식 앱 아키텍처를 참고했고
jetpack에 있는 ViewModel과 LiveData, Databinding을 사용해서 설계하였습니다.

그래서 data를 보시면
entity폴더에는 프로젝트에 필요한 데이터 클래스들이 있고
remote폴더에는 Retrofit관련 service 인터페이스 파일과 remoteDataSource가 있습니다.
repository폴더에는 repository가 있습니다.

그리고 의존성 주입을 위해서 dagger를 사용했습니다.
의존성 주입을 한 이유는 유닛 테스트를 위해서 도입했습니다.
그래서 di폴더에는 dagger에 필요한 파일들이 있습니다.

ui폴더에는 Activity와 ViewModel이 있고,
MainActivity Recyclerview에 사용되는 ListAdapter파일과 BindingAdapter파일이 있습니다.
추가적으로 MainActivity와 관련된 dagger component와 module파일이 있습니다.

util폴더에는 dagger 적용을 위해서 application클래스가 있고
카테고리의 코드를 저장하는 Category클래스 파일,
기타 상수들 저장하는 Constants파일,
그리고 권한 권련된 object파일이 있고
View관련 확장함수들을 정의한 ViewExt파일이 있습니다.

위부터 조금 세부적으로 말씀드리자면

entity는 API관련 클래스들이고 하나 추가한 게 Coordinate 클래스입니다.
Coordinate클래스는 카카오맵의 지도 중심 좌표를 저장하기 위해서 정의했습니다.

remote는 네트워크 통신시 retrofit을 사용했습니다. 그리고 비동기 통신에 coroutine을 사용했습니다.
그래서 api함수를 suspend로 만들었고 remoteDataSource에서 이 api함수를 리턴합니다.

repository에서는 remoteDataSource 의존성을 주입 받아서 remoteDataSource 관련 함수를 리턴합니다.
그리고 Room으로 네트워크 캐싱 추가할까 잠깐 고민했지만, 인터넷이 끊겼을 경우 카카오 맵이 일단 보이지 않기 때문에
캐싱은 불필요할 거 같다는 생각이 들어서 별도로 추가하지 않았습니다.

이제 ui쪽으로 넘어가면
먼저 과제가 앰뷸런스 운전사가 보는 앱이기 때문에 지도가 작으면 화날 것이라고 생각이 들었습니다.
그래서 리사이클러뷰를 접을 수 있게 모션 레이아웃을 추가했습니다. 그리고 지도 앱이다 보니 화면을 가로로 돌려서
많이 볼 것이라고 생각했습니다. 그래서 화면 회전해도 원래 데이터를 들고 있기 위해서 ViewModel에서
화면 중심 좌표, 검색 카테고리, ... 를 정의했습니다.

MainActivity를 보면 크게 onClick함수들, listener, 마커 어뎁터가 있습니다.

• ACCESS_FINE_LOCATION: GPS와 네트워크로 위치로 단말기 위치를 식별
• ACCESS_COARSE_LOCATION: 네트워크를 이용해서 단말기 위치를 식별
• 안드로이드 10(29)부터 백그라운드 위치 권한과 포그라운드 위치 권한이 나뉨
• 항상 허용 - 백그라운드, 포그라운드 위치를 모두 허용한다는 의미
• 앱 사용 중에만 허용 - 포그라운드 위치 권한만 허용한다는 의미
• Android 11(30)
  • 앱 사용 중에만 허용
  • 이번만 허용
  • 거부
• 위치 권한(ACCESS_FINE_LOCATION)을 왜 요청해야 하는지?
  • 위험 권한이기 때문에
  • GPS를 사용하기 위해서
• 위치 설정을 하는 이유?
  • 지도에 현재 내 위치를 표시하기 위해..??
• 경우의 수

  • 위치 권한 X(거부) / 위치 설정 X

  • 위치 권한 X(거부) / 위치 설정 O

  • 위치 권한 O(승인) / 위치 설정 X

  • 위치 권한 O(승인) / 위치 설정 O

  • 위치 정보 액세스 권한 유형

  • 포그라운드 위치

  • 백그라운드 위치 전체적인 구조를 먼저 말씀드리겠습니다.
    앱의 구조의 경우, 안드로이드 권장 아키텍처를 참고해서 구성했습니다.
    그래서 RemoteDataSoure -> Repository -> ViewModel -> Activity 로 만들었습니다.
    그리고 의존성 주입에는 Dagger를 사용했고, 비동기 통신에는 코루틴을 사용했습니다.
    Dagger를 사용한 이유는
    

Coroutine을 사용한 이유는

[ MainActivity ] MainActivity에서 처음에 여러가지 초기화를 진행합니다. 그리고 SDK버전이 23 이상일 경우 ACCESS_FINE_LOCATION에 대한 퍼미션 체크를 진행합니다. 그래서 처음에 권한이 승인됐는지 안됐는지로 나뉘고요. 승인이 이미 된 경우,

• 왜 ACCESS_FINE_LOCATION 권한만 요청했는지?
  • 가이드에 나온대로 ACCESS_FINE_LOCATION 권한을 요청했다.

• ACCESS_FINE_LOCATION 권한에 대해 설명해달라

처음 진입 시

1. 검색을 하지 않았을 경우

2. 검색을 한 번 이상 한 경우

[요구 사항]

• 카카오 맵 연동
• 카테고리(병원, 약국, 주유소)에 따라 데이터 검색
• 지도 처음 위치는 현재 위치로 표시
• 마커 누를 경우 마커 위치로 지도 중심이 이동
• 검색을 하지 않았을 경우->

• suspendCoroutine처럼 coroutine을 일시정지한다
• 그러나 CancellableContunuation을 제공하면서
• 일시정지된 동안에 coroutine job이 취소되거나 완료될때 CancellationException을 던진다?

• invokeOnCancellation(handler: CompletionHandler): 이 continuation의 취소를 비동기적으로 호출할 핸들러를 등록한다

• Continuation: T타입의 value를 반환하는 중단점 후의 continuation(interface)
  • [ 내부에 갖고 있는 함수들 ]
  • CoroutineContext 변수
  • resumeWith(result: Result): 마지막 중단점의 리턴값으로서 성공 또는 실패 결과를 넘겨주면서 코루틴 실행을 재개함
  • [ 확장 함수들 ]
  • resume(value: T) = resumeWith(Result.success(value))
  • resumeWithException(exception: Throwable) = resumeWith(Result.failure(exception))
• CancellableContinuation
  • [ 상태 변수들 ]
  • isActive
  • isCompleted
  • isCancelled
  • [ 함수들 ]
  • public fun tryResume(value: T, idempotent: Any? = null): Any?
  • public fun tryResume(value: T, idempotent: Any?, onCancellation: ((cause: Throwable) -> Unit)?): Any?
  • public fun tryResumeWithException(exception: Throwable): Any?
  • public fun completeResume(token: Any)
  • public fun initCancellability()
  • public fun cancel(cause: Throwable? = null): Boolean : continuation을 취소함. 취소되면 true를 반환
  • public fun invokeOnCancellation(handler: CompletionHandler) : 이 continuation을 취소할때 동시에 호출할 핸들러를 등록
  • public fun CoroutineDispatcher.resumeUndispatched(value: T)
  • public fun CoroutineDispatcher.resumeUndispatchedWithException(exception: Throwable)
  • public fun resume(value: T, onCancellation: ((cause: Throwable) -> Unit)?)

Retrofit에 suspend 키워드를 붙이면 내부적으로 euqueue메서드를 호출하고

• onResponse에서 continuation.resume()을 호출함
• 그 외에 실패할 경우 continuation.resumeWithException()을 호출함

• supervisorJob:

• ListAdapter말고 그냥 recyclerview adapter 구현시, 데이터 변경할 때 notifyDataSetChanged()를 부르면 리스트를 전체 다 바꿔야 하는 단점이 있다
• notifyDataSetChanged()는 리스트가 깜빡이는 문제가 있다.
• 그래서 android에서 만든 diffUtil은 현재 데이터 리스트와 교체될 리스트를 비교해서 진짜 바뀌어야 할 데이터만 바꿔준다.
• 근데 메인스레드에서 이걸 비교하면 블락을 야기할 수 있기 때문에 백그라운드에서 하도록 해야 한다..=> 그래서 AsyncListDiffer같이 비동기 처리를 지원해주는 확장 클래스도 나옴
• 그러나 ListAdapter가 훨씬 사용하기 쉽다(내부적으로 AsyncListDiffer를 사용함)
• AsyncListDiffer는 백그라운드 스레드로 리스트를 비교한다. => newFixedThreadPool(2)를 사용한다.
• diffUtil은 내부적으로 diff 알고리즘을 사용한다.
  • 시간복잡도: O(N + D^2 + N'^2)
  • 공간복잡도: O(N) (N개의 아이템이 있는 경우)
  • 공간에는 최적화되어 있지만 시간 복잡도는 꽤 높은 알고리즘(그래서 백그라운드 스레드에서 돌려야 한다)

• PlaceListAdapter -> diffUtilCallback 부분

  companion object {
      val diffUtilCallback = object: DiffUtil.ItemCallback<Place>() {
          // oldItem == newItem ==> oldItem.id == newItem.id 로 바꿔야 할듯..
          override fun areItemsTheSame(oldItem: Place, newItem: Place): Boolean = oldItem == newItem
  
          // 얘는 맞음 왜냐면 equals 오버라이드해서 필드값들 비교하도록 하고 equals함수를 쓰면 되는데 지금 equals를 쓰고 있고,
          // data class이다 보니 알아서 equals가 내부 필드들 비교하도록 자동으로 만들어져 있기 때문
          override fun areContentsTheSame(oldItem: Place, newItem: Place): Boolean
                = oldItem == newItem
      }
  }

• ListAdapter에 아이템 클릭 이벤트 넣을 경우?
  ViewHolder 클래스에 아래 코드를 추가하면 될 듯

  init {
      itemView.setOnClickListener {
          val pos = adapterPosition
          if(pos != RecyclerView.NO_POSITION) {
              binding.place?.let {
                  val intent = Intent(Intent.ACTION_VIEW, Uri.parse(it.placeUrl))
                  ContextCompat.startActivity(itemView.context, intent, null)
              }
          }
      }
  }