Tạo bố cục danh sách-chi tiết bằng tính năng nhúng hoạt động và Material Design

1. Giới thiệu

Với màn hình lớn, bạn có thể cải thiện trải nghiệm cũng như hiệu suất sử dụng của người dùng thông qua bố cục và giao diện người dùng mà bạn tạo cho ứng dụng. Nhưng nếu ứng dụng của bạn bạn được thiết kế dành cho màn hình nhỏ của điện thoại không thể gập lại, thì ứng dụng có thể sẽ không tận dụng được diện tích màn hình vượt trội mà máy tính bảng, thiết bị gập và thiết bị ChromeOS cung cấp.

Việc cập nhật ứng dụng để khai thác tối đa màn hình lớn có thể tốn thời gian và chi phí, đặc biệt là đối với các ứng dụng cũ dựa trên nhiều hoạt động.

Tính năng nhúng hoạt động có trong Android 12L (API cấp 32) cho phép các ứng dụng dựa trên hoạt động hiển thị nhiều hoạt động cùng lúc trên màn hình lớn để tạo bố cục hai ngăn (chẳng hạn như danh sách-chi tiết (list-detail)). Bạn không cần phải viết lại mã Kotlin hoặc Java. Bạn sẽ thêm một số phần phụ thuộc, tạo tệp cấu hình XML, triển khai trình khởi chạy và bổ sung thêm cho tệp kê khai ứng dụng. Hoặc nếu thích lập trình, bạn chỉ cần thêm một vài lệnh gọi API Jetpack WindowManager vào phương thức onCreate() của hoạt động chính trong ứng dụng.

Điều kiện tiên quyết

Để hoàn thành lớp học lập trình này, bạn cần có kinh nghiệm trong các lĩnh vực sau:

  • Xây dựng ứng dụng Android
  • Làm việc với các hoạt động
  • Viết mã XML
  • Làm việc với Android Studio, bao gồm cả thiết lập thiết bị ảo

Sản phẩm bạn sẽ tạo ra

Trong lớp học lập trình này, bạn sẽ cập nhật ứng dụng dựa trên hoạt động để hỗ trợ bố cục hai ngăn động tương tự như SlidingPaneLayout. Trên màn hình nhỏ, các ứng dụng sẽ phủ (xếp chồng) lên nhau trong cửa sổ tác vụ.

Các hoạt động A, B và C xếp chồng trong cửa sổ tác vụ.

Trên màn hình lớn, dựa trên thông số mà bạn thiết lập, ứng dụng sẽ hiển thị đồng thời hai hoạt động trên màn hình, cạnh nhau hoặc trên cùng và dưới cùng.

4b27b07b7361d6d8.png

Kiến thức bạn sẽ học được

Cách triển khai nhúng hoạt động theo hai cách:

  • Sử dụng tệp cấu hình XML
  • Sử dụng lệnh gọi API Jetpack WindowManager

Bạn cần có

  • Phiên bản Android Studio gần đây
  • Trình mô phỏng hoặc điện thoại Android
  • Máy tính bảng hoặc trình mô phỏng Android nhỏ
  • Máy tính bảng hoặc trình mô phỏng Android lớn

2. Thiết lập

Tải ứng dụng mẫu

Bước 1: Sao chép kho lưu trữ

Sao chép kho lưu trữ Git của các lớp học lập trình màn hình lớn:

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

hoặc tải xuống và huỷ lưu trữ tệp zip của lớp học lập trình màn hình lớn:

Tải mã nguồn xuống

Bước 2: Kiểm tra các tệp nguồn của lớp học lập trình

Chuyển đến thư mục activity-embedding.

Bước 3: Mở dự án của lớp học lập trình

Trong Android Studio, hãy mở dự án Kotlin hoặc Java.

5169252cbf5e110e.png

Thư mục activity-embedding trong tệp repo và tệp zip chứa 2 dự án Android Studio: một bằng ngôn ngữ Kotlin, một bằng ngôn ngữ Java. Hãy mở dự án tuỳ chọn. Các đoạn mã của lớp học lập trình này được cung cấp bằng cả hai ngôn ngữ.

Tạo thiết bị ảo

Nếu bạn không có điện thoại, máy tính bảng nhỏ hoặc máy tính bảng lớn chạy Android API cấp 32 trở lên, hãy mở Trình quản lý thiết bị trong Android Studio và tạo bất cứ thiết bị ảo nào sau đây mà bạn cần:

  • Điện thoại — Pixel 6, API cấp 32 trở lên
  • Máy tính bảng nhỏ — 7 WSVGA (Máy tính bảng), API cấp 32 trở lên
  • Máy tính bảng lớn – Pixel C, API cấp 32 trở lên

3. Chạy ứng dụng

Ứng dụng mẫu hiện danh sách các mục. Khi người dùng chọn một mục, ứng dụng sẽ hiện thông tin về mục đó.

Ứng dụng này bao gồm 3 hoạt động:

  • ListActivity — Có chứa một danh sách các mục trong RecyclerView. Một lớp ItemAdapter tạo danh sách mục cho RecyclerView.
  • DetailActivity — Hiện thông tin về một mục trong danh sách khi mục đó được chọn từ danh sách.
  • SummaryActivity — Hiện thông tin tóm tắt khi mục trong danh sách Tóm tắt được chọn.

Hành vi không được nhúng hoạt động

Chạy ứng dụng mẫu để xem hành vi của ứng dụng mà không cần nhúng hoạt động:

  1. Chạy ứng dụng mẫu trên máy tính bảng lớn hoặc trình mô phỏng Pixel C. Hoạt động chính (Danh sách) xuất hiện:

Máy tính bảng lớn có ứng dụng mẫu chạy theo hướng dọc. Hoạt động Danh sách chạy trên toàn màn hình.

  1. Chọn một mục trong danh sách để chạy hoạt động phụ (Chi tiết). Hoạt động Chi tiết phủ lên hoạt động Danh sách:

Máy tính bảng lớn có ứng dụng mẫu chạy theo hướng dọc. Hoạt động Chi tiết chạy trên toàn màn hình.

  1. Xoay máy tính bảng sang hướng ngang. Hoạt động phụ vẫn phủ lên hoạt động chính và chiếm toàn bộ màn hình:

Máy tính bảng lớn có ứng dụng mẫu chạy theo hướng ngang. Hoạt động Chi tiết chạy trên toàn màn hình.

  1. Chọn nút điều khiển Quay lại (mũi tên hướng sang trái trong thanh ứng dụng) để trở lại danh sách.
  2. Xoay thiết bị theo hướng dọc.
  3. Chọn mục cuối cùng trong danh sách (Tóm tắt) để chạy hoạt động Tóm tắt dưới dạng hoạt động phụ. Hoạt động Tóm tắt sẽ bao phủ hoạt động Danh sách:

Máy tính bảng lớn có ứng dụng mẫu chạy theo hướng dọc. Hoạt động Tóm tắt chạy trên toàn màn hình.

  1. Xoay máy tính bảng sang hướng ngang. Hoạt động phụ vẫn phủ lên hoạt động chính và chiếm toàn bộ màn hình:

Máy tính bảng lớn có ứng dụng mẫu chạy theo hướng ngang. Hoạt động Tóm tắt chạy trên toàn màn hình.

Hành vi khi nhúng hoạt động

Khi bạn hoàn tất lớp học lập trình này, hướng ngang sẽ hiển thị danh sách và thông tin chi tiết về các hoạt động cạnh nhau theo bố cục danh sách-chi tiết:

Máy tính bảng lớn có ứng dụng mẫu chạy theo hướng ngang. Các hoạt động Danh sách và Chi tiết trong bố cục danh sách-chi tiết.

Tuy nhiên, bạn sẽ định cấu hình hoạt động Tóm tắt để hiển thị toàn màn hình, mặc dù hoạt động này được khởi chạy từ trong phần phân tách. Hoạt động Tóm tắt sẽ chồng lên phần phân tách:

Máy tính bảng lớn có ứng dụng mẫu chạy theo hướng ngang. Hoạt động Tóm tắt chạy trên toàn màn hình.

4. Thông tin khái quát

Tính năng nhúng hoạt động chia cửa sổ tác vụ của ứng dụng thành hai vùng chứa: chính và phụ. Bất cứ hoạt động nào cũng có thể khởi tạo phần phân tách bằng cách khởi chạy một hoạt động khác. Hoạt động được khởi tạo sẽ chiếm vùng chứa chính; hoạt động được khởi chạy sẽ chiếm vùng chứa phụ.

Hoạt động chính có thể khởi chạy thêm các hoạt động khác trong vùng chứa phụ. Sau đó, các hoạt động trong cả hai vùng chứa có thể khởi chạy các hoạt động trong vùng chứa tương ứng của chúng. Mỗi vùng chứa có thể chứa một ngăn xếp hoạt động. Để biết thêm thông tin, hãy xem hướng dẫn Nhúng hoạt động dành cho nhà phát triển.

Bạn có thể định cấu hình ứng dụng để hỗ trợ tính năng nhúng hoạt động bằng cách tạo tệp cấu hình XML, hoặc thực hiện các lệnh gọi API Jetpack WindowManager. Chúng ta sẽ bắt đầu từ phương pháp tạo tệp cấu hình XML.

5. Cấu hình XML

Các vùng chứa và phần phân tách hoạt động được thư viện Jetpack WindowManager tạo và quản lý dựa trên các quy tắc phân tách mà bạn tạo trong tệp cấu hình XML.

Thêm phần phụ thuộc WindowManager

Bật ứng dụng mẫu để truy cập vào thư viện WindowManager bằng cách thêm phần phụ thuộc thư viện đó vào tệp build.gradle cấp mô-đun của ứng dụng, ví dụ:

build.gradle

 implementation 'androidx.window:window:1.3.0'

Thông báo cho hệ thống

Cho hệ thống biết ứng dụng của bạn đã triển khai tính năng nhúng hoạt động.

Thêm thuộc tính android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED vào phần tử <application> của tệp kê khai ứng dụng và thiết lập giá trị thành true:

AndroidManifest.xml

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <property
            android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED"
            android:value="true" />
    </application>
</manifest>

Nhà sản xuất thiết bị (OEM) sử dụng chế độ cài đặt này để bật các tính năng tuỳ chỉnh cho những ứng dụng hỗ trợ tính năng nhúng hoạt động. Ví dụ: thiết bị có thể chạy các hoạt động nằm trong khung viền hộp thư, chỉ hiển thị theo chiều dọc (xem android:screenOrientation) trên màn hình ngang để định hướng cho việc chuyển đổi sang hoạt động được nhúng theo bố cục hai ngăn diễn ra suôn sẻ:

Tính năng nhúng hoạt động với ứng dụng chỉ hiển thị theo chiều dọc trên màn hình ngang. Hoạt động A (nằm trong khung viền hộp thư, chỉ hiển thị theo chiều dọc) khởi chạy hoạt động B được nhúng.

Tạo tệp cấu hình

Tạo tệp tài nguyên XML có tên main_split_config.xml trong thư mục res/xml của ứng dụng, trong đó resources là thành phần gốc.

Thay đổi không gian tên XML thành:

main_split_config.xml

xmlns:window="http://schemas.android.com/apk/res-auto"

Quy tắc phân tách cặp hoạt động

Thêm quy tắc phân tách sau đây vào tệp cấu hình:

main_split_config.xml

<!-- Define a split for the named activity pair. -->
<SplitPairRule
    window:splitRatio="0.33"
    window:splitMinWidthDp="840"
    window:finishPrimaryWithSecondary="never"
    window:finishSecondaryWithPrimary="always">
  <SplitPairFilter
      window:primaryActivityName=".ListActivity"
      window:secondaryActivityName=".DetailActivity"/>
</SplitPairRule>

Quy tắc này sẽ thực hiện những việc sau:

  • Định cấu hình các tuỳ chọn phân tách cho các hoạt động có chung phần phân tách:
  • splitRatio – Chỉ định xem hoạt động chính sẽ chiếm bao nhiêu phần (33%) trong cửa sổ tác vụ, không gian còn lại sẽ được để dành cho hoạt động phụ.
  • splitMinWidthDp – Chỉ định chiều rộng màn hình tối thiểu (840) cần thiết cho việc hiển thị đồng thời cả hai hoạt động trên màn hình. Đơn vị tính là pixel không phụ thuộc vào mật độ màn hình (dp).
  • finishPrimaryWithSecondary – Chỉ định liệu các hoạt động trong vùng chứa phân tách chính có kết thúc (không bao giờ) khi tất cả hoạt động trong vùng chứa phụ kết thúc.
  • finishSecondaryWithPrimary – Chỉ định xem các hoạt động trong vùng chứa phân tách phụ có kết thúc (luôn luôn) hay không khi tất cả hoạt động trong hoạt động vùng chứa chính kết thúc.
  • Bao gồm một bộ lọc phân tách xác định các hoạt động có chung cửa sổ tác vụ. Hoạt động chính là ListActivity; hoạt động phụ là DetailActivity.

Quy tắc giữ chỗ

Hoạt động giữ chỗ sẽ chiếm vùng chứa phụ của phần phân tách hoạt động khi không có nội dung nào cho vùng chứa đó, chẳng hạn như khi phần phân tách danh sách-chi tiết mở ra nhưng mục danh sách chưa được chọn. (Để biết thêm thông tin, hãy xem Hoạt động giữ chỗ trong hướng dẫn Nhúng hoạt động dành cho nhà phát triển.)

Thêm quy tắc giữ chỗ sau vào tệp cấu hình:

main_split_config.xml

<!-- Automatically launch a placeholder for the detail activity. -->
<SplitPlaceholderRule
    window:placeholderActivityName=".PlaceholderActivity"
    window:splitRatio="0.33"
    window:splitMinWidthDp="840"
    window:finishPrimaryWithPlaceholder="always"
    window:stickyPlaceholder="false">
  <ActivityFilter
      window:activityName=".ListActivity"/>
</SplitPlaceholderRule>

Quy tắc này sẽ thực hiện những việc sau:

  • Xác định hoạt động ở phần giữ chỗ, PlaceholderActivity (các bạn sẽ tạo hoạt động này trong bước tiếp theo)
  • Định cấu hình các tuỳ chọn cho phần giữ chỗ:
  • splitRatio – Chỉ định xem hoạt động chính sẽ chiếm bao nhiêu phần (33%) trong cửa sổ tác vụ, không gian còn lại sẽ được để dành cho hoạt động giữ chỗ. Thông thường, giá trị này phải khớp với tỷ lệ phân tách của quy tắc phân tách cặp hoạt động có liên kết với hoạt động giữ chỗ.
  • splitMinWidthDp – Chỉ định chiều rộng màn hình tối thiểu (840) cần thiết để hoạt động giữ chỗ xuất hiện trên màn hình cùng với hoạt động chính. Thông thường, giá trị này phải khớp với chiều rộng tối thiểu của quy tắc phân tách cặp hoạt động có liên kết với hoạt động giữ chỗ. Đơn vị tính là pixel không phụ thuộc vào mật độ màn hình (dp).
  • finishPrimaryWithPlaceholder – Chỉ định xem các hoạt động trong vùng chứa phân tách phụ có kết thúc (luôn luôn) hay không khi tất cả hoạt động trong hoạt động vùng chứa chính kết thúc.
  • stickyPlaceholder – Cho biết liệu có nên giữ lại (false) hoạt động giữ chỗ trên màn hình làm hoạt động hàng đầu hay không khi màn hình được đổi kích thước từ hai ngăn xuống còn một ngăn (ví dụ: khi thiết bị gập lại).
  • Bao gồm bộ lọc hoạt động chỉ định hoạt động (ListActivity) mà hoạt động giữ chỗ chia sẻ cửa sổ tác vụ.

Hoạt động giữ chỗ đại diện cho hoạt động phụ của quy tắc phân tách cặp hoạt động có hoạt động chính giống như hoạt động trong bộ lọc hoạt động giữ chỗ (xem "Quy tắc phân tách cặp hoạt động" trong phần "Cấu hình XML" của lớp học lập trình này).

Quy tắc hoạt động

Quy tắc hoạt động là những quy tắc chung. Các hoạt động mà bạn muốn chiếm toàn bộ cửa sổ tác vụ (có nghĩa là không bao giờ thuộc về một phần phân tách) có thể được chỉ định bằng quy tắc hoạt động. (Để biết thêm thông tin, hãy xem Chế độ toàn cửa sổ trong hướng dẫn Nhúng hoạt động dành cho nhà phát triển.)

Chúng ta sẽ làm cho hoạt động tóm tắt lấp đầy toàn bộ cửa sổ tác vụ, chồng lên phần phân tách. Thao tác quay lại sẽ khiến hoạt động trở về phần phân tách.

Hãy thêm quy tắc hoạt động sau đây vào tệp cấu hình:

main_split_config.xml

<!-- Activities that should never be in a split. -->
<ActivityRule
    window:alwaysExpand="true">
  <ActivityFilter
      window:activityName=".SummaryActivity"/>
</ActivityRule>

Quy tắc này sẽ thực hiện những việc sau:

  • Xác định hoạt động sẽ được hiển thị toàn màn hình (SummaryActivity).
  • Định cấu hình các tuỳ chọn cho hoạt động:
  • alwaysExpand – Chỉ định xem liệu hoạt động có cần mở rộng để lấp đầy tất cả không gian hiển thị có sẵn hay không.

Tệp nguồn

Tệp cấu hình XML hoàn chỉnh sẽ có dạng như sau:

main_split_config.xml

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:window="http://schemas.android.com/apk/res-auto">

    <!-- Define a split for the named activity pair. -->
    <SplitPairRule
        window:splitRatio="0.33"
        window:splitMinWidthDp="840"
        window:finishPrimaryWithSecondary="never"
        window:finishSecondaryWithPrimary="always">
      <SplitPairFilter
          window:primaryActivityName=".ListActivity"
          window:secondaryActivityName=".DetailActivity"/>
    </SplitPairRule>

    <!-- Automatically launch a placeholder for the detail activity. -->
    <SplitPlaceholderRule
        window:placeholderActivityName=".PlaceholderActivity"
        window:splitRatio="0.33"
        window:splitMinWidthDp="840"
        window:finishPrimaryWithPlaceholder="always"
        window:stickyPlaceholder="false">
      <ActivityFilter
          window:activityName=".ListActivity"/>
    </SplitPlaceholderRule>

    <!-- Activities that should never be in a split. -->
    <ActivityRule
        window:alwaysExpand="true">
      <ActivityFilter
          window:activityName=".SummaryActivity"/>
    </ActivityRule>

</resources>

Tạo một hoạt động giữ chỗ

Bạn cần tạo một hoạt động mới để làm hoạt động giữ chỗ được chỉ định trong tệp cấu hình XML. Hoạt động có thể rất đơn giản—chỉ là cho người dùng biết nội dung cuối cùng sẽ xuất hiện tại đây.

Tạo hoạt động trong thư mục nguồn chính của ứng dụng mẫu.

Trong Android Studio, hãy làm như sau:

  1. Nhấp chuột phải (nhấp nút phụ) vào thư mục nguồn của ứng dụng mẫu com.example.activity_embedding
  2. Chọn New > Activity > Empty Views Activity (Mới > Hoạt động > Hoạt động của thành phần hiển thị trống
  3. Đặt tên cho hoạt động là PlaceholderActivity
  4. Đặt ngôn ngữ nguồn thành ngôn ngữ Kotlin hoặc Java
  5. Chọn Finish (Hoàn tất).

Android Studio sẽ tạo hoạt động trong gói ứng dụng mẫu, thêm hoạt động vào tệp kê khai ứng dụng và tạo tệp tài nguyên bố cục có tên activity_placeholder.xml trong thư mục res/layout.

  1. Xoá lệnh gọi tới enableEdgeToEdge() nếu tệp của bạn thuộc lớp Kotlin hoặc EdgeToEdge.enable(this); nếu tệp thuộc lớp Java. (Các hoạt động khác trong ứng dụng – cụ thể là DetailActivity không tràn viền.)

Tệp chứa lớp đã hoàn tất sẽ như sau:

PlaceholderActivity.kt

package com.example.activity_embedding

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat

class PlaceholderActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_placeholder)
    ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) {
      v, insets ->
        val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        v.setPadding(systemBars.left, 
                     systemBars.top,
                     systemBars.right, 
                     systemBars.bottom)
        insets
    }
  }
}

PlaceholderActivity.java

package com.example.activity_embedding;

import android.os.Bundle;

import androidx.appcompat.app.AppCompatActivity;
import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;

public class PlaceholderActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_placeholder);
    ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), 
      (v, insets) -> {
        Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
        v.setPadding(systemBars.left, 
                     systemBars.top, 
                     systemBars.right, 
                     systemBars.bottom);
      return insets;
    });
  }
}
  1. Trong tệp AndroidManifest.xml của ứng dụng mẫu, hãy thiết lập nhãn cho hoạt động ở phần giữ chỗ thành một chuỗi trống:

AndroidManifest.xml

<activity
    android:name=".PlaceholderActivity"
    android:exported="false"
    android:label="" />
  1. Thay thế nội dung của tệp bố cục activity_placeholder.xml trong thư mục res/layout bằng nội dung sau:

activity_placeholder.xml

<?xml version="1.0" encoding="utf-8"?>
<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/main"
    android:background="@color/gray"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".PlaceholderActivity">

  <TextView
      android:id="@+id/textViewPlaceholder"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="@string/placeholder_text"
      android:textSize="36sp"
      android:textColor="@color/obsidian"
      app:layout_constraintBottom_toBottomOf="parent"
      app:layout_constraintEnd_toEndOf="parent"
      app:layout_constraintStart_toStartOf="parent"
      app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>
  1. Cuối cùng, hãy thêm tài nguyên chuỗi sau vào tệp tài nguyên strings.xml trong thư mục res/values:

strings.xml

<string name="placeholder_text">Placeholder</string>

Tạo trình khởi tạo

Thành phần WindowManager RuleController phân tích cú pháp các quy tắc được xác định trong tệp cấu hình XML và cung cấp các quy tắc đó cho hệ thống.

Trình khởi tạo của thư viện Startup của Jetpack cho phép RuleController truy cập vào tệp cấu hình.

Thư viện Startup thực hiện việc khởi tạo thành phần khi khởi động ứng dụng. Quá trình khởi tạo phải diễn ra trước khi mọi hoạt động bắt đầu để RuleController có quyền truy cập vào các quy tắc phân tách và có thể áp dụng các quy tắc này nếu cần.

Thêm phần phụ thuộc thư viện Startup

Để bật chức năng khởi động, hãy thêm phần phụ thuộc thư viện Startup vào tệp build.gradle cấp mô-đun của ứng dụng mẫu, ví dụ:

build.gradle

implementation 'androidx.startup:startup-runtime:1.2.0'

Triển khai trình khởi tạo cho RuleController

Tạo tuỳ chọn triển khai giao diện Startup Initializer (Trình khởi tạo khi bắt đầu).

Trong Android Studio, hãy làm như sau:

  1. Nhấp chuột phải (nhấp nút phụ) vào thư mục nguồn của ứng dụng mẫu com.example.activity_embedding
  2. Chọn New > Kotlin Class/File (Mới > Lớp/tệp Kotlin) hoặc New > Java Class (Mới > Lớp Java)
  3. Đặt tên cho lớp là SplitInitializer
  4. Nhấn phím Enter – Android Studio sẽ tạo lớp trong gói ứng dụng mẫu
  5. Thay thế nội dung của tệp lớp bằng:

SplitInitializer.kt

package com.example.activity_embedding

import android.content.Context
import androidx.startup.Initializer
import androidx.window.embedding.RuleController

class SplitInitializer : Initializer<RuleController> {

  override fun create(context: Context): RuleController {
    return RuleController.getInstance(context).apply {
      setRules(RuleController.parseRules(context, R.xml.main_split_config))
    }
  }

  override fun dependencies(): List<Class<out Initializer<*>>> {
    return emptyList()
  }
}

SplitInitializer.java

package com.example.activity_embedding;

import android.content.Context;
import androidx.annotation.NonNull;
import androidx.startup.Initializer;
import androidx.window.embedding.RuleController;
import java.util.Collections;
import java.util.List;

public class SplitInitializer implements Initializer<RuleController> {

   @NonNull
   @Override
   public RuleController create(@NonNull Context context) {
      RuleController ruleController = RuleController.getInstance(context);
      ruleController.setRules(
          RuleController.parseRules(context, R.xml.main_split_config)
      );
      return ruleController;
   }

   @NonNull
   @Override
   public List<Class<? extends Initializer<?>>> dependencies() {
       return Collections.emptyList();
   }
}

Trình khởi tạo cung cấp các quy tắc phân tách cho thành phần RuleController bằng cách truyền mã nhận dạng của tệp tài nguyên XML chứa định nghĩa ((main_split_config) vào phương thức parseRules() của thành phần. Phương thức setRules() sẽ thêm các quy tắc đã phân tích cú pháp vào RuleController.

Tạo trình cung cấp cho quá trình khởi tạo

Trình cung cấp sẽ gọi quá trình khởi tạo quy tắc phân tách.

Thêm androidx.startup.InitializationProvider vào phần tử <application> của tệp kê khai của ứng dụng mẫu làm trình cung cấp và tham chiếu đến SplitInitializer:

AndroidManifest.xml

<provider android:name="androidx.startup.InitializationProvider"
    android:authorities="${applicationId}.androidx-startup"
    android:exported="false">
    <!-- Make SplitInitializer discoverable by InitializationProvider. -->
    <meta-data android:name="${applicationId}.SplitInitializer"
        android:value="androidx.startup" />
</provider>

InitializationProvider khởi tạo SplitInitializer, từ đó gọi các phương thức RuleController phân tích cú pháp tệp cấu hình XML (main_split_config.xml) và thêm các quy tắc vào RuleController (xem phần "Triển khai trình khởi chạy cho RuleController" bên trên).

InitializationProvider khám phá và khởi chạy SplitInitializer trước khi phương thức onCreate() của ứng dụng thực thi. Và do đó, các quy tắc phân tách có hiệu lực khi hoạt động chính của ứng dụng bắt đầu.

Tệp nguồn

Dưới đây là tệp kê khai ứng dụng hoàn chỉnh:

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

  <application
      android:allowBackup="true"
      android:dataExtractionRules="@xml/data_extraction_rules"
      android:fullBackupContent="@xml/backup_rules"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:roundIcon="@mipmap/ic_launcher_round"
      android:supportsRtl="true"
      android:theme="@style/Theme.Activity_Embedding">
    <activity
        android:name=".ListActivity"
        android:exported="true">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    </activity>
    <activity
        android:name=".DetailActivity"
        android:exported="false"
        android:label="" />
    <activity
        android:name=".SummaryActivity"
        android:exported="false"
        android:label="" />
    <activity
        android:name=".PlaceholderActivity"
        android:exported="false"
        android:label="" />
    <property
        android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED"
        android:value="true" />
    <provider
        android:name="androidx.startup.InitializationProvider"
        android:authorities="${applicationId}.androidx-startup"
        android:exported="false">
      <!-- Make SplitInitializer discoverable by InitializationProvider. -->
      <meta-data
          android:name="${applicationId}.SplitInitializer"
          android:value="androidx.startup" />
    </provider>
  </application>

</manifest>

Phím tắt cho quá trình khởi tạo

Nếu bạn muốn kết hợp cấu hình XML với các API WindowManager, để triển khai đơn giản hơn, bạn có thể loại bỏ trình khởi chạy thư viện Startup và trình cung cấp tệp kê khai.

Sau khi bạn tạo tệp cấu hình XML, hãy làm như sau:

Bước 1: Tạo lớp con của Application

Lớp con của ứng dụng của bạn sẽ là lớp đầu tiên được tạo thực thể khi quy trình cho ứng dụng được tạo. Bạn sẽ thêm các quy tắc phân tách vào RuleController trong phương thức onCreate() của lớp con để đảm bảo các quy tắc có hiệu lực trước khi chạy bất cứ hoạt động nào.

Trong Android Studio, hãy làm như sau:

  1. Nhấp chuột phải (nhấp nút phụ) vào thư mục nguồn của ứng dụng mẫu com.example.activity_embedding
  2. Chọn New > Kotlin Class/File (Mới > Lớp/tệp Kotlin) hoặc New > Java Class (Mới > Lớp Java)
  3. Đặt tên cho lớp là SampleApplication
  4. Nhấn phím Enter – Android Studio sẽ tạo lớp trong gói ứng dụng mẫu
  5. Mở rộng lớp này từ siêu kiểu Application

SampleApplication.kt

package com.example.activity_embedding

import android.app.Application

/**
 *