@craft-native/android 0.0.167 → 0.0.169

package/README.md

@@ -204,6 +204,45 @@ Support depends on the installed WebView provider, so validate on each device
 class you plan to ship. The [Android JavaScriptEngine guide](https://developer.android.com/develop/ui/views/layout/webapps/jsengine)
 documents the sandbox and device-support check.
 
+### A whole app of native screens
+
+With `nativeScreens` (paths to the screens that draw them), `tabs` and
+`nativeApp` in craft.config.json, the same keys as the iOS builder, the
+native renderer is a whole app rather than one bundle route:
+
+- a tab bar and a navigation bar (`craft.navigation.setOptions`: title, large
+  title, right buttons with badges, `tabBarHidden`), a stack per tab, Android's
+  Back key popping it;
+- `craft.navigation.open(path)` matched in the iOS shell's order (fixed segments
+  before parameters), a tab's path selecting its tab, a path no screen draws
+  opening the site in a Custom Tab; deep links and tapped notifications route
+  the same way;
+- the app script (`nativeApp`) in its own isolate for the app's life, and in a
+  WorkManager job for `backgroundRefresh` and silent pushes
+  (`craftBackgroundRefresh`, `craftSilentPush`, answered with
+  `craft.background.complete`);
+- `craft.storage.getSync`, `craft.secureStorage.getSync` and `craft.snapshots`:
+  JavaScriptSandbox cannot call the host synchronously, so every isolate starts
+  with a copy of these stores and the host keeps each copy current. Timers and
+  `requestAnimationFrame` (vsync, for the screen on display) are the host's;
+  long messages on the console bridge travel in pieces;
+- the services the iOS host answers by the same module names: Dialog, Browser
+  (Custom Tabs, `mode: 'auth'` callbacks), Linking, Share, Push (FCM),
+  Location (with a foreground-service route recording), Media (videos kept
+  for offline, played in place of their address), KeepAwake, Brightness,
+  StatusBar, Speech and Health;
+- `iconsPath` (a `{ viewBox, strokeWidth, icons }` table of SVG bodies keyed by
+  icon name and SF Symbol) gives `<Icon>`, tabs and bar buttons the app's own
+  vectors in place of Android's glyphs.
+
+Health is Health Connect with the HealthKit contract (`getWorkouts`,
+`getDailyStatistics`, `getHeartRateSamples`, `getSleepIntervals`,
+`saveWorkout`, `saveMindfulSession`...), plus `availability`, `grantedTypes`
+and `openSettings` (`healthAvailability`). `healthConnect: { read, write,
+background, history }` lists the types the manifest declares; Play reviews
+each one. `bun scripts/test-native-health.ts` runs it against an Android 14+
+emulator's Health Connect.
+
 ### 3. Open in Android Studio
 
 ```bash
@@ -754,6 +793,12 @@ of bundled HTML.
 
 ## Publishing
 
+`build({ release: true, bundle: true })` runs `bundleRelease` and writes
+`app/build/outputs/bundle/release/app-release.aab`, signed with the upload key
+from `CRAFT_ANDROID_KEYSTORE` (the keystore's path), `CRAFT_ANDROID_KEYSTORE_PASSWORD`,
+`CRAFT_ANDROID_KEY_ALIAS` and `CRAFT_ANDROID_KEY_PASSWORD` (the keystore password
+when unset). Without them the release build is unsigned.
+
 Build release APK/AAB:
 
 ```bash

package/dist/index.d.ts

@@ -26,6 +26,24 @@ export interface CraftAndroidConfig {
     enableGeolocation?: boolean;
     enableBackgroundLocation?: boolean;
     enableHealthConnect?: boolean;
+    /**
+     * The Health Connect data the app reads and writes, by the shared type
+     * names (`steps`, `sleep`, `workouts`...). The manifest declares only
+     * these, as Play's health permissions review requires; without it, the
+     * original set (steps, heart rate, energy, distance, workouts).
+     */
+    healthConnect?: {
+        read?: HealthConnectType[];
+        write?: HealthConnectType[];
+        /** Read while the app is in the background (a WorkManager refresh): Android 15's READ_HEALTH_DATA_IN_BACKGROUND. */
+        background?: boolean;
+        /** Read further back than the 30 days before the first grant: READ_HEALTH_DATA_HISTORY. */
+        history?: boolean;
+    };
+    enableHealthConnectBackground?: boolean;
+    enableHealthConnectHistory?: boolean;
+    /** The app's privacy policy, which Health Connect links to from its permission screen. */
+    privacyPolicyURL?: string;
     enableKeepAwake?: boolean;
     enableDeepLinks?: boolean;
     /** Reach the person's own devices on the local network over plain HTTP (a Mac companion). */
@@ -40,7 +58,37 @@ export interface CraftAndroidConfig {
     minSdk?: number;
     compileSdk?: number;
     targetSdk?: number;
+    /**
+     * Native renderer: the app's paths and the screen drawing each
+     * (`/m/workout/:id` → `Workout`), its tabs, and the bundle route of the
+     * script that runs beside the screens. The same keys as the iOS builder.
+     */
+    nativeScreens?: Record<string, string>;
+    tabs?: Array<{
+        id: string;
+        title: string;
+        symbol?: string;
+    }>;
+    nativeApp?: string;
+    /** Wake the app script every so often (`craftBackgroundRefresh`), through WorkManager. */
+    backgroundRefresh?: {
+        enabled?: boolean;
+        minimumIntervalMinutes?: number;
+    };
 }
+/** The shared health data types (the iOS builder's HealthKit names). */
+export type HealthConnectType = 'steps' | 'heartRate' | 'activeEnergy' | 'distance' | 'workouts' | 'restingHeartRate' | 'heartRateVariability' | 'bodyMass' | 'sleep' | 'mindful' | 'dietaryEnergy' | 'dietaryProtein' | 'dietaryCarbohydrates' | 'dietaryFat';
+/**
+ * The Health Connect permissions behind each type, for reading and for
+ * writing. CraftNativeHealth.kt asks for the same ones; a permission the
+ * manifest does not declare is refused without a prompt.
+ */
+export declare const HEALTH_CONNECT_PERMISSIONS: Record<HealthConnectType, {
+    read: string[];
+    write: string[];
+}>;
+/** Every `android.permission.health.*` the app's Health Connect types need. */
+export declare function healthConnectPermissions(config: Pick<CraftAndroidConfig, 'healthConnect'>): string[];
 export interface InitOptions {
     name: string;
     packageName?: string;
@@ -58,9 +106,23 @@ export interface InitOptions {
 export interface BuildOptions {
     htmlPath?: string;
     nativeBundlePath?: string;
+    /**
+     * Native renderer: the app's icons as vectors (`{ viewBox, strokeWidth,
+     * icons: { name: svgBody } }`, keyed by Iconify name and SF Symbol), which
+     * `<Icon>`, the tab bar and the bar buttons draw. Without it they fall
+     * back to the glyphs Android's fonts have.
+     */
+    iconsPath?: string;
     devServer?: string;
     output: string;
     release?: boolean;
+    /**
+     * An Android App Bundle (`bundleRelease`, `.aab`), what Google Play takes,
+     * rather than an APK. Signed with CRAFT_ANDROID_KEYSTORE,
+     * CRAFT_ANDROID_KEYSTORE_PASSWORD, CRAFT_ANDROID_KEY_ALIAS and
+     * CRAFT_ANDROID_KEY_PASSWORD when they are set.
+     */
+    bundle?: boolean;
     compile?: boolean;
     /** Same meaning as `InitOptions.runtimeDir`; refreshes what init installed. */
     runtimeDir?: string | null;

package/dist/index.js

@@ -111,6 +111,48 @@ var KOTLIN_KEYWORDS = new Set([
   "while"
 ]);
 var ANDROID_MIN_SDK = 26;
+var HEALTH_CONNECT_PERMISSIONS = {
+  steps: { read: ["READ_STEPS"], write: [] },
+  heartRate: { read: ["READ_HEART_RATE"], write: [] },
+  activeEnergy: { read: ["READ_ACTIVE_CALORIES_BURNED"], write: ["WRITE_ACTIVE_CALORIES_BURNED"] },
+  distance: { read: ["READ_DISTANCE"], write: ["WRITE_DISTANCE"] },
+  workouts: {
+    read: ["READ_EXERCISE", "READ_HEART_RATE", "READ_ACTIVE_CALORIES_BURNED", "READ_DISTANCE"],
+    write: ["WRITE_EXERCISE", "WRITE_ACTIVE_CALORIES_BURNED", "WRITE_DISTANCE"]
+  },
+  restingHeartRate: { read: ["READ_RESTING_HEART_RATE"], write: [] },
+  heartRateVariability: { read: ["READ_HEART_RATE_VARIABILITY"], write: [] },
+  bodyMass: { read: ["READ_WEIGHT"], write: [] },
+  sleep: { read: ["READ_SLEEP"], write: [] },
+  mindful: { read: ["READ_MINDFULNESS"], write: ["WRITE_MINDFULNESS"] },
+  dietaryEnergy: { read: ["READ_NUTRITION"], write: ["WRITE_NUTRITION"] },
+  dietaryProtein: { read: ["READ_NUTRITION"], write: ["WRITE_NUTRITION"] },
+  dietaryCarbohydrates: { read: ["READ_NUTRITION"], write: ["WRITE_NUTRITION"] },
+  dietaryFat: { read: ["READ_NUTRITION"], write: ["WRITE_NUTRITION"] }
+};
+var DEFAULT_HEALTH_CONNECT = { read: ["steps", "heartRate", "activeEnergy", "distance", "workouts"], write: ["workouts"] };
+function healthConnectPermissions(config) {
+  const read = config.healthConnect?.read ?? DEFAULT_HEALTH_CONNECT.read;
+  const write = config.healthConnect?.write ?? (config.healthConnect ? [] : DEFAULT_HEALTH_CONNECT.write);
+  const permissions = new Set;
+  for (const type of read) {
+    const known = HEALTH_CONNECT_PERMISSIONS[type];
+    if (!known)
+      throw new Error(`Unknown Health Connect type: ${type}`);
+    known.read.forEach((permission) => permissions.add(`android.permission.health.${permission}`));
+  }
+  for (const type of write) {
+    const known = HEALTH_CONNECT_PERMISSIONS[type];
+    if (!known)
+      throw new Error(`Unknown Health Connect type: ${type}`);
+    known.write.forEach((permission) => permissions.add(`android.permission.health.${permission}`));
+  }
+  if (config.healthConnect?.background)
+    permissions.add("android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND");
+  if (config.healthConnect?.history)
+    permissions.add("android.permission.health.READ_HEALTH_DATA_HISTORY");
+  return [...permissions];
+}
 var DEFAULT_CONFIG = {
   renderer: "web",
   version: "1.0.0",
@@ -307,17 +349,77 @@ function renderAndroidPermissions(config) {
     permissions.add("android.permission.POST_NOTIFICATIONS");
   if (config.enableKeepAwake)
     permissions.add("android.permission.WAKE_LOCK");
+  if (config.enableHealthConnect)
+    healthConnectPermissions(config).forEach((permission) => permissions.add(permission));
+  if (config.renderer === "native" && config.backgroundRefresh?.enabled)
+    permissions.add("android.permission.RECEIVE_BOOT_COMPLETED");
+  return [...permissions].map((permission) => `    <uses-permission android:name="${permission}" />`).join(`
+`);
+}
+function writeNativeShellSources(output, packagePath, packageName, config) {
+  const javaDir = join(output, "app/src/main/java", packagePath);
+  const write = (template, file, replace = (source) => source) => {
+    const source = readFileSync(join(TEMPLATES_DIR, template), "utf-8").replace(/\{\{PACKAGE_NAME\}\}/g, packageName);
+    writeFileSync(join(javaDir, file), replace(source));
+  };
+  write("CraftNativeShell.kt.template", "CraftNativeShell.kt");
+  write("CraftNativeBackground.kt.template", "CraftNativeBackground.kt");
+  write(config.enableHealthConnect ? "CraftNativeHealth.kt.template" : "CraftNativeHealthStub.kt.template", "CraftNativeHealth.kt");
+  write("CraftNativeServices.kt.template", "CraftNativeServices.kt", (source) => source.replace("{{NATIVE_PUSH_IMPORTS}}", config.enablePushNotifications ? "import com.google.firebase.messaging.FirebaseMessaging" : "").replace("{{NATIVE_PUSH_REGISTER}}", config.enablePushNotifications ? `        try {
+            FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
+                val token = if (task.isSuccessful) task.result else null
+                if (token.isNullOrBlank()) done(failure("PUSH_UNAVAILABLE", task.exception?.message ?: "Firebase Cloud Messaging gave no token"))
+                else {
+                    context.getSharedPreferences("craft-native-push", Context.MODE_PRIVATE).edit().putString("token", token).apply()
+                    done(success(token))
+                }
+            }
+        } catch (error: Exception) {
+            done(failure("PUSH_UNAVAILABLE", error.message ?: "Firebase Cloud Messaging is not configured"))
+        }` : '        done(failure("CAPABILITY_DISABLED", "Push notifications are disabled"))'));
+  if (config.enablePushNotifications)
+    write("CraftNativeMessagingService.kt.template", "CraftNativeMessagingService.kt");
+  else
+    rmSync(join(javaDir, "CraftNativeMessagingService.kt"), { force: true });
+  mkdirSync(join(output, "app/src/main/res/xml"), { recursive: true });
+  writeFileSync(join(output, "app/src/main/res/xml/craft_file_paths.xml"), `<?xml version="1.0" encoding="utf-8"?>
+<paths>
+    <cache-path name="craft-files" path="craft-files/" />
+    <files-path name="craft-media" path="craft-media/" />
+</paths>
+`);
+}
+function renderNativeShellManifest(config) {
+  const parts = [
+    '        <receiver android:name=".CraftNativeNotificationReceiver" android:exported="false" />',
+    `        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${config.packageName}.craftfiles"
+            android:exported="false"
+            android:grantUriPermissions="true">
+            <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/craft_file_paths" />
+        </provider>`
+  ];
+  if (config.enablePushNotifications) {
+    parts.push(`        <service android:name=".CraftNativeMessagingService" android:exported="false">
+            <intent-filter>
+                <action android:name="com.google.firebase.MESSAGING_EVENT" />
+            </intent-filter>
+        </service>`);
+  }
   if (config.enableHealthConnect) {
-    permissions.add("android.permission.health.READ_STEPS");
-    permissions.add("android.permission.health.READ_HEART_RATE");
-    permissions.add("android.permission.health.READ_ACTIVE_CALORIES_BURNED");
-    permissions.add("android.permission.health.READ_DISTANCE");
-    permissions.add("android.permission.health.READ_EXERCISE");
-    permissions.add("android.permission.health.WRITE_EXERCISE");
-    permissions.add("android.permission.health.WRITE_ACTIVE_CALORIES_BURNED");
-    permissions.add("android.permission.health.WRITE_DISTANCE");
+    parts.push(`        <activity-alias
+            android:name="ViewPermissionUsageActivity"
+            android:exported="true"
+            android:targetActivity=".MainActivity"
+            android:permission="android.permission.START_VIEW_PERMISSION_USAGE">
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW_PERMISSION_USAGE" />
+                <category android:name="android.intent.category.HEALTH_PERMISSIONS" />
+            </intent-filter>
+        </activity-alias>`);
   }
-  return [...permissions].map((permission) => `    <uses-permission android:name="${permission}" />`).join(`
+  return parts.join(`
 `);
 }
 function renderAndroidDeepLinks(config) {
@@ -382,6 +484,9 @@ async function init(options) {
     config.enableGeolocation = true;
   if (config.enableHealthConnect) {
     config.compileSdk = Math.max(config.compileSdk ?? 36, 36);
+    config.enableHealthConnectBackground = Boolean(config.healthConnect?.background);
+    config.enableHealthConnectHistory = Boolean(config.healthConnect?.history);
+    healthConnectPermissions(config);
   }
   normalizeAndroidNetworkConfig(config);
   validateAndroidConfig(config);
@@ -433,6 +538,7 @@ async function init(options) {
     writeFileSync(join(output, "app/src/main/java", packagePath, "CraftNativeRefreshableFlatList.kt"), refreshableFlatListTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
     writeFileSync(join(output, "app/src/main/java", packagePath, "CraftNativeCapabilities.kt"), capabilityTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
     writeFileSync(join(output, "app/src/main/java", packagePath, "CraftNativeNotificationReceiver.kt"), notificationTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeNativeShellSources(output, packagePath, finalPackageName, config);
   }
   const craftBridgeTemplate = readFileSync(join(TEMPLATES_DIR, "CraftBridge.kt.template"), "utf-8");
   const craftBridge = craftBridgeTemplate.replace(/\{\{PROMISE_RUNTIME\}\}/g, () => renderAndroidPromiseRuntime("            ")).replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{ENABLE_SPEECH\}\}/g, String(Boolean(config.enableSpeechRecognition))).replace(/\{\{ENABLE_HAPTICS\}\}/g, String(Boolean(config.enableHaptics))).replace(/\{\{ENABLE_SHARE\}\}/g, String(Boolean(config.enableShare))).replace(/\{\{ENABLE_CAMERA\}\}/g, String(Boolean(config.enableCamera))).replace(/\{\{ENABLE_BIOMETRIC\}\}/g, String(Boolean(config.enableBiometric))).replace(/\{\{ENABLE_PUSH\}\}/g, String(Boolean(config.enablePushNotifications))).replace(/\{\{ENABLE_SECURE_STORAGE\}\}/g, String(Boolean(config.enableSecureStorage))).replace(/\{\{ENABLE_GEOLOCATION\}\}/g, String(Boolean(config.enableGeolocation))).replace(/\{\{ENABLE_BACKGROUND_LOCATION\}\}/g, String(Boolean(config.enableBackgroundLocation))).replace(/\{\{ENABLE_KEEP_AWAKE\}\}/g, String(Boolean(config.enableKeepAwake))).replace(/\{\{ENABLE_DEEP_LINKS\}\}/g, String(Boolean(config.enableDeepLinks))).replace(/\{\{ENABLE_HEALTH_CONNECT\}\}/g, String(Boolean(config.enableHealthConnect))).replace(/\{\{FIREBASE_IMPORT\}\}/g, config.enablePushNotifications ? "import com.google.firebase.messaging.FirebaseMessaging" : "").replace(/\{\{REGISTER_PUSH_IMPLEMENTATION\}\}/g, config.enablePushNotifications ? `activity.runOnUiThread {
@@ -464,21 +570,24 @@ async function init(options) {
   const healthTemplate = readFileSync(join(TEMPLATES_DIR, config.enableHealthConnect ? "CraftHealthConnect.kt.template" : "CraftHealthConnectStub.kt.template"), "utf-8");
   writeFileSync(join(output, "app/src/main/java", packagePath, "CraftHealthConnect.kt"), healthTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
   const manifestTemplate = readFileSync(join(TEMPLATES_DIR, "AndroidManifest.xml.template"), "utf-8");
-  const manifest = manifestTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{PERMISSIONS\}\}/g, renderAndroidPermissions(config)).replace(/\{\{USES_CLEARTEXT\}\}/g, config.devServerURL?.startsWith("http://") || config.enableLocalNetwork ? "true" : "false").replace(/\{\{DEEP_LINK_INTENT_FILTERS\}\}/g, renderAndroidDeepLinks(config)).replace(/\{\{BACKGROUND_SERVICE\}\}/g, config.enableBackgroundLocation ? '        <service android:name="com.craft.runtime.LocationRecordingService" android:exported="false" android:foregroundServiceType="location" android:stopWithTask="false" />' : "").replace(/\{\{NATIVE_NOTIFICATION_RECEIVER\}\}/g, config.renderer === "native" ? '        <receiver android:name=".CraftNativeNotificationReceiver" android:exported="false" />' : "").replace(/\{\{HEALTH_CONNECT_QUERIES\}\}/g, config.enableHealthConnect ? `    <queries>
+  const manifest = manifestTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{PERMISSIONS\}\}/g, renderAndroidPermissions(config)).replace(/\{\{USES_CLEARTEXT\}\}/g, config.devServerURL?.startsWith("http://") || config.enableLocalNetwork ? "true" : "false").replace(/\{\{DEEP_LINK_INTENT_FILTERS\}\}/g, renderAndroidDeepLinks(config)).replace(/\{\{BACKGROUND_SERVICE\}\}/g, config.enableBackgroundLocation ? '        <service android:name="com.craft.runtime.LocationRecordingService" android:exported="false" android:foregroundServiceType="location" android:stopWithTask="false" />' : "").replace(/\{\{NATIVE_NOTIFICATION_RECEIVER\}\}/g, config.renderer === "native" ? renderNativeShellManifest(config) : "").replace(/\{\{HEALTH_CONNECT_QUERIES\}\}/g, config.enableHealthConnect ? `    <queries>
         <package android:name="com.google.android.apps.healthdata" />
     </queries>` : "").replace(/\{\{HEALTH_CONNECT_RATIONALE\}\}/g, config.enableHealthConnect ? `            <intent-filter>
                 <action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE" />
-            </intent-filter>
+            </intent-filter>${config.renderer === "native" ? "" : `
             <intent-filter>
                 <action android:name="android.intent.action.VIEW_PERMISSION_USAGE" />
                 <category android:name="android.intent.category.HEALTH_PERMISSIONS" />
-            </intent-filter>` : "");
+            </intent-filter>`}` : "");
   writeFileSync(join(output, "app/src/main/AndroidManifest.xml"), manifest);
   const projectGradleTemplate = readFileSync(join(TEMPLATES_DIR, "build.gradle.kts.project.template"), "utf-8");
   writeFileSync(join(output, "build.gradle.kts"), projectGradleTemplate.replace(/\{\{GOOGLE_SERVICES_PLUGIN\}\}/g, hasGoogleServices ? '    id("com.google.gms.google-services") version "4.4.2" apply false' : ""));
   const appGradleTemplate = readFileSync(join(TEMPLATES_DIR, "build.gradle.kts.app.template"), "utf-8");
   const appGradle = appGradleTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{VERSION_NAME\}\}/g, escapeKotlinString(config.version || "1.0.0")).replace(/\{\{VERSION_CODE\}\}/g, String(config.versionCode || 1)).replace(/\{\{MIN_SDK\}\}/g, String(config.minSdk ?? ANDROID_MIN_SDK)).replace(/\{\{COMPILE_SDK\}\}/g, String(config.compileSdk || 36)).replace(/\{\{TARGET_SDK\}\}/g, String(config.targetSdk || 35)).replace(/\{\{GOOGLE_SERVICES_PLUGIN\}\}/g, hasGoogleServices ? '    id("com.google.gms.google-services")' : "").replace(/\{\{FIREBASE_MESSAGING_DEPENDENCY\}\}/g, config.enablePushNotifications ? '    implementation("com.google.firebase:firebase-messaging:24.1.0")' : "").replace(/\{\{REFRESH_LAYOUT_DEPENDENCY\}\}/g, config.renderer === "native" ? '    implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")' : "").replace(/\{\{HEALTH_CONNECT_DEPENDENCIES\}\}/g, config.enableHealthConnect ? `    implementation("androidx.health.connect:connect-client:1.1.0")
-    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1")` : "").replace(/\{\{JAVASCRIPT_ENGINE_DEPENDENCY\}\}/g, config.renderer === "native" ? '    implementation("androidx.javascriptengine:javascriptengine:1.1.0")' : "");
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1")` : "").replace(/\{\{JAVASCRIPT_ENGINE_DEPENDENCY\}\}/g, config.renderer === "native" ? `    implementation("androidx.javascriptengine:javascriptengine:1.1.0")
+    // The in-app browser (Custom Tabs) and background refresh (WorkManager).
+    implementation("androidx.browser:browser:1.8.0")
+    implementation("androidx.work:work-runtime-ktx:2.9.1")` : "");
   writeFileSync(join(output, "app/build.gradle.kts"), appGradle);
   const proguardTemplate = readFileSync(join(TEMPLATES_DIR, "proguard-rules.pro.template"), "utf-8");
   writeFileSync(join(output, "app/proguard-rules.pro"), proguardTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
@@ -630,7 +739,7 @@ zipStorePath=wrapper/dists
   console.log("");
 }
 async function build(options) {
-  const { htmlPath, nativeBundlePath, devServer, output, release, compile = true } = options;
+  const { htmlPath, nativeBundlePath, devServer, output, release, bundle, compile = true } = options;
   console.log(`
 \uD83D\uDCE6 Building Craft Android project...`);
   const configPath = join(output, "craft.config.json");
@@ -645,6 +754,12 @@ async function build(options) {
     const destination = join(output, "app/src/main/assets/native-screen.js");
     if (nativeBundlePath && resolve(nativeBundlePath) !== resolve(destination))
       cpSync(nativeBundlePath, destination);
+    const icons = join(output, "app/src/main/assets/craft-icons.json");
+    if (options.iconsPath) {
+      requireRegularFile(options.iconsPath, "Icon table");
+      if (resolve(options.iconsPath) !== resolve(icons))
+        cpSync(options.iconsPath, icons);
+    }
     if (!existsSync(destination)) {
       throw new Error("Native Android mode needs app/src/main/assets/native-screen.js. Compile a .stx screen with `stx native compile` first.");
     }
@@ -687,12 +802,15 @@ async function build(options) {
       throw new Error("Gradle is unavailable. Install Android Studio or Gradle before building Android.", { cause: error });
     }
   }
-  const buildType = release ? "assembleRelease" : "assembleDebug";
-  console.log(`   Building ${release ? "release" : "debug"} APK...`);
+  const variant = release ? "Release" : "Debug";
+  const buildType = `${bundle ? "bundle" : "assemble"}${variant}`;
+  console.log(`   Building ${release ? "release" : "debug"} ${bundle ? "app bundle" : "APK"}...`);
+  if (release && !process.env.CRAFT_ANDROID_KEYSTORE)
+    console.log("   CRAFT_ANDROID_KEYSTORE is not set: the release build is unsigned.");
   try {
     await $`cd ${output} && ./gradlew ${buildType}`;
-    const apkPath = release ? "app/build/outputs/apk/release/app-release.apk" : "app/build/outputs/apk/debug/app-debug.apk";
-    console.log(`\u2705 APK built: ${apkPath}`);
+    const artifact = bundle ? `app/build/outputs/bundle/${variant.toLowerCase()}/app-${variant.toLowerCase()}.aab` : release ? "app/build/outputs/apk/release/app-release.apk" : "app/build/outputs/apk/debug/app-debug.apk";
+    console.log(`\u2705 ${bundle ? "App bundle" : "APK"} built: ${artifact}`);
   } catch (error) {
     console.error("Build failed. Open in Android Studio for details.");
     throw error;
@@ -752,8 +870,10 @@ export {
   open,
   installRuntime,
   init,
+  healthConnectPermissions,
   build,
+  HEALTH_CONNECT_PERMISSIONS,
   ANDROID_MIN_SDK
 };
 
-//# debugId=37340FB9307E589364756E2164756E21
+//# debugId=695695A5D869A12C64756E2164756E21