Feat/app demo

README.md

@@ -1,2 +1,21 @@
-# demo-android
-Demo app
+# REES46 Demo Android
+
+## Description
+
+REES46 Demo Android - application to demonstrate working with SDK.
+
+## Configure
+
+Versions:
+Java 22
+Kotlin 2.0.0
+Gradle 8.8
+Android Gradle Plugin 8.5.1
+
+Copy `google-services.json` file from [Firebase console](https://console.firebase.google.com/u/0/) to app module.
+
+## Documentation
+
+For detailed information on methods used from the SDK, please refer to the documentation available at the following link:
+
+[Official API references](https://reference.api.rees46.com/#introduction)

app/.gitignore

@@ -0,0 +1 @@
+/build

app/build.gradle.kts

@@ -0,0 +1,59 @@
+plugins {
+    alias(libs.plugins.android.application)
+    alias(libs.plugins.jetbrains.kotlin.android)
+    id("com.google.gms.google-services")
+    id("androidx.navigation.safeargs.kotlin")
+}
+
+android {
+    namespace = "rees46.demo_android.app"
+    compileSdk = 34
+
+    defaultConfig {
+        applicationId = "rees46.demo_android"
+        minSdk = 24
+        targetSdk = 34
+        versionCode = 1
+        versionName = "1.0"
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_22
+        targetCompatibility = JavaVersion.VERSION_22
+    }
+    kotlinOptions {
+        jvmTarget = "22"
+    }
+    buildFeatures {
+        viewBinding = true
+    }
+}
+
+dependencies {
+
+    implementation(libs.androidx.core.ktx)
+    implementation(libs.androidx.appcompat)
+    implementation(libs.material)
+    implementation(libs.koin.core)
+    implementation(libs.koin.android)
+    implementation(libs.koin.compat)
+    implementation(libs.androidx.navigation.fragment)
+    implementation(libs.androidx.navigation.fragment.ktx)
+    implementation(libs.androidx.navigation.ui.ktx)
+    implementation(libs.androidx.core.splashscreen)
+    implementation(project(":core"))
+    implementation(project(":feature"))
+    implementation(project(":navigation"))
+    implementation(project(":sdkRees46"))
+}

app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

app/src/main/AndroidManifest.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <application
+        android:name=".DemoApplication"
+        android:allowBackup="true"
+        android:icon="@drawable/ic_app"
+        android:label="@string/app_name"
+        android:roundIcon="@drawable/ic_app"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.Demoandroid.Starting"
+        tools:targetApi="31">
+        <activity
+            android:name=".presentation.MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+</manifest>

app/src/main/java/rees46/demo_android/app/DemoApplication.kt

@@ -0,0 +1,59 @@
+package rees46.demo_android.app
+
+import android.app.Application
+import com.personalizatio.SDK
+import org.koin.android.ext.android.getKoin
+import org.koin.android.ext.koin.androidContext
+import org.koin.core.context.startKoin
+import rees46.demo_android.app.di.navigatorModule
+import rees46.demo_android.core.di.sdkModule
+import rees46.demo_android.core.utils.SdkUtils
+import rees46.demo_android.feature.cart.di.cartModule
+import rees46.demo_android.feature.category.di.categoryModule
+import rees46.demo_android.feature.home.di.homeModule
+import rees46.demo_android.feature.productDetails.di.productDetailsModule
+import rees46.demo_android.feature.products.di.productsModule
+import rees46.demo_android.feature.recommendationBlock.di.recommendationBlockModule
+import rees46.demo_android.feature.search.di.searchModule
+import rees46.demo_android.feature.settings.di.settingsModule
+
+class DemoApplication : Application() {
+
+    override fun onCreate() {
+        super.onCreate()
+
+        startKoin {
+            androidContext(this@DemoApplication)
+
+            modules(
+                listOf(
+                    navigatorModule,
+                    sdkModule,
+                    homeModule,
+                    recommendationBlockModule,
+                    cartModule,
+                    categoryModule,
+                    productDetailsModule,
+                    productsModule,
+                    settingsModule,
+                    searchModule
+                )
+            )
+        }
+
+        initializeSdk()
+    }
+
+    private fun initializeSdk() {
+        val sdk = getKoin().get<SDK>()
+        SdkUtils.initialize(
+            sdk = sdk,
+            context = this@DemoApplication,
+            shopId = SHOP_ID
+        )
+    }
+
+    companion object {
+        private const val SHOP_ID = "357382bf66ac0ce2f1722677c59511"
+    }
+}

app/src/main/java/rees46/demo_android/app/di/NavigatorModule.kt

@@ -0,0 +1,15 @@
+package rees46.demo_android.app.di
+
+import androidx.navigation.NavController
+import com.rees46.demo_android.navigation.Navigator
+import org.koin.dsl.module
+import rees46.demo_android.app.navigation.AppNavigator
+
+val navigatorModule = module {
+    single<Navigator> {
+        (navController: NavController) ->
+            AppNavigator(
+                navController = navController
+            )
+    }
+}

app/src/main/java/rees46/demo_android/app/navigation/AppNavigator.kt

@@ -0,0 +1,53 @@
+package rees46.demo_android.app.navigation
+
+import android.os.Bundle
+import androidx.annotation.IdRes
+import androidx.core.os.bundleOf
+import androidx.navigation.NavController
+import com.rees46.demo_android.navigation.Destination
+import com.rees46.demo_android.navigation.Navigator
+import com.rees46.demo_android.navigation.ProductDetails
+import com.rees46.demo_android.navigation.ProductsDetails
+import rees46.demo_android.app.R
+import rees46.demo_android.core.settings.NavigationSettings
+
+class AppNavigator(private val navController: NavController) : Navigator {
+
+    override fun navigate(destination: Destination) {
+        when(destination) {
+            is ProductDetails -> {
+                val bundle = bundleOf(NavigationSettings.PRODUCT_ARGUMENT_FIELD to destination.navigationProduct)
+                navigate(
+                    resId = R.id.productDetailsFragment,
+                    args = bundle
+                )
+            }
+            is ProductsDetails -> {
+                val bundle = bundleOf(NavigationSettings.PRODUCTS_ARGUMENT_FIELD to destination.navigationProducts)
+                navigate(
+                    resId = R.id.productsFragment,
+                    args = bundle
+                )
+            }
+            else -> {}
+        }
+    }
+
+    override fun navigate(id: Int) {
+        navController.navigate(id)
+    }
+
+    override fun popBackStack() {
+        navController.popBackStack()
+    }
+
+    override fun getCurrentDestination() : Int? =
+        navController.currentDestination?.id
+
+    private fun navigate(@IdRes resId: Int, args: Bundle?) {
+        navController.navigate(
+            resId = resId,
+            args = args
+        )
+    }
+}

app/src/main/java/rees46/demo_android/app/presentation/MainActivity.kt

@@ -0,0 +1,114 @@
+package rees46.demo_android.app.presentation
+
+import android.os.Bundle
+import android.view.Menu
+import android.view.MenuInflater
+import android.view.MenuItem
+import androidx.activity.OnBackPressedCallback
+import androidx.appcompat.app.AppCompatActivity
+import androidx.core.splashscreen.SplashScreen.Companion.installSplashScreen
+import androidx.core.view.MenuProvider
+import androidx.core.view.isVisible
+import androidx.lifecycle.LifecycleOwner
+import androidx.navigation.fragment.NavHostFragment
+import org.koin.android.ext.android.get
+import org.koin.core.parameter.parametersOf
+import rees46.demo_android.app.R
+import rees46.demo_android.app.databinding.ActivityMainBinding
+import com.rees46.demo_android.navigation.Navigator
+
+class MainActivity : AppCompatActivity(), LifecycleOwner {
+
+    private lateinit var binding: ActivityMainBinding
+
+    private val navigator by lazy {
+        get<Navigator> {
+            val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
+            parametersOf(navHostFragment.navController)
+        }
+    }
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        installSplashScreen()
+        super.onCreate(savedInstanceState)
+        binding = ActivityMainBinding.inflate(layoutInflater)
+        setContentView(binding.getRoot())
+
+        setupTopAppBar()
+        setupBottomNavigationView()
+        setupPopBackStack()
+        createOptionMenu()
+    }
+
+    private fun setupTopAppBar() {
+        setSupportActionBar(binding.topAppBar)
+    }
+
+    private fun setupBottomNavigationView() {
+        binding.bottomNavigation.setOnItemSelectedListener {
+            when (it.itemId) {
+                R.id.home -> switchBottomTab(R.id.homeFragment)
+                R.id.category -> switchBottomTab(R.id.categoryFragment)
+                R.id.cart -> switchBottomTab(R.id.cartFragment)
+                R.id.settings -> switchBottomTab(R.id.settingsFragment)
+            }
+
+            true
+        }
+    }
+
+    private fun switchBottomTab(id: Int) {
+        if(navigator.getCurrentDestination() == id) return
+
+        navigator.navigate(id)
+    }
+
+    private fun setupPopBackStack() {
+        onBackPressedDispatcher.addCallback(
+            owner = this,
+            onBackPressedCallback = object : OnBackPressedCallback(true) {
+                override fun handleOnBackPressed() {
+                    navigator.popBackStack()
+
+                    changeSelectedBottomItem()
+                }
+            }
+        )
+    }
+
+    private fun changeSelectedBottomItem() {
+        with(binding.bottomNavigation) {
+            when (navigator.getCurrentDestination()) {
+                R.id.homeFragment -> selectedItemId = R.id.home
+                R.id.categoryFragment -> selectedItemId = R.id.category
+                R.id.cartFragment -> selectedItemId = R.id.cart
+                R.id.settingsFragment -> selectedItemId = R.id.settingsFragment
+            }
+        }
+    }
+
+
+    private fun createOptionMenu() {
+        addMenuProvider(object : MenuProvider {
+            override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
+                menuInflater.inflate(R.menu.main_top_app_bar_menu, menu)
+            }
+
+            override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
+                return when (menuItem.itemId) {
+                    R.id.menu_top_app_cart -> {
+                        binding.bottomNavigation.selectedItemId = R.id.cart
+                        true
+                    }
+                    R.id.menu_top_app_search -> {
+                        supportActionBar?.hide()
+                        binding.bottomNavigation.isVisible = false
+                        navigator.navigate(R.id.searchFragment)
+                        true
+                    }
+                    else -> false
+                }
+            }
+        })
+    }
+}

app/src/main/res/drawable/ic_app.xml

@@ -0,0 +1,15 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="76dp"
+    android:height="86dp"
+    android:viewportWidth="76"
+    android:viewportHeight="86"
+    android:tint="#000000">
+  <path
+      android:pathData="M65.53,22.241L42.023,8.541C39.535,7.091 36.465,7.091 33.977,8.541L10.47,22.241C7.998,23.682 6.467,26.341 6.467,29.229V56.771C6.467,59.659 7.998,62.318 10.47,63.759L33.977,77.459C36.465,78.909 39.535,78.909 42.023,77.459L65.53,63.759C68.002,62.318 69.533,59.659 69.533,56.771V29.229C69.533,26.341 68.002,23.682 65.53,22.241ZM44.91,3.588C40.638,1.097 35.362,1.097 31.09,3.588L7.583,17.288C3.343,19.759 0.733,24.308 0.733,29.229V56.771C0.733,61.692 3.343,66.241 7.583,68.712L31.09,82.412C35.362,84.903 40.638,84.903 44.91,82.412L68.417,68.712C72.657,66.241 75.267,61.692 75.267,56.771V29.229C75.267,24.308 72.657,19.759 68.417,17.288L44.91,3.588Z"
+      android:fillColor="#ffffff"
+      android:fillType="evenOdd"/>
+  <path
+      android:pathData="M38.236,56.558C40.1,55.098 42.109,53.423 44.153,51.546C54.122,42.386 59.47,32.271 61.705,27.268C62.607,29.724 63.11,32.63 63.138,35.781C59.577,40.319 53.786,47.264 48.402,51.795C45.384,54.334 42.674,56.443 40.336,58.162C40.605,58.362 40.869,58.557 41.128,58.746C43.264,57.248 45.649,55.482 48.159,53.48C54.322,48.564 59.335,42.885 63.084,37.939C62.993,39.512 62.787,41.133 62.457,42.776C62.257,43.776 62.005,44.771 61.709,45.753C58.631,48.834 55.345,51.854 52.378,54.017C48.898,56.556 45.83,58.618 43.245,60.256C43.518,60.446 43.782,60.628 44.037,60.802C46.293,59.452 48.818,57.847 51.475,56.009C54.886,53.648 57.997,51.057 60.774,48.449C59.654,51.3 58.181,53.972 56.511,56.261C56.217,56.456 55.926,56.645 55.638,56.826C50.042,60.353 45.463,62.801 42.181,64.407C41.87,64.57 41.573,64.723 41.244,64.88L41.223,64.87C40.983,64.984 40.752,65.093 40.529,65.197L40.541,65.203C39.764,65.568 39.2,65.811 38.677,66.034C38.523,66.101 38.378,66.164 38.239,66.223L38.236,66.222L38.233,66.223C38.095,66.164 37.949,66.101 37.796,66.034C37.272,65.811 36.708,65.568 35.931,65.203L35.944,65.197C35.721,65.093 35.49,64.984 35.25,64.87L35.229,64.88C34.9,64.723 34.602,64.57 34.291,64.407C31.009,62.801 26.431,60.353 20.834,56.826C20.547,56.645 20.256,56.456 19.962,56.261C18.292,53.972 16.818,51.3 15.698,48.449C18.475,51.057 21.587,53.648 24.997,56.009C27.654,57.847 30.179,59.452 32.436,60.802C32.69,60.628 32.954,60.446 33.227,60.256C30.643,58.618 27.575,56.556 24.095,54.017C21.128,51.854 17.841,48.834 14.763,45.753C14.467,44.771 14.215,43.776 14.015,42.776C13.685,41.133 13.479,39.512 13.388,37.939C17.138,42.885 22.15,48.564 28.313,53.48C30.823,55.482 33.208,57.248 35.344,58.746C35.603,58.557 35.868,58.362 36.137,58.162C33.798,56.443 31.088,54.334 28.071,51.795C22.687,47.264 16.895,40.319 13.334,35.781C13.362,32.63 13.865,29.724 14.767,27.268C17.002,32.271 22.35,42.386 32.319,51.546C34.363,53.423 36.372,55.098 38.236,56.558ZM38.386,63.227C38.125,63.389 37.875,63.544 37.636,63.69C37.895,63.842 38.145,63.987 38.386,64.126C38.627,63.987 38.877,63.842 39.136,63.69C38.897,63.544 38.647,63.389 38.386,63.227ZM34.636,62.209C34.876,62.057 35.126,61.897 35.387,61.728C35.643,61.881 35.893,62.028 36.136,62.171C35.877,62.331 35.627,62.483 35.388,62.627C35.142,62.492 34.892,62.353 34.636,62.209ZM41.086,61.728C40.83,61.881 40.58,62.028 40.336,62.171C40.595,62.331 40.845,62.483 41.085,62.627C41.33,62.492 41.581,62.353 41.836,62.209C41.597,62.057 41.346,61.897 41.086,61.728ZM37.636,60.091C37.88,59.942 38.13,59.789 38.386,59.631C38.642,59.789 38.892,59.942 39.136,60.091C38.881,60.241 38.631,60.388 38.386,60.53C38.141,60.388 37.891,60.241 37.636,60.091Z"
+      android:fillColor="#ffffff"
+      android:fillType="evenOdd"/>
+</vector>