[Feat] Roborazzi + Robolectric 기반 스크린샷 테스트 도입

.github/workflows/debug.yml

@@ -101,6 +101,73 @@ jobs:
         path: app/build/outputs/apk/release/*.apk
         retention-days: 1
 
+  screenshot-verify:
+    name: Verify Screenshot Regression
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Cache Gradle packages
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/.gradle/caches
+          ~/.gradle/wrapper
+        key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties', '**/buildSrc/**/*.kt') }}
+        restore-keys: |
+          ${{ runner.os }}-gradle-
+
+    - name: set up JDK 17
+      uses: actions/setup-java@v3
+      with:
+        java-version: '17'
+        distribution: 'temurin'
+        cache: gradle
+
+    - name: Create Local Properties
+      run: touch local.properties
+
+    - name: Access Local Properties
+      env:
+        DEV_BASE_URL: ${{ secrets.DEV_BASE_URL }}
+        PROD_BASE_URL: ${{ secrets.PROD_BASE_URL }}
+        KAKAO_NATIVE_APP_KEY: ${{ secrets.KAKAO_NATIVE_APP_KEY }}
+        NAVER_MAPS_CLIENT_ID: ${{ secrets.NAVER_MAPS_CLIENT_ID }}
+        POSTHOG_API_KEY: ${{ secrets.POSTHOG_API_KEY }}
+        POSTHOG_HOST: ${{ secrets.POSTHOG_HOST }}
+      run: |
+        echo DEV_BASE_URL=\"$DEV_BASE_URL\" >> local.properties
+        echo PROD_BASE_URL=\"$PROD_BASE_URL\" >> local.properties
+        echo KAKAO_NATIVE_APP_KEY=$KAKAO_NATIVE_APP_KEY >> local.properties
+        echo NAVER_MAPS_CLIENT_ID=$NAVER_MAPS_CLIENT_ID >> local.properties
+        echo POSTHOG_API_KEY=$POSTHOG_API_KEY >> local.properties
+        echo POSTHOG_HOST=$POSTHOG_HOST >> local.properties
+
+    - name: Generate google-services.json
+      run: |
+        echo "$GOOGLE_SERVICE" > app/google-services.json.b64
+        base64 -d -i app/google-services.json.b64 > app/google-services.json
+      env:
+        GOOGLE_SERVICE: ${{ secrets.GOOGLE_SERVICE }}
+
+    - name: Grant execute permission for gradlew
+      run: chmod +x gradlew
+
+    - name: Verify Roborazzi
+      run: ./gradlew :app:verifyRoborazziDebug
+
+    - name: Upload Roborazzi outputs (failure only)
+      if: failure()
+      uses: actions/upload-artifact@v4
+      with:
+        name: roborazzi-output
+        path: |
+          app/build/outputs/roborazzi
+          app/build/reports/roborazzi
+          app/build/test-results/roborazzi
+        retention-days: 7
+
   deploy-firebase:
     needs: build
     name: Deploy to Firebase

README.md

@@ -74,6 +74,9 @@
 
 이 프로젝트는 fastlane을 사용하여 자동화된 빌드 및 배포를 지원합니다.
 
+## 🖼 Screenshot Testing
+- [Roborazzi + Robolectric 스크린샷 회귀 테스트 가이드](docs/SCREENSHOT_TESTING.md)
+
 **📖 상세한 가이드는 다음 문서를 참조하세요:**
 👉 **[Fastlane을 이용한 배포 총 정리](.github/FASTLANE_DEPLOYMENT_GUIDE.md)**
 

app/build.gradle.kts

@@ -1,9 +1,11 @@
+import com.github.takahirom.roborazzi.ExperimentalRoborazziApi
 import java.util.Properties
 
 plugins {
     alias(libs.plugins.android.application)
     alias(libs.plugins.kotlin.android)
     alias(libs.plugins.compose.compiler)
+    alias(libs.plugins.roborazzi)
     alias(libs.plugins.google.services)
     alias(libs.plugins.firebase.crashlytics)
     alias(libs.plugins.hilt.android)
@@ -134,6 +136,26 @@ android {
     lint {
         abortOnError = false
     }
+
+    testOptions {
+        unitTests.isIncludeAndroidResources = true
+        unitTests.all {
+            val requestedTasks = gradle.startParameter.taskNames.joinToString(" ")
+            val runScreenshotCapture =
+                requestedTasks.contains("recordRoborazzi") || requestedTasks.contains("verifyRoborazzi")
+            it.useJUnitPlatform()
+            it.systemProperty("roborazzi.record.filePathStrategy", "relativePathFromRoborazziContextOutputDirectory")
+            it.systemProperty("eatssu.screenshot.capture", runScreenshotCapture.toString())
+        }
+    }
+}
+
+@OptIn(ExperimentalRoborazziApi::class)
+roborazzi {
+    outputDir.set(file("src/test/screenshots"))
+    compare {
+        outputDir.set(file("build/outputs/roborazzi"))
+    }
 }
 
 dependencies {
@@ -180,6 +202,18 @@ dependencies {
 
     // Testing libraries
     testImplementation(libs.junit)
+    testImplementation(libs.kotest.runner.junit5)
+    testImplementation(libs.kotest.assertions.core)
+    testImplementation(libs.kotest.property)
+    testImplementation(libs.mockk)
+    testImplementation(libs.kotlinx.coroutines.test)
+    testImplementation(libs.turbine)
+    testImplementation(libs.robolectric)
+    testImplementation(libs.roborazzi)
+    testImplementation(libs.roborazzi.compose)
+    testImplementation(libs.roborazzi.junit.rule)
+    testImplementation(libs.androidx.compose.ui.test.junit4)
+    testRuntimeOnly(libs.junit.vintage.engine)
     androidTestImplementation(libs.androidx.test.ext.junit)
     androidTestImplementation(libs.androidx.espresso.core)
 
@@ -269,4 +303,4 @@ dependencies {
 
 configurations.all {
     exclude(group = "io.github.fornewid", module = "naver-map-location")
-}
+}

app/src/main/java/com/eatssu/android/di/AppModule.kt

@@ -6,6 +6,7 @@ import dagger.Module
 import dagger.Provides
 import dagger.hilt.InstallIn
 import dagger.hilt.components.SingletonComponent
+import java.time.Clock
 import javax.inject.Singleton
 
 @Module
@@ -17,4 +18,8 @@ object AppModule {
     fun provideContext(application: Application): Context {
         return application.applicationContext
     }
+
+    @Provides
+    @Singleton
+    fun provideClock(): Clock = Clock.systemDefaultZone()
 }

app/src/main/java/com/eatssu/android/domain/usecase/alarm/AlarmUsecase.kt

@@ -7,10 +7,12 @@ import android.content.Intent
 import com.eatssu.android.alarm.NotificationReceiver
 import dagger.hilt.android.qualifiers.ApplicationContext
 import java.util.Calendar
+import java.time.Clock
 import javax.inject.Inject
 
 class AlarmUseCase @Inject constructor(
     @ApplicationContext private val context: Context,
+    private val clock: Clock,
 ) {
 
     fun scheduleAlarm() {
@@ -21,13 +23,14 @@ class AlarmUseCase @Inject constructor(
         )
 
         val calendar = Calendar.getInstance().apply {
+            timeInMillis = clock.millis()
             set(Calendar.HOUR_OF_DAY, 11)
             set(Calendar.MINUTE, 0)
             set(Calendar.SECOND, 0)
             set(Calendar.MILLISECOND, 0)
         }
 
-        if (calendar.timeInMillis <= System.currentTimeMillis()) {
+        if (calendar.timeInMillis <= clock.millis()) {
             calendar.add(Calendar.DAY_OF_YEAR, 1)
         }