11 KiB
build-test-style
SodaLive 저장소에서 빌드, 테스트, 린트 관련 세부 규칙을 정리한 문서다.
저장소 범위 보충
- 추측하지 말고 근거 파일(
settings.gradle,build.gradle,app/build.gradle, 소스 코드)을 읽고 결정한다.
빌드 / 린트 / 테스트 명령
기본 실행 형태:
./gradlew <task>
빌드:
./gradlew clean
./gradlew :app:assembleDebug
./gradlew :app:assembleRelease
./gradlew :app:build
./gradlew :app:check
린트/포맷:
./gradlew :app:lint
./gradlew :app:lintDebug
./gradlew :app:lintRelease
./gradlew :app:ktlintCheck
./gradlew :app:ktlintFormat
테스트:
./gradlew :app:test
./gradlew :app:testDebugUnitTest
./gradlew :app:testReleaseUnitTest
주의:
- 기본 자동 검증은
app/src/test의 로직/local unit test만 사용한다. - 사용자가 명시적으로 요청하지 않으면
app/src/androidTestUI/계측 테스트를 작성하거나:app:connectedDebugAndroidTest를 실행하지 않는다. - 사용자가 명시적으로 요청하지 않으면 기기·에뮬레이터 UI 조작, 스크린샷 캡처, 시각 QA를 검증 계획이나 완료 증거에 포함하지 않는다.
- UI 변경은 adapter 분기, mapper, formatter, presentation model, 라우팅 등 화면 표현을 결정하는 로직만 테스트한다. View 크기·margin·padding·constraint·visibility 같은 레이아웃 속성 테스트는 작성하지 않는다.
app/build.gradle에lint { checkReleaseBuilds false }가 있어 릴리스 린트는:app:lintRelease를 명시 실행해야 한다.
1) 단일 테스트 실행 (중요)
로컬 단위 테스트(app/src/test)는 --tests 필터를 사용한다.
클래스 단위:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.chat.talk.room.ChatRepositoryTest"
메서드 단위:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.chat.talk.room.ChatRepositoryTest.enterChatRoom inserts messages and returns response"
패턴 매칭 예시:
./gradlew :app:testDebugUnitTest --tests "*TimeUtilsTest*"
배너 컴포넌트 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.banner.*"
마이 탭 공지 배열·롤링 focused 테스트 예시:
./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --console=plain
채팅 탭 Phase 3 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.ChatRoomFilterTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.ChatRoomTimeTextFormatterTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.ChatRoomMapperTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.*"
Yandex 광고 제거 후 캔 구매 회귀 테스트 예시:
./gradlew :app:testDebugUnitTest --tests '*ChatMessageAdapterTest' --tests '*ChatRepositoryTest'
쿼터 구매 액션, 두 캔 옵션의 요청 직렬화와 성공·실패 전달을 검증한다. 실제 결제와 기기 UI는 실행하지 않는다.
DM 채팅 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.dm.*"
Access Phase 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.access.*"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.access.V2AccessGuardTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.*"
Content Action Phase 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.content.action.ContentActionTest"
Main V2 홈 FAB 표시 정책 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.MainHomeFabVisibilityPolicyTest"
Live Action Phase 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.live.action.*"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.live.action.LiveActionCoordinatorUiGateTest"
Home Following 최근 소식 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.home.HomeFollowingNewsAdapterTest"
Home Following 프로필 이미지 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.home.HomeCreatorProfileImageLoaderTest"
Creator/Community Action Phase 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.action.*"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.community.action.*"
Home Recommendation Phase 16 테스트 예시:
./gradlew :app:testDebugUnitTest \
--tests "kr.co.vividnext.sodalive.v2.main.home.HomeMainFragmentLayoutTest" \
--tests "kr.co.vividnext.sodalive.v2.main.home.HomeMainFragmentLoginGuardSourceTest"
CreatorChannel 현재 라이브 공통 컴포넌트 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.ui.CreatorChannelCurrentLiveViewModelTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.CreatorChannelActivitySourceTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.live.CreatorChannelLiveFragmentLayoutTest"
CreatorChannel 팬톡 locale 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.fantalk.CreatorChannelFanTalkAdapterLocaleTest"
CreatorChannel 커뮤니티 상대 시간 locale 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.creator.channel.community.CreatorChannelCommunityRelativeTimeLocaleTest"
Chat Action Phase 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.chat.action.*"
Gift 개인정보·재생성 라우팅·modal 회귀 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.data.GiftNetworkPrivacyTest" --rerun
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest" --rerun
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" --tests "kr.co.vividnext.sodalive.v2.components.modal.*" --rerun
같은 테스트 결과 XML에 동시에 쓰지 않도록 다른 Gradle 테스트 실행이 끝난 뒤 직렬 실행한다. GiftNavigationTest는 Robolectric local unit test이며 기기·계측 테스트가 아니다.
이벤트 상세 ID 전용 진입·링크 정책·기존 배너 라우팅 focused 테스트 예시:
./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --tests '*HomeMainFragmentLayoutTest' --tests '*ContentMainFragmentSourceTest' --console=plain
fake API와 Robolectric local unit test로 조회 상태·호환 bridge·재시도·재생성·안전한 링크 실행을 검증한다. 실서버 호출, 기기 UI 및 레이아웃 속성 검증은 수행하지 않는다.
이벤트 직접 URI·푸시 별칭·AppsFlyer UDL lifecycle 및 인접 라우팅 회귀:
./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --console=plain
./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.event.*' --tests '*GiftNavigationTest' --tests '*DeepLinkActivitySourceTest' --tests '*MainV2*Test' --tests '*SodaFirebaseMessagingServiceSourceTest' --console=plain
./gradlew :app:ktlintMainSourceSetCheck :app:ktlintTestSourceSetCheck --console=plain
현재 빌드 스킴의 직접 이벤트 URI는 Intent, HTTPS OneLink 이벤트는 UDL만 상세 이동을 소유한다. SDK callback은 mock으로 전달하며 실제 SDK 네트워크·푸시·대시보드는 호출하지 않는다. Gradle 테스트는 다른 실행과 직렬로 수행한다.
본인인증 후 콘텐츠 보기 설정 테스트 예시:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.*"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.V2AuthViewModelTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.V2AuthVerifyRequestTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.ContentPreferenceBottomSheetTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.auth.V2AuthFlowTest"
인증 설정 테스트는 요청 직렬화와 상태·저장·재시도 계약을 검증한다. 실제 본인인증 서버나 기기 UI는 호출하지 않는다. 종료 회귀는 X→계속하기 선택 보존, 종료하기→Sheet/Flow 제거·호스트 유지, 실패 후 종료, 재인증 및 popup 수명주기 정리를 검증한다. 레이아웃 속성은 직접 검사하지 않는다.
참고:
- 신규 Kotlin 테스트 메서드는 backtick 함수명을 사용하고, 테스트명은 한글 문장으로 작성한다.
- 기존 영어 테스트명을 수정하지 않는 최소 변경 상황을 제외하고, 새 테스트명에 영어 문장을 사용하지 않는다.
- 외부 라이브러리 API명/영문 도메인 용어 때문에 테스트명을 영어로 유지해야 하는 경우, 해당 테스트 바로 위에 검증 의도를 설명하는 한글 주석을 추가한다.
- Kotlin backtick 테스트명은 공백이 포함될 수 있으므로 전체 문자열을 인용한다.
- 한글 테스트명을
--tests로 실행할 때도 클래스명과 메서드명을 포함한 전체 문자열을 따옴표로 감싼다. - 메서드 매칭이 불안정하면 클래스 단위로 먼저 실행한다.
이미지 placeholder/error/fallback 및 초기 기본 이미지 제거 회귀 테스트:
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.chat.talk.room.ImageLoaderTest" --tests "kr.co.vividnext.sodalive.live.room.update.LiveRoomImageRequestTest" --tests "kr.co.vividnext.sodalive.v2.gift.ui.GiftInboxAdapterTest"
실제 request source·변환, 실패 시 빈 결과, null/blank 입력과 이전 요청 해제를 검증하는 Robolectric local unit test다. 기기 UI/계측 테스트가 아니며 레이아웃 크기·간격을 검증하지 않는다.
추천 서브 배너 계약·링크·익명 조회 및 추천 상태 회귀:
./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.widget.subbanner.*' --tests '*HomeRecommendationViewModelTest' --tests '*ContentMainViewModelTest' --tests '*AudioRecommendationsMapperTest' --console=plain
기존 추천 GET의 헤더·envelope·placement·ID 정밀도, URI 원문과 Android 우선/web fallback, 캐러셀 상태 로직을 검증한다. 테스트 fixture는 로컬 테스트에만 사용하며 운영 요청을 대체하지 않는다. Gradle 실행은 다른 테스트 실행과 직렬로 수행한다.
2) UI/계측 테스트 예외
- UI/계측 테스트가 반드시 필요한 경우에도 사용자의 명시 요청을 먼저 확인한다.
- 승인된 작업에서만 해당 Task의 계획 문서에 대상, 실행 명령, 종료 조건과 정리 절차를 기록하고 실행한다.