Feat: Android 프로젝트 초기세팅

.github/android-ci.yml → .github/workflows/android-ci.yml

@@ -6,8 +6,8 @@ on:
   push:
     branches: [ "main", "develop" ] # 브랜치에 push될 때
   pull_request:
-    branches: [ "main", "develop" ] # 브랜치로 pull request가 생성될 때   
-  workflow_dispatch: # Github Actions 수동으로 실행될 때
+    branches: [ "main", "develop" ] # 브랜치로 pull request가 생성될 때
+  workflow_dispatch: # Github Actions 수동으로 실행될 때
 
 # 실행될 작업(Job) 목록
 jobs:

.gitignore

@@ -8,6 +8,7 @@ build/
 
 # Local configuration file (sdk path, etc)
 local.properties
+secrets.properties
 
 # Log/OS Files
 *.log
@@ -417,3 +418,4 @@ obj/
 !/gradle/wrapper/gradle-wrapper.jar
 
 # End of https://www.toptal.com/developers/gitignore/api/macos,windows,android,androidstudio,kotlin,java,gradle,maven,intellij,git
+/node_modules/

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit $1 --format ./scripts/commitlint-formatter-korean.js

.husky/pre-commit

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+

app/build.gradle.kts

@@ -6,6 +6,10 @@ plugins {
     alias(libs.plugins.ksp)
     alias(libs.plugins.hilt.android)
     alias(libs.plugins.ktlint)
+    alias(libs.plugins.secrets.gradle.plugin)
+    alias(libs.plugins.google.services)
+    alias(libs.plugins.firebase.crashlytics)
+    alias(libs.plugins.firebase.perf)
 }
 
 android {
@@ -24,6 +28,11 @@ android {
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }
 
+    buildFeatures {
+        buildConfig = true
+        compose = true
+    }
+
     buildTypes {
         release {
             isMinifyEnabled = false
@@ -37,8 +46,17 @@ android {
         sourceCompatibility = JavaVersion.VERSION_17
         targetCompatibility = JavaVersion.VERSION_17
     }
-    buildFeatures {
-        compose = true
+
+    secrets {
+        // 기본 'local.properties' 대신 다른 파일 이름 지정
+        propertiesFileName = "secrets.properties"
+
+        // CI/CD 환경을 위한 기본값 파일 지정 (버전 관리에 포함 가능)
+        defaultPropertiesFileName = "secrets.defaults.properties"
+
+        // 특정 키를 무시하도록 정규식 추가 (기본적으로 "sdk.dir"은 무시됨)
+        ignoreList.add("keyToIgnore")
+        ignoreList.add("ignore*")
     }
 }
 
@@ -53,13 +71,18 @@ dependencies {
     implementation(libs.androidx.activity.compose)
     implementation(libs.androidx.lifecycle.viewmodel.ktx) // ViewModel
     implementation(libs.androidx.navigation.compose) // Navigation
+    implementation(libs.androidx.datastore.preferences) // DataStore Preferences
+    implementation(libs.androidx.room.runtime) // Room Runtime
+    ksp(libs.androidx.room.compiler) // Room Compiler
+    implementation(libs.androidx.room.ktx) // Room KTX
 
     // Jetpack Compose dependencies
     implementation(platform(libs.androidx.compose.bom))
     implementation(libs.androidx.compose.ui)
     implementation(libs.androidx.compose.ui.graphics)
     implementation(libs.androidx.compose.ui.tooling.preview)
     implementation(libs.androidx.compose.material3)
+    implementation(libs.androidx.compose.material.icons.extended) // TODO 배포시 해당 의존성 삭제하고 필요한 아이콘만 개별 추가
     // Debug dependencies
     debugImplementation(libs.androidx.compose.ui.tooling)
     debugImplementation(libs.androidx.compose.ui.test.manifest)
@@ -69,11 +92,19 @@ dependencies {
     androidTestImplementation(libs.androidx.espresso.core)
     androidTestImplementation(platform(libs.androidx.compose.bom))
     androidTestImplementation(libs.androidx.compose.ui.test.junit4)
+    // Firebase dependencies
+    implementation(platform(libs.firebase.bom))
+    implementation(libs.firebase.analytics)
+    implementation(libs.firebase.crashlytics)
+    implementation(libs.firebase.perf)
+    implementation(libs.firebase.messaging)
+    implementation(libs.firebase.config)
 
     // Retrofit dependencies
     implementation(libs.retrofit)
     implementation(libs.logging.interceptor)
     implementation(libs.retrofit2.kotlinx.serialization.converter)
+    implementation(libs.kotlinx.serialization.json)
     // Coroutines dependencies
     implementation(libs.kotlinx.coroutines.core)
     implementation(libs.kotlinx.coroutines.android)
@@ -86,6 +117,10 @@ dependencies {
     implementation(libs.androidx.hilt.navigation.compose)
     // Timber dependency for logging
     implementation(libs.timber)
+    // Browser (Chrome Custom Tabs)
+    implementation(libs.androidx.browser)
+    // Security Crypto for EncryptedSharedPreferences
+    implementation(libs.androidx.security.crypto)
 //    // DataStore dependencies
 //    implementation("androidx.datastore:datastore-preferences:1.0.0")
 //    // Room dependencies

app/src/main/AndroidManifest.xml

@@ -14,18 +14,17 @@
         android:maxSdkVersion="32" />
     <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
-    <!--    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />-->
-    <!--    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />-->
 
     <application
-        android:name=".EverpApp"
+        android:name=".EverpApplication"
         android:allowBackup="true"
         android:dataExtractionRules="@xml/data_extraction_rules"
         android:fullBackupContent="@xml/backup_rules"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
+        android:networkSecurityConfig="@xml/network_security_config"
         android:theme="@style/Theme.Everp">
         <activity
             android:name=".MainActivity"
@@ -38,6 +37,40 @@
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
+
+        <!-- 크래시 발생 시 표시되는 에러 화면 -->
+        <activity
+            android:name=".ui.error.ErrorActivity"
+            android:exported="false"
+            android:launchMode="singleTask"
+            android:excludeFromRecents="true"
+            android:theme="@style/Theme.Everp" />
+
+        <service
+            android:name=".service.fcm.MyFirebaseMessagingService"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="com.google.firebase.MESSAGING_EVENT" />
+            </intent-filter>
+        </service>
+
+        <meta-data
+            android:name="firebase_performance_logcat_enabled"
+            android:value="true" />
+
+        <!-- OAuth2 Redirect 수신 (everp-aos://callback) -->
+        <activity
+            android:name="com.autoever.everp.ui.redirect.RedirectReceiverActivity"
+            android:exported="true"
+            android:launchMode="singleTop"
+            android:theme="@style/Theme.Transparent">
+            <intent-filter android:label="oauth2-redirect">
+                <action android:name="android.intent.action.VIEW" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+                <data android:scheme="everp-aos" android:host="callback" />
+            </intent-filter>
+        </activity>
     </application>
 
-</manifest>
+</manifest>

app/src/main/java/com/autoever/everp/EverpApplication.kt

@@ -0,0 +1,60 @@
+package com.autoever.everp
+
+import android.app.Application
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.os.Build
+import com.autoever.everp.common.exception.GlobalExceptionHandler
+import dagger.hilt.android.HiltAndroidApp
+import com.autoever.everp.service.fcm.MyFirebaseMessagingService
+import timber.log.Timber
+import javax.inject.Inject
+
+@HiltAndroidApp
+class EverpApplication : Application() {
+
+    @Inject
+    lateinit var globalExceptionHandler: GlobalExceptionHandler
+
+    override fun onCreate() {
+        super.onCreate()
+        initTimber()
+        initGlobalExceptionHandler()
+        createNotificationChannels()
+    }
+
+    /**
+     * 전역 예외 처리기 초기화
+     * 
+     * 가장 먼저 초기화하여 앱 실행 중 발생하는 모든 예외를 잡을 수 있도록 함
+     */
+    private fun initGlobalExceptionHandler() {
+        try {
+            globalExceptionHandler.initialize()
+            Timber.i("Global exception handler initialized")
+        } catch (e: Exception) {
+            // 초기화 실패 시에도 앱은 계속 실행
+            Timber.e(e, "Failed to initialize global exception handler")
+        }
+    }
+
+    private fun initTimber() {
+        if (BuildConfig.DEBUG) {
+            Timber.plant(Timber.DebugTree())
+        }
+    }
+
+    private fun createNotificationChannels() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            val channel = NotificationChannel(
+                MyFirebaseMessagingService.DEFAULT_CHANNEL_ID,
+                "일반 알림",
+                NotificationManager.IMPORTANCE_HIGH,
+            ).apply {
+                description = "EvERP 기본 알림 채널"
+            }
+            val manager = getSystemService(NotificationManager::class.java)
+            manager.createNotificationChannel(channel)
+        }
+    }
+}

app/src/main/java/com/autoever/everp/MainActivity.kt

@@ -4,49 +4,50 @@ import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
 import androidx.activity.enableEdgeToEdge
+import androidx.lifecycle.lifecycleScope
+import com.autoever.everp.domain.repository.PushNotificationRepository
+import com.autoever.everp.ui.MainScreen
 import androidx.compose.foundation.layout.fillMaxSize
-import androidx.compose.foundation.layout.padding
-import androidx.compose.material3.Scaffold
-import androidx.compose.material3.Text
-import androidx.compose.runtime.Composable
+import androidx.compose.material3.Surface
 import androidx.compose.ui.Modifier
-import androidx.compose.ui.tooling.preview.Preview
 import com.autoever.everp.ui.theme.EverpTheme
+import com.autoever.everp.ui.navigation.AppNavGraph
 import dagger.hilt.android.AndroidEntryPoint
+import kotlinx.coroutines.launch
+import timber.log.Timber
+import javax.inject.Inject
 
 @AndroidEntryPoint
 class MainActivity : ComponentActivity() {
+
+    @Inject
+    lateinit var notificationRepository: PushNotificationRepository
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         enableEdgeToEdge()
+        getFcmToken()
         setContent {
             EverpTheme {
-                Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
-                    Greeting(
-                        name = "Android",
-                        modifier = Modifier.padding(innerPadding),
-                    )
-                }
+                MainScreen()
+//                Surface(modifier = Modifier.fillMaxSize()) {
+//                    AppNavGraph()
+//                }
             }
         }
     }
-}
 
-@Composable
-fun Greeting(
-    name: String,
-    modifier: Modifier = Modifier,
-) {
-    Text(
-        text = "Hello $name!",
-        modifier = modifier,
-    )
-}
-
-@Preview(showBackground = true)
-@Composable
-fun GreetingPreview() {
-    EverpTheme {
-        Greeting("Android")
+    private fun getFcmToken() {
+        // Repository를 통해서만 FCM 토큰 접근
+        // MainActivity에서는 Firebase 객체에 직접 접근하지 않음
+        lifecycleScope.launch {
+            try {
+                val token = notificationRepository.getToken()
+                Timber.tag("FCM").i("FCM Token: $token")
+                // TODO: 서버에 토큰 전송 또는 로컬 저장 등 필요한 작업 수행
+            } catch (e: Exception) {
+                Timber.tag("FCM").e(e, "Fetching FCM token failed")
+            }
+        }
     }
 }

app/src/main/java/com/autoever/everp/auth/api/AuthApi.kt

@@ -0,0 +1,19 @@
+package com.autoever.everp.auth.api
+
+import com.autoever.everp.auth.config.AuthConfig
+import com.autoever.everp.auth.model.TokenResponse
+
+/**
+ * 인증 서버 연동 API
+ * - 인가 코드 교환(Authorization Code + PKCE)
+ * - 로그아웃
+ */
+interface AuthApi {
+    suspend fun exchangeAuthCodeForToken(
+        config: AuthConfig,
+        code: String,
+        codeVerifier: String,
+    ): TokenResponse
+
+    suspend fun logout(accessToken: String?): Boolean
+}