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.
Bản nâng cấp lớn cho hệ điều hành Android có thể gây khó chịu 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.
Để bật tính năng Nhóm nâng cấp cho hệ điều hành Android, hãy đăng ký bằng biểu mẫu Yêu cầu kích hoạt Nhóm nâng cấp Android.
Tuỳ chỉnh trải nghiệm của Nhóm nâng cấp
Bạn có thể tuỳ chỉnh trải nghiệm của Tiệc nâng cấp 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 các nguyên tắc trong Hướng dẫn về phong cách của Upgrade Party và thêm thông tin tuỳ chỉnh của bạn vào biểu mẫu Yêu cầu kích hoạt Upgrade Party trên Android.
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 luồng hiện 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 nhiều màu
- 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 con 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.
- Điện thoại giảm kích thước. Các hình dạng bắt đầu nhập vào màn hình.
- Ảnh động đã hoàn tất. Các hình dạng liên 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 về quy trình của từng tính năng, bao gồm cả các tương tác chạm. Xuất bản ghi dưới dạng tệp Lottie.
Màn hình ngoài
Màn hình ngoài sẽ hoàn tất luồng. 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 độ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.
- Hình dạng hiện ra ở phía sau chiếc điện thoại di động.
- Các hình dạng bay ra khỏi nền như 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 luồng 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:
minSdkVersiontừ 14 trở lêncompileSdkVersion28 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
UpgradePartyvà đặ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 dự kiến 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 yêu cầu không được xử lý kịp thời.API_NOT_CONNECTED: Có nghĩa là API chưa có sẵn (ví dụ: mô-đunUpgradePartychư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 nhóm
Hãy làm theo các bước sau để kiểm thử quy trình Bên nâng cấp mà người dùng của bạn 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.