คู่มือนี้จะอธิบายวิธีเปิดใช้ความคิดเห็นในแอปโดยใช้ Firebase App DistributionAndroid SDK (ไม่บังคับ) เพื่อให้ผู้ทดสอบส่งความคิดเห็น (รวมถึงภาพหน้าจอ) ในแอปได้โดยตรง
ก่อนเริ่มต้น
เพิ่ม Firebase ลงในโปรเจ็กต์ Android หากยังไม่ได้ดำเนินการ
ขั้นตอนที่ 1: เปิดใช้ App Distribution Tester API
เปิดคอนโซล Google Cloud แล้วเลือกโปรเจ็กต์ Firebase
คลิกเปิดใช้ในส่วน Firebase App Testers API
ขั้นตอนที่ 2: เพิ่ม App Distribution ลงในแอป
Android SDK App Distribution ประกอบด้วยไลบรารี 2 รายการต่อไปนี้
firebase-appdistribution-api
: ไลบรารีแบบ API เท่านั้น ซึ่งคุณจะรวมไว้ในตัวแปรของบิลด์ทั้งหมดได้firebase-appdistribution
: การใช้งาน SDK เต็มรูปแบบ (ไม่บังคับ)
ไลบรารี API เท่านั้นช่วยให้โค้ดเรียกใช้ SDK ได้ การเรียกใช้จะไม่มีผลหากไม่มีการติดตั้งใช้งาน SDK แบบเต็ม
ประกาศทรัพยากร Dependency สำหรับ App Distribution Android SDK ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติจะเป็น
<project>/<app-module>/build.gradle.kts
หรือ<project>/<app-module>/build.gradle
)หากต้องการหลีกเลี่ยงการรวมฟังก์ชันการอัปเดตด้วยตนเองของการใช้งาน SDK แบบสมบูรณ์ในบิลด์ Google Play ให้ระบุตัวแปรของบิลด์ ซึ่งรวมถึงประเภทบิลด์หรือตัวแปรผลิตภัณฑ์ที่จะเผยแพร่ผ่าน App Distribution
ประกาศทรัพยากร Dependency สำหรับ App Distribution Android SDK ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยทั่วไปจะเป็น
app/build.gradle
) เพิ่มการติดตั้งใช้งาน SDK เวอร์ชันเต็มไปยังตัวแปรที่มีไว้สำหรับการทดสอบรุ่นทดลองโดยเฉพาะเท่านั้น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") }
ขั้นตอนที่ 3: กำหนดค่าความคิดเห็นในแอป
หากต้องการรวบรวมความคิดเห็นจากผู้ทดสอบ ให้ใช้ทริกเกอร์อย่างใดอย่างหนึ่งต่อไปนี้เพื่อเปิดใช้ให้ผู้ทดสอบเริ่มแสดงความคิดเห็น
ทริกเกอร์การแจ้งเตือนในตัว: App Distribution Android SDK สามารถแสดงการแจ้งเตือนอย่างต่อเนื่องที่ผู้ทดสอบแตะได้จากทุกที่ในแอป ใช้ทริกเกอร์นี้หากต้องการเริ่มต้นใช้งานอย่างรวดเร็วและไม่ต้องปรับแต่งวิธีที่ผู้ทดสอบจะให้ความคิดเห็น
ทริกเกอร์ที่กำหนดเอง: คุณระบุกลไกทริกเกอร์ของตัวเองได้ เช่น การแตะปุ่มหรือรายการในเมนูในแอปหรือการเขย่าอุปกรณ์
เมื่อคุณใช้ทริกเกอร์อย่างใดอย่างหนึ่งเหล่านี้และผู้ทดสอบส่งความคิดเห็น Android SDK จะดําเนินการต่อไปนี้
จับภาพหน้าจอของกิจกรรมปัจจุบันของแอป
ดำเนินการตรวจสอบเพื่อให้มั่นใจว่าผู้ทดสอบได้เปิดใช้ฟีเจอร์การทดสอบของ SDK แล้ว หากไม่ได้เปิดใช้ฟีเจอร์การทดสอบ Android SDK จะแจ้งให้ผู้ทดสอบลงชื่อเข้าใช้ App Distribution ด้วยบัญชี Google
เริ่มกิจกรรมแบบเต็มหน้าจอซึ่งช่วยให้ผู้ทดสอบเขียนและส่งความคิดเห็นได้
ตัวเลือกที่ 1: ทริกเกอร์การแจ้งเตือน
ใช้ showFeedbackNotification()
เพื่อแสดงการแจ้งเตือนแบบถาวรหรือต่อเนื่องในอุปกรณ์ของผู้ทดสอบ ซึ่งผู้ทดสอบสามารถแตะเพื่อเริ่มแสดงความคิดเห็นได้
เมื่อกำหนดค่าการแจ้งเตือน คุณต้องระบุข้อความที่จะแสดงต่อผู้ทดสอบก่อนที่จะส่งความคิดเห็น และระดับการขัดจังหวะของการแจ้งเตือน (สอดคล้องกับความสำคัญของช่องทางการแจ้งเตือน) หากต้องการแจ้งให้ผู้ทดสอบทราบเกี่ยวกับการเก็บรวบรวมและการประมวลผลข้อมูลความคิดเห็น คุณสามารถใช้ข้อความเพื่อแจ้งเตือนดังกล่าว
เมื่อคุณใช้ showFeedbackNotification()
และเมื่อแอปทำงานในเบื้องหลัง ระบบจะซ่อนการแจ้งเตือน หากต้องการซ่อนการแจ้งเตือนอย่างชัดเจน ให้ใช้ cancelFeedbackNotification()
เราขอแนะนำให้คุณใส่ showFeedbackNotification()
ใน onCreate()
ของกิจกรรมหลัก
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);
}
}
ตัวเลือกที่ 2: ทริกเกอร์ที่กําหนดเอง
ใช้วิธีการ startFeedback()
เพื่อเริ่มแสดงความคิดเห็นโดยใช้กลไกที่คุณเลือก ตัวอย่างเช่น หากต้องการเรียกให้แสดงความคิดเห็น คุณอาจต้องเพิ่มรายการเมนู "ส่งความคิดเห็น" ลงในเมนูการดำเนินการของแอป หรือให้ผู้ทดสอบเขย่าอุปกรณ์หรือถ่ายภาพหน้าจอ
เมื่อเรียกให้แสดงความคิดเห็น ให้ระบุข้อความที่จะแสดงต่อผู้ทดสอบก่อนที่จะส่งความคิดเห็น หากต้องการแจ้งให้ผู้ทดสอบทราบเกี่ยวกับการเก็บรวบรวมและการประมวลผลข้อมูลความคิดเห็น คุณสามารถใช้ข้อความนี้เพื่อแจ้งให้ทราบ
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
ขั้นตอนที่ 4: สร้างและทดสอบการใช้งาน
การทดสอบในเครื่อง
หากต้องการทดสอบการติดตั้งใช้งานโดยไม่ต้องเผยแพร่แอปก่อน ให้ทำตามขั้นตอนต่อไปนี้
เปิดใช้โหมดนักพัฒนาซอฟต์แวร์ในอุปกรณ์ภายในของคุณ
adb shell setprop debug.firebase.appdistro.devmode true
สร้างแอปเป็นตัวแปรรุ่นก่อนเผยแพร่ซึ่งมีApp Distribution ไลบรารีทั้งหมด และทดสอบว่าคุณสามารถเรียกให้แสดงความคิดเห็นได้โดยใช้กลไกที่ติดตั้งใช้งานในขั้นตอนที่ 3: กำหนดค่าความคิดเห็นในแอป ระบบจะไม่ส่งความคิดเห็นเมื่ออยู่ในโหมดนักพัฒนาซอฟต์แวร์
หลังจากทดสอบแล้ว คุณสามารถปิดใช้โหมดนักพัฒนาซอฟต์แวร์ในอุปกรณ์ได้โดยทำดังนี้
adb shell setprop debug.firebase.appdistro.devmode false
การทดสอบจากต้นทางถึงปลายทาง
หากต้องการทดสอบว่าแอปสามารถส่งความคิดเห็นได้ ให้สร้างแอปเป็นตัวแปรรุ่นก่อนเผยแพร่ซึ่งมีไลบรารี App Distribution ทั้งหมด และทดสอบการติดตั้งใช้งานโดยทำตามขั้นตอนต่อไปนี้
อัปโหลดแอปรุ่นใหม่ไปยัง App Distribution
เผยแพร่รุ่นของแอปไปยังบัญชีที่คุณมีสิทธิ์เข้าถึง
ดาวน์โหลดแอปผ่านเว็บของ App Distribution หรือแอปสำหรับทดสอบบน Android
ทริกเกอร์ความคิดเห็นโดยใช้กลไกที่ติดตั้งใช้งานในขั้นตอนที่ 3: กำหนดค่าความคิดเห็นในแอป
ตรวจสอบว่าคุณลงชื่อเข้าใช้ด้วยบัญชีเดียวกับที่ใช้เผยแพร่รุ่นของแอป และส่งความคิดเห็น
ดูความคิดเห็นในการ์ดของรุ่นใหม่ในFirebaseคอนโซล
ดูวิธีแก้ปัญหาที่พบได้ทั่วไป เช่น ผู้ทดสอบเริ่มแสดงความคิดเห็นในแอปไม่ได้ ได้ที่การเปิดใช้ฟีเจอร์การทดสอบด้วย SDK
ขั้นตอนที่ 5: จัดการความคิดเห็นของผู้ทดสอบ
หลังจากเปิดใช้ให้ผู้ทดสอบส่งความคิดเห็นแล้ว คุณจะใช้เครื่องมือต่อไปนี้เพื่อตรวจสอบและดำเนินการตามความคิดเห็นได้
ดูและลบความคิดเห็นในคอนโซล Firebase
คุณสามารถตรวจสอบและลบความคิดเห็นของผู้ใช้ รวมถึงภาพหน้าจอได้โดยเปิดแท็บความคิดเห็นของผู้ทดสอบในรุ่นที่ต้องการในคอนโซล Firebase ความคิดเห็นของผู้ใช้จะจัดระเบียบตามรุ่นเพื่อให้คุณยืนยันเวอร์ชันที่ใช้ความคิดเห็นได้
หลังจากตรวจสอบความคิดเห็นของผู้ใช้แล้ว คุณสามารถลบความคิดเห็นดังกล่าวได้โดยคลิกปุ่มลบความคิดเห็น ระบบจะนำความคิดเห็นที่ลบออกออกจากรุ่นของคุณ
รับการแจ้งเตือนทางอีเมลสำหรับความคิดเห็นใหม่
หากต้องการทราบข้อมูลเกี่ยวกับความคิดเห็นใหม่ของผู้ทดสอบอย่างสม่ำเสมอ คุณสามารถรับการแจ้งเตือนทางอีเมลเมื่อผู้ทดสอบส่งความคิดเห็น การแจ้งเตือนทางอีเมลจะมีความคิดเห็นที่เป็นลายลักษณ์อักษรที่ผู้ทดสอบให้ไว้และลิงก์ไปยังภาพหน้าจอที่ผู้ทดสอบส่ง
หากต้องการรับการแจ้งเตือนทางอีเมล App Distribution ผ่านกลไกเริ่มต้นนี้ คุณต้องมีสิทธิ์ firebase.projects.update
บทบาทต่อไปนี้มีสิทธิ์ที่จําเป็นนี้โดยค่าเริ่มต้น ได้แก่ ผู้ดูแลระบบ Firebase หรือเจ้าของหรือผู้แก้ไขโปรเจ็กต์
โดยค่าเริ่มต้น สมาชิกโปรเจ็กต์ทุกคนที่มีสิทธิ์ที่จำเป็นในการรับการแจ้งเตือนทางอีเมลจะได้รับอีเมลเมื่อมีการส่งรายงานความคิดเห็นใหม่ สมาชิกโปรเจ็กต์สามารถเลือกไม่รับการแจ้งเตือนเหล่านี้ได้ทีละคน
หากต้องการปิดใช้การแจ้งเตือนทางอีเมล โปรดดูรับการแจ้งเตือน Firebase
ส่งความคิดเห็นใหม่ไปยังเครื่องมือของบุคคลที่สาม
นอกจากนี้ คุณยังส่งApp Distributionการแจ้งเตือนไปยังช่องทางการแจ้งเตือนที่ต้องการของทีมได้โดยใช้ Cloud Functions for Firebase เช่น คุณสามารถเขียนฟังก์ชันที่บันทึกเหตุการณ์การแจ้งเตือนสําหรับความคิดเห็นใหม่ในแอป และโพสต์ข้อมูลการแจ้งเตือนไปยังบริการของบุคคลที่สาม เช่น Discord, Slack หรือ Jira
หากต้องการตั้งค่าความสามารถในการแจ้งเตือนขั้นสูงโดยใช้ Cloud Functions for Firebase ให้ทําตามขั้นตอนต่อไปนี้
ตั้งค่า Cloud Functions for Firebase ซึ่งประกอบด้วยงานต่อไปนี้
ดาวน์โหลด Node.js และ npm
ติดตั้งและลงชื่อเข้าใช้ Firebase CLI
เริ่มต้น Cloud Functions for Firebase โดยใช้ Firebase CLI
เขียนและติดตั้งใช้งานฟังก์ชันที่บันทึกเหตุการณ์การแจ้งเตือนความคิดเห็นในแอปจาก App Distribution และจัดการเพย์โหลดเหตุการณ์ (เช่น โพสต์ข้อมูลการแจ้งเตือนในข้อความบน Discord)
หากต้องการดูฟังก์ชันตัวอย่างที่แสดงวิธีส่งความคิดเห็นใหม่ไปยัง Jira โปรดไปที่ตัวอย่างนี้
หากต้องการดูข้อมูลเกี่ยวกับเหตุการณ์การแจ้งเตือนทั้งหมดที่คุณบันทึกได้ โปรดดูเอกสารอ้างอิงสำหรับการแจ้งเตือน App Distribution