feat: set up android module bare bone

android/build.gradle

@@ -0,0 +1,56 @@
+plugins {
+    id 'com.android.library'
+    id 'kotlin-android'
+}
+
+android {
+    compileSdk 31
+
+    defaultConfig {
+        multiDexEnabled true
+
+        minSdk 16
+        targetSdk 31
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles "consumer-rules.pro"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+    compileOptions {
+        coreLibraryDesugaringEnabled true
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+    kotlinOptions {
+        jvmTarget = '1.8'
+    }
+    testOptions {
+        unitTests {
+            includeAndroidResources = true
+        }
+    }
+}
+
+dependencies {
+    implementation project(':main')
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.5.2'
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2'
+
+    testImplementation 'org.junit.jupiter:junit-jupiter:5.7.2'
+    testImplementation 'io.mockk:mockk:1.10.6'
+    testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.3.2'
+    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
+    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
+    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.7.2'
+    testImplementation 'org.junit.jupiter:junit-jupiter-params:5.7.2'
+    testImplementation 'org.robolectric:robolectric:4.7.3'
+    testImplementation 'androidx.test:core:1.4.0'
+}

android/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

android/src/androidTest/java/com/amplitude/android/ExampleInstrumentedTest.java

@@ -0,0 +1,26 @@
+package com.amplitude.android;
+
+import android.content.Context;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+import static org.junit.Assert.*;
+
+import androidx.test.platform.app.InstrumentationRegistry;
+import androidx.test.ext.junit.runners.AndroidJUnit4;
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+@RunWith(AndroidJUnit4.class)
+public class ExampleInstrumentedTest {
+    @Test
+    public void useAppContext() {
+        // Context of the app under test.
+        Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
+        assertEquals("com.amplitude.android.test", appContext.getPackageName());
+    }
+}

android/src/main/AndroidManifest.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.amplitude.android">
+
+</manifest>

android/src/main/java/com/amplitude/android/AndroidAmplitude.kt

@@ -0,0 +1,15 @@
+package com.amplitude.android
+
+import android.content.Context
+import com.amplitude.Amplitude
+import com.amplitude.platform.plugins.AmplitudeDestination
+
+open class AndroidAmplitude(
+    val context: Context,
+    configuration: AndroidConfiguration
+): Amplitude(configuration) {
+
+    override fun build() {
+        add(AmplitudeDestination())
+    }
+}

android/src/main/java/com/amplitude/android/AndroidConfiguration.kt

@@ -0,0 +1,23 @@
+package com.amplitude.android
+
+import com.amplitude.Configuration
+import com.amplitude.Constants
+import com.amplitude.LoggerProvider
+import com.amplitude.StorageProvider
+import com.amplitude.android.utilities.AndroidLoggerProvider
+import com.amplitude.android.utilities.AndroidStorageProvider
+import com.amplitude.events.BaseEvent
+
+class AndroidConfiguration(
+    apiKey: String,
+    flushQueueSize: Int = Constants.FLUSH_QUEUE_SIZE,
+    flushIntervalMillis: Int = Constants.FLUSH_INTERVAL_MILLIS,
+    optOut: Boolean = false,
+    storageProvider: StorageProvider = AndroidStorageProvider(),
+    loggerProvider: LoggerProvider = AndroidLoggerProvider(),
+    minIdLength: Int? = null,
+    callback: ((BaseEvent) -> Unit)? = null,
+    useAdvertisingIdForDeviceId: Boolean = false,
+    useAppSetIdForDeviceId: Boolean = false,
+    enableCoppaControl: Boolean = false
+) : Configuration(apiKey, flushQueueSize, flushIntervalMillis, optOut, storageProvider, loggerProvider, minIdLength, callback)

android/src/main/java/com/amplitude/android/plugins/AndroidContextPlugin.kt

@@ -0,0 +1,14 @@
+package com.amplitude.android.plugins
+
+import com.amplitude.Amplitude
+import com.amplitude.events.BaseEvent
+import com.amplitude.platform.Plugin
+
+class AndroidContextPlugin : Plugin {
+    override val type: Plugin.Type = Plugin.Type.Before
+    override lateinit var amplitude: Amplitude
+
+    override fun execute(event: BaseEvent): BaseEvent? {
+        return event
+    }
+}

android/src/main/java/com/amplitude/android/plugins/AndroidLifecyclePlugin.kt

@@ -0,0 +1,9 @@
+package com.amplitude.android.plugins
+
+import com.amplitude.Amplitude
+import com.amplitude.platform.Plugin
+
+class AndroidLifecyclePlugin : Plugin {
+    override val type: Plugin.Type = Plugin.Type.Utility
+    override lateinit var amplitude: Amplitude
+}

android/src/main/java/com/amplitude/android/utilities/AndroidLogger.kt

@@ -0,0 +1,31 @@
+package com.amplitude.android.utilities
+
+import com.amplitude.Amplitude
+import com.amplitude.Logger
+import com.amplitude.LoggerProvider
+
+class AndroidLogger() : Logger {
+    override var logMode: Logger.LogMode = Logger.LogMode.INFO
+
+    override fun debug(message: String) {
+        TODO("Not yet implemented")
+    }
+
+    override fun error(message: String) {
+        TODO("Not yet implemented")
+    }
+
+    override fun info(message: String) {
+        TODO("Not yet implemented")
+    }
+
+    override fun warn(message: String) {
+        TODO("Not yet implemented")
+    }
+}
+
+class AndroidLoggerProvider() : LoggerProvider {
+    override fun getLogger(amplitude: Amplitude): Logger {
+        return AndroidLogger()
+    }
+}

android/src/main/java/com/amplitude/android/utilities/AndroidStorage.kt

@@ -0,0 +1,28 @@
+package com.amplitude.android.utilities
+
+import com.amplitude.Amplitude
+import com.amplitude.Storage
+import com.amplitude.StorageProvider
+import com.amplitude.events.BaseEvent
+
+class AndroidStorage(
+    val amplitude: Amplitude
+) : Storage {
+    override fun write(event: BaseEvent) {
+        TODO("Not yet implemented")
+    }
+
+    override fun rollover() {
+        TODO("Not yet implemented")
+    }
+
+    override fun getEvents(): List<String> {
+        TODO("Not yet implemented")
+    }
+}
+
+class AndroidStorageProvider: StorageProvider {
+    override fun getStorage(amplitude: Amplitude): Storage {
+        return AndroidStorage(amplitude)
+    }
+}

android/src/test/java/com/amplitude/android/ExampleUnitTest.java

@@ -0,0 +1,17 @@
+package com.amplitude.android;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+/**
+ * Example local unit test, which will execute on the development machine (host).
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+public class ExampleUnitTest {
+    @Test
+    public void addition_isCorrect() {
+        assertEquals(4, 2 + 2);
+    }
+}

build.gradle

@@ -2,9 +2,11 @@ buildscript {
     ext.kotlin_version = "1.5.10"
     repositories {
         mavenCentral()
+        google()
     }
 
     dependencies {
+        classpath 'com.android.tools.build:gradle:7.0.4'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
@@ -17,16 +19,10 @@ allprojects{
         maven { url "https://kotlin.bintray.com/kotlinx" }
     }
 
-    apply plugin: "kotlin"
-
-    compileKotlin {
+    tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).all {
         kotlinOptions {
+            freeCompilerArgs = ['-Xjvm-default=enable']
             jvmTarget = "1.8"
-            javaParameters = true
         }
     }
-
-    dependencies {
-        implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-    }
 }

gradle.properties

@@ -0,0 +1,4 @@
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+android.useAndroidX=true
+android.enableJetifier=true
+kotlin.code.style=official

main/build.gradle

@@ -1,5 +1,6 @@
 plugins {
     id 'java'
+    id 'kotlin'
     id 'org.jetbrains.kotlin.jvm'
 }
 

main/java/com/amplitude/Amplitude.kt

@@ -37,7 +37,7 @@ open class Amplitude internal constructor(
      */
     constructor(configuration: com.amplitude.Configuration) : this(configuration, com.amplitude.State())
 
-    internal fun build() {
+    open fun build() {
         add(ContextPlugin())
         add(AmplitudeDestination())
 

main/java/com/amplitude/Configuration.kt

@@ -4,7 +4,7 @@ import com.amplitude.events.BaseEvent
 import com.amplitude.utilities.ConsoleLoggerProvider
 import com.amplitude.utilities.InMemoryStorageProvider
 
-data class Configuration(
+open class Configuration(
     val apiKey: String,
     val flushQueueSize: Int = Constants.FLUSH_QUEUE_SIZE,
     val flushIntervalMillis: Int = Constants.FLUSH_INTERVAL_MILLIS,

main/java/com/amplitude/platform/Plugin.kt

@@ -11,6 +11,7 @@ interface Plugin {
         Before,
         Enrichment,
         Destination,
+        Utility,
         Observe
     }
 

main/java/com/amplitude/platform/Timeline.kt

@@ -8,6 +8,7 @@ internal class Timeline {
         Plugin.Type.Before to Mediator(mutableListOf()),
         Plugin.Type.Enrichment to Mediator(mutableListOf()),
         Plugin.Type.Destination to Mediator(mutableListOf()),
+        Plugin.Type.Utility to Mediator(mutableListOf())
     )
     lateinit var amplitude: com.amplitude.Amplitude
 

settings.gradle

@@ -3,3 +3,5 @@ include 'main'
 project(':main').projectDir = file('main')
 include 'samples:kotlin-jvm-app'
 project(':samples:kotlin-jvm-app').projectDir = file('samples/kotlin-jvm-app')
+include 'android'
+project(':android').projectDir = file('android')