Merge remote-tracking branch 'origin/release/1.0.2'

Author: angryPodo

app/build.gradle.kts

@@ -41,6 +41,11 @@ android {
         versionName = libs.versions.versionName.get()
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+        buildConfigField(
+            "String",
+            "AMPLITUDE_API_KEY",
+            "\"${properties.getProperty("amplitudeKey")}\""
+        )
     }
 
     signingConfigs {

app/src/main/java/com/hilingual/analytics/AmplitudeTracker.kt

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2025 The Hilingual Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.hilingual.analytics
+
+import android.content.Context
+import com.amplitude.android.Amplitude
+import com.amplitude.android.Configuration
+import com.hilingual.BuildConfig
+import com.hilingual.core.common.analytics.Page
+import com.hilingual.core.common.analytics.Tracker
+import com.hilingual.core.common.analytics.TriggerType
+import dagger.hilt.android.qualifiers.ApplicationContext
+import javax.inject.Inject
+import javax.inject.Singleton
+import timber.log.Timber
+
+@Singleton
+class AmplitudeTracker @Inject constructor(
+    @ApplicationContext private val context: Context
+) : Tracker {
+
+    private val amplitude = Amplitude(
+        Configuration(
+            apiKey = BuildConfig.AMPLITUDE_API_KEY,
+            context = context
+        )
+    )
+
+    override fun logEvent(trigger: TriggerType, page: Page, event: String) {
+        val eventName = "${trigger.value}_${page.pageName}.$event"
+        Timber.tag("AmplitudeTracker").d("Tracking event: $eventName, properties: None")
+        amplitude.track(eventName)
+    }
+
+    override fun logEvent(
+        trigger: TriggerType,
+        page: Page,
+        event: String,
+        properties: Map<String, Any>
+    ) {
+        val eventName = "${trigger.value}_${page.pageName}.$event"
+        Timber.tag("AmplitudeTracker").d("Tracking event: $eventName, properties: $properties")
+        amplitude.track(eventName, properties.toMutableMap())
+    }
+}

app/src/main/java/com/hilingual/di/TrackerModule.kt

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2025 The Hilingual Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.hilingual.di
+
+import com.hilingual.analytics.AmplitudeTracker
+import com.hilingual.core.common.analytics.Tracker
+import dagger.Binds
+import dagger.Module
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+
+@Module
+@InstallIn(SingletonComponent::class)
+abstract class TrackerModule {
+
+    @Binds
+    abstract fun bindTracker(
+        amplitudeTracker: AmplitudeTracker
+    ): Tracker
+}

app/src/release/generated/baselineProfiles/baseline-prof.txt

@@ -26,6 +26,7 @@ class AndroidApplicationConventionPlugin : Plugin<Project> {
             }
 
             DependencyManager.addAndroidLibraryDependencies(this)
+            DependencyManager.addTrackerDependency(this)
         }
     }
 }

app/src/release/generated/baselineProfiles/startup-prof.txt

@@ -24,6 +24,7 @@ class AndroidPresentationConventionPlugin : Plugin<Project> {
 
             // presentation 모듈에 공통적으로 필요한 의존성들을 추가합니다.
             DependencyManager.addPresentationDependencies(this)
+            DependencyManager.addTrackerDependency(this)
         }
     }
 }

build-logic/convention/src/main/kotlin/AndroidApplicationConventionPlugin.kt

@@ -46,6 +46,7 @@ object DependencyManager {
             // 모듈
             add("implementation", project.project(":core:common"))
             add("implementation", project.project(":core:designsystem"))
+            add("implementation", project.project(":core:ui"))
             add("implementation", project.project(":core:navigation"))
 
             // AndroidX
@@ -63,6 +64,12 @@ object DependencyManager {
         }
     }
 
+    fun addTrackerDependency(project: Project) {
+        project.dependencies {
+            add("implementation", project.libs.findLibrary("amplitude-analytics-android").get())
+        }
+    }
+
     fun addDataDependencies(project: Project) {
         project.dependencies {
             // 모듈

build-logic/convention/src/main/kotlin/AndroidPresentationConventionPlugin.kt

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2025 The Hilingual Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.hilingual.core.common.analytics
+
+class FakeTracker : Tracker {
+    override fun logEvent(trigger: TriggerType, page: Page, event: String) {}
+    override fun logEvent(trigger: TriggerType, page: Page, event: String, properties: Map<String, Any>) {}
+}

build-logic/convention/src/main/kotlin/com/hilingual/buildlogic/DependencyManager.kt

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2025 The Hilingual Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.hilingual.core.common.analytics
+
+enum class Page(val pageName: String) {
+    // 홈
+    HOME("home"),
+
+    // 일기 작성
+    WRITE_DIARY("write_diary"),
+
+    // 피드백
+    FEEDBACK("feedback"),
+
+    // 단어장
+    VOCABULARY("vocabulary"),
+
+    // 피드
+    FEED("feed"),
+    POSTED_DIARY("posted_diary"),
+    MY_FEED("my_feed")
+}