คู่มือนี้จะอธิบายวิธีเปิดใช้ความคิดเห็นในแอปโดยใช้ Firebase App DistributionAndroid SDK (ไม่บังคับ) เพื่อให้ผู้ทดสอบส่งความคิดเห็น (รวมถึงภาพหน้าจอ) ในแอปได้โดยตรง
ก่อนเริ่มต้น
เพิ่ม Firebase ลงในโปรเจ็กต์ Android หากยังไม่ได้ดำเนินการ
ขั้นตอนที่ 1: เปิดใช้ App Distribution Tester API
เปิดคอนโซล Google Cloud แล้วเลือกโปรเจ็กต์ Firebase
คลิกเปิดใช้ในส่วน Firebase App Testers API
ขั้นตอนที่ 2: เพิ่ม App Distribution ลงในแอป
App Distribution Android SDK ประกอบด้วยไลบรารี 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
เผยแพร่รุ่นของแอปไปยังบัญชีที่คุณมีสิทธิ์เข้าถึง
ดาวน์โหลดแอปผ่านเว็บหรือแอปทดสอบ Android ของ App Distribution
เรียกใช้ความคิดเห็นโดยใช้กลไกที่ใช้งานใน ขั้นตอนที่ 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