Initial Splunk code donation

.gitignore

@@ -1 +1,5 @@
-.idea
+.idea
+.gradle
+/local.properties
+.DS_Store
+**/build/

README.md

@@ -1,11 +1,11 @@
 # OpenTelemetry Android
 
-:warning: This is a brand new repository that is in the process of being spun up. 
+:warning: This is a brand new repository that is in the process of being spun up.
 
 ## Status: Experimental
 
 # About
 
 The repository contains the OpenTelemetry Android SDK for generating mobile
 client telemetry for real user monitoring (RUM). It is built on top
-of the [OpenTelemetry Java SDK](https://github.com/open-telemetry/opentelemetry-java).
+of the [OpenTelemetry Java SDK](https://github.com/open-telemetry/opentelemetry-java).

build.gradle.kts

@@ -0,0 +1,32 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        // keep this version in sync with /buildSrc/build.gradle.kts
+        classpath("com.android.tools.build:gradle:8.0.2")
+    }
+}
+
+plugins {
+    id("otel.spotless-conventions")
+}
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+        maven {
+            url = uri("https://oss.sonatype.org/content/repositories/snapshots")
+        }
+    }
+    if (findProperty("release") != "true") {
+        version = "$version-SNAPSHOT"
+    }
+}
+
+subprojects {
+    apply(plugin = "otel.spotless-conventions")
+}

buildSrc/build.gradle.kts

@@ -0,0 +1,28 @@
+plugins {
+    `kotlin-dsl`
+
+    // When updating, update below in dependencies too
+    id("com.diffplug.spotless") version "6.20.0"
+}
+
+spotless {
+    kotlinGradle {
+        ktlint()
+        target("* * / *.gradle.kts")
+    }
+}
+
+repositories {
+    mavenCentral()
+    google()
+    gradlePluginPortal()
+}
+
+dependencies {
+    // keep this version in sync with /build.gradle.kts
+    implementation("com.android.tools.build:gradle:8.0.2")
+
+    implementation("com.diffplug.spotless:spotless-plugin-gradle:6.20.0")
+    implementation("net.ltgt.gradle:gradle-errorprone-plugin:3.1.0")
+    implementation("net.ltgt.gradle:gradle-nullaway-plugin:1.6.0")
+}

buildSrc/src/main/kotlin/otel.android-library-conventions.gradle.kts

@@ -0,0 +1,52 @@
+import org.gradle.api.publish.maven.MavenPublication
+import java.net.URI
+
+plugins {
+    id("com.android.library")
+    id("maven-publish")
+    id("signing")
+}
+
+android {
+    lint {
+        warningsAsErrors = true
+        // A newer version of androidx.appcompat:appcompat than 1.3.1 is available: 1.4.1 [GradleDependency]
+        // we rely on dependabot for dependency updates
+        disable.add("GradleDependency")
+    }
+}
+
+val sourcesJar by tasks.registering(Jar::class) {
+
+    from(android.sourceSets.named("main").get().java.srcDirs)
+    archiveClassifier.set("sources")
+}
+
+project.afterEvaluate {
+
+    // note: we need to declare this here in afterEvaluate because the android plugin doesn't
+    // resolve dependencies early enough to make the libraryVariants hack work until here.
+    val javadoc by tasks.registering(Javadoc::class) {
+        source = android.sourceSets.named("main").get().java.getSourceFiles()
+        classpath += project.files(android.bootClasspath)
+
+        // grab the library variants, because apparently this is where the real classpath lives that
+        // is needed for javadoc generation.
+        val firstVariant = project.android.libraryVariants.toList().first()
+        val javaCompile = firstVariant.javaCompileProvider.get()
+        classpath += javaCompile.classpath
+        classpath += javaCompile.outputs.files
+    }
+
+    val javadocJar by tasks.registering(Jar::class) {
+        dependsOn(javadoc)
+        archiveClassifier.set("javadoc")
+        from(javadoc.get().destinationDir)
+    }
+
+    val component = project.components.findByName("release")
+    publishing {
+        publications {
+        }
+    }
+}

buildSrc/src/main/kotlin/otel.errorprone-conventions.gradle.kts

@@ -0,0 +1,39 @@
+import net.ltgt.gradle.errorprone.CheckSeverity
+import net.ltgt.gradle.errorprone.errorprone
+import net.ltgt.gradle.nullaway.nullaway
+import java.util.Locale
+
+plugins {
+    id("net.ltgt.errorprone")
+    id("net.ltgt.nullaway")
+}
+
+dependencies {
+    errorprone("com.uber.nullaway:nullaway:0.9.9")
+    errorprone("com.google.errorprone:error_prone_core:2.15.0")
+    errorproneJavac("com.google.errorprone:javac:9+181-r4173-1")
+}
+
+nullaway {
+    annotatedPackages.add("io.opentelemetry.android")
+}
+
+tasks {
+    withType<JavaCompile>().configureEach {
+        options.errorprone {
+            if (name.lowercase(Locale.getDefault()).contains("test")) {
+                // just disable all error prone checks for test
+                isEnabled.set(false);
+            }
+
+            nullaway {
+                severity.set(CheckSeverity.ERROR)
+            }
+
+            // Builder 'return this;' pattern
+            disable("CanIgnoreReturnValueSuggester")
+            // Common to avoid an allocation
+            disable("MixedMutabilityReturnType")
+        }
+    }
+}

buildSrc/src/main/kotlin/otel.spotless-conventions.gradle.kts

@@ -0,0 +1,39 @@
+import com.diffplug.gradle.spotless.SpotlessExtension
+
+plugins {
+    id("com.diffplug.spotless")
+}
+
+extensions.configure<SpotlessExtension>("spotless") {
+    java {
+        googleJavaFormat().aosp()
+        licenseHeaderFile(rootProject.file("gradle/spotless.license.java"), "(package|import|public)")
+        target("src/**/*.java")
+    }
+    plugins.withId("org.jetbrains.kotlin.jvm") {
+        kotlin {
+            ktlint()
+            licenseHeaderFile(rootProject.file("gradle/spotless.license.java"), "(package|import|public)")
+        }
+    }
+    kotlinGradle {
+        ktlint()
+    }
+    format("misc") {
+        // not using "**/..." to help keep spotless fast
+        target(
+                ".gitignore",
+                ".gitattributes",
+                ".gitconfig",
+                ".editorconfig",
+                "*.md",
+                "src/**/*.md",
+                "docs/**/*.md",
+                "*.sh",
+                "src/**/*.properties"
+        )
+        indentWithSpaces()
+        trimTrailingWhitespace()
+        endWithNewline()
+    }
+}

gradle.properties

@@ -0,0 +1,23 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app"s APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=true
+
+# generate the BuildConfig class that contains the app version
+android.defaults.buildfeatures.buildconfig=true
+
+version=0.1.0
+group=io.opentelemetry.android

gradle/spotless.license.java

@@ -0,0 +1,5 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,6 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.1-bin.zip
+networkTimeout=10000
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists