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 Người kiểm tra ứ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.kts
hoặ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 mô-đun (cấp ứng dụng) (thường là
app/build.gradle
). Chỉ thêm triển khai SDK đầy đủ cho các biến thể dành riêng cho thử nghiệm 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 từ người kiểm thử, hãy sử dụng một trong các điều kiện kích hoạt sau để cho phép người kiểm thử gửi ý kiến 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 tùy chỉnh: Bạn có thể cung cấp trình kích hoạt của riêng mình cơ chế, chẳng hạn như nhấn vào 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 ý kiến phản hồi, SDK Android sẽ thực hiện các thao tác sau:
Chụp ảnh màn hình về 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 các tính năng thử nghiệm chưa được bật, SDK Android sẽ nhắc người thử nghiệm ký 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 đến
nền thì thông báo sẽ bị ẩn. Nếu bạn muốn ẩn rõ ràng
thông báo đó, hãy 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 cơ chế
lựa 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 bạn 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ì đưa ra thông báo như vậy.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
Bước 4: Xây dựng và kiểm thử kết quả 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. Phản hồi là không được gửi khi ở chế độ nhà phát triển.
Sau khi thử nghiệm, bạn có thể tắt chế độ nhà phát triển trên thiết bị của mình:
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 ý kiến 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 đó tới 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 thử nghiệm
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á phản hồi của người dùng, bao gồm ảnh chụp màn hình, bằng cách mở thẻ Phản hồi của nhân viên kiểm thử trong một bản phát hành cụ thể trong 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 mà ý kiến phản hồi áp dụng.
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 khi có ý kiến phản hồi mới
Để chủ động tìm hiểu thêm về phản hồi của người thử nghiệm mới, bạn có thể nhận được 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 App Distribution cảnh báo qua email thông qua cơ chế mặc định này, bạn phải có
quyền firebase.projects.update
. Sau đây là những vai trò
quyền cần thiết theo mặc định: Quản trị viên Firebase
hoặc dự án Chủ sở hữu hoặc Người chỉnh sửa.
Theo mặc định, mọi thành viên của dự án có các quyền cần thiết để nhận thông báo qua email sẽ nhận được email khi 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 ghi lại một sự kiện thông báo về phản hồi mới trong ứng dụng và đăng thông tin cho một dịch vụ của 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 những việc 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 hàm ghi lại một 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 phản hồi mới cho 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.