Upgrade Party là một quy trình khám phá làm nổi bật các tính năng mới cho người dùng Android mỗi khi họ nhận được bản nâng cấp hệ điều hành lớn.
Việc nâng cấp hệ điều hành Android lớn có thể gây ra trải nghiệm không như mong đợi cho người dùng. Quy trình Upgrade Party giúp tăng mức độ tương tác của người dùng và giúp người dùng hiểu cách sử dụng hệ điều hành mới được làm mới.
Sau khi nâng cấp lên phiên bản hệ điều hành mới nhất, người dùng sẽ nhận được thông báo đẩy chào mừng họ đến với hệ điều hành mới và giới thiệu quy trình thẻ với các tính năng mới.
Nhà sản xuất thiết bị có thể bật tính năng Upgrade Party cho các thiết bị chạy hệ điều hành Android bằng cách gửi biểu mẫu Yêu cầu kích hoạt Upgrade Party cho Android.
Tuỳ chỉnh trải nghiệm Nhóm nâng cấp
Bạn có thể tuỳ chỉnh trải nghiệm của chương trình Nâng cấp cho nhóm theo các cách sau:
- Xoá các tính năng không liên quan.
- Cập nhật ngôn ngữ trong các khối văn bản.
- Sửa đổi ảnh động, màu sắc và phông chữ cho phù hợp với thương hiệu của bạn.
Để tuỳ chỉnh quy trình, hãy xem lại các nguyên tắc trong Hướng dẫn về phong cách của Lượt nâng cấp và đưa thông tin tuỳ chỉnh vào nội dung phản hồi của biểu mẫu.
Hướng dẫn về kiểu lời mời nâng cấp
Hãy sử dụng hướng dẫn về kiểu này để sửa đổi giao diện của lời mời nâng cấp cho phù hợp với thương hiệu của riêng bạn (màn hình, màu sắc, phông chữ). Bạn nên giữ kích thước và cấu trúc gần giống với thiết kế ban đầu.
Quy trình Gửi lời mời nâng cấp có 3 thành phần sau:
- Màn hình giới thiệu
- Màn hình tính năng
- Màn hình kết thúc
Ảnh động trên mỗi màn hình giúp giải thích từng tính năng.
Màn hình giới thiệu
Màn hình giới thiệu chứa một ảnh động ngắn chào mừng người dùng và khuyến khích họ bắt đầu quy trình hiển thị trên màn hình giới thiệu.
Bố cục

Ảnh động của thiết bị luôn bao gồm:
- Nền trắng và các hình dạng đầy màu sắc
- Khung thiết bị
- Nội dung giao diện người dùng
Tạo kiểu
Nếu chọn điều chỉnh kiểu Material You, bạn có thể sử dụng màu sắc và hình dạng mặc định như trong ví dụ.

Nếu bạn sử dụng màu thương hiệu của riêng mình, hãy đảm bảo rằng màu đó phù hợp với nền giao diện người dùng.
Chuyển động
Lựa chọn 1: Có đồng hồ trên màn hình chính
- Các số sẽ xuất hiện trên màn hình.
- Các số di chuyển vào giữa trong khi giảm kích thước. Khung điện thoại di động sẽ xuất hiện.
- Kích thước điện thoại giảm. Các hình dạng bắt đầu xuất hiện trên màn hình.
- Ảnh động đã hoàn tất. Các hình dạng tiếp tục di chuyển nhẹ nhàng.
![]() |
![]() |
Cách 2: Không có đồng hồ trên màn hình chính
- Điện thoại di động xuất hiện trên màn hình.
- Điện thoại di chuyển vào giữa trong khi tăng kích thước. Các hình dạng bắt đầu đi vào màn hình.
- Điện thoại đạt đến kích thước tối đa và các hình dạng tiếp tục di chuyển.
![]() |
![]() |
Màn hình tính năng
Mỗi màn hình tính năng sẽ làm nổi bật một tính năng trong hệ điều hành mới.
Bố cục

Ảnh động của thiết bị luôn bao gồm:
- Nền đầy màu sắc
- Khung thiết bị
- Nội dung giao diện người dùng
Tạo kiểu
- Chọn màu nền phù hợp với nội dung giao diện người dùng và giao diện tổng thể.
- Bên trong màn hình, hãy đặt cỡ chữ dễ đọc. Nếu cần, hãy đặt cỡ chữ lớn hơn.
Chuyển động
Ghi lại ảnh động của luồng của từng tính năng, bao gồm cả các hoạt động tương tác bằng thao tác chạm. Xuất bản ghi dưới dạng tệp Lottie.
Màn hình kết thúc
Màn hình kết thúc hoàn tất quy trình. Nó cho người dùng biết rằng họ đã xem qua tất cả màn hình.
Bố cục

Ảnh động của thiết bị luôn bao gồm:
- Hình bán nguyệt trên nền (cùng với các hình dạng ảnh động)
- Khung thiết bị
- Nội dung giao diện người dùng
Tạo kiểu
- Chọn màu nền phù hợp với nội dung giao diện người dùng và giao diện tổng thể.
- Sử dụng hình bán nguyệt.
Chuyển động
Làm theo quy trình ảnh động tiêu chuẩn cho màn hình kết thúc:
- Điện thoại di động di chuyển lên một chút.
- Một vòng tròn sẽ xuất hiện ở chế độ nền.
- Các hình dạng xuất hiện từ phía sau điện thoại di động.
- Các hình dạng bay ra khỏi nền như pháo hoa giấy.
![]() |
![]() |
Kích hoạt Upgrade Party bằng SDK
Theo mặc định, hệ điều hành Android sẽ gửi cho người dùng một thông báo đẩy giới thiệu quy trình thẻ với các tính năng mới nhất ngay khi họ nâng cấp. Nếu bạn muốn kích hoạt luồng từ thông báo đẩy của riêng mình hoặc một ứng dụng, hãy sử dụng SDK Android.
Điều kiện tiên quyết
Hãy đảm bảo tệp bản dựng của ứng dụng sử dụng các giá trị sau:
minSdkVersion
từ 14 trở lêncompileSdkVersion
28 trở lên
Định cấu hình ứng dụng
- Giải nén thư viện từ tệp Zip được cung cấp rồi đặt thư viện đó vào kho lưu trữ của bạn.
Thêm các phần phụ thuộc cho SDK Google Growth vào tệp Gradle ở cấp ứng dụng trong mô-đun của bạn, thường là
app/build.gradle
:dependencies { implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar') }
Thêm các thư viện sau làm phần phụ thuộc:
com.google.android.gms:play-services-base:18.0.1 com.google.android.gms:play-services-basement:18.0.0 com.google.android.gms:play-services-tasks:18.0.1
Sử dụng API
Để khởi chạy ứng dụng, hãy sử dụng lớp
UpgradeParty
và đặt tham sốactivity
.import com.google.android.gms.growth.UpgradeParty; UpgradeParty.getClient(activity);
UpgradePartyClient
thu được sẽ hiển thị chức năng API.
isEligibleForUpgradeParty
Task<Boolean> isEligibleForUpgradeParty();
Trả về một đối tượng Task
xác minh không đồng bộ xem người dùng có đủ điều kiện tham gia một Lễ nâng cấp hay không. Giá trị boolean thu được cho biết người dùng có đủ điều kiện hay không.
invokeUpgradeParty
Task<Void> invokeUpgradeParty();
Gọi một Upgrade Party Activity
. Đối tượng Task
thu được cho biết liệu có lỗi xảy ra khi bắt đầu hoạt động hay không.
Lỗi
Cả hai phương thức API đều có thể không thành công với một ngoại lệ thuộc loại com.google.android.gms.common.api.ApiException
. Trong những trường hợp như vậy, phương thức gọi sẽ thử lại sau.
Sau đây là các mã trạng thái phổ biến dự kiến:
INTERNAL_ERROR
: Biểu thị mọi lỗi trong luồng logic cơ bản.TIMEOUT
: Xuất hiện khi không thể xử lý yêu cầu kịp thời.API_NOT_CONNECTED
: Có nghĩa là API không có sẵn (ví dụ: mô-đunUpgradeParty
chưa sẵn sàng).DEVELOPER_ERROR
: Xuất hiện khi gói gọi không được phép truy cập vào lớpUpgradeParty
.
Ví dụ về SDK
Hãy xem ví dụ sau về một ứng dụng gọi SDK:
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import com.google.android.gms.growth.UpgradeParty;
import com.google.android.gms.growth.UpgradePartyClient;
public class SampleActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
final UpgradePartyClient client = UpgradeParty.getClient(this);
// Hide the invocation button initially
View startUpgradePartyButton = findViewById(R.id.__some_button__);
startUpgradePartyButton.setVisibility(View.GONE);
// Register an onClick handler to invoke the Upgrade Party Activity
startUpgradePartyButton
.setOnClickListener(
view -> {
client
.invokeUpgradeParty()
.addOnCompleteListener(
task -> {
if (!task.isSuccessful()) {
// Do something with error, see task.getException()
}
});
});
}
// Check if eligible for an Upgrade Party
client
.isEligibleForUpgradeParty()
.addOnCompleteListener(
task -> {
if (!task.isSuccessful()) {
// Do something with error, see task.getException()
} else {
// Show/Hide invocation button, based on the result
int visibility =
task.getResult() ? View.VISIBLE : View.GONE;
startUpgradePartyButton..setVisibility(visibility);
}
});
}
Kiểm thử quy trình Nâng cấp gói
Hãy làm theo các bước sau để kiểm thử quy trình Upgrade Party mà người dùng nhìn thấy khi nâng cấp hệ điều hành Android:
- Trên thiết bị Android thử nghiệm, hãy chuyển đến phần Cài đặt > Google > Gỡ lỗi bên nâng cấp.
- Chọn Báo cáo nâng cấp, rồi chọn Mở bên nâng cấp. Thao tác này sẽ bắt đầu quy trình liên quan, dựa trên phiên bản hệ điều hành của thiết bị. Ví dụ: Android 12 Upgrade Party phát trên một thiết bị chạy hệ điều hành Android 12.