แจ้งผู้ทดสอบเกี่ยวกับงานสร้างใหม่

SDK ของ Firebase App Distribution สำหรับ iOS และ Android ให้คุณแสดงการแจ้งเตือนในแอปแก่ผู้ทดสอบเมื่อแอปเวอร์ชันใหม่พร้อมให้ติดตั้ง คู่มือนี้อธิบายวิธีใช้ App Distribution iOS และ Android SDK เพื่อสร้างและปรับแต่งการแจ้งเตือนบิวด์ใหม่สำหรับผู้ทดสอบของคุณ

ก่อนที่คุณจะเริ่มต้น

หากคุณยังไม่ได้ ดำเนินการ ให้เพิ่ม Firebase ในโครงการ Android ของคุณ

ขั้นตอนที่ 1 : เปิดใช้งาน App Distribution Tester API

1. เลือกโครงการของคุณใน Google Cloud Console

2. ใต้ Firebase App Testers API ให้คลิก เปิดใช้

ขั้นตอนที่ 2 : เพิ่ม App Distribution ในแอพของคุณ

App Distribution Android SDK ประกอบด้วยสองไลบรารี:

• firebase-appdistribution-api - ไลบรารี่เฉพาะ API ซึ่งคุณสามารถรวมไว้ใน รุ่นบิลด์ ทั้งหมด
• firebase-appdistribution - การใช้งาน SDK แบบเต็ม (ไม่บังคับ)

ไลบรารีเฉพาะ API ช่วยให้รหัสของคุณทำการเรียกไปยัง SDK การเรียกจะไม่มีผลหากไม่มีการใช้งาน SDK แบบเต็ม

ประกาศการพึ่งพาสำหรับ App Distribution Android SDK ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติจะเป็น <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle ). หากต้องการหลีกเลี่ยงการรวมฟังก์ชันการอัปเดตด้วยตนเองของการติดตั้งใช้งาน SDK แบบสมบูรณ์ในบิลด์ Play ของคุณ ให้เพิ่มการพึ่งพาไลบรารีเฉพาะ API ให้กับ ตัวแปรบิวด์ ทั้งหมด เพิ่มเฉพาะการใช้งาน SDK แบบสมบูรณ์ให้กับตัวแปรที่มีไว้สำหรับการทดสอบก่อนเผยแพร่เท่านั้น:

dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta10")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta10")
}

dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta10")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta10")
}

ขั้นตอนที่ 3 : กำหนดค่าการแจ้งเตือนในแอป

App Distribution Android SDK มีวิธีต่อไปนี้ในการตั้งค่าการแจ้งเตือนบิวด์ในแอปสำหรับผู้ทดสอบของคุณ:

• การกำหนดค่าการแจ้งเตือนพื้นฐานที่มาพร้อมกับการอัปเดตแอปที่สร้างไว้ล่วงหน้าและกล่องโต้ตอบการลงชื่อเข้าใช้เพื่อแสดงต่อผู้ทดสอบ
• การกำหนดค่าการแจ้งเตือนขั้นสูงที่ให้คุณปรับแต่งส่วนต่อประสานผู้ใช้ของคุณเอง

หากคุณใช้ Android SDK ของ App Distribution เป็นครั้งแรก เราขอแนะนำให้ใช้ การกำหนดค่าพื้นฐาน

การกำหนดค่าพื้นฐาน

ใช้ updateIfNewReleaseAvailable เพื่อแสดงกล่องโต้ตอบการเปิดใช้งานการแจ้งเตือนที่สร้างไว้ล่วงหน้าแก่ผู้ทดสอบที่ยังไม่ได้เปิดใช้งานการแจ้งเตือน จากนั้นตรวจสอบว่ามีการสร้างใหม่หรือไม่ เมื่อเรียก เมธอดจะแสดงลำดับต่อไปนี้:

1. ตรวจสอบว่าผู้ทดสอบเปิดใช้งานการแจ้งเตือนหรือไม่ หากผู้ทดสอบยังไม่ได้เปิดใช้งานการแจ้งเตือน วิธีการจะแจ้งให้ผู้ทดสอบลงชื่อเข้าใช้ App Distribution ด้วยบัญชี Google ของตน

2. ตรวจสอบการสร้างใหม่ที่มีอยู่เพื่อให้ผู้ทดสอบติดตั้ง

3. แสดงการแจ้งเตือนที่สร้างไว้ล่วงหน้าพร้อมท์ให้ผู้ทดสอบอัปเดต

4. หากบิลด์ใหม่เป็น Android App Bundle (AAB) ให้เปลี่ยนเส้นทางผู้ทดสอบไปที่ Google Play เพื่อดำเนินการอัปเดตให้เสร็จสิ้น

   หากบิลด์ใหม่เป็นแอปพลิเคชัน Android PacKage (APK) SDK จะดาวน์โหลดบิลด์ใหม่ในเบื้องหลังและแจ้งให้ผู้ทดสอบติดตั้งเมื่อการดาวน์โหลดเสร็จสิ้น SDK จะส่งการแจ้งเตือนความคืบหน้าการดาวน์โหลดไปยังผู้ใช้โดยใช้ NotificationManager คุณยังสามารถเพิ่มตัวบ่งชี้ความคืบหน้าของคุณเองได้ด้วยการแนบตัวจัดการ onProgressUpdate เข้ากับงาน updateIfNewReleaseAvailable

คุณสามารถเรียก updateIfNewReleaseAvailable ได้ทุกเมื่อในแอปของคุณ ตัวอย่างเช่น คุณสามารถเรียกใช้ updateIfNewReleaseAvailable ระหว่างเมธอด onResume ของกิจกรรมหลักของแอป

ตัวอย่างต่อไปนี้จะตรวจสอบว่าผู้ทดสอบเปิดใช้งานการแจ้งเตือนและมีสิทธิ์เข้าถึงบิลด์ใหม่หรือไม่ หากตรงตามเงื่อนไขเหล่านี้ กล่องโต้ตอบจะปรากฏขึ้นเมื่อรุ่นพร้อมให้ติดตั้ง:

// Copy and paste this into any part of your app - for example, in your main
// activity's onResume method.
val firebaseAppDistribution = FirebaseAppDistribution.getInstance()
firebaseAppDistribution.updateIfNewReleaseAvailable()
    .addOnProgressListener { updateProgress ->
      // (Optional) Implement custom progress updates in addition to
      // automatic NotificationManager updates.
    }
    .addOnFailureListener { e ->
      // (Optional) Handle errors.
      if (e is FirebaseAppDistributionException) {
        when (e.errorCode) {
          Status.NOT_IMPLEMENTED -> {
            // SDK did nothing. This is expected when building for Play.
          }
          else -> {
            // Handle other errors.
          }
        }
      }
    }

// Copy and paste this into any part of your app - for example, in your main
// activity's onResume method.
FirebaseAppDistribution firebaseAppDistribution = FirebaseAppDistribution.getInstance();
firebaseAppDistribution.updateIfNewReleaseAvailable()
    .addOnProgressListener(updateProgress -> {
      // (Optional) Implement custom progress updates in addition to
      // automatic NotificationManager updates.
    })
    .addOnFailureListener(e -> {
      // (Optional) Handle errors.
      if (e instanceof FirebaseAppDistributionException) {
        switch (((FirebaseAppDistributionException)e).getErrorCode()) {
          case NOT_IMPLEMENTED:
            // SDK did nothing. This is expected when building for Play.
            break;
          default:
            // Handle other errors.
            break;
        }
      }
    });

การกำหนดค่าขั้นสูง

การกำหนดค่าการลงชื่อเข้าใช้ขั้นสูง

เมธอด signInTester และ isTesterSignedIn ช่วยให้คุณมีความยืดหยุ่นมากขึ้นในการปรับแต่งประสบการณ์การลงชื่อเข้าใช้ของผู้ทดสอบ เพื่อให้ประสบการณ์ของผู้ทดสอบเข้ากับรูปลักษณ์ของแอปได้ดียิ่งขึ้น

ตัวอย่างต่อไปนี้จะตรวจสอบว่าผู้ทดสอบได้ลงชื่อเข้าใช้บัญชีผู้ทดสอบการเผยแพร่แอปของตนแล้วหรือไม่ การดำเนินการนี้ทำให้คุณสามารถเลือกแสดงส่วนต่อประสานผู้ใช้ (UI) สำหรับการลงชื่อเข้าใช้ของคุณต่อผู้ทดสอบที่ยังไม่ได้ลงชื่อเข้าใช้เท่านั้น หลังจากที่ผู้ทดสอบลงชื่อเข้าใช้แล้ว คุณสามารถเรียก updateIfNewReleaseAvailable เพื่อตรวจสอบว่าผู้ทดสอบสามารถเข้าถึงบิลด์ใหม่ได้หรือไม่

// Only show sign-in UI if this is the "beta" variant (example).
if (BuildConfig.BUILD_TYPE == "beta" && !firebaseAppDistribution.isTesterSignedIn) {
    // Start your sign-in UI here.
}

// Only check for updates if the tester is already signed in (do not prompt).
if (firebaseAppDistribution.isTesterSignedIn) {
    firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener {
        // Handle failed update.
    }
}

// Only show sign-in UI if this is the "beta" variant (example).
if (BuildConfig.BUILD_TYPE == "beta" && !firebaseAppDistribution.isTesterSignedIn()) {
    // Start your sign-in UI here.
}

// Only check for updates if the tester is already signed in (do not prompt).
if (firebaseAppDistribution.isTesterSignedIn()) {
    firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener( e -> {
        // Handle failed update.
    });
}

จาก UI การลงชื่อเข้าใช้ของคุณ เมื่อผู้ทดสอบเลือกที่จะดำเนินการต่อ ให้เรียก signInTester() :

firebaseAppDistribution.signInTester().addOnSuccessListener {
  // Handle successful sign-in.
}.addOnFailureListener {
  // Handle failed sign-in.
});

firebaseAppDistribution.signInTester().addOnSuccessListener( unused -> {
  // Handle successful sign-in.
}).addOnFailureListener(e -> {
  // Handle failed sign-in.
});

การกำหนดค่าการอัปเดตขั้นสูง

วิธีการ checkForNewRelease และ updateApp ทำให้คุณมีความยืดหยุ่นมากขึ้นในการปรับแต่งเมื่อผู้ทดสอบของคุณได้รับแจ้งให้อัปเดต คุณยังสามารถปรับแต่งกล่องโต้ตอบการอัปเดตที่สร้างไว้ล่วงหน้าและตัวบ่งชี้ความคืบหน้าการดาวน์โหลดเพื่อให้เข้ากับรูปลักษณ์ของแอปได้ดียิ่งขึ้น

โปรดทราบว่า updateApp ไม่มีตัวบ่งชี้ความคืบหน้าในการดาวน์โหลด ซึ่งหมายความว่าคุณต้องใช้การบ่งชี้ความคืบหน้าของคุณเองโดยใช้ NotificationManager การแสดงสถานะในแอปบางประเภท หรือวิธีการอื่นๆ

ตัวอย่างต่อไปนี้ตรวจสอบว่ามีรุ่นใหม่หรือไม่ จากนั้นจึงแสดง UI แบบกำหนดเอง ก่อนเรียก checkForNewRelease และ updateApp ตรวจสอบให้แน่ใจว่าผู้ทดสอบลงชื่อเข้าใช้โดยใช้ การกำหนดค่าการลงชื่อเข้าใช้ขั้นสูง

firebaseAppDistribution.checkForNewRelease().addOnSuccessListener { release ->
    if (release != null) {
        // New release available. Start your update UI here.
    }
}.addOnFailureListener {
    // Handle failed check for new release. Fails with Status#NOT_IMPLEMENTED
    // if built for Play.
}

firebaseAppDistribution.checkForNewRelease().addOnSuccessListener(release -> {
    if (release != null) {
        // New release available. Start your update UI here.
    }
}).addOnFailureListener(e -> {
    // Handle failed check for new release. Fails with Status#NOT_IMPLEMENTED
    // if built for Play.
});

เมื่อผู้ทดสอบเลือกที่จะดำเนินการอัปเดตต่อจาก UI อัปเดตของคุณ ให้เรียก updateApp() :

firebaseAppDistribution.updateApp()
    .addOnProgressListener { updateState ->
      // Use updateState to show update progress.
    }

firebaseAppDistribution.updateApp()
    .addOnProgressListener(updateState -> {
      // Use updateState to show update progress.
    });

ขั้นตอนที่ 4 : สร้างและทดสอบการใช้งานของคุณ

สร้างแอปและทดสอบการใช้งานโดย แจกจ่ายบิลด์ ให้กับผู้ทดสอบโดยใช้คอนโซล Firebase

ไปที่ คู่มือการแก้ไขปัญหาการกระจายแอป สำหรับความช่วยเหลือเกี่ยวกับปัญหาทั่วไป เช่น:

• ผู้ทดสอบไม่ได้รับการแจ้งเตือนในแอป
• ผู้ทดสอบได้รับแจ้งให้ลงชื่อเข้าใช้ Google มากกว่าหนึ่งครั้ง