Hướng dẫn này mô tả cách bật tính năng phản hồi trong ứng dụng bằng cách sử dụng SDK Android Firebase App Distribution không bắt buộc để người kiểm thử có thể gửi phản hồi (bao gồm cả ảnh chụp màn hình) ngay trong ứng dụng.
Trước khi bắt đầu
Nếu bạn chưa thực hiện, hãy thêm Firebase vào dự án Android.
Bước 1: Bật API Trình kiểm thử App Distribution
Mở bảng điều khiển Google Cloud rồi chọn dự án Firebase của bạn.
Trong API Trình kiểm thử ứng dụng Firebase, hãy nhấp vào Bật.
Bước 2: Thêm App Distribution vào ứng dụng
SDK Android App Distribution bao gồm hai thư viện:
firebase-appdistribution-api: Thư viện chỉ dành cho API mà bạn có thể đưa vào tất cả biến thể bản dựng.firebase-appdistribution: Triển khai SDK đầy đủ (không bắt buộc).
Thư viện chỉ API cho phép mã của bạn thực hiện lệnh gọi đến SDK. Các lệnh gọi này sẽ không có hiệu lực nếu không có quá trình triển khai SDK đầy đủ.
Khai báo phần phụ thuộc cho SDK Android App Distribution trong tệp Gradle mô-đun (cấp ứng dụng) (thường là
<project>/<app-module>/build.gradle.ktshoặc<project>/<app-module>/build.gradle).Để tránh đưa chức năng tự cập nhật đầy đủ của quá trình triển khai SDK vào các bản dựng Google Play, hãy xác định các biến thể bản dựng, bao gồm cả loại bản dựng hoặc phiên bản sản phẩm mà bạn sẽ phân phối thông qua App Distribution.
Khai báo phần phụ thuộc cho SDK Android App Distribution trong tệp Gradle của mô-đun (ở cấp ứng dụng) (thường là
app/build.gradle). Chỉ thêm hoạt động triển khai SDK đầy đủ vào các biến thể dành riêng cho hoạt động kiểm thử trước khi phát hành:Kotlin+KTX
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta14") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta14") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14") }
Bước 3: Định cấu hình tính năng phản hồi trong ứng dụng
Để thu thập ý kiến phản hồi của người kiểm thử, hãy sử dụng một trong các trình kích hoạt sau để cho phép người kiểm thử bắt đầu phản hồi:
Trình kích hoạt thông báo tích hợp sẵn: SDK Android App Distribution có thể hiển thị một thông báo đang diễn ra mà người kiểm thử có thể nhấn vào từ bất kỳ vị trí nào trong ứng dụng. Hãy sử dụng trình kích hoạt này nếu bạn muốn bắt đầu nhanh hơn và không cần tuỳ chỉnh cách người kiểm thử đưa ra ý kiến phản hồi.
Trình kích hoạt tuỳ chỉnh: Bạn có thể cung cấp cơ chế kích hoạt của riêng mình, chẳng hạn như nhấn vào một nút hoặc mục trong trình đơn trong ứng dụng hoặc lắc thiết bị.
Khi bạn sử dụng một trong các trình kích hoạt này và người kiểm thử gửi phản hồi, SDK Android sẽ thực hiện các thao tác sau:
Chụp ảnh màn hình hoạt động hiện tại của ứng dụng.
Chạy các bước kiểm tra để đảm bảo người kiểm thử đã bật các tính năng kiểm thử của SDK. Nếu bạn không bật các tính năng kiểm thử, SDK Android sẽ nhắc người kiểm thử đăng nhập vào App Distribution bằng Tài khoản Google của họ.
Bắt đầu một hoạt động toàn màn hình cho phép người kiểm thử viết và gửi ý kiến phản hồi.
Cách 1: Trình kích hoạt thông báo
Sử dụng showFeedbackNotification() để hiển thị thông báo liên tục hoặc đang diễn ra trên thiết bị của người kiểm thử. Họ có thể nhấn vào thông báo này để bắt đầu phản hồi.
Khi định cấu hình thông báo, bạn cần cung cấp một số văn bản sẽ hiển thị cho người kiểm thử trước khi họ gửi ý kiến phản hồi và mức độ gián đoạn của thông báo (tương ứng với mức độ quan trọng của kênh thông báo). Nếu muốn thông báo cho người kiểm thử về việc thu thập và xử lý dữ liệu phản hồi của họ, bạn có thể sử dụng văn bản để thông báo như vậy.
Khi bạn sử dụng showFeedbackNotification() và khi ứng dụng chuyển sang chạy trong nền, thông báo sẽ bị ẩn. Nếu bạn muốn ẩn rõ ràng thông báo, hãy sử dụng cancelFeedbackNotification(). Bạn nên đặt showFeedbackNotification() trong onCreate() của hoạt động chính.
Kotlin+KTX
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
Firebase.appDistribution.showFeedbackNotification(
// Text providing notice to your testers about collection and
// processing of their feedback data
R.string.additionalFormText,
// The level of interruption for the notification
InterruptionLevel.HIGH)
}
}
Java
public class MainActivity extends AppCompatActivity {
FirebaseAppDistribution firebaseAppDistribution =
FirebaseAppDistribution.getInstance();
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
firebaseAppDistribution.showFeedbackNotification(
// Text providing notice to your testers about collection and
// processing of their feedback data
R.string.additionalFormText,
// The level of interruption for the notification
InterruptionLevel.HIGH);
}
}
Cách 2: Trình kích hoạt tuỳ chỉnh
Sử dụng phương thức startFeedback() để bắt đầu phản hồi bằng một cơ chế mà bạn chọn. Ví dụ: để kích hoạt phản hồi, bạn có thể thêm mục trình đơn "Gửi phản hồi" vào trình đơn thao tác của ứng dụng hoặc cho phép người kiểm thử lắc thiết bị hoặc chụp ảnh màn hình.
Khi bạn kích hoạt tính năng phản hồi, hãy cung cấp một số văn bản sẽ hiển thị cho người kiểm thử trước khi họ gửi phản hồi. Nếu muốn thông báo cho người kiểm thử về việc thu thập và xử lý dữ liệu phản hồi của họ, bạn có thể sử dụng văn bản này để thông báo.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
Bước 4: Tạo và kiểm thử quá trình triển khai
Kiểm thử cục bộ
Để kiểm thử cách triển khai mà không cần phải phân phối ứng dụng trước, hãy làm theo các bước sau:
Bật chế độ nhà phát triển trên thiết bị cục bộ:
adb shell setprop debug.firebase.appdistro.devmode true
Tạo ứng dụng dưới dạng biến thể phát hành trước bao gồm toàn bộ thư viện App Distribution và kiểm thử để đảm bảo bạn có thể kích hoạt phản hồi bằng cơ chế được triển khai trong Bước 3: Định cấu hình phản hồi trong ứng dụng. Ý kiến phản hồi sẽ không được gửi khi ở chế độ nhà phát triển.
Sau khi kiểm thử, bạn có thể tắt chế độ nhà phát triển trên thiết bị:
adb shell setprop debug.firebase.appdistro.devmode false
Kiểm thử toàn diện
Để kiểm thử xem ứng dụng của bạn có thể gửi phản hồi hay không, hãy tạo ứng dụng dưới dạng biến thể phát hành trước bao gồm toàn bộ thư viện App Distribution và kiểm thử quá trình triển khai theo các bước sau:
Tải bản phát hành ứng dụng mới lên App Distribution.
Phân phối bản phát hành ứng dụng cho một tài khoản mà bạn có quyền truy cập.
Tải ứng dụng xuống thông qua trang web của App Distribution hoặc ứng dụng kiểm thử Android.
Kích hoạt ý kiến phản hồi bằng cơ chế được triển khai trong Bước 3: Định cấu hình ý kiến phản hồi trong ứng dụng.
Đảm bảo bạn đã đăng nhập bằng chính tài khoản mà bạn đã phân phối bản phát hành ứng dụng và gửi ý kiến phản hồi.
Xem ý kiến phản hồi của bạn trong thẻ của bản phát hành mới trong bảng điều khiển Firebase.
Để tìm hiểu cách giải quyết các vấn đề thường gặp, chẳng hạn như người kiểm thử không thể bắt đầu phản hồi trong ứng dụng, hãy xem bài viết Bật các tính năng kiểm thử bằng SDK.
Bước 5: Quản lý ý kiến phản hồi của người kiểm thử
Sau khi cho phép người kiểm thử gửi ý kiến phản hồi, bạn có thể sử dụng các công cụ sau để xem xét và hành động dựa trên ý kiến phản hồi đó:
Xem và xoá ý kiến phản hồi trong bảng điều khiển Firebase
Bạn có thể xem lại và xoá ý kiến phản hồi của người dùng, bao gồm cả ảnh chụp màn hình, bằng cách mở thẻ Ý kiến phản hồi của người kiểm thử trong một bản phát hành cụ thể trên bảng điều khiển Firebase. Ý kiến phản hồi của người dùng được sắp xếp theo bản phát hành để bạn có thể xác nhận phiên bản áp dụng ý kiến phản hồi.
Sau khi xem xét ý kiến phản hồi của người dùng, bạn có thể xoá ý kiến phản hồi đó bằng cách nhấp vào nút Xoá ý kiến phản hồi. Ý kiến phản hồi đã xoá sẽ bị xoá khỏi bản phát hành.
Nhận thông báo qua email về ý kiến phản hồi mới
Để chủ động tìm hiểu ý kiến phản hồi mới của người kiểm thử, bạn có thể nhận được thông báo qua email khi người kiểm thử gửi ý kiến phản hồi. Cảnh báo qua email bao gồm ý kiến phản hồi bằng văn bản mà người kiểm thử cung cấp và đường liên kết đến mọi ảnh chụp màn hình mà họ gửi.
Để nhận thông báo qua email App Distribution thông qua cơ chế mặc định này, bạn phải có quyền firebase.projects.update. Theo mặc định, các vai trò sau đây sẽ có quyền bắt buộc này: Quản trị viên Firebase hoặc Chủ sở hữu hoặc Người chỉnh sửa dự án.
Theo mặc định, mọi thành viên của dự án có quyền cần thiết để nhận cảnh báo qua email sẽ nhận được email khi có báo cáo phản hồi mới được gửi. Các thành viên trong dự án có thể chọn không nhận các cảnh báo này.
Để tắt thông báo qua email, hãy xem bài viết Nhận thông báo của Firebase.
Gửi ý kiến phản hồi mới đến các công cụ của bên thứ ba
Bạn cũng có thể gửi cảnh báo App Distribution đến kênh thông báo ưu tiên của nhóm bằng Cloud Functions for Firebase. Ví dụ: bạn có thể viết một hàm ghi lại sự kiện cảnh báo cho ý kiến phản hồi mới trong ứng dụng và đăng thông tin cảnh báo lên một dịch vụ bên thứ ba như Discord, Slack hoặc Jira.
Để thiết lập các tính năng cảnh báo nâng cao bằng Cloud Functions for Firebase, hãy làm theo các bước sau:
Thiết lập Cloud Functions for Firebase, bao gồm các nhiệm vụ sau:
Tải Node.js và npm xuống.
Cài đặt và đăng nhập vào CLI Firebase.
Khởi động Cloud Functions for Firebase bằng CLI Firebase.
Viết và triển khai một hàm ghi lại sự kiện cảnh báo phản hồi trong ứng dụng từ App Distribution và xử lý tải trọng sự kiện (ví dụ: đăng thông tin cảnh báo trong một thông báo trên Discord).
Để xem một hàm mẫu hướng dẫn bạn cách gửi ý kiến phản hồi mới đến Jira, hãy tham khảo mẫu này.
Để tìm hiểu về tất cả sự kiện cảnh báo mà bạn có thể ghi lại, hãy xem tài liệu tham khảo về cảnh báo App Distribution.