Hướng dẫn này mô tả cách bật phản hồi trong ứng dụng bằng SDK Android phân phối ứng dụng Firebase tùy chọn để người thử nghiệm của bạn có thể gửi phản hồi (bao gồm cả ảnh chụp màn hình) trực tiếp trong ứng dụng.
Trước khi bắt đầu
Nếu bạn chưa có, hãy thêm Firebase vào dự án Android của bạn .
Bước 1: Kích hoạt API Trình kiểm tra phân phối ứng dụng
Mở Google Cloud Console và chọn dự án Firebase của bạn.
Trong API Trình kiểm tra ứng dụng Firebase, hãy nhấp vào Bật .
Bước 2: Thêm Phân phối ứng dụng vào ứng dụng của bạn
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 tất cả các biến thể bản dựng . -
firebase-appdistribution: Triển khai SDK đầy đủ (tùy chọn).
Thư viện chỉ dành cho API cho phép mã của bạn gọi SDK. Các cuộc gọi không có hiệu lực nếu không có triển khai SDK đầy đủ.
Để tránh đưa chức năng tự cập nhật của việc triển khai SDK đầy đủ vào các bản dựng Google Play của bạn, hãy xác định các biến thể bản dựng, bao gồm các loại bản dựng hoặc hương vị 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) của bạn (thường là
app/build.gradle). Chỉ thêm triển khai SDK đầy đủ vào 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-beta08' // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation 'com.google.firebase:firebase-appdistribution:16.0.0-beta08' }Java
dependencies { // ADD the API-only library to all variants implementation 'com.google.firebase:firebase-appdistribution-api:16.0.0-beta08' // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation 'com.google.firebase:firebase-appdistribution:16.0.0-beta08' }
Bước 3: Định cấu hình phản hồi trong ứng dụng
Để thu thập phản hồi từ người thử nghiệm của bạn, hãy sử dụng một trong các trình kích hoạt sau để cho phép người thử nghiệm bắt đầu phản hồi:
Trình kích hoạt thông báo tích hợp : SDK Android Phân phối ứng dụng có thể hiển thị thông báo liên tục mà người thử nghiệm có thể nhấn từ bất kỳ đâu 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 tùy chỉnh cách người thử nghiệm cung cấp phản hồi.
Trình kích hoạt tùy 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 nút hoặc mục menu trong ứng dụng của bạn hoặc lắc thiết bị.
Khi bạn sử dụng một trong hai trình kích hoạt này và trình thử nghiệm gửi phản hồi, SDK Android sẽ thực hiện các hành động sau:
Chụp ảnh màn hình hoạt động hiện tại của ứng dụng.
Chạy kiểm tra để đảm bảo người thử nghiệm đã bật các tính năng thử nghiệm của SDK. Nếu các tính năng thử nghiệm không được bật, SDK Android sẽ nhắc người thử nghiệm đăng nhập 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 tra viết và gửi phản hồi của họ.
Tùy chọn 1: 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 liên tục trên thiết bị của người thử nghiệm mà 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 sẽ được hiển thị cho người kiểm tra trước khi họ gửi 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 bạn muốn cung cấp thông báo cho người thử nghiệm 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 để cung cấp thông báo như vậy.
Khi bạn sử dụng showFeedbackNotification() và khi ứng dụng chuyển sang chế độ nền, thông báo sẽ bị ẩn. Nếu bạn muốn ẩn thông báo một cách rõ ràng, hãy sử dụng cancelFeedbackNotification() . Chúng tôi khuyên bạn nên đặt showFeedbackNotification() trong onCreate() của hoạt động chính của mì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);
}
}
Tùy chọn 2: Trình kích hoạt tùy chỉnh
Sử dụng phương thức startFeedback() để bắt đầu phản hồi bằng cơ chế bạn chọn. Ví dụ: để kích hoạt phản hồi, bạn có thể muốn thêm mục menu "Gửi phản hồi" vào menu hành động của ứng dụng hoặc để người thử nghiệm lắc thiết bị của họ hoặc chụp ảnh màn hình . Khi bạn kích hoạt phản hồi, hãy cung cấp một số văn bản sẽ được hiển thị cho người kiểm tra trước khi họ gửi phản hồi. Nếu bạn muốn cung cấp thông báo cho người thử nghiệm 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 để cung cấp 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à thử nghiệm triển khai của bạn
thử nghiệm cục bộ
Để kiểm tra triển khai của bạn mà không 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
Xây dựng ứng dụng của bạn dưới dạng một biến thể phát hành trước bao gồm các thư viện Phân phối ứng dụng đầy đủ và kiểm tra xem bạn có thể kích hoạt phản hồi bằng cách sử dụng cơ chế được triển khai trong Bước 3: Định cấu hình phản hồi trong ứng dụng hay không . Phản hồi 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
Thử nghiệm đầu cuối
Để 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 ứng dụng của bạn dưới dạng một biến thể phát hành trước bao gồm các thư viện Phân phối ứng dụng đầy đủ và thử nghiệm triển khai của bạn theo các bước sau:
Tải bản phát hành ứng dụng mới lên Phân phối ứng dụng.
Phân phối bản phát hành ứng dụng cho tài khoản mà bạn có quyền truy cập.
Tải xuống ứng dụng thông qua trang web của Phân phối ứng dụng hoặc ứng dụng thử nghiệm Android.
Kích hoạt phản hồi bằng cách sử dụng cơ chế được triển khai trong Bước 3: Định cấu hình phản hồi trong ứng dụng .
Đảm bảo rằng 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 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 Firebase .
Để tìm hiểu cách giải quyết các vấn đề phổ biến, chẳng hạn như người thử nghiệm không thể bắt đầu phản hồi trong ứng dụng, hãy xem Kích hoạt các tính năng thử nghiệm bằng SDK .
Bước 5: Quản lý phản hồi của người thử nghiệm
Sau khi bạn cho phép người thử nghiệm gửi 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 phản hồi đó:
Xem và xóa phản hồi trong bảng điều khiển Firebase
Bạn có thể xem xét và xóa 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ở tab Phản hồi của người kiểm tra trong một bản phát hành cụ thể trong bảng điều khiển Firebase. 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 phản hồi.
Sau khi xem xét phản hồi của người dùng, bạn có thể xóa phản hồi đó bằng cách nhấp vào nút Xóa phản hồi . Phản hồi đã xóa sẽ bị xóa khỏi bản phát hành của bạn.
Nhận thông báo qua email về phản hồi mới
Để chủ động tìm hiểu về phản hồi mới của người thử nghiệm, bạn có thể nhận thông báo qua email khi người thử nghiệm gửi phản hồi. Thông báo qua email bao gồm phản hồi bằng văn bản mà người kiểm tra của bạn đã cung cấp và liên kết tới bất kỳ ảnh chụp màn hình nào họ đã gửi.
Để nhận thông báo email Phân phối ứng dụ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 bao gồm 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 dự án 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 dự án có thể chọn không tham gia các cảnh báo này.
Để tắt thông báo qua email, hãy xem Nhận thông báo về Firebase .
Gửi phản hồi mới cho các công cụ của bên thứ ba
Bạn cũng có thể gửi thông báo Phân phối ứng dụng đến kênh thông báo ưa thích của nhóm mình bằng cách sử dụng Chức năng đám mây cho Firebase. Ví dụ: bạn có thể viết một hàm ghi lại sự kiện cảnh báo cho phản hồi mới trong ứng dụng và đăng thông tin cảnh báo lên dịch vụ của bên thứ ba như Discord, Slack hoặc Jira.
Để thiết lập khả năng cảnh báo nâng cao bằng Chức năng đám mây cho Firebase, hãy làm theo các bước sau:
Thiết lập Chức năng đám mây cho Firebase , bao gồm các tác vụ sau:
Tải xuống Node.js và npm.
Cài đặt và đăng nhập vào Firebase CLI.
Khởi tạo Chức năng đám mây cho Firebase bằng Firebase CLI.
Viết và triển khai một chức năng nắm bắt sự kiện cảnh báo phản hồi trong ứng dụng từ 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 thông báo trên Discord).
Để xem chức năng ví dụ chỉ cho bạn cách gửi phản hồi mới tới 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 về cảnh báo Phân phối ứng dụng .