高级活动嵌入

1. 简介

活动嵌入功能在 Android 12L（API 级别 32）中引入，使基于活动的应用程序能够在大屏幕上同时显示多个活动，从而创建双面板布局，例如列表-详情。

该使用活动嵌入和 Material Design 创建列表-详情布局代码实验室介绍了如何使用 XML 或 Jetpack WindowManager API 调用来创建列表-详情布局。

本代码实验室将指导您完成一些新发布的活动嵌入功能，这些功能进一步提升了您在大型屏幕设备上的应用程序体验。这些功能包括面板展开、活动固定和全屏对话框暗化。

先决条件

已完成使用活动嵌入和 Material Design 创建列表-详情布局代码实验室
具有 Android Studio 使用经验，包括使用Android 15 设置虚拟设备

您将学习的内容

如何

启用面板展开
使用其中一个分割窗口实现活动固定
使用全屏对话框暗化

您需要的内容

最新版本的 Android Studio
安装了 Android 15 的 Android 手机或模拟器
最小宽度大于 600dp 的 Android 大型平板电脑或模拟器

2. 设置

获取示例应用程序

步骤 1：克隆仓库

克隆大型屏幕代码实验室 Git 仓库

git clone https://github.com/android/large-screen-codelabs

或下载并解压缩大型屏幕代码实验室 zip 文件

下载源代码

步骤 2：检查代码实验室源文件

导航到activity-embedding-advanced 文件夹。

步骤 3：打开代码实验室项目

在 Android Studio 中，打开 Kotlin 或 Java 项目

File list for the activity folder in the repo and zip file.

仓库和 zip 文件中的activity-embedding-advanced 文件夹包含两个 Android Studio 项目：一个 Kotlin 项目，一个 Java 项目。打开您选择的项目。代码片段以两种语言提供。

创建虚拟设备

如果您没有 API 级别 35 或更高的 Android 手机、小型平板电脑或大型平板电脑，请在 Android Studio 中打开设备管理器并创建您需要的以下任何虚拟设备

手机 - Pixel 8，API 级别 35 或更高
平板电脑 - Pixel 平板电脑，API 级别 35 或更高

3. 运行应用程序

示例应用程序显示项目列表。当用户选择一个项目时，应用程序会显示有关该项目的信息。

该应用程序包含三个活动

ListActivity - 在RecyclerView 中包含项目列表
DetailActivity - 选择列表中的项目时，显示有关列表项目的信息
SummaryActivity - 选择“摘要”列表项目时，显示信息摘要

从之前的代码实验室继续

在代码实验室使用活动嵌入和 Material Design 创建列表-详情布局中，我们开发了一个应用程序，该应用程序使用活动嵌入功能显示列表-详情视图，并通过导航栏和底部导航栏实现导航。

在大型平板电脑或 Pixel 模拟器上以纵向模式运行应用程序。您将看到主列表屏幕和底部的导航栏。

将平板电脑横向旋转（横向）。显示屏应分成两部分，一侧显示列表，另一侧显示详情。底部的导航栏应替换为垂直导航栏。

活动嵌入的新功能

准备好提升您的双面板布局了吗？在本代码实验室中，我们将添加一些很酷的新功能来增强用户体验。以下是我们将要构建的内容

让我们使这些面板动态化！我们将实现面板展开功能，让用户能够调整（或展开）面板大小以自定义视图。

让我们赋予用户优先级控制权！通过活动固定功能，用户可以始终让最重要的任务显示在屏幕上。

需要专注于特定任务吗？我们将添加一个全屏暗化功能，轻轻淡化分散注意力的内容，让用户专注于最重要的事情。

4. 面板展开

在大屏幕上使用双面板布局时，在许多情况下，用户需要关注分割面板中的一个，同时保持另一个面板显示在屏幕上，例如，在一侧阅读文章，同时在另一侧保持聊天对话列表。用户通常希望调整面板大小以关注一个活动。

为了实现此目标，活动嵌入添加了一个新的 API，使您可以让用户有机会更改分割比例并自定义调整大小的过渡。

添加依赖项

首先，将 WindowManager 1.4 添加到您的build.gradle 文件中。

**注意：**此库中的一些功能仅在 Android 15（API 级别 35）和更高版本上有效。

build.gradle

 implementation 'androidx.window:window:1.4.0-alpha02'

自定义窗口分隔线

创建一个DividerAttributes 实例并将其添加到SplitAttributes。此对象配置分割布局的整体行为。您可以使用DividerAttributes 的颜色、宽度和拖动范围属性来增强用户体验。

自定义分隔线

**检查 WindowManager Extensions API 级别。**由于面板展开功能仅在API 级别 6 及更高版本上可用，因此这也适用于其余的新功能。
创建**DividerAttributes**：要设置面板之间分隔线的样式，请创建一个**DividerAttributes**对象。此对象允许您设置

color：更改分隔线的颜色以匹配应用程序的主题或创建视觉分隔。
widthDp：调整分隔线的宽度以获得更好的可见性或更细微的外观。

添加到**SplitAttributes**：自定义分隔线后，将其添加到您的**DividerAttributes**对象中。
**设置拖动范围（可选）：**您还可以控制用户可以拖动分隔线以调整面板大小的距离。

**DRAG_RANGE_SYSTEM_DEFAULT**：使用此特殊值让系统根据设备的屏幕大小和外形尺寸确定合适的拖动范围。
**自定义值（介于 0.33 和 0.66 之间）**：设置您自己的拖动范围以限制用户可以调整面板大小的程度。请记住，如果他们拖动超过此限制，则分割布局将被禁用。

将splitAttributes替换为以下代码。

SplitManager.kt

val splitAttributesBuilder: SplitAttributes.Builder = SplitAttributes.Builder()
   .setSplitType(SplitAttributes.SplitType.ratio(0.33f))
   .setLayoutDirection(SplitAttributes.LayoutDirection.LEFT_TO_RIGHT)

if (WindowSdkExtensions.getInstance().extensionVersion >= 6) {
   splitAttributesBuilder.setDividerAttributes(
       DividerAttributes.DraggableDividerAttributes.Builder()
           .setColor(getColor(context, R.color.divider_color))
           .setWidthDp(4)
           .setDragRange(
               DividerAttributes.DragRange.DRAG_RANGE_SYSTEM_DEFAULT)
           .build()
   )
}
val splitAttributes: SplitAttributes = splitAttributesBuilder.build()

SplitManager.java

SplitAttributes.Builder splitAttributesBuilder = new SplitAttributes.Builder()
        .setSplitType(SplitAttributes.SplitType.ratio(0.33f))
        .setLayoutDirection(SplitAttributes.LayoutDirection.LEFT_TO_RIGHT);

if (WindowSdkExtensions.getInstance().getExtensionVersion() >= 6) {
    splitAttributesBuilder.setDividerAttributes(
            new DividerAttributes.DraggableDividerAttributes.Builder()
                    .setColor(ContextCompat.getColor(context, R.color.divider_color))
                    .setWidthDp(4)
                    .setDragRange(DividerAttributes.DragRange.DRAG_RANGE_SYSTEM_DEFAULT)
                    .build()
    );
}
SplitAttributes splitAttributes = splitAttributesBuilder.build();

在res/color文件夹中创建divider_color.xml，内容如下。

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
   <item android:color="#669df6" />
</selector>

运行它！

就是这样。构建并运行示例应用程序。

您应该会看到面板展开，并且可以四处拖动它。

在旧版本中更改分割比例

**重要的兼容性说明：**面板展开功能仅在WindowManager Extensions 6 或更高版本上可用，这意味着您需要 Android 15（API 级别 35）或更高版本。

但是，您仍然希望为旧版 Android 版本的用户提供良好的体验。

在 Android 14（API 级别 34）和更低版本上，您仍然可以使用SplitAttributesCalculator 类提供动态分割比例调整。即使没有面板展开功能，这也提供了一种保持对布局一定程度用户控制的方法。

想知道使用这些功能的最佳方法吗？我们将在“最佳实践”部分介绍所有最佳实践和内部技巧。

5. 活动固定

您是否曾经想过在自由导航另一个窗口的同时保持分割屏幕视图的一部分固定？想想在一侧阅读长篇文章，同时仍然能够与另一半的其它应用程序内容进行交互。

这就是活动固定功能的用武之地！它允许您将其中一个分割窗口固定到位，以便即使在另一个窗口中导航时，它也会保留在屏幕上。这为您的用户提供了更专注和高效的多任务处理体验。

添加固定按钮

首先，让我们在DetailActivity中添加一个按钮。当用户单击该按钮时，应用程序会固定此DetailActivity。

对activity_detail.xml进行以下更改

向ConstraintLayout添加一个 ID

android:id="@+id/detailActivity"

在布局底部添加一个按钮

<androidx.appcompat.widget.AppCompatButton
      android:id="@+id/pinButton"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="@string/pin_this_activity"
      app:layout_constraintBottom_toBottomOf="parent"
      app:layout_constraintEnd_toEndOf="parent"
      app:layout_constraintStart_toStartOf="parent"
      app:layout_constraintTop_toBottomOf="@id/textViewItemDetail"/>

将TextView的底部约束到按钮的顶部

app:layout_constraintBottom_toTopOf="@id/pinButton"

删除TextView中的这一行。

app:layout_constraintBottom_toBottomOf="parent"

这是activity_detail.xml布局文件的完整 XML 代码，包括我们刚刚添加的**固定此活动**按钮

<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/detailActivity"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@color/white"
    tools:context=".DetailActivity">

  <TextView
      android:id="@+id/textViewItemDetail"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:textSize="36sp"
      android:textColor="@color/obsidian"
      app:layout_constraintBottom_toTopOf="@id/pinButton"
      app:layout_constraintEnd_toEndOf="parent"
      app:layout_constraintStart_toStartOf="parent"
      app:layout_constraintTop_toTopOf="parent" />

  <androidx.appcompat.widget.AppCompatButton
      android:id="@+id/pinButton"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="@string/pin_this_activity"
      app:layout_constraintBottom_toBottomOf="parent"
      app:layout_constraintEnd_toEndOf="parent"
      app:layout_constraintStart_toStartOf="parent"
      app:layout_constraintTop_toBottomOf="@id/textViewItemDetail"/>

</androidx.constraintlayout.widget.ConstraintLayout>

将字符串pin_this_activity添加到res/values/strings.xml。

<string name="pin_this_activity">PIN THIS ACTIVITY</string>

连接固定按钮

**声明变量：**在您的DetailActivity.kt文件中，声明一个变量来保存对**固定此活动**按钮的引用

DetailActivity.kt

private lateinit var pinButton: Button

DetailActivity.java

private Button pinButton;

在布局中找到按钮并添加setOnClickListener()回调。

DetailActivity.kt / onCreate

pinButton = findViewById(R.id.pinButton)
pinButton.setOnClickListener {
 pinActivityStackExample(taskId)
}

DetailActivity.java / onCreate()

Button pinButton = findViewById(R.id.pinButton);
pinButton.setOnClickListener( (view) => {
        pinActivityStack(getTaskId());

});

在您的DetailActivity类中创建一个名为pinActivityStackExample的新方法。我们将在此处实现实际的固定逻辑。

DetailActivity.kt

private fun pinActivityStackExample(taskId: Int) {

 val splitAttributes: SplitAttributes = SplitAttributes.Builder()
   .setSplitType(SplitAttributes.SplitType.ratio(0.66f))
   .setLayoutDirection(SplitAttributes.LayoutDirection.LEFT_TO_RIGHT)
   .build()

 val pinSplitRule = SplitPinRule.Builder()
   .setSticky(true)
   .setDefaultSplitAttributes(splitAttributes)
   .build()

 SplitController.getInstance(applicationContext).pinTopActivityStack(taskId, pinSplitRule)
}

DetailActivity.java

private void pinActivityStackExample(int taskId) {
    SplitAttributes splitAttributes = new SplitAttributes.Builder()
            .setSplitType(SplitAttributes.SplitType.ratio(0.66f))
            .setLayoutDirection(SplitAttributes.LayoutDirection.LEFT_TO_RIGHT)
            .build();

    SplitPinRule pinSplitRule = new SplitPinRule.Builder()
            .setSticky(true)
            .setDefaultSplitAttributes(splitAttributes)
            .build();

    SplitController.getInstance(getApplicationContext()).pinTopActivityStack(taskId, pinSplitRule);
}

注意

一次只能固定一个活动。使用

unpinTopActivityStack()

取消固定当前固定的活动，然后再固定另一个活动。

要在固定活动时启用面板展开，请调用

setDividerAttributes()

为新创建的

SplitAttributes

也是如此。

使用 WindowManager 1.4 时，后退导航的行为发生了变化。使用按钮导航时，后退事件会发送到最后一个聚焦的活动。

按钮导航

使用按钮导航时，后退事件现在始终发送到最后一个聚焦的活动。这简化了后退导航行为，使之对用户来说更易预测。

手势导航

**Android 14（API 级别 34）和更低版本：**后退手势将事件发送到发生手势的活动，这可能会导致分割屏幕场景中出现意外行为。
Android 15（API 级别 35）和更高版本
**同一应用程序活动：**无论滑动方向如何，后退手势始终会结束顶部活动，从而提供更统一的体验。
**不同应用程序活动（叠加）：**后退事件会发送到最后一个聚焦的活动，这与按钮导航的行为一致。

运行它！

构建并运行示例应用程序。

固定活动

导航到DetailActivity屏幕。
点击PIN THIS ACTIVITY按钮。

6. 全屏对话框暗化

虽然活动嵌入有助于分屏布局，但以前版本的对话框只会使其自身活动容器暗化。这可能会造成视觉体验不连贯，尤其是在您希望对话框占据中心位置时。

解决方案：WindowManager 1.4

我们已经为您准备好了！使用 WindowManager 1.4，对话框现在默认情况下会使整个应用窗口暗化(DimAreaBehavior.Companion.ON_TASK)，提供更沉浸式和更集中的体验。
需要恢复旧的行为吗？没问题！您仍然可以选择仅使用ON_ACTIVITY_STACK使活动容器暗化。

`ON_ACTIVITY_STACK`	`ON_TASK`

以下是如何使用ActivityEmbeddingController管理全屏暗化行为的方法

注意：全屏对话框暗化功能需要 WindowManager Extensions 5 或更高版本。

SplitManager.kt / createSplit()

with(ActivityEmbeddingController.getInstance(context)) {
   if (WindowSdkExtensions.getInstance().extensionVersion  >= 5) {
       setEmbeddingConfiguration(
           EmbeddingConfiguration.Builder()
               .setDimAreaBehavior(ON_TASK)
               .build()
       )
   }
}

SplitManager.java / createSplit()

ActivityEmbeddingController controller = ActivityEmbeddingController.getInstance(context);
if (WindowSdkExtensions.getInstance().getExtensionVersion()  >= 5) {
    controller.setEmbeddingConfiguration(
        new EmbeddingConfiguration.Builder()
            .setDimAreaBehavior(EmbeddingConfiguration.DimAreaBehavior.ON_TASK)
            .build()
    );
}

为了展示全屏暗化功能，我们将引入一个警报对话框，在固定活动之前提示用户确认。出现此对话框时，它会使整个应用程序窗口暗化，而不仅仅是活动所在的容器。

DetailActivity.kt

pinButton.setOnClickListener {
 showAlertDialog(taskId)
}

...
private fun showAlertDialog(taskId: Int) {
 val builder = AlertDialog.Builder(this)
 builder.setTitle(getString(R.string.dialog_title))
 builder.setMessage(getString(R.string.dialog_message))
 builder.setPositiveButton(getString(R.string.button_yes)) { _, _ ->
   if (WindowSdkExtensions.getInstance().extensionVersion  >= 6) {
     pinActivityStackExample(taskId)
   }
 }
 builder.setNegativeButton(getString(R.string.button_cancel)) { _, _ ->
   // Cancel
 }
 val dialog: AlertDialog = builder.create()
 dialog.show()
}

DetailActivity.java

pinButton.setOnClickListener(new View.OnClickListener() {
   @Override
   public void onClick(View v) {
       showAlertDialog(getTaskId());
   }
});

...

private void showAlertDialog(int taskId) {
   AlertDialog.Builder builder = new AlertDialog.Builder(this);
   builder.setTitle(getString(R.string.dialog_title));
   builder.setMessage(getString(R.string.dialog_message));

   builder.setPositiveButton(getString(R.string.button_yes), new DialogInterface.OnClickListener() {
       @Override
       public void onClick(DialogInterface dialog, int which) {
           if (WindowSdkExtensions.getInstance().getExtensionVersion() >= 6) {
               pinActivityStackExample(taskId);
           }
       }
   });
   builder.setNegativeButton(getString(R.string.button_cancel), new DialogInterface.OnClickListener() {
       @Override
       public void onClick(DialogInterface dialog, int which) {
           // Cancel
       }
   });
   AlertDialog dialog = builder.create();
   dialog.show();
}

将以下字符串添加到res/values/strings.xml。

<!-- Dialog information -->
<string name="dialog_title">Activity Pinning</string>
<string name="dialog_message">Confirm to pin this activity</string>
<string name="button_yes">Yes</string>
<string name="button_cancel">Cancel</string>

运行它！

构建并运行示例应用程序。

点击固定活动按钮

出现一个警报对话框，提示您确认固定操作。
注意整个屏幕（包括两个分屏）都已暗化，从而将注意力集中在对话框上。

7. 最佳实践

允许用户关闭双面板布局

为了使向新布局的过渡更加平滑，让我们允许用户在双面板视图和单列视图之间切换。我们可以使用SplitAttributesCalculator和SharedPreferences来存储用户偏好。

更改 Android 14 及更低版本的分屏比例

我们已经探讨了面板扩展，它为用户在 Android 15 及更高版本上调整分屏比例提供了一种很好的方法。但是，我们如何在较旧的 Android 版本上为用户提供类似的灵活性呢？

让我们深入了解SplitAttributesCalculator如何帮助我们实现这一点，并确保在更广泛的设备上获得一致的体验。

这是一个示例外观

创建设置屏幕

首先，让我们为用户配置创建一个专门的设置屏幕。

在这个设置屏幕中，我们将加入一个开关来启用或禁用整个应用程序的活动嵌入功能。此外，我们将包含一个进度条，允许用户调整双面板布局的分屏比例。请注意，只有在启用活动嵌入开关的情况下，才会应用分屏比例值。

用户在SettingsActivity中设置值后，我们将它们保存在SharedPreferences中，以便稍后在应用程序的其他地方使用。

build.gradle

添加偏好依赖项。

implementation 'androidx.preference:preference-ktx:1.2.1' // Kotlin

或者

implementation 'androidx.preference:preference:1.2.1' // Java

SettingsActivity.kt

package com.example.activity_embedding

import android.os.Bundle
import android.view.MenuItem
import androidx.appcompat.app.AppCompatActivity
import androidx.preference.PreferenceFragmentCompat
import androidx.preference.SeekBarPreference
import androidx.preference.SwitchPreferenceCompat

class SettingsActivity : AppCompatActivity() {

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.settings_activity)
    if (savedInstanceState == null) {
      supportFragmentManager
        .beginTransaction()
        .replace(R.id.settings, SettingsFragment())
        .commit()
    }
    supportActionBar?.setDisplayHomeAsUpEnabled(true)
  }

  override fun onOptionsItemSelected(item: MenuItem): Boolean {
    if (item.itemId == android.R.id.home) finishActivity()
    return super.onOptionsItemSelected(item)
  }

  private fun finishActivity() { finish() }

  class SettingsFragment : PreferenceFragmentCompat() {
    override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
      setPreferencesFromResource(R.xml.root_preferences, rootKey)
findPreference<SwitchPreferenceCompat>("dual_pane")?.setOnPreferenceChangeListener { _, newValue ->
        if (newValue as Boolean) {
          this.activity?.let {
            SharePref(it.applicationContext).setAEFlag(true)
          }
        } else {
          this.activity?.let {
            SharePref(it.applicationContext).setAEFlag(false)
          }
        }
        this.activity?.finish()
        true
      }

      val splitRatioPreference: SeekBarPreference? = findPreference("split_ratio")
      splitRatioPreference?.setOnPreferenceChangeListener { _, newValue ->
        if (newValue is Int) {
          this.activity?.let { SharePref(it.applicationContext).setSplitRatio(newValue.toFloat()/100) }
        }
        true
      }
    }
  }
}

SettingsActivity.java

package com.example.activity_embedding;

import android.os.Bundle;
import android.view.MenuItem;

import androidx.appcompat.app.AppCompatActivity;
import androidx.preference.PreferenceFragmentCompat;
import androidx.preference.SeekBarPreference;
import androidx.preference.SwitchPreferenceCompat;

public class SettingsActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.settings_activity);
        if (savedInstanceState == null) {
            getSupportFragmentManager()
                .beginTransaction()
                .replace(R.id.settings, new SettingsFragment())
                .commit();
        }
        if (getSupportActionBar() != null) {
            getSupportActionBar().setDisplayHomeAsUpEnabled(true);
        }
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        if (item.getItemId() == android.R.id.home) {
            finishActivity();
            return true;
        }
        return super.onOptionsItemSelected(item);
    }

    private void finishActivity() {
        finish();
    }

    public static class SettingsFragment extends PreferenceFragmentCompat {
        @Override
        public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
            setPreferencesFromResource(R.xml.root_preferences, rootKey);

            SwitchPreferenceCompat dualPanePreference = findPreference("dual_pane");
            if (dualPanePreference != null) {
                dualPanePreference.setOnPreferenceChangeListener((preference, newValue) -> {
                    boolean isDualPane = (Boolean) newValue;
                    if (getActivity() != null) {
                        SharePref sharePref = new SharePref(getActivity().getApplicationContext());
                        sharePref.setAEFlag(isDualPane);
                        getActivity().finish();
                    }
                    return true;
                });
            }

            SeekBarPreference splitRatioPreference = findPreference("split_ratio");
            if (splitRatioPreference != null) {
                splitRatioPreference.setOnPreferenceChangeListener((preference, newValue) -> {
                    if (newValue instanceof Integer) {
                        float splitRatio = ((Integer) newValue) / 100f;
                        if (getActivity() != null) {
                            SharePref sharePref = new SharePref(getActivity().getApplicationContext());
                            sharePref.setSplitRatio(splitRatio);
                        }
                    }
                    return true;
                });
            }
        }
    }
}

在布局文件夹中添加`settings_activity.xml`

settings_activity.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
   android:layout_height="match_parent">

   <FrameLayout
       android:id="@+id/settings"
       android:layout_width="match_parent"
       android:layout_height="match_parent" />
</LinearLayout>

将`SettingsActivity`添加到您的清单文件中。

<activity
   android:name=".SettingsActivity"
   android:exported="false"
   android:label="@string/title_activity_settings" />

为`SettingsActivity`配置分屏规则。

SplitManager.kt / createSplit()

val settingActivityFilter = ActivityFilter(
   ComponentName(context, SettingsActivity::class.java),
   null
)
val settingActivityFilterSet = setOf(settingActivityFilter)
val settingActivityRule = ActivityRule.Builder(settingActivityFilterSet)
   .setAlwaysExpand(true)
   .build()
ruleController.addRule(settingActivityRule)

SplitManager.java / createSplit()

Set<ActivityFilter> settingActivityFilterSet = new HashSet<>();
ActivityFilter settingActivityFilter = new ActivityFilter(
        new ComponentName(context, SettingsActivity.class),
        null
);
settingActivityFilterSet.add(settingActivityFilter);
ActivityRule settingActivityRule = new ActivityRule.Builder(settingActivityFilterSet)
        .setAlwaysExpand(true).build();
ruleController.addRule(settingActivityRule);

以下是在SharedPreferences中保存用户设置的代码。

SharedPref.kt

package com.example.activity_embedding

import android.content.Context
import android.content.SharedPreferences

class SharePref(context: Context) {
    private val sharedPreferences: SharedPreferences =
        context.getSharedPreferences("my_app_preferences", Context.MODE_PRIVATE)

    companion object {
        private const val AE_FLAG = "is_activity_embedding_enabled"
        private const val SPLIT_RATIO = "activity_embedding_split_ratio"
        const val DEFAULT_SPLIT_RATIO = 0.3f
    }

    fun setAEFlag(isEnabled: Boolean) {
        sharedPreferences.edit().putBoolean(AE_FLAG, isEnabled).apply()
    }

    fun getAEFlag(): Boolean = sharedPreferences.getBoolean(AE_FLAG, true)

    fun getSplitRatio(): Float = sharedPreferences.getFloat(SPLIT_RATIO, DEFAULT_SPLIT_RATIO)

    fun setSplitRatio(ratio: Float) {
        sharedPreferences.edit().putFloat(SPLIT_RATIO, ratio).apply()
    }
}

SharedPref.java

package com.example.activity_embedding;

import android.content.Context;
import android.content.SharedPreferences;

public class SharePref {
    private static final String PREF_NAME = "my_app_preferences";
    private static final String AE_FLAG = "is_activity_embedding_enabled";
    private static final String SPLIT_RATIO = "activity_embedding_split_ratio";
    public static final float DEFAULT_SPLIT_RATIO = 0.3f;

    private final SharedPreferences sharedPreferences;

    public SharePref(Context context) {
        this.sharedPreferences = context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
    }

    public void setAEFlag(boolean isEnabled) {
        SharedPreferences.Editor editor = sharedPreferences.edit();
        editor.putBoolean(AE_FLAG, isEnabled);
        editor.apply();
    }

    public boolean getAEFlag() {
        return sharedPreferences.getBoolean(AE_FLAG, true);
    }

    public float getSplitRatio() {
        return sharedPreferences.getFloat(SPLIT_RATIO, DEFAULT_SPLIT_RATIO);
    }

    public void setSplitRatio(float ratio) {
        SharedPreferences.Editor editor = sharedPreferences.edit();
        editor.putFloat(SPLIT_RATIO, ratio);
        editor.apply();
    }
}

您还需要一个偏好设置屏幕布局 xml，在 res/xml 下创建root_preferences.xml，其中包含以下代码。

<PreferenceScreen xmlns:app="http://schemas.android.com/apk/res-auto"
   xmlns:android="http://schemas.android.com/apk/res/android">
   <PreferenceCategory app:title="@string/split_setting_header">

       <SwitchPreferenceCompat
           app:key="dual_pane"
           app:title="@string/dual_pane_title" />

       <SeekBarPreference
           app:key="split_ratio"
           app:title="@string/split_ratio_title"
           android:min="0"
           android:max="100"
           app:defaultValue="50"
           app:showSeekBarValue="true" />
   </PreferenceCategory>
</PreferenceScreen>

并将以下内容添加到res/values/strings.xml。

<string name="title_activity_settings">SettingsActivity</string>
<string name="split_setting_header">Dual Pane Display</string>
<string name="dual_pane_title">Dual Pane</string>
<string name="split_ratio_title">Split Ratio</string>

将`SettingsActivity`添加到菜单

让我们将新创建的SettingsActivity连接到导航目的地，以便用户可以轻松地从应用程序的主界面访问它。

在您的ListActivity文件中，声明底部导航栏和左侧导航轨的变量

ListActivity.kt

 private lateinit var navRail: NavigationRailView private lateinit var bottomNav: BottomNavigationView

ListActivity.java

 private NavigationRailView navRail;  private BottomNavigationView bottomNav;

在您的ListActivity的onCreate()方法中，使用findViewById将这些变量连接到布局中的相应视图；
向底部导航栏和导航轨添加OnItemSelectedListener以处理项目选择事件

ListActivity.kt / onCreate()

navRail  = findViewById(R.id.navigationRailView)
bottomNav = findViewById(R.id.bottomNavigationView)

val menuListener = NavigationBarView.OnItemSelectedListener { item ->
    when (item.itemId) {
        R.id.navigation_home -> {
            true
        }
        R.id.navigation_dashboard -> {
            true
        }
        R.id.navigation_settings -> {
            startActivity(Intent(this, SettingsActivity::class.java))
            true
        }
        else -> false
    }
}

navRail.setOnItemSelectedListener(menuListener)
bottomNav.setOnItemSelectedListener(menuListener)

ListActivity.java / onCreate()

NavigationRailView navRail = findViewById(R.id.navigationRailView);
BottomNavigationView bottomNav = findViewById(R.id.bottomNavigationView);

NavigationBarView.OnItemSelectedListener menuListener = new NavigationBarView.OnItemSelectedListener() {
   @Override
   public boolean onNavigationItemSelected(@NonNull MenuItem item) {
       switch (item.getItemId()) {
           case R.id.navigation_home:
               // Handle navigation_home selection
               return true;
           case R.id.navigation_dashboard:
               // Handle navigation_dashboard selection
               return true;
           case R.id.navigation_settings:
               startActivity(new Intent(ListActivity.this, SettingsActivity.class));
               return true;
           default:
               return false;
       }
   }
};

navRail.setOnItemSelectedListener(menuListener);
bottomNav.setOnItemSelectedListener(menuListener);

应用程序读取SharedPreferences并在分屏模式或SPLIT_TYPE_EXPAND模式下呈现应用程序。

当窗口配置更改时，程序会检查是否满足分屏窗口约束（如果宽度 > 840dp）
并且应用程序会检查SharedPreferences的值以查看用户是否启用了分屏窗口显示，否则它将返回具有SPLIT_TYPE_EXPAND类型的SplitAttribute。
如果启用了分屏窗口，应用程序将读取SharedPreferences的值以获取分屏比例。这仅在WindowSDKExtensions版本小于 6 时有效，因为版本 6 已经支持面板扩展并忽略分屏比例设置。相反，开发人员可以允许用户在 UI 上拖动分隔线。

ListActivity.kt / onCreate()

...

SplitController.getInstance(this).setSplitAttributesCalculator{
       params -> params.defaultSplitAttributes
   if (params.areDefaultConstraintsSatisfied) {
       setWiderScreenNavigation(true)

       if (SharePref(this.applicationContext).getAEFlag()) {
           if (WindowSdkExtensions.getInstance().extensionVersion  < 6) {
               // Read a dynamic split ratio from shared preference.
               val currentSplit = SharePref(this.applicationContext).getSplitRatio()
               if (currentSplit != SharePref.DEFAULT_SPLIT_RATIO) {
                   return@setSplitAttributesCalculator SplitAttributes.Builder()
                       .setSplitType(SplitAttributes.SplitType.ratio(SharePref(this.applicationContext).getSplitRatio()))
                     .setLayoutDirection(SplitAttributes.LayoutDirection.LEFT_TO_RIGHT)
                       .build()
               }
           }
           return@setSplitAttributesCalculator params.defaultSplitAttributes
       } else {
           SplitAttributes.Builder()
               .setSplitType(SPLIT_TYPE_EXPAND)
               .build()
       }
   } else {
       setWiderScreenNavigation(false)
       SplitAttributes.Builder()
           .setSplitType(SPLIT_TYPE_EXPAND)
           .build()
   }
}

...

ListActivity.java / onCreate()

...
SplitController.getInstance(this).setSplitAttributesCalculator(params -> {
   if (params.areDefaultConstraintsSatisfied()) {
       setWiderScreenNavigation(true);

       SharePref sharedPreference = new SharePref(this.getApplicationContext());
       if (sharedPreference.getAEFlag()) {
           if (WindowSdkExtensions.getInstance().getExtensionVersion()  < 6) {
               // Read a dynamic split ratio from shared preference.
               float currentSplit = sharedPreference.getSplitRatio();
               if (currentSplit != SharePref.DEFAULT_SPLIT_RATIO) {
                   return new SplitAttributes.Builder()
                           .setSplitType(SplitAttributes.SplitType.ratio(sharedPreference.getSplitRatio()))
                           .setLayoutDirection(SplitAttributes.LayoutDirection.LEFT_TO_RIGHT)
                           .build();
               }
           }
           return params.getDefaultSplitAttributes();
       } else {
           return new SplitAttributes.Builder()
                   .setSplitType(SPLIT_TYPE_EXPAND)
                   .build();
       }
   } else {
       setWiderScreenNavigation(false);
       return new SplitAttributes.Builder()
               .setSplitType(SPLIT_TYPE_EXPAND)
               .build();
   }
});

...

要在设置更改后触发SplitAttributesCalculator，我们需要使当前属性无效。我们通过从ActivityEmbeddingController调用invalidateVisibleActivityStacks()来实现；在 WindowManager 1.4 之前，调用该方法

invalidateTopVisibleSplitAttributes.

ListActivity.kt / onResume()

override fun onResume() {
   super.onResume()
   ActivityEmbeddingController.getInstance(this).invalidateVisibleActivityStacks()
}

ListActivity.java / onResume()

@Override
public void onResume() {
    super.onResume();
    ActivityEmbeddingController.getInstance(this).invalidateVisibleActivityStacks();
}

运行它！

构建并运行示例应用程序。

探索设置

导航到设置屏幕。
打开和关闭启用分屏窗口开关。
调整分屏比例滑块（如果您的设备可用）。

观察布局变化:

在运行 Android 14 及更低版本的设备上：布局应根据开关在单面板和双面板模式之间切换，并且在调整滑块时分屏比例应更改。
在运行 Android 15 及更高版本的设备上：面板扩展应允许您动态调整面板大小，而不管滑块设置如何。

8. 恭喜！

做得好！您已成功使用活动嵌入和 WindowManager 增强了您的应用程序的强大新功能。您的用户现在将在大型屏幕上享受更灵活、更直观和更引人入胜的体验，无论他们的 Android 版本如何。

9. 了解更多

开发者指南 — 活动嵌入
参考文档 — androidx.window.embedding

高级活动嵌入

1. 简介

先决条件

您将学习的内容

您需要的内容

2. 设置

获取示例应用程序

步骤 1：克隆仓库

步骤 2：检查代码实验室源文件

步骤 3：打开代码实验室项目

创建虚拟设备

3. 运行应用程序

从之前的代码实验室继续

活动嵌入的新功能

4. 面板展开

添加依赖项

自定义窗口分隔线

SplitManager.kt

SplitManager.java

运行它！

在旧版本中更改分割比例

5. 活动固定

添加固定按钮

连接固定按钮

DetailActivity.kt

DetailActivity.java

DetailActivity.kt / onCreate

DetailActivity.java / onCreate()

DetailActivity.kt

DetailActivity.java

后退导航更改

运行它！

6. 全屏对话框暗化

SplitManager.kt / createSplit()

SplitManager.java / createSplit()

DetailActivity.kt

DetailActivity.java

运行它！

7. 最佳实践

允许用户关闭双面板布局

更改 Android 14 及更低版本的分屏比例

创建设置屏幕

build.gradle

SettingsActivity.kt

SettingsActivity.java

在布局文件夹中添加settings_activity.xml

settings_activity.xml

将SettingsActivity添加到您的清单文件中。

为SettingsActivity配置分屏规则。

SplitManager.kt / createSplit()

SplitManager.java / createSplit()

SharedPref.kt

SharedPref.java

将SettingsActivity添加到菜单

ListActivity.kt

ListActivity.java

ListActivity.kt / onCreate()

ListActivity.java / onCreate()

ListActivity.kt / onCreate()

ListActivity.java / onCreate()

ListActivity.kt / onResume()

ListActivity.java / onResume()

运行它！

8. 恭喜！

9. 了解更多

在布局文件夹中添加`settings_activity.xml`

将`SettingsActivity`添加到您的清单文件中。

为`SettingsActivity`配置分屏规则。

将`SettingsActivity`添加到菜单