‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ניהול הזמינות של מודולים של Google Play Services על פי דרישה

כפי שמתואר במאמר סקירה כללית של Google Play Services, ערכות SDK שמופעלות על ידי Google Play Services מגובות בשירותים במכשיר במכשירי Android שאושרו על ידי Google. כדי לחסוך בנפח האחסון ובזיכרון בכל המכשירים, חלק מהשירותים מסופקים כמודולים שמותקנים על פי דרישה כשהאפליקציה זקוקה לפונקציונליות הרלוונטית. לדוגמה, ערכת ML Kit מספקת את האפשרות הזו כשמשתמשים במודלים ב-Google Play Services.

ברוב המקרים, ערכת ה-SDK של Google Play Services מורידה ומתקינה את המודולים הנדרשים באופן אוטומטי כשהאפליקציה משתמשת ב-API שדורש אותם. עם זאת, יכול להיות שתרצו יותר שליטה בתהליך, למשל אם אתם רוצים לשפר את חוויית המשתמש על ידי התקנת המודול מראש.

‫API של ModuleInstallClient מאפשר לכם:

בודקים אם המודולים כבר מותקנים במכשיר.
מבקשים להתקין את המודולים.
עוקבים אחרי התקדמות ההתקנה.
טיפול בשגיאות במהלך תהליך ההתקנה.

במדריך הזה מוסבר איך להשתמש ב-ModuleInstallClient כדי לנהל מודולים באפליקציה. שימו לב שקטעי הקוד הבאים משתמשים ב-TensorFlow Lite SDK (play-services-tflite-java) כדוגמה, אבל השלבים האלה רלוונטיים לכל ספרייה שמשולבת עם OptionalModuleApi.

לפני שמתחילים

כדי להכין את האפליקציה, מבצעים את השלבים שמפורטים בקטעים הבאים.

דרישות מוקדמות לאפליקציה

מוודאים שקובץ ה-build של האפליקציה כולל את הערכים הבאים:

minSdkVersion של 23 ומעלה

הגדרת האפליקציה

בקובץ settings.gradle ברמה העליונה, צריך לכלול את מאגר ה-Maven של Google ואת מאגר ה-Maven המרכזי בתוך הבלוק dependencyResolutionManagement:
```
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}
```
בקובץ ה-build של Gradle של המודול (בדרך כלל app/build.gradle), מוסיפים את התלויות של Google Play Services בשביל play-services-base ו-play-services-tflite-java:
```
dependencies {
  implementation 'com.google.android.gms:play-services-base:18.11.1'
  implementation 'com.google.android.gms:play-services-tflite-java:16.5.0'
}
```

איך בודקים אם יש מודולים זמינים

לפני שמנסים להתקין מודול, אפשר לבדוק אם הוא כבר מותקן במכשיר. כך אפשר להימנע מבקשות התקנה מיותרות.

מקבלים מופע של ModuleInstallClient:

Kotlin

val moduleInstallClient = ModuleInstall.getClient(context)

Java

ModuleInstallClient moduleInstallClient = ModuleInstall.getClient(context);

בודקים את הזמינות של המודול באמצעות OptionalModuleApi. ה-API הזה מסופק על ידי ה-SDK של Google Play Services שבו אתם משתמשים.

Kotlin

val optionalModuleApi = TfLite.getClient(context)
moduleInstallClient
  .areModulesAvailable(optionalModuleApi)
  .addOnSuccessListener {
    if (it.areModulesAvailable()) {
      // Modules are present on the device...
    } else {
      // Modules are not present on the device...
    }
  }
  .addOnFailureListener {
    // Handle failure...
  }

Java

OptionalModuleApi optionalModuleApi = TfLite.getClient(context);
moduleInstallClient
    .areModulesAvailable(optionalModuleApi)
    .addOnSuccessListener(
        response -> {
          if (response.areModulesAvailable()) {
            // Modules are present on the device...
          } else {
            // Modules are not present on the device...
          }
        })
    .addOnFailureListener(
        e -> {
          // Handle failure…
        });

בקשה להתקנה מושהית

אם אתם לא צריכים את המודול באופן מיידי, אתם יכולים לבקש התקנה מושהית. כך Google Play Services יכולה להתקין את המודול ברקע, למשל כשהמכשיר לא בשימוש ומחובר ל-Wi-Fi.

מקבלים מופע של ModuleInstallClient:

Kotlin

val moduleInstallClient = ModuleInstall.getClient(context)

Java

ModuleInstallClient moduleInstallClient = ModuleInstall.getClient(context);

שליחת הבקשה המושהית:

Kotlin

val optionalModuleApi = TfLite.getClient(context)
moduleInstallClient.deferredInstall(optionalModuleApi)

Java

OptionalModuleApi optionalModuleApi = TfLite.getClient(context);
moduleInstallClient.deferredInstall(optionalModuleApi);

בקשה להתקנה דחופה של מודול

אם האפליקציה צריכה את המודול באופן מיידי, אפשר לבקש התקנה דחופה. המערכת תנסה להתקין את המודול כמה שיותר מהר, גם אם זה אומר שהיא תצטרך להשתמש בחבילת הגלישה.

מקבלים מופע של ModuleInstallClient:

Kotlin

val moduleInstallClient = ModuleInstall.getClient(context)

Java

ModuleInstallClient moduleInstallClient = ModuleInstall.getClient(context);

(אופציונלי) יוצרים InstallStatusListener כדי לעקוב אחרי התקדמות ההתקנה.

אם רוצים להציג את התקדמות ההורדה בממשק המשתמש של האפליקציה (לדוגמה, באמצעות סרגל התקדמות), אפשר ליצור InstallStatusListener כדי לקבל עדכונים.

Kotlin

inner class ModuleInstallProgressListener : InstallStatusListener {
  override fun onInstallStatusUpdated(update: ModuleInstallStatusUpdate) {
    // Progress info is only set when modules are in the progress of downloading.
    update.progressInfo?.let {
      val progress = (it.bytesDownloaded * 100 / it.totalBytesToDownload).toInt()
      // Set the progress for the progress bar.
      progressBar.setProgress(progress)
    }

    if (isTerminateState(update.installState)) {
      moduleInstallClient.unregisterListener(this)
    }
  }

  fun isTerminateState(@InstallState state: Int): Boolean {
    return state == STATE_CANCELED || state == STATE_COMPLETED || state == STATE_FAILED
  }
}

val listener = ModuleInstallProgressListener()

Java

static final class ModuleInstallProgressListener implements InstallStatusListener {
    @Override
    public void onInstallStatusUpdated(ModuleInstallStatusUpdate update) {
      ProgressInfo progressInfo = update.getProgressInfo();
      // Progress info is only set when modules are in the progress of downloading.
      if (progressInfo != null) {
        int progress =
            (int)
                (progressInfo.getBytesDownloaded() * 100 / progressInfo.getTotalBytesToDownload());
        // Set the progress for the progress bar.
        progressBar.setProgress(progress);
      }
      // Handle failure status maybe…

      // Unregister listener when there are no more install status updates.
      if (isTerminateState(update.getInstallState())) {

        moduleInstallClient.unregisterListener(this);
      }
    }

    public boolean isTerminateState(@InstallState int state) {
      return state == STATE_CANCELED || state == STATE_COMPLETED || state == STATE_FAILED;
    }
  }

InstallStatusListener listener = new ModuleInstallProgressListener();

מגדירים את ModuleInstallRequest ומוסיפים את OptionalModuleApi לבקשה:

Kotlin

val optionalModuleApi = TfLite.getClient(context)
val moduleInstallRequest =
  ModuleInstallRequest.newBuilder()
    .addApi(optionalModuleApi)
    // Add more APIs if you would like to request multiple modules.
    // .addApi(...)
    // Set the listener if you need to monitor the download progress.
    // .setListener(listener)
    .build()

Java

OptionalModuleApi optionalModuleApi = TfLite.getClient(context);
ModuleInstallRequest moduleInstallRequest =
    ModuleInstallRequest.newBuilder()
        .addApi(optionalModuleApi)
        // Add more API if you would like to request multiple modules
        //.addApi(...)
        // Set the listener if you need to monitor the download progress
        //.setListener(listener)
        .build();

שולחים את בקשת ההתקנה:

Kotlin

moduleInstallClient
  .installModules(moduleInstallRequest)
  .addOnSuccessListener {
    if (it.areModulesAlreadyInstalled()) {
      // Modules are already installed when the request is sent.
    }
    // The install request has been sent successfully. This does not mean
    // the installation is completed. To monitor the install status, set an
    // InstallStatusListener to the ModuleInstallRequest.
  }
  .addOnFailureListener {
    // Handle failure…
  }

Java

moduleInstallClient.installModules(moduleInstallRequest)
    .addOnSuccessListener(
        response -> {
          if (response.areModulesAlreadyInstalled()) {
            // Modules are already installed when the request is sent.
          }
          // The install request has been sent successfully. This does not
          // mean the installation is completed. To monitor the install
          // status, set an InstallStatusListener to the
          // ModuleInstallRequest.
        })
    .addOnFailureListener(
        e -> {
          // Handle failure...
        });

בדיקת האפליקציה באמצעות `FakeModuleInstallClient`

ערכות ה-SDK של Google Play Services מספקות את FakeModuleInstallClient כדי לאפשר לכם לדמות את התוצאות של ממשקי ה-API להתקנת מודולים בבדיקות באמצעות הזרקת תלות. כך אפשר לבדוק את ההתנהגות של האפליקציה בתרחישים שונים בלי לפרוס אותה במכשיר אמיתי.

דרישות מוקדמות לאפליקציה

מגדירים שהאפליקציה תשתמש במסגרת החדרת התלות של Hilt.

החלפת `ModuleInstallClient` ב-`FakeModuleInstallClient` בבדיקה

כדי להשתמש ב-FakeModuleInstallClient בבדיקות, צריך להחליף את הקישור של ModuleInstallClient בהטמעה המזויפת.

הוספת תלות:

בקובץ ה-build של Gradle של המודול (בדרך כלל app/build.gradle), מוסיפים את התלויות של Google Play Services בשביל play-services-base-testing בבדיקה.
```
  dependencies {
    // other dependencies...

    testImplementation 'com.google.android.gms:play-services-base-testing:16.2.0'
  }
```

יוצרים מודול Hilt כדי לספק את ModuleInstallClient:

Kotlin

@Module
@InstallIn(ActivityComponent::class)
object ModuleInstallModule {

  @Provides
  fun provideModuleInstallClient(
    @ActivityContext context: Context
  ): ModuleInstallClient = ModuleInstall.getClient(context)
}

Java

@Module
@InstallIn(ActivityComponent.class)
public class ModuleInstallModule {
  @Provides
  public static ModuleInstallClient provideModuleInstallClient(
    @ActivityContext Context context) {
    return ModuleInstall.getClient(context);
  }
}

מזריקים את ModuleInstallClient לפעילות:

Kotlin

@AndroidEntryPoint
class MyActivity: AppCompatActivity() {
  @Inject lateinit var moduleInstallClient: ModuleInstallClient

  ...
}

Java

@AndroidEntryPoint
public class MyActivity extends AppCompatActivity {
  @Inject ModuleInstallClient moduleInstallClient;

  ...
}

מחליפים את הקישור בבדיקה:

Kotlin

@UninstallModules(ModuleInstallModule::class)
@HiltAndroidTest
class MyActivityTest {
  ...
  private val context:Context = ApplicationProvider.getApplicationContext()
  private val fakeModuleInstallClient = FakeModuleInstallClient(context)
  @BindValue @JvmField
  val moduleInstallClient: ModuleInstallClient = fakeModuleInstallClient

  ...
}

Java

@UninstallModules(ModuleInstallModule.class)
@HiltAndroidTest
class MyActivityTest {
  ...
  private static final Context context = ApplicationProvider.getApplicationContext();
  private final FakeModuleInstallClient fakeModuleInstallClient = new FakeModuleInstallClient(context);
  @BindValue ModuleInstallClient moduleInstallClient = fakeModuleInstallClient;

  ...
}

סימולציה של תרחישים שונים

בעזרת FakeModuleInstallClient, אתם יכולים לדמות תרחישים שונים, כמו:

המודולים כבר מותקנים.
המודולים לא זמינים במכשיר.
תהליך ההתקנה נכשל.
בקשת ההתקנה המושהית מצליחה או נכשלת.
בקשת ההתקנה הדחופה מצליחה או נכשלת.

Kotlin

@Test
fun checkAvailability_available() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset()

  val availableModule = TfLite.getClient(context)
  fakeModuleInstallClient.setInstalledModules(api)

  // Verify the case where modules are already available...
}

@Test
fun checkAvailability_unavailable() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset()

  // Do not set any installed modules in the test.

  // Verify the case where modules unavailable on device...
}

@Test
fun checkAvailability_failed() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset()

  fakeModuleInstallClient.setModulesAvailabilityTask(Tasks.forException(RuntimeException()))

  // Verify the case where an RuntimeException happened when trying to get module's availability...
}

Java

@Test
public void checkAvailability_available() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset();

  OptionalModuleApi optionalModuleApi = TfLite.getClient(context);
  fakeModuleInstallClient.setInstalledModules(api);

  // Verify the case where modules are already available...
}

@Test
public void checkAvailability_unavailable() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset();

  // Do not set any installed modules in the test.

  // Verify the case where modules unavailable on device...
}

@Test
public void checkAvailability_failed() {
  fakeModuleInstallClient.setModulesAvailabilityTask(Tasks.forException(new RuntimeException()));

  // Verify the case where an RuntimeException happened when trying to get module's availability...
}

הדמיית תוצאה של בקשת התקנה מושהית

Kotlin

@Test
fun deferredInstall_success() {
  fakeModuleInstallClient.setDeferredInstallTask(Tasks.forResult(null))

  // Verify the case where the deferred install request has been sent successfully...
}

@Test
fun deferredInstall_failed() {
  fakeModuleInstallClient.setDeferredInstallTask(Tasks.forException(RuntimeException()))

  // Verify the case where an RuntimeException happened when trying to send the deferred install request...
}

Java

@Test
public void deferredInstall_success() {
  fakeModuleInstallClient.setDeferredInstallTask(Tasks.forResult(null));

  // Verify the case where the deferred install request has been sent successfully...
}

@Test
public void deferredInstall_failed() {
  fakeModuleInstallClient.setDeferredInstallTask(Tasks.forException(new RuntimeException()));

  // Verify the case where an RuntimeException happened when trying to send the deferred install request...
}

הדמיית תוצאה של בקשת התקנה דחופה

Kotlin

@Test
fun installModules_alreadyExist() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset();

  OptionalModuleApi optionalModuleApi = TfLite.getClient(context);
  fakeModuleInstallClient.setInstalledModules(api);

  // Verify the case where the modules already exist when sending the install request...
}

@Test
fun installModules_withoutListener() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset();

  // Verify the case where the urgent install request has been sent successfully...
}

@Test
fun installModules_withListener() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset();

  // Generates a ModuleInstallResponse and set it as the result for installModules().
  val moduleInstallResponse = FakeModuleInstallUtil.generateModuleInstallResponse()
  fakeModuleInstallClient.setInstallModulesTask(Tasks.forResult(moduleInstallResponse))

  // Verify the case where the urgent install request has been sent successfully...

  // Generates some fake ModuleInstallStatusUpdate and send it to listener.
  val update = FakeModuleInstallUtil.createModuleInstallStatusUpdate(
    moduleInstallResponse.sessionId, STATE_COMPLETED)
  fakeModuleInstallClient.sendInstallUpdates(listOf(update))

  // Verify the corresponding updates are handled correctly...
}

@Test
fun installModules_failed() {
  fakeModuleInstallClient.setInstallModulesTask(Tasks.forException(RuntimeException()))

  // Verify the case where an RuntimeException happened when trying to send the urgent install request...
}

Java

@Test
public void installModules_alreadyExist() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset();

  OptionalModuleApi optionalModuleApi = TfLite.getClient(context);
  fakeModuleInstallClient.setInstalledModules(api);

  // Verify the case where the modules already exist when sending the install request...
}

@Test
public void installModules_withoutListener() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset();

  // Verify the case where the urgent install request has been sent successfully...
}

@Test
public void installModules_withListener() {
  // Reset any previously installed modules.
  fakeModuleInstallClient.reset();

  // Generates a ModuleInstallResponse and set it as the result for installModules().
  ModuleInstallResponse moduleInstallResponse =
      FakeModuleInstallUtil.generateModuleInstallResponse();
  fakeModuleInstallClient.setInstallModulesTask(Tasks.forResult(moduleInstallResponse));

  // Verify the case where the urgent install request has been sent successfully...

  // Generates some fake ModuleInstallStatusUpdate and send it to listener.
  ModuleInstallStatusUpdate update = FakeModuleInstallUtil.createModuleInstallStatusUpdate(
      moduleInstallResponse.getSessionId(), STATE_COMPLETED);
  fakeModuleInstallClient.sendInstallUpdates(ImmutableList.of(update));

  // Verify the corresponding updates are handled correctly...
}

@Test
public void installModules_failed() {
  fakeModuleInstallClient.setInstallModulesTask(Tasks.forException(new RuntimeException()));

  // Verify the case where an RuntimeException happened when trying to send the urgent install request...
}

ניהול הזמינות של מודולים של Google Play Services על פי דרישה קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

לפני שמתחילים

דרישות מוקדמות לאפליקציה

הגדרת האפליקציה

איך בודקים אם יש מודולים זמינים

Kotlin

Java

Kotlin

Java

בקשה להתקנה מושהית

Kotlin

Java

Kotlin

Java

בקשה להתקנה דחופה של מודול

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

בדיקת האפליקציה באמצעות FakeModuleInstallClient

דרישות מוקדמות לאפליקציה

החלפת ModuleInstallClient ב-FakeModuleInstallClient בבדיקה

Kotlin

Java

Kotlin

Java

Kotlin

Java

סימולציה של תרחישים שונים

Kotlin

Java

הדמיית תוצאה של בקשת התקנה מושהית

Kotlin

Java

הדמיית תוצאה של בקשת התקנה דחופה

Kotlin

Java

ניהול הזמינות של מודולים של Google Play Services על פי דרישה

בדיקת האפליקציה באמצעות `FakeModuleInstallClient`

החלפת `ModuleInstallClient` ב-`FakeModuleInstallClient` בבדיקה