2020년 2월 24일 월요일

[안드로이드] 폰트 리소스 적용

폰트 리소스 적용기

발단

현재 담당하고 있는 앱에서 앱의 모든 텍스트뷰에 시스템폰트 대신 커스텀 폰트를 적용해야 하는 스펙이 있었고, 이를 쉽게 적용하기 위해 Typekit 이라는 라이브러리를 사용하고 있었습니다. 그러나 targetApi를 29로 올리면 이 라이브러리에서 크래시가 발생합니다. 내부에서 리플렉션을 이용하여 모든 텍스트뷰에 폰트를 주입하고 있었는데, 이 리플렉션을 이용하는 부분이 문제가 되었습니다. 이 라이브러리는 2016년 7월16일 이후로 커밋이 올라오지 않아서 사실상 관리되지 않는 라이브러리로 개선을 기대할 수 없어서 다른 방법을 찾아야만 했습니다.

8.0 미만 버전에서 폰트를 적용하는 방법

초창기부터 안드로이드는 커스텀폰트를 적용하기 위해 Assets 공간을 활용했습니다. Assets 폴더에 커스텀 폰트 파일(.ttf, .otf 등등)을 넣어두고 Typeface.createFromAsset() 메서드를 이용하여 해당 폰트를 불러와서 텍스트뷰에 적용했습니다.
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        val assetManager = resources.assets
        val customTypeface = Typeface.createFromAsset(assetManager, "font/custom_font.ttf")
        
        val textView = ...
        textView.typeface = customTypeface
    }
}

그럼 Typekit은?

위의 방법으로 앱의 모든 TextView에 폰트를 적용하기란 매우 번거롭고 코드량도 많아집니다. Typekit은 Application.onCreate() 등 앱의 최초 초기화시에 폰트를 로드하고, BaseActivity를 만들어 attachBaseContext()메서드를 상속받아 새로운 Context를 등록해주면 끝입니다.
// 폰트 초기화
class MyApplication : Application() {
    override fun onCreate() {
        ...
        val assetManager = resources.assets
        val customTypeface = Typeface.createFromAsset(assetManager, "font/custom_font.ttf")
        Typekit.getInstace().addNormal(customTypeface)
    }
}

// 폰트 적용
class BaseActivity : AppCompatActivity() {
    override fun attachBaseContext(newBase: Context?) {
        super.attachBaseContext(TypekitContextWrapper(newBase))
    }
}
사용은 간단한데, 내부적으로 살펴보니 TypeContextWrapper 클래스는 getSystemService()를 오버라이드하여 TypekitLayoutInflater라는 커스텀 인플레이터를 반환하도록 되어 있었습니다. 이 인플레이터가 뷰 생성/인플레이팅시에 리플렉션으로 폰트를 주입해주는 핵심 역할을 담당하고 있었습니다.

8.0 이상에서 폰트 적용하기

8.0(API 26 오레오)부터 폰트를 리소스로 취급하도록 변경되었으며, font-family를 xml로 작성하여 쉽게 사용할 수 있도록 되었습니다. res/font/ 폴더 내에 사용할 폰트를 넣어두면 리소스로 인식됩니다. 리소스로 인식할 수 있는 폰트파일은 .ttf, .ttc, .otf, .xml 가 있습니다.

xml로 font-family 작성하기

<font-family xmlns:android="http://schemas.android.com/apk/res/android">
    <font
        android:fontStyle="normal"
        android:fontWeight="400"
        android:font="@font/lobster_regular" />
    <font
        android:fontStyle="italic"
        android:fontWeight="400"
        android:font="@font/lobster_italic" />
</font-family>
  • font-family : 폰트 xml은 반드시 이 루트 엘리먼트로 시작
  • font
    • fontStyle : 폰트의 스타일. italic / normal 상수값 대입 가능
    • fontWeight : 폰트의 두께. 100 ~ 900 사이의 100단위 양수
    • font : res/font 폴더 내에 있는 폰트 리소스

layout.xml에서 폰트를 직접 적용하기

<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    ...
    android:fontFamily="@font/my_font_family" />

Style에서 폰트를 적용하기

<style name="MyTextStyle" parent="@android:style/TextAppearance.Small">
    <item name="android:fontFamily">@font/my_font_family</item>
</style>

폰트 리소스를 코드에서 사용하기

  • Resources 클래스에 API 26부터 새로생긴 getFont() 메서드 이용
val typeface = resources.getFont(R.font.my_font_family)
textview.typeface = typeface
  • 코드에서의 하위호환을 유지하기 위해 AndroidX(구 SupportLibrary v26.x)의 ResourcesCompat.getFont()를 이용
  • API 16이상부터 사용가능 (minApi = 16)
  • font-family xml을 작성하는 경우 android 네임스페이스 대신, app 네임스페이스를 사용해야 함
<font-family xmlns:app="http://schemas.android.com/apk/res-auto">
    <font
        app:fontStyle="normal"
        app:fontWeight="400"
        app:font="@font/lobster_regular" />
    <font
        app:fontStyle="italic"
        app:fontWeight="400"
        app:font="@font/lobster_italic" />
</font-family>

val typeface = ResourcesCompat.getFont(context, R.font.my_font_family)

다운로더블 폰트

APK에 폰트파일을 포함하는 대신 Provider 애플리케이션으로부터 폰트를 요청하거나, 폰트를 다운로드 받을 수 있는 API가 안드로이드 8.0 (API 26) / Support Library 26에 추가되었습니다. 이 기능은 아이스크림 샌드위치(API 14)이상의 기기에서 Support Library 26 이상 버전을 이용하는 경우에 이용할 수 있습니다.

동작 방식

폰트를 관리해주는 Font Provider를 도입했습니다. 이 Provider는 폰트를 다운로드 받거나 캐싱하여 다른 앱에서 요청하는 폰트를 공유하도록 하는 역할을 담당합니다. 즉, 각각의 앱에서는 필요한 폰트를 FontsContract라는 API로 이 Provider로 요청하고, 요청한 결과를 콜백으로 받습니다.

사용방법

1. 리소스를 이용

res/font 리소스에 xml로 다운로더블 폰트의 제공자 정보를 작성하는 방법입니다. xml로 font-family를 추가하고, 태그에서 속성값을 주어야 합니다.
<font-family xmlns:android="http://schemas.android.com/apk/res/android"
    app:fontProviderAuthority="com.google.android.gms.fonts"
    app:fontProviderPackage="com.google.android.gms"
    app:fontProviderQuery="Goudy Bookletter 1911"
    app:fontProviderCerts="@array/com_google_android_gms_fonts_certs">
</font-family>
  • fontProviderAuthority : 폰트를 가져올 FontProvider의 소유자 정보. 매니페스트에서 Provider를 지정할 때 넣어주는 android:authority값을 의미함
  • fontProviderPackage : 해당 프로바이더의 패키지
  • fontProviderQuery : 프로바이더에게 요청할 폰트의 식별자(이름)
  • fontProviderCerts : 해당 폰트를 사용하기 위한 인증키(?)

2. 코드를 이용

FontsContract.requeestFont() 메서드를 이용하여 코드에서 Typeface를 바로 얻을 수 있습니다. FontRequest 객체에 Provider에 대한 정보를 추가하여, requestFont()메서드의 인자로 전달하면, 해당 폰트를 콜백메서드로 반환해 줍니다. AndroidX(Support Library v26)에서 하위호환을 지원하기 위해 FontsContractCompat 클래스를 지원합니다.
val request = FontRequest(
        "com.example.fontprovider.authority",
        "com.example.fontprovider",
        "my font",
        certs
)
val callback = object : FontsContract.FontRequestCallback() {

    override fun onTypefaceRetrieved(typeface: Typeface) {
        // Your code to use the font goes here
        ...
    }

    override fun onTypefaceRequestFailed(reason: Int) {
        // Your code to deal with the failure goes here
        ...
    }
}
FontsContract.requestFonts(context, request, handler, null, callback)
  • FontRequest 생성자 파라미터
    • String : 프로바이더 소유자
    • String : 프로바이더 패키지
    • String : 쿼리할 이름
    • List<List<byte[]> : 인증키
  • FontsContract.requestFont() 파라미터
    • Context : 프로바이더 사용을 위한 컨텍스트
    • Request : 프로바이더 정보를 담은 FontRequest 객체
    • Handler : 폰트조회를 수행할 핸들러
    • CancellationSignal : 폰트조회를 취소할 객체
    • FontRequestCallback : 폰트조회결과를 받을 콜백

3. 추가사항

1) 매니페스트에 사용할 폰트를 미리 선언하기(Optional)
뷰 인플레이션과 리소스 검색은 메인스레드에서 진행되는 동기 작업입니다. 그렇기에 앱 구동후에 사용할 폰트를 프로바이더로부터 쿼리하는 작업도 메인스레드에서 동작합니다. 이는 최초 레이아웃에 걸리는 시간을 증가시켜서 앱의 성능을 조금 저하시킵니다. 이를 피하기 위해 매니페스트에 미리 폰트를 선언해두면, 시스템이 미리 폰트를 쿼리해두어, 바로 사용가능하도록 준비해줍니다. 만약 쿼리한 폰트가 없다면 기본폰트로 지정됩니다.
res/values 폴더에 폰트의 목록을 array로 지정해 둡니다.
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <array name="preloaded_fonts" translatable="false">
        <item>@font/goudy_bookletter_1911</item>
    </array>
</resources>
그 다음, 매니페스트에 로 해당 array를 명시합니다.
<meta-data
    android:name="preloaded_fonts"
    android:resource="@array/preloaded_fonts" />
2) 인증 추가
사용할 FontProvider가 미리 설치되어있지 않거나 Support Library를 사용하여 구현하는 경우라면, 반드시 이 인증키를 명시해 주어야 합니다.
res/values 폴더에 인증키 목록을 string-array로 지정합니다.
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <array name="com_google_android_gms_fonts_certs">
        <item>@array/com_google_android_gms_fonts_certs_dev</item>
        <item>@array/com_google_android_gms_fonts_certs_prod</item>
    </array>
    <string-array name="com_google_android_gms_fonts_certs_dev">
        <item>
            MIIEqDCCA5CgAwIBAgIJANWFuGx90071MA0GCSqGSIb3DQEBBAUAMIGUMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNTW91bnRhaW4gVmlldzEQMA4GA1UEChMHQW5kcm9pZDEQMA4GA1UECxMHQW5kcm9pZDEQMA4GA1UEAxMHQW5kcm9pZDEiMCAGCSqGSIb3DQEJARYTYW5kcm9pZEBhbmRyb2lkLmNvbTAeFw0wODA0MTUyMzM2NTZaFw0zNTA5MDEyMzM2NTZaMIGUMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNTW91bnRhaW4gVmlldzEQMA4GA1UEChMHQW5kcm9pZDEQMA4GA1UECxMHQW5kcm9pZDEQMA4GA1UEAxMHQW5kcm9pZDEiMCAGCSqGSIb3DQEJARYTYW5kcm9pZEBhbmRyb2lkLmNvbTCCASAwDQYJKoZIhvcNAQEBBQADggENADCCAQgCggEBANbOLggKv+IxTdGNs8/TGFy0PTP6DHThvbbR24kT9ixcOd9W+EaBPWW+wPPKQmsHxajtWjmQwWfna8mZuSeJS48LIgAZlKkpFeVyxW0qMBujb8X8ETrWy550NaFtI6t9+u7hZeTfHwqNvacKhp1RbE6dBRGWynwMVX8XW8N1+UjFaq6GCJukT4qmpN2afb8sCjUigq0GuMwYXrFVee74bQgLHWGJwPmvmLHC69EH6kWr22ijx4OKXlSIx2xT1AsSHee70w5iDBiK4aph27yH3TxkXy9V89TDdexAcKk/cVHYNnDBapcavl7y0RiQ4biu8ymM8Ga/nmzhRKya6G0cGw8CAQOjgfwwgfkwHQYDVR0OBBYEFI0cxb6VTEM8YYY6FbBMvAPyT+CyMIHJBgNVHSMEgcEwgb6AFI0cxb6VTEM8YYY6FbBMvAPyT+CyoYGapIGXMIGUMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNTW91bnRhaW4gVmlldzEQMA4GA1UEChMHQW5kcm9pZDEQMA4GA1UECxMHQW5kcm9pZDEQMA4GA1UEAxMHQW5kcm9pZDEiMCAGCSqGSIb3DQEJARYTYW5kcm9pZEBhbmRyb2lkLmNvbYIJANWFuGx90071MAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEEBQADggEBABnTDPEF+3iSP0wNfdIjIz1AlnrPzgAIHVvXxunW7SBrDhEglQZBbKJEk5kT0mtKoOD1JMrSu1xuTKEBahWRbqHsXclaXjoBADb0kkjVEJu/Lh5hgYZnOjvlba8Ld7HCKePCVePoTJBdI4fvugnL8TsgK05aIskyY0hKI9L8KfqfGTl1lzOv2KoWD0KWwtAWPoGChZxmQ+nBli+gwYMzM1vAkP+aayLe0a1EQimlOalO762r0GXO0ks+UeXde2Z4e+8S/pf7pITEI/tP+MxJTALw9QUWEv9lKTk+jkbqxbsh8nfBUapfKqYn0eidpwq2AzVp3juYl7//fKnaPhJD9gs=
        </item>
    </string-array>
    <string-array name="com_google_android_gms_fonts_certs_prod">
        <item>
            MIIEQzCCAyugAwIBAgIJAMLgh0ZkSjCNMA0GCSqGSIb3DQEBBAUAMHQxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYDVQQKEwtHb29nbGUgSW5jLjEQMA4GA1UECxMHQW5kcm9pZDEQMA4GA1UEAxMHQW5kcm9pZDAeFw0wODA4MjEyMzEzMzRaFw0zNjAxMDcyMzEzMzRaMHQxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYDVQQKEwtHb29nbGUgSW5jLjEQMA4GA1UECxMHQW5kcm9pZDEQMA4GA1UEAxMHQW5kcm9pZDCCASAwDQYJKoZIhvcNAQEBBQADggENADCCAQgCggEBAKtWLgDYO6IIrgqWbxJOKdoR8qtW0I9Y4sypEwPpt1TTcvZApxsdyxMJZ2JORland2qSGT2y5b+3JKkedxiLDmpHpDsz2WCbdxgxRczfey5YZnTJ4VZbH0xqWVW/8lGmPav5xVwnIiJS6HXk+BVKZF+JcWjAsb/GEuq/eFdpuzSqeYTcfi6idkyugwfYwXFU1+5fZKUaRKYCwkkFQVfcAs1fXA5V+++FGfvjJ/CxURaSxaBvGdGDhfXE28LWuT9ozCl5xw4Yq5OGazvV24mZVSoOO0yZ31j7kYvtwYK6NeADwbSxDdJEqO4k//0zOHKrUiGYXtqw/A0LFFtqoZKFjnkCAQOjgdkwgdYwHQYDVR0OBBYEFMd9jMIhF1Ylmn/Tgt9r45jk14alMIGmBgNVHSMEgZ4wgZuAFMd9jMIhF1Ylmn/Tgt9r45jk14aloXikdjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNTW91bnRhaW4gVmlldzEUMBIGA1UEChMLR29vZ2xlIEluYy4xEDAOBgNVBAsTB0FuZHJvaWQxEDAOBgNVBAMTB0FuZHJvaWSCCQDC4IdGZEowjTAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBBAUAA4IBAQBt0lLO74UwLDYKqs6Tm8/yzKkEu116FmH4rkaymUIE0P9KaMftGlMexFlaYjzmB2OxZyl6euNXEsQH8gjwyxCUKRJNexBiGcCEyj6z+a1fuHHvkiaai+KL8W1EyNmgjmyy8AW7P+LLlkR+ho5zEHatRbM/YAnqGcFh5iZBqpknHf1SKMXFh4dd239FJ1jWYfbMDMy3NS5CTMQ2XFI1MvcyUTdZPErjQfTbQe3aDQsQcafEQPD+nqActifKZ0Np0IS9L9kR/wbNvyz6ENwPiTrjV2KRkEjH78ZMcUQXg0L3BYHJ3lc69Vs5Ddf9uUGGMYldX3WfMBEmh/9iFBDAaTCK
        </item>
    </string-array>
</resources>
이 인증키를 리소스 / 코드에서 사용하면 됩니다.

참고

작성자: 시간: 댓글 없음:
라벨: , , , , , , , , ,

2019년 2월 9일 토요일

[안드로이드] RecyclerView Selection 가이드(번역)

원문

RecyclerView Selection 가이드

며칠전에 저는 클린아키텍쳐에 대해 탐구해보고자 간단한 앱을 만들기 시작했습니다.
앱의 기능중에 유저의 다중선택을 받아서, 다른화면에 뿌려주어야 하는데, 이러한 다중선택 기능에 많은 시간을 쏟고싶지 않아서, recyclerview-selection 라이브러리를 쓰기로 결정했습니다. 이 포스트는 이 라이브러리를 구현하는 과정과, 겪었던 문제들에 대하여 살펴볼 예정입니다.

Step 0 - 앱 구축

가장 먼저 10개의 랜덤한 숫자의 목록을 보여주는 간단한 앱을 만들었습니다. 최대한 간단하도록 구성하여, Activity와 Adapter만 있도록 했습니다.
class MainActivity : AppCompatActivity() {

    private val adapter = MainAdapter()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        recyclerView.layoutManager = LinearLayoutManager(this)
        recyclerView.adapter = adapter
        adapter.list = createRandomIntList()
        adapter.notifyDataSetChanged()
    }

    private fun createRandomIntList(): List<Int> {
        val random = Random()
        return (1..10).map { random.nextInt() }
    }
}

class MainAdapter : RecyclerView.Adapter<MainAdapter.ViewHolder>() {
    var list: List<Int> = arrayListOf()

    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        val number = list[position]
        holder.bind(number)
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        val itemView = LayoutInflater
            .from(parent.context)
            .inflate(R.layout.item_row, parent, false)
        return ViewHolder(itemView)
    }

    override fun getItemCount(): Int {
        return list.size
    }

    inner class ViewHolder(view: View) : RecyclerView.ViewHolder(view) {
        private var text: TextView = view.findViewById(R.id.text)

        fun bind(value: Int) {
            text.text = value.toString()
        }
    }
}

Step 1 - RecyclerView - Selection 라이브러리 추가

build.gradle 파일에 다음과 같이 입력하여 라이브러리를 추가해 줍니다.
dependancies {
    implementation 'androidx.recyclerview:recyclerview-selection:1.0.0'
}

Step 2 - Key 타입 선택

공식문서에서는 KeyProvider를 구축하고 사용하기 위해 키로 사용할 타입을 정의하라고 되어 있습니다. 셀렉션 라이브러리는 Parcelable, Strnig, Long 세가지 타입을 키로 지원합니다. 다음은 몇몇 사용사례에 대해 어떤 타입을 키로 사용하면 좋을지에 대한 가이드라인입니다.
  • Parcelable : 어떤 Parcelable 타입도 키로 사용될 수 있습니다. 특히, 안드로이드의 Content Provider 프레임워크에서 사용되는 Uri를 사용할 때, Uri를 키로 사용한다면 좋은 사용사례가 될 것입니다.
  • String : 문자열 기반의 식별자를 가진 데이터라면, 키로 사용하기에 좋습니다.
  • Long : RecyclerView에서 이미 사용되고 있는 long 타입 기반의 식별자 체계를 사용핳고 있다면, Long 타입의 키는 좋은 선택이 될 것입니다. 그러나, 런타임에서 long타입은 안정적으로 접근하기에 제한적입니다. 기본적인 long 키에 대한 저장소를 사용한다면, 밴드 선택 기능은 지원되지 않습니다.
이 글에서는 Long 타입을 키로 사용하고, 리스트의 position 값을 키로써 사용하겠습니다. 우리의 아이디는 안정적이어야 하므로, 이를 위해 RecyclerView.Adapter의 setHasStableIds() 메서드를 이용하겠습니다. 저 메서드의 인자를 true로 주면, RecyclerView에서 long 타입의 유일한 id는 각각 하나의 아이템에만 매칭된다는 의미입니다.
init {
    setHasStableIds(true)
}
해당 설정 후에, RecyclerView.Adapter의 getItemId(position) 메서드를 상속받아서 적절한 id값으로 리턴할 수 있도록 해야 합니다.
override fun getItemId(position: Int): Long = position.toLong()

Step 3 - KeyProvider의 구현

Key로 사용할 타입을 정했다면, KeyProvider를 구현할 차례입니다. 이 글에서는, 라이브러리에서 미리 구현체로 제공하는 StableIdKeyProvider를 이용할 것입니다. 필요하다면 KeyProvider를 직접 구현하셔야 합니다.

Step 4 - ItemDetailsLookup

ItemDetailsLookup 클래스는 사용자가 선택한 항목들에 대한 정보를 라이브러리에 제공하는 역할을 합니다. ViewHolder가 현재 보여주고 있는 아이템 정보에 대해, 이 클래스 내의 추상클래스인 ItemDetails<Key>를 ViewHolder가 반환할 수 있도록 구현해야 합니다. 라이브러리에서는 선택동작을 수행할 때 발생하는 MotionEvent를 가지고 선택을 판별하며, MotionEvent의 좌표값을 이용해 RecyclerView에서 해당 View를 얻어옵니다. 얻어온 View를 이용하여 ViewHolder 객체를 얻을 수 있습니다. ItemDetails<Key> 인터페이스를 미리 구현한 ViewHolder 객체이므로 아이템의 정보를 얻을 수 있습니다.
// ItemDetailsLookup 클래스
class MyItemDetailsLookup(private val recyclerView: RecyclerView) : ItemDetailsLookup<Long>() {
    override fun getItemDetails(event: MotionEvent): ItemDetails<Long>? {
        val view = recyclerView.findChildViewUnder(event.x, event.y)
        if (view != null) {
            return (recyclerView.getChildViewHolder(view) as MainAdapter.ViewHolder)
                .getItemDetails()
        }
        return null
    }
}

// ViewHolder에서 
fun getItemDetails(): ItemDetailsLookup.ItemDetails<Long> =
    object : ItemDetailsLookup.ItemDetails<Long>() {
        override fun getPosition(): Int = adapterPosition
        override fun getSelectionKey(): Long? = itemId
    }

Step 5 - 선택된 항목 하이라이트 하기

유저들은 본인이 선택한 항목의 UI가 하이라이트 되어 본인이 어느것을 선택했는지 확인할 수 있기를 원할 것입니다. 하이라이트를 여러가지 방법으로 표현할 수 있을 것입니다. Gmail 앱처럼 선택된 항목의 ViewHolder의 특정 부분에 애니메이션을 줄 수도 있겠지만, 이 포스트에서는 간단하게 항목의 배경색을 변경하는 것으로 구현할 것입니다.
먼저, 뷰의 상태에 따라 배경색이 변하는 새로운 Drawable을 구성합니다.
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@android:color/holo_blue_light" android:state_activated="true" />
    <item android:drawable="@android:color/white" />
</selector>
다음에는, 만든 Drawable을 뷰의 백그라운드로 지정합니다.
<View
   ...
   android:background="@drawable/item_drawable"
   ... />
다음으로, 어댑터를 변경하여 뷰홀더가 선택상태를 제어할 수 있도록 합니다. 이를 위해 어댑터 내부에서 Tracker 필드를 추가해 줍니다. Tracker는 특정 항목이 선택되었는지의 여부를 라이브러리가 계속 추적할 수 있도록 도와줍니다. 이 예제에서는 Tracker 객체를 Activity에서 생성하여 어댑터에 넣어줄 것입니다.(tracker 생성에 관하여는 Step 6에서 설명합니다.)
class MainActivity : Activity() {
    var tracker : SelectionTracker<Long>? = null
    var adapter : RecyclerView.Adapter = // Adapter 객체
    ...
    
    override fun onCreate(var savedInstanceState : Bundle?) {
        ...
        tracker = // SelectionTracker 생성 로직 (Step 6)
        // adapter 내부에 setTracker()를 구현했다고 가정
        adapter.tracker = tracker
        ...
    }
}
어댑터의 onBindViewHolder() 메서드에서 tracker의 isSelected(key)를 호출하여, 해당 항목이 선택되었는지를 판별하여 UI를 갱신해줍니다.
// Adapter.onBindVIewHolder
override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    val number = list[position]
    tracker?.let {
        holder.bind(number, it.isSelected(position.toLong()))
    }
}

// ViewHolder 내부
fun bind(value: Int, isActivated: Boolean = false) {
    text.text = value.toString()
    itemView.isActivated = isActivated
}

Step 6 - Tracker 생성

Step 5에서 잠시 언급했던 대로, MainActivity에서 Tracker를 생성할 것입니다. Tracker 생성을 위해 라이브러리에서 제공하는 SelectionTracker.Builder 클래스를 사용합니다. Builder 클래스를 이용하여 tracker를 간단하게 생성하고, 생성할 때 Tracker에 설정할 수 있는 옵션값에 대해서도 살펴보겠습니다.
먼저, Builder클래스를 사용하기 위해 필요한 인자들은 다음과 같습니다.
  • selectionId : Activity / fragment에서 선택동작을 식별하기 위한 String 타입의 id
  • recyclerView : tracker를 추가할 RecyclerView
  • keyProvider : 선택 Key의 Source
  • detailsLookup : RecyclerView의 항목 정보에 대한 Source
  • storage : 선택 상태의 저장에 대한 정책
class MainActivity : Activity() {
    var tracker : SelectionTracker<Long>? = null
    var adapter : RecyclerView.Adapter = // Adapter 객체
    ...
    
    override fun onCreate(var savedInstanceState : Bundle?) {
        ...
        tracker = SelectionTracker.Builder<Long>(
            "mySelection",
            recyclerView,
            StableIdKeyProvider(recyclerView),
            MyItemDetailsLookup(recyclerView),
            StorageStrategy.createLongStorage()
        ).withSelectionPredicate(
            SelectionPredicates.createSelectAnything()
        ).build()
        ...
    }
}
위의 예제에서, Step 4에서 구현했었던 MyItemDetailsLookup를 제외하고는, 모두 라이브러리에서 제공하는 기본 클래스입니다. 마지막으로 어떤 제약사항 없이 여러개의 아이템을 선택하도록 하는 SelectionPredicate를 지정해 주었습니다.(SelectionPredicates.createSelectAnything()) SelectionPredicate 를 직접 상속받아 구현할 수도 있습니다. 모든 메서드의 결과값은 boolean으로, true를 반환하면 해당 선택을 허용하는 것이고, false를 반환하면 선택을 서용하지 않는 것입니다. 이 메서드를 이용하여, 선택에 대하여 다양한 제약사항을 추가할 수 있습니다.
return object : SelectionTracker.SelectionPredicate<K>() {
    override fun canSetStateForKey(key: K, nextState: Boolean): 
    Boolean {
        return true
    }

    override fun canSetStateAtPosition(position: Int, nextState:  
    Boolean): Boolean {
        return true
    }

    override fun canSelectMultiple(): Boolean {
        return true
    }
}
RecyclerView에서 항목 선택을 시작하려면, 선택하려는 아이템을 롱클릭했을 때 선택모드로 진입합니다. 이에 대하여 이 글의 마지막에서 살펴보겠습니다.
지금까지 구현한 코드는 다음의 Github에서 확인가능합니다.

Selection Observer

라이브러리에서는 Observer를 등록하여 선택 동작에 대해 관찰할 수 있도록 지원합니다.
이번에는, 두개의 아이템을 선택하면 두 아이템의 합을 계산하여 다른 화면에서 보여주는 아주 간단한 예제를 만들어보겠습니다. 다음의 예제에서 Tracker 객체에 Observer를 등록하는 것을 볼 수 있습니다.
tracker?.addObserver(
    object : SelectionTracker.SelectionObserver<Long>() {
        override fun onSelectionChanged() {
            super.onSelectionChanged()
            val items = tracker?.selection!!.size()
            if (items == 2) {
                launchSum(tracker?.selection!!)
            }
        }
    })
launchSum() 메서드에서는 전달받은 selection을 map 연산을 이용하여 ArrayList로 변환하여 새로운 Activity에 전달합니다.
private fun launchSum(selection: Selection<Long>) {
    val list = selection.map {
        adapter.list[it.toInt()]
    }.toList()
    SumActivity.launch(this, list as ArrayList<Int>)
}
지금까지 구현한 코드는 다음의 Github에서 확인가능합니다.

선택상태를 Lifecycle 변화에도 유지하기

위의 구현들은 Android의 라이프사이클 변화를 고려하지 않은 구현이라 상태가 유지되지 않습니다. 단적인 예로, 스크린을 회전한다면 선택내용들은 전부 유실될 것입니다. 그러한 상황이라면 다음과 같은 크래시를 보게 될 것입니다.
java.lang.NullPointerException: Attempt to invoke virtual method ‘int androidx.recyclerview.widget.RecyclerView$ViewHolder.getAdapterPosition()’ on a null object reference
이 크래시는 Child 뷰가 분리되어 있는 동안 더이상 선택되지 않은 항목을 삭제하려고 할 때, StableIdKeyProvider 내부에서 값을 얻어오지 못하여 생기는 것입니다. StableIdKeyProvier를 유지하는 대신, ItemKeyProvider를 직접 구현하여 해결하는 방식으로 접근해보겠습니다.
class MyItemKeyProvider(private val recyclerView: RecyclerView) : ItemKeyProvider<Long>(ItemKeyProvider.SCOPE_MAPPED) {

    override fun getKey(position: Int): Long? {
        return recyclerView.adapter?.getItemId(position)
    }

    override fun getPosition(key: Long): Int {
        val viewHolder = recyclerView.findViewHolderForItemId(key)
        return 
            viewHolder?.layoutPosition ?: RecyclerView.NO_POSITION
    }
}

또다른 크래시 이슈와 해결책

크래시를 발생시킬 수 있는 또다른 상황이 있습니다. 유저가 동적으로 선택할 아이템의 개수를 변경하는 상황을 생각해봅시다. 유저가 동적으로 선택할 갯수를 입력할 수 있도록 EditText를 추가하여, 동적으로 입력된 숫자만큼만 아이템을 선택할 수 있도록 변경할 수 있을 것입니다.
StableIdKeyProvider를 그대로 사용했다면, EditText를 선택하는 순간 위에서 살펴본 바와 같은 크래시가 났을 것입니다. 이 해답도 이전에 보았던대로 ItemKeyProvider를 직접 구현하는 것입니다.
이 모든 과정에 대환 최종 코드는 Github에서 확인하세요.

주의사항 및 결론

저는 항목 선택기능에 대하여, 큰 공수를 들이지 않고 빨리 해결해보고자 이 라이브러리를 사용하려고 했었습니다. 불해하게도, 바로 위에 언급했던 크래시들과 같은 이슈들을 다루느라, 오히려 시간을 더 많이 소비했습니다.
또 다른 문제는 다중 선택모드로 진입하는 유일한 방법은 선택하고자 하는 아이템을 롱클릭하는 것 밖에 업다는 것이었습니다. 저는 버튼을 이용하여 선택모드로 변경하는 걸 원했지만, 부질없는 생각이었습니다. 부질없는 이유를 알고싶다면, 라이브러리가 어떻게 동작하는지 알아야 합니다.
싱글탭과 롱클릭 이벤트를 다루기 위해 TouchInputHandler 클래스가 존재합니다. 내부 코드에서, 싱글탭일 때 다음과 같은 코드를 발견할 수 있을 것입니다.
if (mSelectionTracker.hasSelection()) { ... }
위 코드에서 볼 수 있듯이 mSelectionTracker.hasSelection() 가 true값을 반환하여 if문이 참이 되어야만 선택에 대한 뭔가를 처리할 수 있습니다. 롱클릭은 저러한 체크를 하고있지 않고, 바로 롱클릭한 항목을 선택 리스트에 추가합니다. hasSelection()메서드는 DefaultSelectionTracker에서 구현된 것으로, SelectionTracker.Builder로 새로운 Tracker 인스턴스를 만들었을 때 기본적으로 사용되는 메서드입니다. 이 메서드의 구현체는 다음과 같습니다.
@Override
public boolean hasSelection() {
    return !mSelection.isEmpty();
}
TouchInputHandler를 상속받아서 싱글탭 메서드를 다시 구현하면 가장 좋겠지만, 이 클래스는 final 로 선언되어 있어서 상속이 불가능합니다. 그럼에도 굳이 어떻게든 해보고 싶어서 MotionInputHandler 클래스를 상속받아서 필요한 모든 메서드를 구현하면 될 것이라고 생각할 수도 있겠지만, 그건 공수가 많이 듭니다.
SelectionTracker.Builder 에서 Tracker를 생성하기 위해 build() 메서드를 호출하는 시점에 TouchInputHandler 가 생성되어 할당되기 때문에, 특정 InputHandler 인스턴스를 사용할 수 없도록 되어 있습니다. 즉, 커스텀 Tracker를 만들고, 라이브러리에서 제공하는 Builder 클래스를 사용하지 않은 채 생성하여, 커스텀 InputHandler 인스턴스를 지정해주는 과정이 필요합니다. 이렇게까지 노력을 하느니, 기존에 해오던 방식대로 직접 선택기능을 구현하는게 더 빠를 것입니다.
이 글을 다 읽고, 글에서 언급된 크래시들을 빨리 해결하여 선택기능에 대한 (제한적이지만) 빠른 해결책을 원한다면, 라이브러리를 쓰는 것이 나쁘지는 않습니다. 단, 커스터마이징이 어느정도 가능하지만, 커스터마이징을 하는 오버헤드가 너무나도 크다는 것을 염두해 두어야 합니다.
작성자: 시간: 댓글 3개:
라벨: , , , , ,
피드 구독하기: 글 (Atom)