android-34/com/android/server/wm/ActivityOptionsWrapper.java

/*
 * Copyright (C) 2022 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.android.server.wm;

import android.annotation.RequiresApi;
import android.annotation.SystemApi;
import android.app.ActivityOptions;
import android.car.builtin.annotation.PlatformVersion;
import android.os.Build;
import android.os.IBinder;
import android.window.WindowContainerToken;

import com.android.annotation.AddedIn;

/**
 * Wrapper of {@link ActivityOptions}.
 * @hide
 */
@SystemApi(client = SystemApi.Client.MODULE_LIBRARIES)
public final class ActivityOptionsWrapper {
    private final ActivityOptions mOptions;

    /** See {@link android.app.WindowConfiguration#WINDOWING_MODE_UNDEFINED}. */
    @RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
    @AddedIn(PlatformVersion.UPSIDE_DOWN_CAKE_0)
    public static final int WINDOWING_MODE_UNDEFINED = 0;

    private ActivityOptionsWrapper(ActivityOptions options) {
        mOptions = options;
    }

    /**
     * Creates a new instance of {@link ActivityOptionsWrapper}.
     */
    @AddedIn(PlatformVersion.TIRAMISU_0)
    public static ActivityOptionsWrapper create(ActivityOptions options) {
        if (options == null) return null;
        return new ActivityOptionsWrapper(options);
    }

    /**
     * Gets the underlying {@link ActivityOptions} that is wrapped by this instance.
     */
    // Exposed the original object in order to allow to use the public accessors.
    @AddedIn(PlatformVersion.TIRAMISU_0)
    public ActivityOptions getOptions() {
        return mOptions;
    }

    /**
     * Gets the windowing mode to launch the Activity into
     */
    @RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
    @AddedIn(PlatformVersion.UPSIDE_DOWN_CAKE_0)
    public int getLaunchWindowingMode() {
        return mOptions.getLaunchWindowingMode();
    }

    /**
     * Gets {@link TaskDisplayAreaWrapper} to launch the Activity into
     */
    @AddedIn(PlatformVersion.TIRAMISU_0)
    public TaskDisplayAreaWrapper getLaunchTaskDisplayArea() {
        WindowContainerToken daToken = mOptions.getLaunchTaskDisplayArea();
        if (daToken == null) return null;
        TaskDisplayArea tda = (TaskDisplayArea) WindowContainer.fromBinder(daToken.asBinder());
        return TaskDisplayAreaWrapper.create(tda);
    }

    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder(mOptions.toString());
        sb.append(" ,mLaunchDisplayId=");
        sb.append(mOptions.getLaunchDisplayId());
        return sb.toString();
    }

    /**
     * Sets the given {@code windowContainerToken} as the launch root task. See
     * {@link ActivityOptions#setLaunchRootTask(WindowContainerToken)} for more info.
     */
    @RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
    @AddedIn(PlatformVersion.UPSIDE_DOWN_CAKE_0)
    public void setLaunchRootTask(IBinder windowContainerToken) {
        WindowContainerToken launchRootTaskToken = WindowContainer.fromBinder(windowContainerToken)
                        .mRemoteToken.toWindowContainerToken();
        mOptions.setLaunchRootTask(launchRootTaskToken);
    }
}