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ở bảng điều khiển Google Cloud và 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 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 thực hiện lệnh gọi tới SDK. Lệnh gọi 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) của bạn (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 của quá trình triển khai SDK đầy đủ vào các bản dựng trên Google Play của bạn, 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 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 cách triển khai SDK đầy đủ vào các biến thể chỉ 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-beta12") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta12") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta12") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta12") }
Bước 3: Định cấu hình phản hồi trong ứng dụng
Để thu thập phản hồi từ những 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. 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 tùy chỉnh cách người thử nghiệm đưa ra 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, 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à người kiểm tra 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 kiểm tra đã kích hoạt các tính năng kiểm tra của SDK. Nếu các tính năng thử nghiệm không được bật thì 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 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: 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 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 tầm 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 chạy ở 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() vào 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 việc triển khai của bạn
Thử nghiệm cục bộ
Để kiểm tra việc triển khai của bạn 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
Xây dựng ứng dụng của bạn dưới dạng 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 kiểm tra, 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 từ đầu đến 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 xây dựng ứng dụng của bạn dưới dạng 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 việc 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 tới tài khoản mà bạn có quyền truy cập.
Tải xuống ứng dụng thông qua ứng dụng thử nghiệm Android hoặc web của Phân phối ứng dụng.
Kích hoạt phản hồi bằng cơ chế được triển khai ở Bước 3: Định cấu hình 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 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 sự cố thường gặp, 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 Bật 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 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 lại 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 thử nghiệm 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ấn 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 của người thử nghiệm mới, bạn có thể nhận thông báo qua email khi người thử nghiệm gửi phản hồi. Cảnh báo qua email bao gồm phản hồi bằng văn bản mà người thử nghiệm 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 qua email 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 . 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 dự án hoặc Người chỉnh sửa .
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 có 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 Firebase .
Gửi phản hồi mới tới 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 tới kênh thông báo ưa thích của nhóm mình bằ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 để nhận 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 Cloud Functions 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 các chức năng đám mây cho Firebase bằng Firebase CLI.
Viết và triển khai chức năng ghi lại 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ý trọng tải sự kiện (ví dụ: đăng thông tin cảnh báo trong tin nhắn trên Discord).
Để xem chức năng mẫu 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 .