feat(android-distribution): Add module foundation with compilation stubs

This PR establishes the foundational structure for the sentry-android-distribution module with compilation stubs that enable parallel development of individual components.

### Changes
- Android module configuration with necessary dependencies
- AndroidManifest.xml with ContentProvider for auto-initialization
- Distribution object with init(), isEnabled(), checkForUpdate() methods
- DistributionOptions data class for configuration
- UpdateStatus sealed class for result types
- UpdateInfo data class for update details
- Internal stub implementations that compile successfully

### Implementation Strategy
- All methods return placeholder errors ("Implementation coming in future PR")
- Follows zero-dependency design (only depends on sentry module)
- Enables parallel development of binary identifier, HTTP client, API models, and core logic

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: runningcode

sentry-android-distribution/api/sentry-android-distribution.api

@@ -1,4 +1,89 @@
 public final class io/sentry/android/distribution/Distribution {
+	public static final field INSTANCE Lio/sentry/android/distribution/Distribution;
+	public final fun checkForUpdate (Landroid/content/Context;)Lio/sentry/android/distribution/UpdateStatus;
+	public final fun checkForUpdateCompletableFuture (Landroid/content/Context;)Ljava/util/concurrent/CompletableFuture;
+	public final fun downloadUpdate (Landroid/content/Context;Lio/sentry/android/distribution/UpdateInfo;)V
+	public final fun init (Landroid/content/Context;Lio/sentry/android/distribution/DistributionOptions;)V
+	public final fun isEnabled ()Z
+}
+
+public final class io/sentry/android/distribution/DistributionContentProvider : android/content/ContentProvider {
 	public fun <init> ()V
+	public fun delete (Landroid/net/Uri;Ljava/lang/String;[Ljava/lang/String;)I
+	public fun getType (Landroid/net/Uri;)Ljava/lang/String;
+	public fun insert (Landroid/net/Uri;Landroid/content/ContentValues;)Landroid/net/Uri;
+	public fun onCreate ()Z
+	public fun query (Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;
+	public fun update (Landroid/net/Uri;Landroid/content/ContentValues;Ljava/lang/String;[Ljava/lang/String;)I
+}
+
+public final class io/sentry/android/distribution/DistributionOptions {
+	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V
+	public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public final fun component1 ()Ljava/lang/String;
+	public final fun component2 ()Ljava/lang/String;
+	public final fun component3 ()Ljava/lang/String;
+	public final fun component4 ()Ljava/lang/String;
+	public final fun component5 ()Ljava/lang/String;
+	public final fun copy (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)Lio/sentry/android/distribution/DistributionOptions;
+	public static synthetic fun copy$default (Lio/sentry/android/distribution/DistributionOptions;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;ILjava/lang/Object;)Lio/sentry/android/distribution/DistributionOptions;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getBuildConfiguration ()Ljava/lang/String;
+	public final fun getOrgAuthToken ()Ljava/lang/String;
+	public final fun getOrganizationSlug ()Ljava/lang/String;
+	public final fun getProjectSlug ()Ljava/lang/String;
+	public final fun getSentryBaseUrl ()Ljava/lang/String;
+	public fun hashCode ()I
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class io/sentry/android/distribution/UpdateInfo {
+	public fun <init> (Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;Ljava/lang/String;Ljava/lang/String;)V
+	public final fun component1 ()Ljava/lang/String;
+	public final fun component2 ()Ljava/lang/String;
+	public final fun component3 ()I
+	public final fun component4 ()Ljava/lang/String;
+	public final fun component5 ()Ljava/lang/String;
+	public final fun component6 ()Ljava/lang/String;
+	public final fun copy (Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;Ljava/lang/String;Ljava/lang/String;)Lio/sentry/android/distribution/UpdateInfo;
+	public static synthetic fun copy$default (Lio/sentry/android/distribution/UpdateInfo;Ljava/lang/String;Ljava/lang/String;ILjava/lang/String;Ljava/lang/String;Ljava/lang/String;ILjava/lang/Object;)Lio/sentry/android/distribution/UpdateInfo;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getAppName ()Ljava/lang/String;
+	public final fun getBuildNumber ()I
+	public final fun getBuildVersion ()Ljava/lang/String;
+	public final fun getCreatedDate ()Ljava/lang/String;
+	public final fun getDownloadUrl ()Ljava/lang/String;
+	public final fun getId ()Ljava/lang/String;
+	public fun hashCode ()I
+	public fun toString ()Ljava/lang/String;
+}
+
+public abstract class io/sentry/android/distribution/UpdateStatus {
+}
+
+public final class io/sentry/android/distribution/UpdateStatus$Error : io/sentry/android/distribution/UpdateStatus {
+	public fun <init> (Ljava/lang/String;)V
+	public final fun component1 ()Ljava/lang/String;
+	public final fun copy (Ljava/lang/String;)Lio/sentry/android/distribution/UpdateStatus$Error;
+	public static synthetic fun copy$default (Lio/sentry/android/distribution/UpdateStatus$Error;Ljava/lang/String;ILjava/lang/Object;)Lio/sentry/android/distribution/UpdateStatus$Error;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getMessage ()Ljava/lang/String;
+	public fun hashCode ()I
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class io/sentry/android/distribution/UpdateStatus$NewRelease : io/sentry/android/distribution/UpdateStatus {
+	public fun <init> (Lio/sentry/android/distribution/UpdateInfo;)V
+	public final fun component1 ()Lio/sentry/android/distribution/UpdateInfo;
+	public final fun copy (Lio/sentry/android/distribution/UpdateInfo;)Lio/sentry/android/distribution/UpdateStatus$NewRelease;
+	public static synthetic fun copy$default (Lio/sentry/android/distribution/UpdateStatus$NewRelease;Lio/sentry/android/distribution/UpdateInfo;ILjava/lang/Object;)Lio/sentry/android/distribution/UpdateStatus$NewRelease;
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getInfo ()Lio/sentry/android/distribution/UpdateInfo;
+	public fun hashCode ()I
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class io/sentry/android/distribution/UpdateStatus$UpToDate : io/sentry/android/distribution/UpdateStatus {
+	public static final field INSTANCE Lio/sentry/android/distribution/UpdateStatus$UpToDate;
 }
 

sentry-android-distribution/src/main/AndroidManifest.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <uses-permission android:name="android.permission.INTERNET" />
+
+  <application>
+    <provider
+      android:name="io.sentry.android.distribution.DistributionContentProvider"
+      android:authorities="${applicationId}.sentry-distribution-provider"
+      android:exported="false"
+      android:initOrder="100" />
+  </application>
+</manifest>

sentry-android-distribution/src/main/java/io/sentry/android/distribution/Distribution.kt

@@ -1,3 +1,70 @@
 package io.sentry.android.distribution
 
-public class Distribution {}
+import android.content.Context
+import android.content.Intent
+import android.net.Uri
+import io.sentry.android.distribution.internal.DistributionInternal
+import java.util.concurrent.CompletableFuture
+
+/**
+ * The public Android SDK for Sentry Build Distribution.
+ *
+ * Provides functionality to check for app updates and download new versions from Sentry's preprod
+ * artifacts system.
+ */
+public object Distribution {
+  /**
+   * Initialize build distribution with the provided options. This should be called once per
+   * process, typically in Application.onCreate().
+   *
+   * @param context Android context
+   * @param options Configuration options for build distribution
+   */
+  public fun init(context: Context, options: DistributionOptions) {
+    DistributionInternal.init(context, options)
+  }
+
+  /**
+   * Check if build distribution is enabled and properly configured.
+   *
+   * @return true if build distribution is enabled
+   */
+  public fun isEnabled(): Boolean {
+    return DistributionInternal.isEnabled()
+  }
+
+  /**
+   * Check for available updates synchronously (blocking call). This method will block the calling
+   * thread while making the network request. Consider using checkForUpdateCompletableFuture for
+   * non-blocking behavior.
+   *
+   * @param context Android context
+   * @return UpdateStatus indicating if an update is available, up to date, or error
+   */
+  public fun checkForUpdate(context: Context): UpdateStatus {
+    return DistributionInternal.checkForUpdate(context)
+  }
+
+  /**
+   * Check for available updates using CompletableFuture for Java compatibility.
+   *
+   * @param context Android context
+   * @return CompletableFuture with UpdateStatus result
+   */
+  public fun checkForUpdateCompletableFuture(context: Context): CompletableFuture<UpdateStatus> {
+    return DistributionInternal.checkForUpdateCompletableFuture(context)
+  }
+
+  /**
+   * Download and install the provided update by opening the download URL in the default browser or
+   * appropriate application.
+   *
+   * @param context Android context
+   * @param info Information about the update to download
+   */
+  public fun downloadUpdate(context: Context, info: UpdateInfo) {
+    val browserIntent = Intent(Intent.ACTION_VIEW, Uri.parse(info.downloadUrl))
+    browserIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+    context.startActivity(browserIntent)
+  }
+}

sentry-android-distribution/src/main/java/io/sentry/android/distribution/DistributionContentProvider.kt

@@ -0,0 +1,42 @@
+package io.sentry.android.distribution
+
+import android.content.ContentProvider
+import android.content.ContentValues
+import android.database.Cursor
+import android.net.Uri
+
+/**
+ * ContentProvider that automatically initializes the Sentry Distribution SDK.
+ *
+ * This provider is automatically instantiated by the Android system when the app starts, ensuring
+ * the Distribution SDK is available without requiring manual initialization in
+ * Application.onCreate().
+ */
+public class DistributionContentProvider : ContentProvider() {
+  override fun onCreate(): Boolean {
+    // TODO: Automatic initialization will be implemented in future PR
+    return true
+  }
+
+  // Required ContentProvider methods (not used for initialization)
+  override fun query(
+    uri: Uri,
+    projection: Array<String>?,
+    selection: String?,
+    selectionArgs: Array<String>?,
+    sortOrder: String?,
+  ): Cursor? = null
+
+  override fun getType(uri: Uri): String? = null
+
+  override fun insert(uri: Uri, values: ContentValues?): Uri? = null
+
+  override fun delete(uri: Uri, selection: String?, selectionArgs: Array<String>?): Int = 0
+
+  override fun update(
+    uri: Uri,
+    values: ContentValues?,
+    selection: String?,
+    selectionArgs: Array<String>?,
+  ): Int = 0
+}

sentry-android-distribution/src/main/java/io/sentry/android/distribution/DistributionOptions.kt

@@ -0,0 +1,18 @@
+package io.sentry.android.distribution
+
+/**
+ * Configuration options for Sentry Build Distribution.
+ *
+ * @param orgAuthToken Organization authentication token for API access
+ * @param organizationSlug Sentry organization slug
+ * @param projectSlug Sentry project slug
+ * @param sentryBaseUrl Base URL for Sentry API (defaults to https://sentry.io)
+ * @param buildConfiguration Optional build configuration name for filtering
+ */
+public data class DistributionOptions(
+  val orgAuthToken: String,
+  val organizationSlug: String,
+  val projectSlug: String,
+  val sentryBaseUrl: String = "https://sentry.io",
+  val buildConfiguration: String? = null,
+)

sentry-android-distribution/src/main/java/io/sentry/android/distribution/UpdateInfo.kt

@@ -0,0 +1,20 @@
+package io.sentry.android.distribution
+
+/**
+ * Information about an available app update.
+ *
+ * @param id Unique identifier for this build artifact
+ * @param buildVersion Version string (e.g., "1.2.0")
+ * @param buildNumber Build number for this version
+ * @param downloadUrl URL where the update can be downloaded
+ * @param appName Application name
+ * @param createdDate ISO timestamp when this build was created
+ */
+public data class UpdateInfo(
+  val id: String,
+  val buildVersion: String,
+  val buildNumber: Int,
+  val downloadUrl: String,
+  val appName: String,
+  val createdDate: String,
+)

sentry-android-distribution/src/main/java/io/sentry/android/distribution/UpdateStatus.kt

@@ -0,0 +1,13 @@
+package io.sentry.android.distribution
+
+/** Represents the result of checking for app updates. */
+public sealed class UpdateStatus {
+  /** Current app version is up to date, no update available. */
+  public object UpToDate : UpdateStatus()
+
+  /** A new release is available for download. */
+  public data class NewRelease(val info: UpdateInfo) : UpdateStatus()
+
+  /** An error occurred during the update check. */
+  public data class Error(val message: String) : UpdateStatus()
+}

sentry-android-distribution/src/main/java/io/sentry/android/distribution/internal/DistributionInternal.kt

@@ -0,0 +1,31 @@
+package io.sentry.android.distribution.internal
+
+import android.content.Context
+import io.sentry.android.distribution.DistributionOptions
+import io.sentry.android.distribution.UpdateStatus
+import java.util.concurrent.CompletableFuture
+
+/** Internal implementation for build distribution functionality. */
+internal object DistributionInternal {
+  private var isInitialized = false
+
+  @Synchronized
+  fun init(context: Context, distributionOptions: DistributionOptions) {
+    // TODO: Implementation will be added in future PR
+    isInitialized = true
+  }
+
+  fun isEnabled(): Boolean {
+    return isInitialized
+  }
+
+  fun checkForUpdate(context: Context): UpdateStatus {
+    return UpdateStatus.Error("Implementation coming in future PR")
+  }
+
+  fun checkForUpdateCompletableFuture(context: Context): CompletableFuture<UpdateStatus> {
+    val future = CompletableFuture<UpdateStatus>()
+    future.complete(UpdateStatus.Error("Implementation coming in future PR"))
+    return future
+  }
+}