Merge changes from topic "experimental_bubbles_client_control" into main (b9fbfa2c) · Commits · e / os / android_frameworks_base

core/java/android/window/IMultitaskingController.aidl

0 → 100644

+49 −0

Original line number	Diff line number	Diff line
		/**
		* Copyright (c) 2025 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 android.window;

		import android.os.Bundle;
		import android.os.IBinder;
		import android.content.Intent;
		import android.window.IMultitaskingDelegate;

		/**
		* System private API for interacting with the multi-tasking controller that allows applications to
		* request actions and configurations related to some multi-window features and modes implemented
		* in WM Shell through the client interface.
		* The client interface is not meant to serve as an implementation for public APIs. This is because
		* exposing information or functions related to specific windowing modes in the public SDK limits
		* the platform's ability to evolve the UX, and hurts app compatibility with existing or future
		* OEM system UX customizations.
		* Therefore, this interface is only meant to be used for experimental purposes.
		* The supported actions are functionally equivalent to SysUI interactions, so all delegate
		* methods require REQUEST_SYSTEM_MULTITASKING_CONTROLS permission.
		* @hide
		*/
		interface IMultitaskingController {
		/**
		* Method used by WMShell to register itself as a delegate that can respond to the app requests.
		*/
		@JavaPassthrough(annotation="@android.annotation.RequiresPermission(android.Manifest.permission.MANAGE_ACTIVITY_TASKS)")
		oneway void registerMultitaskingDelegate(in IMultitaskingDelegate delegate);

		/**
		* Returns an instance of an interface for use by applications to make requests to the system.
		*/
		@JavaPassthrough(annotation="@android.annotation.RequiresPermission(android.Manifest.permission.REQUEST_SYSTEM_MULTITASKING_CONTROLS)")
		@nullable IMultitaskingDelegate getClientInterface();
		}

core/java/android/window/IMultitaskingDelegate.aidl

0 → 100644

+39 −0

Original line number	Diff line number	Diff line
		/**
		* Copyright (c) 2025 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 android.window;

		import android.os.IBinder;
		import android.content.Intent;

		/**
		* System private API for requesting actions and configurations related to some multi-window
		* features and modes like Bubbles.
		* @hide
		*/
		interface IMultitaskingDelegate {
		@JavaPassthrough(annotation="@android.annotation.RequiresPermission(android.Manifest.permission.REQUEST_SYSTEM_MULTITASKING_CONTROLS)")
		oneway void createBubble(in IBinder token, in Intent intent, boolean collapsed);

		@JavaPassthrough(annotation="@android.annotation.RequiresPermission(android.Manifest.permission.REQUEST_SYSTEM_MULTITASKING_CONTROLS)")
		oneway void updateBubbleState(in IBinder token, boolean collapsed);

		@JavaPassthrough(annotation="@android.annotation.RequiresPermission(android.Manifest.permission.REQUEST_SYSTEM_MULTITASKING_CONTROLS)")
		oneway void updateBubbleMessage(in IBinder token, String message);

		@JavaPassthrough(annotation="@android.annotation.RequiresPermission(android.Manifest.permission.REQUEST_SYSTEM_MULTITASKING_CONTROLS)")
		oneway void removeBubble(in IBinder token);
		}

core/java/android/window/IWindowOrganizerController.aidl

+4 −0

Original line number	Diff line number	Diff line
		@@ -21,6 +21,7 @@ import android.view.SurfaceControl;
		import android.os.IBinder;
		import android.view.RemoteAnimationAdapter;
		import android.window.IDisplayAreaOrganizerController;
		import android.window.IMultitaskingController;
		import android.window.ITaskFragmentOrganizerController;
		import android.window.ITaskOrganizerController;
		import android.window.ITransitionMetricsReporter;
		@@ -81,6 +82,9 @@ interface IWindowOrganizerController {
		/** @return An interface enabling the management of task fragment organizers. */
		ITaskFragmentOrganizerController getTaskFragmentOrganizerController();

		/** @return An interface enabling the management of some multi-window features like Bubbles. */
		IMultitaskingController getMultitaskingController();

		/**
		* Registers a transition player with Core. There is only one of these active at a time so
		* calling this will replace the existing one (if set) until it is unregistered.

core/java/android/window/flags/windowing_sdk.aconfig

+7 −0

Original line number	Diff line number	Diff line
		@@ -203,3 +203,10 @@ flag {
		purpose: PURPOSE_BUGFIX
		}
		}

		flag {
		namespace: "windowing_sdk"
		name: "enable_experimental_bubbles_controller"
		description: "Experiment to allow apps to request Bubbles actions in WM Shell"
		bug: "407149510"
		}

core/res/AndroidManifest.xml

+7 −0

Original line number	Diff line number	Diff line
		@@ -4343,6 +4343,13 @@
		<permission android:name="android.permission.EMBED_ANY_APP_IN_UNTRUSTED_MODE"
		android:protectionLevel="internal\|role" />

		<!-- Allows an application to make requests to WM Shell for actions or
		configurations related to select multitasking features like Bubbles.
		@hide -->
		<permission android:name="android.permission.REQUEST_SYSTEM_MULTITASKING_CONTROLS"
		android:protectionLevel="signature\|privileged"
		android:featureFlag="com.android.window.flags.enable_experimental_bubbles_controller" />

		<!-- Allows an application to start any activity, regardless of permission
		protection or exported state.
		@hide -->