feat(android): utils for enableEdgeToEdge, setStatusBarColor, setNavigationBarColor, setDarkModeHandler

NathanWalker · NathanWalker · commit fcb8253b46f3 · 2025-11-05T09:43:36.000-08:00
docs here: https://github.com/NativeScript/docs/pull/185/files
diff --git a/apps/automated/src/ui/layouts/stack-layout-tests.ts b/apps/automated/src/ui/layouts/stack-layout-tests.ts
@@ -44,11 +44,16 @@ export class StackLayoutTest extends testModule.UITest<StackLayout> {
 
 		TKUnit.assertEqual(this.rootLayout.orientation, CoreTypes.Orientation.vertical, 'Default orientation should be Vertical.');
 
+		// Capture current counts to assert on deltas instead of absolute values.
+		// Some platforms may perform extra layout passes, so we only require at least one new pass.
+		const beforeMeasure = this.rootLayout.measureCount;
+		const beforeArrange = this.rootLayout.arrangeCount;
+
 		this.rootLayout.orientation = 'horizontal';
 		this.waitUntilTestElementLayoutIsValid();
 
-		TKUnit.assertEqual(this.rootLayout.measureCount, 2, 'Orientation change should invalidate measure.');
-		TKUnit.assertEqual(this.rootLayout.arrangeCount, 2, 'Orientation change should invalidate arrange.');
+		TKUnit.assert(this.rootLayout.measureCount > beforeMeasure, `Orientation change should trigger a new measure. Before: ${beforeMeasure}, After: ${this.rootLayout.measureCount}`);
+		TKUnit.assert(this.rootLayout.arrangeCount > beforeArrange, `Orientation change should trigger a new arrange. Before: ${beforeArrange}, After: ${this.rootLayout.arrangeCount}`);
 	}
 
 	public test_ShouldMeasureWith_AtMost_OnVertical() {
diff --git a/packages/core/utils/native-helper.android.ts b/packages/core/utils/native-helper.android.ts
@@ -1,7 +1,7 @@
 import { platformCheck } from './platform-check';
 
 // importing this helper as a separate file avoids "android" symbol clash with the global android object
-import { resources, collections, getWindow, getApplication, getCurrentActivity, getApplicationContext, getResources, getPackageName, getInputMethodManager, showSoftInput, dismissSoftInput } from './native-helper-for-android';
+import { resources, collections, getWindow, getApplication, getCurrentActivity, getApplicationContext, getResources, getPackageName, getInputMethodManager, showSoftInput, dismissSoftInput, enableEdgeToEdge, setDarkModeHandler, setNavigationBarColor, setStatusBarColor } from './native-helper-for-android';
 export { dataSerialize, dataDeserialize } from './native-helper-for-android';
 
 export { getWindow } from './native-helper-for-android';
@@ -18,6 +18,10 @@ export const android = {
 	getInputMethodManager,
 	showSoftInput,
 	dismissSoftInput,
+	enableEdgeToEdge,
+	setStatusBarColor,
+	setNavigationBarColor,
+	setDarkModeHandler,
 };
 
 /**
diff --git a/packages/core/utils/native-helper.d.ts b/packages/core/utils/native-helper.d.ts
@@ -107,6 +107,36 @@ export const android: {
 	 * Hides the soft input method, usually a soft keyboard.
 	 */
 	dismissSoftInput: (nativeView?: android.view.View) => void;
+	/**
+	 * Sets the dark mode handler for the application.
+	 * @param options Options to set dark mode handler.
+	 */
+	setDarkModeHandler(options?: { activity?: androidx.appcompat.app.AppCompatActivity; handler: (bar: 'status' | 'navigation', resources: android.content.res.Resources) => boolean }): void;
+	/**
+	 * Sets the navigation bar color for the application.
+	 * @param options Options to set navigation bar color.
+	 */
+	setNavigationBarColor(options?: { activity?: androidx.appcompat.app.AppCompatActivity; lightColor?: Color; darkColor?: Color }): void;
+	/**
+	 * Sets the status bar color for the application.
+	 * @param options Options to set status bar color.
+	 */
+	setStatusBarColor(options?: { activity?: androidx.appcompat.app.AppCompatActivity; lightColor?: Color; darkColor?: Color }): void;
+	/**
+	 * Enables edge-to-edge navigation for the provided activity.
+	 * @param activity The activity to enable edge-to-edge navigation for.
+	 * @param options Optional configuration for status and navigation bar colors.
+	 */
+	enableEdgeToEdge(
+		activity: androidx.appcompat.app.AppCompatActivity,
+		options?: {
+			statusBarLightColor?: Color;
+			statusBarDarkColor?: Color;
+			navigationBarLightColor?: Color;
+			navigationBarDarkColor?: Color;
+			handleDarkMode?: (bar: 'status' | 'navigation', resources: android.content.res.Resources) => boolean;
+		},
+	): void;
 };
 
 /**
