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 của tính năng Phân phối ứng dụng Firebase để người kiểm thử có thể gửi ý kiến 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
Thêm Firebase vào dự án Android của bạn nếu bạn chưa thực hiện.
Bước 1: Bật API Người kiểm tra phân phối ứng dụng
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 tính năng Phân phối ứng dụng vào ứng dụng
SDK Android phân phối ứng dụng 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 trong mọi 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 cuộc gọi có sẽ không có hiệu lực nếu không triển khai SDK đầy đủ.
Khai báo phần phụ thuộc cho SDK Android phân phối ứng dụng 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 bao gồm chức năng tự cập nhật của quá trình triển khai SDK đầy đủ trong các bản dựng trên Google Play, hãy xác định các biến thể bản dựng, bao gồm 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 Phân phối ứng dụng.
Khai báo phần phụ thuộc cho SDK Android phân phối ứng dụng 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-beta13") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta13") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta13") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta13") }
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 phân phối ứng dụng có thể hiển thị một thông báo liên tục mà người kiểm thử có thể nhấn từ bất cứ vị trí nào trong ứng dụng. Sử dụng trình kích hoạt này nếu bạn muốn bắt đầu nhanh hơn và bạn không cần tuỳ chỉnh cách người kiểm thử cung cấp ý 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 thử nghiệm gửi phản hồi, SDK Android sẽ thực hiện những 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 Phân phối ứng dụng 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: Điều kiện kích hoạt thông báo
Sử dụng showFeedbackNotification() để hiển thị cố định hoặc
đang diễn ra
trên thiết bị của người thử nghiệm rằng họ có thể nhấn để 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
được hiển thị cho người thử nghiệm trước khi họ gửi phản hồi và cấp độ
gián đoạn cho thông báo (tương ứng với mức độ quan trọng của kênh thông báo). 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, bạn có thể sử dụng văn bản để đưa ra 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ô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
hãy đặt showFeedbackNotification() vào 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: Điều kiện 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ể muốn thêm
"Gửi phản hồi" mục trong trình đơn vào trình đơn thao tác của ứng dụng hoặc cho phép người thử nghiệm
lắc thiết bị
hoặc chụp ảnh màn hình.
Khi bạn kích hoạt ý kiến 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 gửi ý kiến 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ử kết quả 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ộ của bạn:
adb shell setprop debug.firebase.appdistro.devmode true
Tạo ứng dụng dưới dạng một biến thể bản phát hành trước bao gồm phiên bản Phân phối ứng dụng đầy đủ thư viện và kiểm thử xem bạn có thể kích hoạt phản hồi bằng cơ chế này hay không được triển khai trong Bước 3: Định cấu hình tính năng phản hồi trong ứng dụng. Ý kiến 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 tra xem ứng dụng của bạn có thể gửi phản hồi hay không, hãy tạo bản phát hành trước của ứng dụng bao gồm toàn bộ các thư viện Phân phối ứng dụng và kiểm thử theo các bước sau:
Tải bản phát hành ứng dụng mới lên tính năng Phân phối ứng dụng.
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 ứng dụng web hoặc ứng dụng kiểm thử Android của tính năng Phân phối ứng dụng.
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 tính năng phản hồi trong ứng dụng.
Hãy đả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 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 của 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 thử nghiệm không thể bắt đầu gửi ý kiến phản hồi trong ứng dụng, hãy xem phần Bật tính năng thử nghiệm 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 để xem xét và hành động dựa trên phản hồi đó:
Xem và xoá ý kiến phản hồi trong bảng điều khiển của 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 của 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 phản hồi của người dùng, bạn có thể xoá phản hồi đó bằng cách nhấp vào Nút Xoá ý kiến phản hồi. Phản hồi đã bị xoá sẽ bị loại bỏ 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 phản hồi mà người kiểm thử cung cấp và một đường liên kết đến mọi ảnh chụp màn hình mà họ gửi.
Để nhận cảnh báo qua email về Phân phối ứng dụng 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. Từng thành viên dự án có thể chọn không nhận các thông báo này.
Để tắt cảnh báo qua email, hãy xem Nhận cảnh báo 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 Phân phối ứng dụng tới thông báo ưu tiên của nhóm bằng Cloud Functions cho 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 tính năng cảnh báo nâng cao bằng Cloud Functions cho Firebase, hãy làm theo các bước sau:
Thiết lập Cloud Functions cho 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 Firebase CLI.
Khởi chạy Cloud Functions cho Firebase bằng CLI của 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ừ tính năng Phân phối ứng dụng 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ả các sự kiện cảnh báo mà bạn có thể nắm bắt, hãy xem tài liệu tham khảo tài liệu về cảnh báo Phân phối ứng dụng.