คู่มือนี้จะอธิบายวิธีเปิดใช้ความคิดเห็นในแอปโดยใช้ตัวเลือก Android SDK Firebase App Distribution เพื่อให้ผู้ทดสอบส่งความคิดเห็นได้ (รวมถึงภาพหน้าจอ) ในแอปได้โดยตรง
ก่อนเริ่มต้น
เพิ่ม Firebase ลงในโปรเจ็กต์ Android หากยังไม่ได้ทำ
ขั้นตอนที่ 1: เปิดใช้ Tester API ของ App Distribution
เปิดคอนโซล 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 สำหรับ Android SDK App Distribution ใน โมดูล (ระดับแอป) ไฟล์ Gradle (ปกติคือ
<project>/<app-module>/build.gradle.kts
หรือ<project>/<app-module>/build.gradle
)เพื่อหลีกเลี่ยงการรวมฟังก์ชันการอัปเดตตนเองของการใช้งาน SDK อย่างเต็มรูปแบบ ในบิลด์ของ Google Play ให้ระบุตัวแปรของบิลด์ ซึ่งรวมถึง ประเภทบิลด์ หรือรสชาติของผลิตภัณฑ์ ที่คุณจะเผยแพร่ผ่าน App Distribution
ประกาศทรัพยากร Dependency สำหรับ Android SDK App Distribution ใน ไฟล์ 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-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") }
ขั้นตอนที่ 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