🔗[Android] java.lang.ClassCastException

검색해보니 나는 잘 모르는 스크립트 파일을 작성을 해야하는데 어쩌구 저쩌구....

순식간에 승훈이가 됨

이 글에서는 기본적인 개념이나 방법 말고 실제로 제가 workflow를 만들면서 겪은 문제만을 서술합니다.

목표

1. 타겟 브랜치에 pull request나 push가 되면 자동으로 signed apk(debug)를 만들어내기
2. 만들어진 signed apk가 자동으로 Slack 채널로 전달됨

내가 겪은 문제

Slack으로 파일 전송

1. 달라지는 apk 파일 이름 처리

app.gradle에서 추출하는 apk 파일의 이름을 만들어주는데, 이름 사이에 빌드된 시간이 들어간다. 그래서 파일 이름이 매번 바뀌니까 파일 이름을 하드코딩으로 박아넣을 수 없었다.

- name: Get signed debug apk file path
  id: debugApk
  run: echo "apkfile=$(find app/build/outputs/apk/debug/*.apk)" >> $GITHUB_OUTPUT

이렇게 추출된 apk 파일이 있는 경로에서 파일 이름을 *로 와일드카드?를 써서 찾을 수 있었다. 그리고 경로를 GITHUB_OUTPUT이라는 변수?에 저장하는 듯 싶다. (아직 뭘 몰라서 눈치껏 파악하고 있습니다)

저렇게 저장하면

file_path: '${{ steps.debugApk.outputs.apkfile }}'

이런식으로 꺼내쓸 수 있는 듯 하다.

apk에 sign하기

keystore 적용하기

나는 keystore를 적용할 때 properties 파일을 사용했다. 1. 로컬에 keystore.properties 파일을 만들어서 로컬에서 빌드할 때 사용함

// ./keystore.properties 파일

storeFile=./keystore.jks
storePassword={비밀번호}
keyAlias={이름}
keyPassword={비밀번호}

// app.gradle.kts 파일

fun getProperties(path: String) = Properties().apply {
    load(FileInputStream(rootProject.file(path)))
}

android {
    // ...

    signingConfigs {
        getByName("debug") {
            // keystore.properties 파일을 읽어와서 사용
            val keystoreProp = getProperties("keystore.properties")

            storeFile = File(keystoreProp.getProperty("storeFile"))
            storePassword = keystoreProp.getProperty("storePassword")
            keyAlias = keystoreProp.getProperty("keyAlias")
            keyPassword = keystoreProp.getProperty("keyPassword")
        }
    }

    buildTypes {
        getByName("debug") {
            signingConfig = signingConfigs.getByName("debug")
        }

        // ...
    }

    // ...
}

2. keystore.properties, keystore.jks 파일은 gitignore에 등록해서 리모트에 올라가지 않음 3. Action에서 keystore.jks 파일을 생성한다.

    - name: Decode Keystore
      env: 
        ENCODED_STRING: ${{ secrets.KEYSTORE_BASE_64 }}
      run: |
        echo $ENCODED_STRING > keystore-b64.txt
        base64 -d keystore-b64.txt > keystore.jks
        cp keystore.jks ./app/keystore.jks  # <- 복사하는 이유는 후술..

로컬에 만들어진 .jks 파일을 base64로 인코딩하고, 그걸 secret에 변수로 저장해놓는다. 그러면 Action에서는 인코딩된 문자열을 다시 디코딩해서 keystore.jks 파일로 만든다.

4. Action에서 build하기 전에 keystore.properties 파일을 생성함

    - name: Create keystore.properties file
      env:
        KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
        KEYSTORE_ALIAS: ${{ secrets.KEYSTORE_ALIAS }}
        KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}
      run: |
        echo "storeFile=./keystore.jks" > keystore.properties
        echo "storePassword=$KEYSTORE_PASSWORD" >> keystore.properties
        echo "keyAlias=$KEYSTORE_ALIAS" >> keystore.properties
        echo "keyPassword=$KEY_PASSWORD" >> keystore.properties

리눅스 명령어를 잘 몰라서 그냥 echo 네번 써서 파일에 네줄로 썼습니다..

빌드하기 전에 keystore.properties 파일을 만들어서 빌드할 때 사용될 수 있도록 했다. 만들어지는 위치는 프로젝트의 최상위 경로(./)에 만들어진다.

5. 빌드한다.

    - name: Build signed debug apk
      run: ./gradlew assembleDebug --stacktrace

not found for signing config 'debug'

그런데 빌드하는 과정에서 자꾸 에러가 나서 실패를 하는 것이다...

Execution failed for task ':app:validateSigningDebug'.
> Keystore file '/home/runner/.gradle/daemon/8.2/./keystore.jks' not found for signing config 'debug'.

검색을 해봐도 다들 경로를 확인하라는 답변이 제일 많이 보였다.

그래서 keystore.jks의 경로를 계속 바꿔가면서 해봤는데도 해결이 안됐다.

그러다가 ./ 경로와 ./app/ 경로 둘 다에 keystore.jks를 복사해서 넣으니 정상적으로 빌드가 됐다!

    - name: Decode Keystore
      env: 
        ENCODED_STRING: ${{ secrets.KEYSTORE_BASE_64 }}
      run: |
        echo $ENCODED_STRING > keystore-b64.txt
        base64 -d keystore-b64.txt > keystore.jks
        cp keystore.jks ./app/keystore.jks  # <- 왜그런진 모르겠지만 복사해준다

sign 확인하기

apk에 sign이 정상적으로 된건지 확인을 해보고 싶었다. 다들 keytool을 사용해서 확인하라는데 자꾸 제대로 확인이 안됐다.

C:\...\...\...>keytool -printcert -jarfile app-debug.apk
Not a signed jar file

찾아보니 Android SDK 버전이 올라가면서 버전이 올라갔고?? apksigner라는걸 사용해야하는 듯 싶었다. (잘 몰라서 정말 미안합니다)

apksigner는 Android SDK 경로에 있다.

Tool > SDK Manager > Android SDK Location

cmd에서 apksigner가 있는 경로로 이동하여 다음과 같이 치면 서명을 확인할 수 있다.

 apksigner verify --print-certs {apk 파일 경로}

전체 workflow

name: Android CI

on:
  push:
    branches: [ "main" ]
  pull_request:
    branches: [ "main" ]

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3
    - name: set up JDK 17
      uses: actions/setup-java@v3
      with:
        java-version: '17'
        distribution: 'temurin'
        cache: gradle

    - name: Grant execute permission for gradlew
      run: chmod +x gradlew

    - name: Decode Keystore
      env: 
        ENCODED_STRING: ${{ secrets.KEYSTORE_BASE_64 }}
      run: |
        echo $ENCODED_STRING > keystore-b64.txt
        base64 -d keystore-b64.txt > keystore.jks
        cp keystore.jks ./app/keystore.jks

    - name: Create keystore.properties file
      env:
        KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
        KEYSTORE_ALIAS: ${{ secrets.KEYSTORE_ALIAS }}
        KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}
      run: |
        echo "storeFile=./keystore.jks" > keystore.properties
        echo "storePassword=$KEYSTORE_PASSWORD" >> keystore.properties
        echo "keyAlias=$KEYSTORE_ALIAS" >> keystore.properties
        echo "keyPassword=$KEY_PASSWORD" >> keystore.properties

    - name: Build signed debug apk
      run: ./gradlew assembleDebug --stacktrace

    - name: Get signed debug apk file path
      id: debugApk
      run: echo "apkfile=$(find app/build/outputs/apk/debug/*.apk)" >> $GITHUB_OUTPUT

    - name: slack upload file
      uses: MeilCli/slack-upload-file@v4.0.0
      with:
        slack_token: ${{ secrets.SLACK_TOKEN }}
        channel_id: ${{ secrets.SLACK_CHANNEL_APK_DELIVERY }}
        content: 'content'
        file_path: '${{ steps.debugApk.outputs.apkfile }}'
        if_no_files_found: error
        initial_comment: 'create signed apk file: ${{ job.status }}'

참조

• Automating Android Builds with GitHub Actions: A Step-by-Step Guide
• How do I verify that an Android apk is signed with a release certificate?
• [Android] Github Action을 이용하여 apk 파일 Slack으로 내보내기

광고 구조를 리팩토링하고 싶다고 생각이 들게 된 발단은, 앱 내에 다른 광고들을 더 추가하는 작업을 하면서 하게 되었다.

새로운 곳에 광고가 추가될 때마다 해야하는 코드 작업이 필요 이상으로 많으며, 온갖 곳에 분기처리 코드가 있어서 혹시라도 실수할까봐 이미 한 작업을 몇번이나 확인해야만 했다.

그때부터 남는 시간에 조금씩 광고 구조를 어떻게 개선하면 좋을지 생각하게 되었다.

기존 상태와 문제점

우리의 앱은 실행 시 처음에 서버로부터 광고 정보를 받아온다.

1. 어떤 화면에서 2. 광고 업체들을 어떤 순서로 표시할지에 대한 정보이다.

광고를 표시하는 화면에 진입하면 저장되어있는 화면 별 광고 순서를 가져와서, resume 때마다 광고를 순서에 맞게 변경하고 있다.

그리고... 문제가 많다.

1. 별도의 통신 라이브러리를 사용하지 않음 서버에서 받은 광고 표시 정보의 응답을 바로 데이터 클래스로 파싱하지 못하고, 일일히 응답 xml의 태그들을 하드코딩된 String들로 값을 가져와서 변환해주고 있다.

2. xml을 파싱해서 얻은 데이터를 SharedPreference에 저장함 응답으로 오는 광고 정보만 20개 이상인데, 각각 다른 key 값을 사용해서 SharedPreference에 저장하고 있으니 광고의 종류만큼 key로 사용하는 상수들이 생겨난다.

3. 여러 광고 업체의 SDK를 사용하며, 하나의 클래스에서 모든 경우를 다 처리함. 앱 내에서 여러 광고 업체를 통해 광고를 표시하고 있는데, 그래서 광고 업체마다의 SDK가 제공하는 인터페이스와 사용 방법이 다 다르다. 그런데 이걸 하나의 클래스 안에서 지옥의 분기처리를 통해 업체 별로 달라지는 광고 View들을 다루고 있다. 코드의 양이 너무나 많고, 심지어 클래스 내에서 Activity의 참조도 가지고있다.

4. 무조건 static String 상수를 사용함 광고 표시 위치 구분, 어떤 업체의 광고 View를 표시해야 할지 구분하는 요소를 String 상수로만 정의해놓았다. 그리고 코드에는 equals와 하드코딩된 String 문자열들이 가득하다.

세세하게 따지면 더 많은 문제가 있지만, 대표적으로 이정도인 것 같다.

개선 지향점

대표적인 문제점들을 바탕으로 리팩토링의 컨셉을 정해봤다.

1. Retrofit 적용하기 이건 전체적으로 적용해나갈 것이라 해당 리팩토링에만 국한된 내용은 아니다. 적용하게 되면 또 다른 긴 파싱 코드를 추가하지 않고 원하는 데이터 클래스로 변환이 가능할 것이다.

2. SharedPreference 제거하기 SharedPreference를 이런 용으로 사용하는 것 자체가 문제지만, 수많은 각각의 상수 key들이 보기 안좋은 분기처리 코드를 유발하는 원인이 되었다. 그래서 저장하고자 하는 데이터들을 하나의 Entity로 디자인하고 Room을 사용하여 DB에 저장하려 한다.

3. 광고 업체 별 분기처리 제거 업체마다 광고 View를 다루는 방법이 다르기 때문에 분기처리를 없애기 위해서는 인터페이스의 통일이 필요하다. 그리고 광고 업체 별 광고 처리 코드를 인터페이스를 구현하는 개별 클래스들로 분산시킬 것이다.

4. String 상수 제거 단순한 String 상수는 문자열이 주는 의미를 제외하고 코드상에서 어떠한 의미나 맥락을 가지기 어렵다는 것을 코드를 보며 깨달았다. 복잡한 의미가 필요한 상황에서는 부적절하기에 다른 요소로 대체하고자 한다.

사실은... 위의 항목들을 달성하여 이루고자 하는 진짜 목표는 따로 있다. "광고 추가 작업할 때 최소한의 코드 작업만 하도록 만들기"가 진짜 목표이다. 지금은 광고를 추가하기 위해 거의 열 군데 쯤 되는 곳을 건드려야 한다.

진짜 목표를 이루고자 하면 가독성이나 유지보수성은 자연스레 좋아질 것이라고 생각한다.

쟁점

커다란 컨셉을 정한 뒤 세부적인 요소들을 결정하는데 있어서 팀원분들과 많은 이야기를 나누었다.

String 상수 대체하기(sealed OR enum)

앱 내에서 광고는 삽입될 화면과 현재 표시해야할 광고 업체로 구분해주어야 한다. 광고를 표시하는데 필요한 광고 코드가 화면과 업체 별로 달라지기 때문이다.

광고 구분을 위해 코드 상에 산재되어있는 화면과 업체 관련 하드코딩 String들과 상수들을 완벽히 걷어내고, 앞으로는 그 어디에서도 해당 String들을 사용하지 않도록 만들자고 결정했다.

그래서 앞으로 사용할 구분 요소들을 sealed class로 정의해야 할지, enum으로 정의해야할지 결정해야 했다.

sealed class와 enum 둘 다 무언가를 구분하기 위한 용도로 사용하기 적합하며, 단순한 String 상수보다 코드상에서 더 많은 의미를 가질 수 있기 때문에 고민되었다.

하지만 이야기를 통해 다음과 같이 정리할 수 있었다.

• sealed class는 다형성을 활용하기에 적합하다. -> 서브클래스 별로 어떤 메서드의 동작을 다르게 구현해야한다던가 하는 처리가 필요 없었다.

• enum은 요소들을 entries를 통해 Array로 묶어줄 수 있다. -> 특정 요소를 Array의 find로 빠르게 찾을 수 있다. 서버 응답 광고 정보를 DB의 데이터 클래스로 변환할 때 필요했다.

• Room은 enum 변환을 자동으로 처리해준다. -> 코드 상에서 String들을 없애기로 했기 때문에 Room에 저장하고 가져오는 타입을 enum으로 정의하는 것이 좋을 것이다.

결론적으로 enum을 사용하는 것이 적합하다고 판단했다.

광고 처리 클래스의 책임은 어디까지?

(참고자료)

다이어그램에 있는 AdView는 업체 별 광고 View들의 인터페이스를 통일하기 위한 interface이다. 그리고 AdView를 사용하는 클래스인 AdUtil는 내부적으로 순서에 맞게 광고를 load 해주는 등의 처리를 한다.

AdUtil의 설계에 대해 이야기를 하다가 팀원 분이 의문을 제기해주셨다. "AdUtil 클래스가 처리하는 내용의 범위는 어떻게 되나요?"

나는 광고와 관련된 처리를 외부에서 전혀 알지 못했으면 좋겠다고 생각했다.

• 언제 load 해야하고, 언제 resume 해줘야하고, 언제 pause 해주며, 언제 stop 해줘야 하는지에 대해 Activity는 전혀 모르고, 그저 AdUtil을 사용하여 광고를 표시한다.
• AdUtil은 LifecycleObserver 같은걸 구현하여 Activity에 스스로를 observer로 등록한다.
• 광고를 표시하려고 하는 Activity마다 lifecycle에 맞춰 광고 View를 resume, pause하는 코드를 일일히 작성 할 필요가 없어진다.
• Activity와 광고 관련 코드를 분리할 수 있다.

반면에 팀원 분은 다음과 같이 생각하고 계셨다.

• 광고를 표시하려고 하는 Activity에서 load, resume, pause 등의 처리를 직접 해주어야 한다고 생각한다.
• 배너 형태로 표시하는 광고가 RecyclerView 사이사이에 끼어있는 경우도 있으니 Activity의 lifecycle에만 맞추어서 광고 View를 처리하지 못하는 상황이 분명히 있다.
• 광고 View를 사용하는 곳에서 어떻게 사용할지 직접 결정할 수 있어야 할 것 같다.

두 생각 다 납득할만 하다고 생각한다. 다만 어떤 것이 우리의 프로젝트 코드 상황에 더 적합할지 가려내고 결정해야 한다.

사실 이 사항에 대해서 명확하게 결정난 것은 없다. 우리는 아직 많고 복잡한 기존 코드에 대해 빠삭하게 알고있지도 못할 뿐더러, 기획팀의 변화무쌍한 개발요청은 언제나 불확실하기 때문이다.

추구하고자 하는 코드의 기준과 제약사항들을 다시 점검하고 지금 순간에서의 최선의 결정을 내릴 수 있게 해야하지 싶다.

계속...

두서에도 적어놨지만 이 리팩토링은 진행 중이기 때문에 내용이 더 추가될 수도 있다.

🔗[Android] Compose TextField 커스텀

기능

• 캡스락 + ijkl = 방향키
• 캡스락 + h = home
• 캡스락 + ; = end
• 캡스락 + c = 캡스락
• 캡스락 + ESC = `(backtick)
• 캡스락 + 숫자열, -, + = 1F ~ 12F 키
• 캡스락 단독 = 한영전환
• win + 위아래 방향키 = pgup/pgdn
• win + 좌우 방향키 = home/end
• win + 방향키 + shift = 블록 잡기 가능

🔗[Android] LazyColumn안에 LazyVerticalGrid 넣기(nested scroll)

super.init이라는 주니어 안드로이드 개발자들을 위한 행사가 열린다기에 만삼천원 플렉스해서 다녀왔습니다.

2시간 걸려 도착한 삼성역^^

우와 구글이다~

근데 입구를 못찾아서 굳게 닫힌 문 앞에 3분간 서있다가 정신 차리고 입구로 찾아들어갔다.

우와 멋지다~

나는 아는 사람이 하나도 없어서 혼자 입에 거미줄 치고 우두커니 앉아있었다^_ㅜ

여튼 기다리다 보니 드디어 행사가 시작됐다. 행사는 총 여섯분의 발표가 준비되어 있었다. 행사 구성을 찍어오면 좋았을껄... 아쉽다.

본론

1번째 순서

발표자분이 본인의 취준기를 발표해주셨다. 1년이라는 시간동안 취준을 하면서 어떤 일을 겪었는지, 무엇을 깨달았는지, 취준 방법 등을 공유해주셨다.

근데 발표를 듣다보니 내가 언젠가 구글 검색하다가 봤었던 블로그의 주인분이라서 놀랐다.

영양가있는 내용들 덕분에 앞으로 면접을 잘 준비할 수 있을 것 같았다. 특히 거꾸로 되짚어 나가면서 개발 지식들을 정리하는 방법이 인상깊었다.

2번째 순서

Retrofit 대신 사용할 수 있는 Ktor라는 라이브러리를 소개하는 발표였다.

구미가 당기게끔 소개를 잘 하셔서 한번 써 보고 싶어졌다.

3번째 순서

Compose를 소개하는 발표였다.

Compose를 소개하는 것이다 보니 기본적인 내용들 위주로 발표가 진행되어 이미 알고있는 내용들을 다시 복습할 수 있었다.

4번째 순서

Jira 자동화에 대한 발표였다.

들으면서 지금 회사에서 사용하고 있는 Jira는 그냥 빙산의 일각... 그냥 겉 껍데기만을 핥고있는 것이였구나 하는 생각이 들었다. 신기하고 유익했다.

5번째 순서

Design Document를 쓰는 방법에 대한 발표였다.

사실 나는 Design Document라는 것을 이 발표를 들으면서 처음 알게 되었다. Design Document에 대한 개념과 작성하는 법, 왜 작성해야 하는지에 대한 설명을 듣고 나니 정말 유용해 보였다. 회사 팀 내부적으로 사용하지 않더라도 개인적으로 작성하고 사용해봐야겠단 생각이 들었다.

특히 문서를 작성함으로서 구조의 피드백과 코드의 피드백을 분리할 수 있다는게 인상깊었다.

6번째 순서

4년차 개발자분이 현재까지의 본인의 커리어 여정을 요약해서 발표해주셨다.

본인을 굉장히 겸손하게 표현하셨는데... 첫 회사로 누구나 아는 대기업에 취직하셨다고 하기에 충격받았다. 너무 겸손하신 듯 싶다...

과한 준비성을 본받고 싶어졌다.

결론

진득허니 앉아서 발표를 듣고있자니 엉덩이가 조금 아파서 누워버릴 뻔 했지만 여튼 마지막까지 얌전히 잘 들었다.

누군가의 경험을 들을 수 있다는 것은 참 소중하다고 생각한다. 누군가가 직접 몸으로 부딪혀 겪고 깨달은 것을 나는 앉아서 그 이야기를 듣는 것만으로도 조금이나마 얻을 수 있기 때문이다. 그런고로 발표자분들께 감사를 드리고 싶다.

소중한 주말을 이 행사에 내어주었지만... 결과적으론 다녀온 보람이 있다고 느꼈다. 앞으로 기회가 된다면 이런 행사에 적극적으로 참가하고 싶다. 받은 티셔츠는 잠옷으로 아주 잘 쓸 것 같다.

상황

Room을 사용해서 가져온 Todo 아이템들을 LazyColumn을 통해서 화면에 리스트로 보여주고 있었다. 각 항목을 왼쪽으로 swipe하면 삭제할 수 있고, 삭제했을 때 뜨는 SnackBar 알림의 'UNDO' 버튼을 클릭하면 방금 삭제한 아이템을 다시 DB에 추가해서 화면에 다시 보여줄 수 있는 기능이 있다.

그런데 삭제한 아이템을 다시 DB에 추가해서 화면에 표시할 때, LazyColumn의 아이템이 swipe된 상태(dismissed) 그대로 다시 추가되는 현상이 발생했다.

원인

1. DB에 방금 삭제한 Todo 데이터를 다시 추가한다고 했는데, 여기서 각 Todo 아이템의 primaryKey인 id도 그대로 DB에 다시 추가하고 있었다.
2. 그리고 LazyColumn에서는 Todo 아이템의 id를 items(...)의 key값으로 사용하고 있었다.

다시 추가된 Todo 데이터의 id가 dismissed된 항목의 id와 같기 때문에 마지막 상태(dismissed) 그대로 다시 화면에 항목이 보이게 된 것이다.

해결

DB에 데이터를 다시 추가할 때 id 값을 0으로 변경하고 넣어줬더니 해당 현상은 사라졌다.

똑같은 key값으로 항목이 다시 추가되면 마지막 상태 그대로 항목이 표시될 줄은 몰랐다......

SpringBoot 프로젝트 만들기

https://start.spring.io/ Spring initializr를 사용해서 프로젝트를 생성한다길래 위 링크에서 프로젝트를 생성했다. 나는 Gradle, Kotlin으로 프로젝트를 만들었다. 오른쪽에 dependency는 나는 Spring Web만 추가했었는데, 알고보니 thymeleaf라든가 프로젝트에 앞으로 쓸 것들을 미리 추가하는게 편한 것 같다.

BootStrap 적용

https://getbootstrap.com/docs/5.2/getting-started/download/ 위 주소에서 Complied CSS와 JS 파일을 다운받았다.

다운로드 버튼 클릭하면 Zip 파일을 받을 수 있는데, 압축 해제하면 안에 css 폴더와 js 폴더가 있다.

이 두 폴더를 다음 경로에 넣는다.

/프로젝트이름/src/main/resources/static

그리고 templates 폴더에는 index.html 파일을 만들어줬다.

위에 링크로 다시 돌아가면 Starter template이라는 것이 있는데 이걸 싸악 복사해서 index.html에 붙여넣기 했다.

body 태그 안에 JavaScript 옵션을 선택하라는데 난 잘 모르겠고 그냥 Option 1을 그대로 썼다. 나머지 주석 처리된 것들은 지워버림.

https://getbootstrap.com/docs/5.2/examples/ 위 링크로 들어가면 예제 템플릿들이 있는데, 게시판 모양의 템플릿이 없어서 그냥 밑으로 내리면 있는 NavBar에서 NavBar Static 템플릿을 골랐다.

https://getbootstrap.com/docs/5.2/examples/navbar-static/ 내가 고른 NavBar Static 템플릿의 링크

원하는 템플릿으로 들어가서 마우스 오른쪽 클릭하고 페이지 소스 보기를 하면 템플릿의 소스가 나타난다. 여기서 body 태그 안에 있는 <nav>...</nav> 부분과 <main>...</main> 부분만 복사했다. (필요한 알맹이만 가져오기)

CSS가 깨지는 부분이 있다면, 템플릿의 <head> 태그 내부에 해당 템플릿을 위한 css 파일이 link되어 있을텐데 그 링크를 누르면 CSS 파일의 내용이 보인다. 그 파일의 이름 그대로 resources/static/css 폴더에다가 CSS 파일을 만들어 내용을 복사 붙여넣기 하고, 템플릿에 있던 CSS 파일 링크하는 부분을 복사해서 본인 html 파일의 똑같은 위치에 붙여넣기 하면 된다.

이렇게 해서 일단 Bootstap을 적용했다.

thymeleaf 적용

build.gradle.kts 파일에 dependencies 블럭에다가 다음과 같이 추가했다.

implementation("org.springframework.boot:spring-boot-starter-thymeleaf")

gradle 싱크를 맞추고 나서 application.properties 파일에 다음과 같이 설정해주었다.

# 참조 경로 설정
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
# thymeleaf 사용 설정 
spring.thymeleaf.enabled=true
# templates 디렉토리에 파일이 없으면 에러 발생 
spring.thymeleaf.check-template-location=true

다른 설정들도 있었는데 그냥 이렇게만 했다... 이유는 없음

(작성중)

참조

• https://thisisprogrammingworld.tistory.com/134
• https://velog.io/@ddingmun8/SpringBoot-%EB%B6%80%ED%8A%B8%EC%8A%A4%ED%8A%B8%EB%9E%A9-%ED%85%9C%ED%94%8C%EB%A6%BF-%EC%A0%81%EC%9A%A9%ED%95%98%EA%B8%B0
• https://www.youtube.com/watch?v=WGIJ4CDUX44&list=PLPtc9qD1979DG675XufGs0-gBeb2mrona&index=5&ab_channel=%EC%BD%94%EB%94%A9%EC%9D%98%EC%8B%A0

🔗[Kotlin] Flow를 StateFlow로 변환

새로운 프로젝트를 만들때에

1. github에 레포를 만들고,
2. 로컬로 clone한 다음에,
3. 해당 폴더에 새로운 Android 프로젝트를 만들면 늘 이상한 오류가 생겼기 때문에, 앞으로는 새로운 레포와 로컬을 따로 만들고 그 둘을 이어주기로 했다.

첫 번째

github에 새로운 레포지토리를 만든다. README.md나 .gitignore 등이 추가되면서 Initial commit이 발생한다.

두 번째

로컬에 새로운 Android 프로젝트를 만들고 해당 프로젝트 폴더에서 git init을 해준다. 그리고 로컬에서의 첫번째 커밋을 해준다. Create project같은 제목으로..

세 번째

git remote add origin (주소) 원격 저장소의 주소를 remote에 추가한다.

그리고 git pull --rebase를 하면 upstream 설정하라고 뜬다. 하라는대로 한다. 다시 git pull --rebase를 한다. 충돌이 난다. 충돌 난 상태에서 git add . 한번 해주고, git rebsae --continue 해준다. 별안간 vi 편집기가 뜨면서 커밋 메시지를 작성하라고 한다. 이미 로컬에서 첫번째 커밋할 때 적은 메시지가 적혀있기 때문에 더 작성할 것 없이 :wq로 저장하고 빠져나온다. 원격에 반영되도록 git push 해준다.

git log로 확인하면 레포지토리 만들 때의 Initial commit 위에 로컬에서 한 커밋이 잘 얹어져있다.

@OptIn(ExperimentalMaterialApi::class)
@Composable
fun TodoRow(
    todo: Todo,
    onCheckCompleted: (Todo) -> Unit
) {
    // swipe 상태 저장할 State 변수 
    val swipeableState = androidx.compose.material.rememberSwipeableState(initialValue = 0)
    // 앵커로 사용할 위치
    val point = LocalDensity.current.run { LocalConfiguration.current.screenWidthDp.dp.toPx() }
    // 위치 to 상태
    val anchors = mapOf(0f to 0, -point to 1)

    if (swipeableState.isAnimationRunning) {
        DisposableEffect(Unit) {
            onDispose {
                // -point로 설정한 앵커에 도달하면 currentValue가 1이 됨
                if (swipeableState.currentValue == 1) {
                    // 애니메이션이 끝나고 실행될 코드 
                }
            }
        }
    }

    // Box 안의 Content가 Swipe 됨 
    Box(
        Modifier
            .fillMaxWidth()
            .swipeable(
                state = swipeableState,
                orientation = Orientation.Horizontal,
                anchors = anchors,
                thresholds = { _, _ -> FractionalThreshold(0.8f) },
                velocityThreshold = 1000.dp
            )
    ) {
        // Content 
        Card(
            modifier = Modifier
                .offset { 
                    // swipe했을 때 위치가 움직이도록 offset 설정 
                    IntOffset(swipeableState.offset.value.roundToInt(), 0) 
                  }
                .fillMaxWidth()
                .padding(vertical = 4.dp),
            shape = RoundedCornerShape(16.dp)
        ) {
            // Card 위에 표시될 Composable들...
        }
    }
}

코드 정리가 필요할 것 같지만 일단 되는대로 구현했다.

스와이프 되었으면 하는 컴포저블을 Box로 감싸고, 해당 Box에 Modifier.swipeable을 적용했다. swipeable의 인자는 차례대로 다음과 같다(이 외에도 더 존재함).

• state - rememberSwipeableState로 얻은 SwipeableState를 넘긴다.
• orientation - 스와이프 할 방향 지정.
• anchors - 앵커로 지정할 화면 위치(px값)와 해당 위치에 도달했을 때의 상태를 묶은 Map을 넘긴다.
• thresholds - 특정한 위치까지 스와이프 하지 않으면 원래 상태로 돌아오는 위치를 지정할 수 있다.
• velocityThreshold - 지정한 위치까지 스와이프 하지 않아도 특정 빠르기만큼 스와이프하면 스와이프되도록 하는 속도값(dp)을 지정할 수 있다.

그리고 swipeable에 사용할 변수들을 상단에 정의했다. swipeableState의 initialValue나 anchors에 저장하고 있는 상태에 해당하는 값은 꼭 Int값으로 하지 않고 원하는 타입으로 지정할 수 있다. 본인은 스와이프 했을 때 화면 밖까지 이동해서 사라졌으면 해서 현재 화면의 크기를 음수로 바꾼 값을 앵커로 사용하고, 해당 위치에서 swipeableState의 currentValue가 1이 되도록 저장했다.

변수들 밑의 if문은 애니메이션이 끝났을 때 동작되는 코드이다.. (참고한 글)

마지막으로 스와이프 되었으면 하는 컴포저블의 offset을 swipeableState의 offset으로 설정해주면 된다.

여담: 얼레벌레 얼추 구현해놓고 SwipeToDismiss라는 컴포저블이 있다는걸 발견했다... 구현한게 아까워서 글로 남김...

참조한 글

• 안드로이드 공식 문서
• 'android compose swipeable'로 검색하면 나오는 각종 글

상황: ViewModel이 가지는 mutableStateList를 MainActivity에서 Composable로 넘겨줌. Composable은 한번 읽은 State에 대해서 값이 변화했을 때 변화를 감지하여 recompose를 진행한다고 배웠음. 근데 init블럭의 코드를 통해 todoItems의 값이 변화되어도 화면은 업데이트 되지 않았음.

이유: init블럭의 코드는 todoItems가 참조하고 있는 리스트의 값을 바꾼 것이 아니라 아예 새로운 리스트를 참조하게 만들어버렸기 때문에, composable 입장에서 관찰하고 있는 리스트는 변화가 없으니까 업데이트를 안하는게 당연함.

해결:

init {
    viewModelScope.launch {
        todoItems.addAll(getTodoListUseCase.invoke().toMutableStateList())
    }
}

todoItems에 값을 add 해주니까 화면 업데이트가 너무 잘된다.

이런... 허무한 실수.....

참조글들을 보며 구현하면서 이해한 구조

Domain 레이어

• UseCase 클래스는 적절한 Repository 구현체를 주입받아 비즈니스 로직을 수행함.
• Repository의 구현 클래스는 Data 레이어에 있지만, UseCase는 그저 Repository 인터페이스를 사용하기 때문에 Data 레이어에 대한 의존성이 없음.
• Entity는 Domain 레이어 안에서 사용할 데이터 모델.

  Data 레이어

• Domain 레이어에 있는 Repository 인터페이스를 구현하는 클래스가 있음.
• RepositoryImpl 클래스는 적절한 DataSource를 사용하여(주입받음) 기능을 구현한다.
• DataSource는 데이터를 가져올 수 있는 곳의 개수만큼 존재할 수 있음.
• DataModel은 Data 레이어 안에서 데이터베이스나 리모트에서 받는 Response에서 사용될 데이터 모델. Domain 레이어의 Entity와 헷갈릴 수 있지만 엄연히 다른 존재임.
• Mapper는 DataModel과 Entity를 서로 치환? 시켜주는 존재. Domain 레이어에서 DataModel을 사용할 수 없고, Data 레이어에서 Entity를 그대로 사용할 수 없기 때문에 Mapper가 필요하다.

  Presentation 레이어

• ViewModel에서 UseCase들을 주입받아 사용한다. UseCase를 통해 데이터를 가져오거나 넘긴다.
• Activity나 Fragment에서는 ViewModel을 주입받아 DataBinding 같은걸 사용해서 화면에 데이터를 보여준다.

참조

https://jungwoon.github.io/android/2021/04/12/Android-CleanArchitecture.html https://youngest-programming.tistory.com/484

@GlideModule
class GlideModule : AppGlideModule()

그다음에 빌드 한번 눌러주면 GlideApp 사용 가능해진다

buildscript {
    ext {
        some_version = '1.1.0'
    }

    repositories {
        google()
    }

    dependencies {
        def nav_version = "2.4.1"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

plugins {
    // ...
}

task clean(type: Delete) {
    // ...
}

안에다가 classpath랑 ext 써주면됨

하나 얻기

런처 선언

private val permissionLauncher = registerForActivityResult(
    ActivityResultContracts.RequestPermission()
) { result: Boolean ->
    if (!result) {
        Toast.makeText(this, "거부됨", Toast.LENGTH_SHORT).show()
    }
}

런처 사용하기

permissionLauncher.launch(
    android.Manifest.permission.WRITE_EXTERNAL_STORAGE
)

여러개 얻기

런처 선언

private val permissionLauncher = registerForActivityResult(
    ActivityResultContracts.RequestMultiplePermissions()
) { result ->
    // 결과 중 하나라도 false면 토스트 표시하기 
    if (result.any { permission -> !permission.value }) {
        Toast.makeText(this, "거부됨", Toast.LENGTH_SHORT).show()
    }
}

런처 사용하기

permissionLauncher.launch(
    arrayOf(
        android.Manifest.permission.READ_EXTERNAL_STORAGE,
        android.Manifest.permission.WRITE_EXTERNAL_STORAGE
    )
)

가끔 쓸때마다 매번 까먹어서 정리

🔗[Android] Palette로 이미지에서 평균색 알아내기 (Java)

🔗[Android] Retrofit2 Multipart사용하기 (Java)

🔗[Android] RecyclerView와 ListAdapter (Java)