developer options api

app/build.gradle.kts

@@ -152,6 +152,8 @@ dependencies {
 
     // Access settings & model data
     implementation(project(":data:settings"))
+    implementation(project(":data:settings:api"))
+
     implementation(project(":core:model"))
 
     // Camera Preview

app/src/main/java/com/google/jetpackcamera/AppModule.kt

@@ -15,12 +15,16 @@
  */
 package com.google.jetpackcamera
 
+import com.google.jetpackcamera.core.common.DefaultAppConfig
 import com.google.jetpackcamera.core.common.DefaultCaptureModeOverride
 import com.google.jetpackcamera.core.common.DefaultFilePathGenerator
 import com.google.jetpackcamera.core.common.DefaultSaveMode
 import com.google.jetpackcamera.core.common.FilePathGenerator
 import com.google.jetpackcamera.model.CaptureMode
 import com.google.jetpackcamera.model.SaveMode
+import com.google.jetpackcamera.settings.api.DeveloperAppConfig
+import com.google.jetpackcamera.settings.api.OptionRestrictionConfig
+import com.google.jetpackcamera.settings.api.SettingConfig
 import dagger.Module
 import dagger.Provides
 import dagger.hilt.InstallIn
@@ -29,6 +33,17 @@ import dagger.hilt.components.SingletonComponent
 @Module
 @InstallIn(SingletonComponent::class)
 object AppModule {
+
+    @Provides
+    @DefaultAppConfig
+    fun providesDeveloperAppConfig(): DeveloperAppConfig = DeveloperAppConfig.LibraryDefaults.copy(
+        captureMode = SettingConfig(
+            CaptureMode.IMAGE_ONLY,
+            uiRestriction = OptionRestrictionConfig.FullyRestricted()
+        ),
+        hdrEnabled = SettingConfig(defaultValue = true)
+    )
+
     /**
      * provides the default [CaptureMode] to override by the app
      */

app/src/main/java/com/google/jetpackcamera/MainActivity.kt

@@ -145,6 +145,7 @@ class MainActivity : ComponentActivity() {
                             JcaApp(
                                 externalCaptureMode = externalCaptureMode,
                                 shouldReviewAfterCapture = shouldReviewAfterCapture,
+                                useDeveloperConfig = useDeveloperConfig,
                                 captureUris = captureUris,
                                 debugSettings = debugSettings,
                                 openAppSettings = ::openAppSettings,
@@ -211,6 +212,9 @@ class MainActivity : ComponentActivity() {
     private val shouldReviewAfterCapture: Boolean
         get() = intent?.shouldReviewAfterCapture == true
 
+    private val useDeveloperConfig: Boolean
+        get() = intent?.getBooleanExtra(KEY_USE_DEVELOPER_CONFIG, false) ?: false
+
     private val Intent.externalCaptureUri: Uri?
         get() = IntentCompat.getParcelableExtra(
             this,
@@ -310,6 +314,7 @@ class MainActivity : ComponentActivity() {
 
         private const val KEY_DEBUG_MODE = "KEY_DEBUG_MODE"
         const val KEY_DEBUG_SINGLE_LENS_MODE = "KEY_DEBUG_SINGLE_LENS_MODE"
+        const val KEY_USE_DEVELOPER_CONFIG = "KEY_USE_DEVELOPER_CONFIG"
     }
 }
 

app/src/main/java/com/google/jetpackcamera/ui/JcaApp.kt

@@ -51,6 +51,7 @@ import com.google.jetpackcamera.ui.Routes.SETTINGS_ROUTE
 fun JcaApp(
     externalCaptureMode: ExternalCaptureMode,
     shouldReviewAfterCapture: Boolean,
+    useDeveloperConfig: Boolean = false,
     captureUris: List<Uri>,
     debugSettings: DebugSettings,
     onRequestWindowColorMode: (Int) -> Unit,
@@ -63,6 +64,7 @@ fun JcaApp(
         modifier = modifier,
         externalCaptureMode = externalCaptureMode,
         shouldReviewAfterCapture = shouldReviewAfterCapture,
+        useDeveloperConfig = useDeveloperConfig,
         captureUris = captureUris,
         debugSettings = debugSettings,
         onOpenAppSettings = openAppSettings,
@@ -78,6 +80,7 @@ private fun JetpackCameraNavHost(
     modifier: Modifier = Modifier,
     externalCaptureMode: ExternalCaptureMode,
     shouldReviewAfterCapture: Boolean,
+    useDeveloperConfig: Boolean = false,
     captureUris: List<Uri>,
     debugSettings: DebugSettings,
     onOpenAppSettings: () -> Unit,
@@ -113,6 +116,7 @@ private fun JetpackCameraNavHost(
         previewScreen(
             externalCaptureMode = externalCaptureMode,
             shouldCacheReview = shouldReviewAfterCapture,
+            useDeveloperConfig = useDeveloperConfig,
             captureUris = captureUris,
             debugSettings = debugSettings,
             onRequestWindowColorMode = onRequestWindowColorMode,

core/common/src/main/java/com/google/jetpackcamera/core/common/CommonModule.kt

@@ -74,3 +74,7 @@ annotation class IODispatcher
 @Qualifier
 @Retention(AnnotationRetention.BINARY)
 annotation class DefaultCoroutineScope
+
+@Qualifier
+@Retention(AnnotationRetention.BINARY)
+annotation class DefaultAppConfig

data/settings/api/.gitignore

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

data/settings/api/build.gradle.kts

@@ -0,0 +1,64 @@
+/*
+ * Copyright (C) 2026 The Android Open Source 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
+ *
+ *      http://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.
+ */
+plugins {
+    alias(libs.plugins.android.library)
+    alias(libs.plugins.kotlin.android)
+}
+
+android {
+    namespace = "com.google.jetpackcamera.settings.api"
+    compileSdk = 35
+
+    defaultConfig {
+        minSdk = 23
+        targetSdk = 35
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles("consumer-rules.pro")
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_11
+        targetCompatibility = JavaVersion.VERSION_11
+    }
+    kotlinOptions {
+        jvmTarget = "11"
+    }
+}
+
+dependencies {
+    implementation(libs.androidx.core.ktx)
+    implementation(libs.androidx.appcompat)
+    implementation(libs.material)
+    testImplementation(libs.junit)
+    androidTestImplementation(libs.androidx.junit)
+    androidTestImplementation(libs.androidx.espresso.core)
+
+    // Access Model data
+    implementation(project(":core:model"))
+    implementation(project(":core:common"))
+    implementation(project(":data:settings"))
+
+}

data/settings/api/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

data/settings/api/src/main/AndroidManifest.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2026 The Android Open Source 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
+  ~
+  ~      http://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.
+  -->
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+</manifest>

data/settings/api/src/main/java/com/google/jetpackcamera/settings/api/RestrictionConfig.kt

@@ -0,0 +1,136 @@
+/*
+ * Copyright (C) 2026 The Android Open Source 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
+ *
+ *      http://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.google.jetpackcamera.settings.api
+
+import com.google.jetpackcamera.model.AspectRatio
+import com.google.jetpackcamera.model.CaptureMode
+import com.google.jetpackcamera.model.DynamicRange
+import com.google.jetpackcamera.model.FlashMode
+import com.google.jetpackcamera.model.ImageOutputFormat
+import com.google.jetpackcamera.settings.model.CameraAppSettings
+import com.google.jetpackcamera.settings.model.DEFAULT_CAMERA_APP_SETTINGS
+
+/**
+ * Defines a configuration for the Jetpack Camera App that can be used by developers
+ * to override the default app settings.
+ */
+data class DeveloperAppConfig(
+    val captureMode: SettingConfig<CaptureMode>,
+    val aspectRatio: SettingConfig<AspectRatio>,
+    val flashMode: SettingConfig<FlashMode>,
+    val audio: SettingConfig<Boolean>,
+    val hdrEnabled: SettingConfig<Boolean>
+) {
+    // Ensures that all individual setting configurations are valid.
+    init {
+        fun <T : Any> SettingConfig<T>.containsIfOptionsEnabled(options: Set<T>): Boolean {
+            return when (val restriction = this.uiRestriction) {
+                is OptionRestrictionConfig.OptionsEnabled -> {
+                    restriction.enabledOptions.containsAll(options)
+                }
+
+                else -> true
+            }
+        }
+
+        require(flashMode.containsIfOptionsEnabled(setOf(FlashMode.OFF)))
+    }
+
+    companion object {
+        // Provides a foundation based on JCA's DEFAULT_CAMERA_APP_SETTINGS
+        val LibraryDefaults: DeveloperAppConfig = DeveloperAppConfig(
+            aspectRatio = SettingConfig(DEFAULT_CAMERA_APP_SETTINGS.aspectRatio),
+            flashMode = SettingConfig(DEFAULT_CAMERA_APP_SETTINGS.flashMode),
+            captureMode = SettingConfig(DEFAULT_CAMERA_APP_SETTINGS.captureMode),
+            audio = SettingConfig(DEFAULT_CAMERA_APP_SETTINGS.audioEnabled),
+            hdrEnabled = SettingConfig(
+                DEFAULT_CAMERA_APP_SETTINGS.dynamicRange != DynamicRange.SDR
+            )
+        )
+    }
+
+    /**
+     * Converts this [DeveloperAppConfig] into a [CameraAppSettings] object.
+     *
+     * This function maps the developer-defined settings to the internal camera app settings model.
+     */
+    fun toCameraAppSettings(
+        defaultSettings: CameraAppSettings = DEFAULT_CAMERA_APP_SETTINGS
+    ): CameraAppSettings {
+        val imageOutputFormat = if (this.hdrEnabled.defaultValue) {
+            ImageOutputFormat.JPEG_ULTRA_HDR
+        } else {
+            ImageOutputFormat.JPEG
+        }
+
+        val dynamicRange =
+            if (this.hdrEnabled.defaultValue) DynamicRange.HLG10 else DynamicRange.SDR
+
+        return defaultSettings.copy(
+            aspectRatio = this.aspectRatio.defaultValue,
+            flashMode = this.flashMode.defaultValue,
+            captureMode = this.captureMode.defaultValue,
+            audioEnabled = this.audio.defaultValue,
+            imageFormat = imageOutputFormat,
+            dynamicRange = dynamicRange
+        )
+    }
+}
+
+/**
+ * Represents a single configurable setting in the application, including its
+ * default value and any UI restrictions that apply to it.
+ *
+ * @param defaultValue The initial value for this setting.
+ * @param uiRestriction The restrictions applied to this setting in the UI.
+ */
+data class SettingConfig<T>(
+    val defaultValue: T,
+    val uiRestriction: OptionRestrictionConfig<T> = OptionRestrictionConfig.NotRestricted()
+) {
+    init {
+        // Validate that if options are enabled for this setting, the default value
+        // is always included in the set of enabled options.
+        (uiRestriction as? OptionRestrictionConfig.OptionsEnabled)?.let {
+            require(
+                uiRestriction.enabledOptions.size >= 2 &&
+                    uiRestriction.enabledOptions.contains(
+                        defaultValue
+                    )
+            ) {
+                "OptionsRestrictionConfig.OptionsEnabled#enabledOptions must also contain the defaultValue"
+            }
+        }
+    }
+}
+
+sealed interface OptionRestrictionConfig<T> {
+    /** All device-supported options are available. */
+    class NotRestricted<T> : OptionRestrictionConfig<T>
+
+    /** The entire setting is unavailable and hidden from the UI. */
+    class FullyRestricted<T> : OptionRestrictionConfig<T>
+
+    /** ONLY the options in this set are allowed, if supported by the device. */
+    data class OptionsEnabled<T>(val enabledOptions: Set<T>) : OptionRestrictionConfig<T> {
+        init {
+            require(enabledOptions.isNotEmpty()) {
+                "enabledOptions must not be empty. " +
+                    "Use FullyRestricted to disable the feature."
+            }
+        }
+    }
+}

feature/preview/build.gradle.kts

@@ -140,6 +140,7 @@ dependencies {
     implementation(project(":core:common"))
     implementation(project(":data:media"))
     implementation(project(":data:settings"))
+    implementation(project(":data:settings:api"))
     implementation(project(":core:model"))
     testImplementation(project(":core:common"))
     implementation(project(":ui:components:capture"))