@craft-native/android 0.0.436 → 0.0.443

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export type { AndroidMapProvider } from './native-map.js';
  * well as the one-file bundle, and the app runs each screen from its own
  * route's file. Stacks asks for route bundles only when this is true.
  */
+/** Build-time proof for Stacks capability mappings, including unreleased source builds. */
+export declare const nativeSensorCapabilities: readonly ['motionSensors', 'barometer', 'pedometer'];
 export declare const nativeRouteBundles = true;
 /**
  * The app evaluates stx's shared runtime (`__runtime.js`, stx's
@@ -65,6 +67,12 @@ export interface CraftAndroidConfig {
     enableSecureStorage?: boolean;
     enableGeolocation?: boolean;
     enableBackgroundLocation?: boolean;
+    /** Foreground raw Android sensors on native screens; separate from iOS fused motion. */
+    enableMotionSensors?: boolean;
+    /** Foreground pressure and session-relative altitude; does not enable background recording. */
+    enableBarometer?: boolean;
+    /** Foreground hardware step counters/detectors; requires activity recognition on Android 10+. */
+    enablePedometer?: boolean;
     enableBluetooth?: boolean;
     /**
      * A Bluetooth heart-rate strap, or a watch broadcasting its heart rate (the
@@ -114,6 +122,18 @@ export interface CraftAndroidConfig {
     }>;
     trustedOrigins?: string[];
     appIconPath?: string;
+    /**
+     * The launch splash: a directory laid out as Android resources, holding
+     * `drawable-<density>/splash_icon.png` (Android 12's splash icon, 288dp
+     * with its content inside the 192dp circle) and `splash_logo.png` (the
+     * logo the window background centres before Android 12), with Dark Mode
+     * ones in `drawable-night-<density>`. ts-images' `generateSplashScreens`
+     * writes exactly this (`android.resources`). Both sit on `backgroundColor`
+     * (`backgroundColorDark` at night), the colour the first frame continues.
+     * Without it, Android 12 shows the launcher icon and older versions the
+     * background colour.
+     */
+    splashResources?: string;
     /**
      * The small icon in the status bar and on every notification the app
      * shows, push or local: an Android vector drawable (`.xml`) or a `.png`,
@@ -260,6 +280,30 @@ export interface RunOptions {
     device?: string;
     output: string;
 }
+/** A splash file, by its place under `res/` (`drawable-night-xxhdpi/splash_icon.png`). */
+export interface AndroidSplashFile {
+    folder: string;
+    name: 'splash_icon.png' | 'splash_logo.png';
+    path: string;
+}
+/**
+ * The splash files in a resources directory: `splash_icon.png` and
+ * `splash_logo.png` in each `drawable[-night][-<density>]` folder. A directory
+ * with neither is a mistake, not an app without a splash.
+ */
+export declare function androidSplashFiles(resources: string): AndroidSplashFile[];
+/**
+ * The launch theme the activity starts in, and the theme it swaps to before
+ * its first frame. Android 12 and later draw their splash from
+ * `windowSplashScreen*`; earlier versions draw the window background, here
+ * the logo centred on the background colour. Either way the colour is the
+ * app's own `background`, so nothing flashes when the first frame replaces it.
+ */
+export declare function androidLaunchThemes(splash: Pick<AndroidSplashFile, 'name'>[]): {
+    base: string;
+    v31: string;
+    background?: string;
+};
 export declare function syncAndroidWebAssets(source: string, output: string): void;
 export declare function renderAndroidPermissions(config: CraftAndroidConfig): string;
 export declare function renderAndroidDeepLinks(config: CraftAndroidConfig): string;

package/dist/index.js

@@ -549,6 +549,7 @@ function compressNativeSources(target) {
   if (packed.length < bytes.length)
     writeFileSync(target, packed);
 }
+var nativeSensorCapabilities = ["motionSensors", "barometer", "pedometer"];
 var nativeRouteBundles = true;
 var nativeRouteRuntime = true;
 var nativeMessages = true;
@@ -715,6 +716,9 @@ var DEFAULT_CONFIG = {
   enableSecureStorage: false,
   enableGeolocation: false,
   enableBackgroundLocation: false,
+  enableMotionSensors: false,
+  enableBarometer: false,
+  enablePedometer: false,
   enableBluetooth: false,
   enableHeartRate: false,
   enableHealthConnect: false,
@@ -753,6 +757,49 @@ function requireRegularFile(path, label) {
   if (!statSync(path).isFile())
     throw new Error(`${label} must be a file: ${path}`);
 }
+function androidSplashFiles(resources) {
+  if (!existsSync(resources) || !statSync(resources).isDirectory())
+    throw new Error(`Splash resources must be a directory: ${resources}`);
+  const files = [];
+  for (const folder of readdirSync(resources).sort()) {
+    if (!/^drawable(?:-night)?(?:-(?:l|m|tv|h|xh|xxh|xxxh)dpi)?$/.test(folder))
+      continue;
+    for (const name of ["splash_icon.png", "splash_logo.png"]) {
+      const path = join3(resources, folder, name);
+      if (existsSync(path) && statSync(path).isFile())
+        files.push({ folder, name, path });
+    }
+  }
+  if (!files.length)
+    throw new Error(`Splash resources hold no drawable*/splash_icon.png or splash_logo.png: ${resources}`);
+  return files;
+}
+function androidLaunchThemes(splash) {
+  const icon = splash.some((file) => file.name === "splash_icon.png");
+  const logo = splash.some((file) => file.name === "splash_logo.png");
+  const base = logo ? `    <style name="Theme.CraftApp.Launch" parent="Theme.CraftApp">
+        <item name="android:windowBackground">@drawable/craft_launch_background</item>
+    </style>
+` : `    <style name="Theme.CraftApp.Launch" parent="Theme.CraftApp" />
+`;
+  const v31 = `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="Theme.CraftApp.Launch" parent="Theme.CraftApp">
+        <item name="android:windowSplashScreenBackground">@color/background</item>${icon ? `
+        <item name="android:windowSplashScreenAnimatedIcon">@drawable/splash_icon</item>` : ""}
+    </style>
+</resources>
+`;
+  const background = logo ? `<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android" android:opacity="opaque">
+    <item android:drawable="@color/background" />
+    <item>
+        <bitmap android:gravity="center" android:src="@drawable/splash_logo" />
+    </item>
+</layer-list>
+` : undefined;
+  return { base, v31, background };
+}
 function containsPath(parent, candidate) {
   const relativePath = relative(parent, candidate);
   return relativePath === "" || relativePath !== ".." && !relativePath.startsWith(`..${sep}`) && !isAbsolute2(relativePath);
@@ -960,6 +1007,7 @@ function writeAndroidConfig(output, config) {
   writeFileSync(join3(output, "craft.config.json"), JSON.stringify(config, null, 2));
   const runtimeConfig = { ...config };
   delete runtimeConfig.appIconPath;
+  delete runtimeConfig.splashResources;
   delete runtimeConfig.notificationIconPath;
   delete runtimeConfig.googleServicesFile;
   writeFileSync(join3(output, "app/src/main/assets/craft.config.json"), JSON.stringify(runtimeConfig, null, 2));
@@ -1013,10 +1061,14 @@ function renderAndroidPermissions(config) {
   }
   if (config.enablePushNotifications)
     permissions.add("android.permission.POST_NOTIFICATIONS");
-  if (config.enableKeepAwake)
+  if (config.enableKeepAwake || config.enableBarometer && config.enableBackgroundLocation)
     permissions.add("android.permission.WAKE_LOCK");
   if (config.enableHealthConnect)
     healthConnectPermissions(config).forEach((permission) => permissions.add(permission));
+  if (config.enablePedometer)
+    permissions.add("android.permission.ACTIVITY_RECOGNITION");
+  if (config.enablePedometer && config.enableHealthServices)
+    permissions.add("android.permission.RECEIVE_BOOT_COMPLETED");
   if (config.renderer === "native" && config.backgroundRefresh?.enabled)
     permissions.add("android.permission.RECEIVE_BOOT_COMPLETED");
   if (config.enableHeartRate) {
@@ -1056,13 +1108,16 @@ function writeNativeShellSources(output, packagePath, packageName, config) {
   write("CraftSnapshotFile.kt.template", "CraftSnapshotFile.kt");
   write("CraftNativeImageCache.kt.template", "CraftNativeImageCache.kt");
   write("CraftNativeHaptics.kt.template", "CraftNativeHaptics.kt");
+  write("CraftNativeMotion.kt.template", "CraftNativeMotion.kt");
   write("CraftNativeBackground.kt.template", "CraftNativeBackground.kt");
   write(config.enableHealthConnect ? "CraftNativeHealth.kt.template" : "CraftNativeHealthStub.kt.template", "CraftNativeHealth.kt");
   write(config.enableHealthServices ? "CraftHealthServices.kt.template" : "CraftHealthServicesStub.kt.template", "CraftHealthServices.kt");
   if (config.enableHealthServices) {
     write("CraftHealthServicesService.kt.template", "CraftHealthServicesService.kt");
+    write("CraftPassiveSteps.kt.template", "CraftPassiveSteps.kt");
   } else {
     rmSync2(join3(javaDir, "CraftHealthServicesService.kt"), { force: true });
+    rmSync2(join3(javaDir, "CraftPassiveSteps.kt"), { force: true });
   }
   write("CraftNativeServices.kt.template", "CraftNativeServices.kt", (source) => source.replace("{{NATIVE_PUSH_IMPORTS}}", config.enablePushNotifications ? "import com.google.firebase.messaging.FirebaseMessaging" : "").replace("{{NATIVE_WALLET_IMPORTS}}", config.enableWallet ? `import com.google.android.gms.pay.Pay
 import com.google.android.gms.pay.PayApiAvailabilityStatus
@@ -1255,6 +1310,7 @@ async function init(options) {
   if (config.appIconPath && ![".gif", ".jpg", ".png", ".webp"].includes(appIconExtension ?? "")) {
     throw new Error(`Unsupported Android app icon format: ${appIconExtension || "(none)"}`);
   }
+  const splash = config.splashResources ? androidSplashFiles(config.splashResources) : [];
   if (config.notificationIconPath)
     requireRegularFile(config.notificationIconPath, "Notification icon");
   const notificationIconExtension = config.notificationIconPath ? extname(config.notificationIconPath).toLowerCase() : undefined;
@@ -1348,6 +1404,7 @@ async function init(options) {
   const nativeDir = join3(output, "app/src/main/java/com/craft/runtime");
   mkdirSync2(nativeDir, { recursive: true });
   writeFileSync(join3(nativeDir, "CraftNative.kt"), craftNative);
+  writeFileSync(join3(nativeDir, "CraftRecordingPressure.kt"), readFileSync2(join3(TEMPLATES_DIR, "CraftRecordingPressure.kt.template"), "utf-8"));
   const serviceTemplate = readFileSync2(join3(TEMPLATES_DIR, "LocationRecordingService.kt.template"), "utf-8");
   writeFileSync(join3(nativeDir, "LocationRecordingService.kt"), serviceTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
   const healthTemplate = readFileSync2(join3(TEMPLATES_DIR, config.enableHealthConnect ? "CraftHealthConnect.kt.template" : "CraftHealthConnectStub.kt.template"), "utf-8");
@@ -1356,7 +1413,9 @@ async function init(options) {
     writeFileSync(join3(output, "app/src/main/java", packagePath, file), readFileSync2(join3(TEMPLATES_DIR, template), "utf8").replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
   }
   const manifestTemplate = readFileSync2(join3(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(/\{\{HEART_RATE_SERVICE\}\}/g, config.enableHeartRate ? '        <service android:name=".CraftHeartRateService" android:exported="false" android:foregroundServiceType="connectedDevice" />' : "").replace(/\{\{HEALTH_SERVICES_SERVICE\}\}/g, config.enableHealthServices ? '        <service android:name=".CraftHealthServicesService" android:exported="false" android:foregroundServiceType="health" android:stopWithTask="false" />' : "").replace(/\{\{NATIVE_NOTIFICATION_RECEIVER\}\}/g, config.renderer === "native" ? renderNativeShellManifest(config) : "").replace(/\{\{CRASH_REPORTER_PROVIDER\}\}/g, `        <provider android:name=".CraftCrashReporterInit" android:authorities="\${applicationId}.craft-crash" android:exported="false" android:initOrder="1000" />`).replace(/\{\{GOOGLE_MAPS_API_KEY\}\}/g, config.mapProvider !== "maplibre" && config.mapsApiKey ? `        <meta-data android:name="com.google.android.geo.API_KEY" android:value="${escapeXml(config.mapsApiKey)}" />` : "").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(/\{\{HEART_RATE_SERVICE\}\}/g, config.enableHeartRate ? '        <service android:name=".CraftHeartRateService" android:exported="false" android:foregroundServiceType="connectedDevice" />' : "").replace(/\{\{HEALTH_SERVICES_SERVICE\}\}/g, config.enableHealthServices ? '        <service android:name=".CraftHealthServicesService" android:exported="false" android:foregroundServiceType="health" android:stopWithTask="false" />' + (config.enablePedometer ? `
+        <service android:name=".CraftPassiveStepsService" android:exported="true" android:permission="com.google.android.wearable.healthservices.permission.PASSIVE_DATA_BINDING" />
+        <receiver android:name=".CraftPassiveStepsBootReceiver" android:exported="true"><intent-filter><action android:name="android.intent.action.BOOT_COMPLETED" /></intent-filter></receiver>` : "") : "").replace(/\{\{NATIVE_NOTIFICATION_RECEIVER\}\}/g, config.renderer === "native" ? renderNativeShellManifest(config) : "").replace(/\{\{CRASH_REPORTER_PROVIDER\}\}/g, `        <provider android:name=".CraftCrashReporterInit" android:authorities="\${applicationId}.craft-crash" android:exported="false" android:initOrder="1000" />`).replace(/\{\{GOOGLE_MAPS_API_KEY\}\}/g, config.mapProvider !== "maplibre" && config.mapsApiKey ? `        <meta-data android:name="com.google.android.geo.API_KEY" android:value="${escapeXml(config.mapsApiKey)}" />` : "").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" />
@@ -1461,6 +1520,17 @@ zipStorePath=wrapper/dists
 </vector>
 `);
   }
+  const resDir = join3(output, "app/src/main/res");
+  for (const folder of existsSync(resDir) ? readdirSync(resDir) : []) {
+    if (folder.startsWith("drawable"))
+      for (const name of ["splash_icon.png", "splash_logo.png"])
+        rmSync2(join3(resDir, folder, name), { force: true });
+  }
+  for (const file of splash) {
+    mkdirSync2(join3(resDir, file.folder), { recursive: true });
+    cpSync(file.path, join3(resDir, file.folder, file.name));
+  }
+  const launch = androidLaunchThemes(splash);
   const themesXml = `<?xml version="1.0" encoding="utf-8"?>
 <resources>
     <style name="Theme.CraftApp" parent="Theme.Material3.DayNight.NoActionBar">
@@ -1468,9 +1538,15 @@ zipStorePath=wrapper/dists
         <item name="android:navigationBarColor">@color/primary</item>
         <item name="android:windowBackground">@color/background</item>
     </style>
-</resources>
+${launch.base}</resources>
 `;
   writeFileSync(join3(output, "app/src/main/res/values/themes.xml"), themesXml);
+  mkdirSync2(join3(output, "app/src/main/res/values-v31"), { recursive: true });
+  writeFileSync(join3(output, "app/src/main/res/values-v31/themes.xml"), launch.v31);
+  if (launch.background)
+    writeFileSync(join3(output, "app/src/main/res/drawable/craft_launch_background.xml"), launch.background);
+  else
+    rmSync2(join3(output, "app/src/main/res/drawable/craft_launch_background.xml"), { force: true });
   const activityMainXml = config.renderer === "native" ? `<?xml version="1.0" encoding="utf-8"?>
 <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/native_root"
@@ -1694,6 +1770,8 @@ async function run(options) {
 export {
   ANDROID_MIN_SDK,
   HEALTH_CONNECT_PERMISSIONS,
+  androidLaunchThemes,
+  androidSplashFiles,
   build,
   compressNativeSources,
   createAndroidEmulator,
@@ -1704,6 +1782,7 @@ export {
   nativeMessages,
   nativeRouteBundles,
   nativeRouteRuntime,
+  nativeSensorCapabilities,
   open,
   renderAndroidDeepLinks,
   renderAndroidPermissions,
@@ -1715,4 +1794,4 @@ export {
   syncNativeFonts
 };
 
-//# debugId=6765F03CB34C0C1D64756E2164756E21
+//# debugId=607F99B9A5B4A43764756E2164756E21