অন-ডিমান্ড Google Play পরিষেবা মডিউলগুলির জন্য উপলব্ধতা পরিচালনা করুন৷

Google Play পরিষেবাগুলির সংক্ষিপ্ত বিবরণ নিবন্ধে বর্ণিত হিসাবে, Google-প্রত্যয়িত Android ডিভাইসগুলিতে Google Play পরিষেবাগুলি দ্বারা চালিত SDKগুলি অন-ডিভাইস পরিষেবাগুলির দ্বারা সমর্থিত। ডিভাইসের পুরো ফ্লিট জুড়ে স্টোরেজ এবং মেমরি সংরক্ষণ করতে, কিছু পরিষেবা মডিউল হিসাবে সরবরাহ করা হয় যেগুলি যখন আপনার অ্যাপের প্রাসঙ্গিক কার্যকারিতার প্রয়োজন হয় তখন চাহিদা অনুযায়ী ইনস্টল করা হয়। উদাহরণস্বরূপ, Google Play পরিষেবাগুলিতে মডেলগুলি ব্যবহার করার সময় ML Kit এই বিকল্পটি প্রদান করে ৷

বেশিরভাগ ক্ষেত্রে, Google Play পরিষেবাগুলি SDK প্রয়োজনীয় মডিউলগুলি স্বয়ংক্রিয়ভাবে ডাউনলোড করে এবং ইনস্টল করে যখন আপনার অ্যাপ একটি API ব্যবহার করে যার জন্য তাদের প্রয়োজন হয়৷ যাইহোক, আপনি প্রক্রিয়াটির উপর আরও নিয়ন্ত্রণ রাখতে চাইতে পারেন, যেমন আপনি মডিউলটি আগে থেকে ইনস্টল করে ব্যবহারকারীর অভিজ্ঞতা উন্নত করতে চান।

ModuleInstallClient API আপনাকে এটি করার ক্ষমতা দেয়:

• মডিউলগুলি ইতিমধ্যে ডিভাইসে ইনস্টল করা আছে কিনা তা পরীক্ষা করুন।
• মডিউল ইনস্টল করার জন্য অনুরোধ.
• ইনস্টলেশন অগ্রগতি নিরীক্ষণ.
• ইনস্টলেশন প্রক্রিয়া চলাকালীন ত্রুটিগুলি পরিচালনা করুন।

এই নির্দেশিকা আপনাকে দেখায় কিভাবে আপনার অ্যাপে মডিউল পরিচালনা করতে ModuleInstallClient ব্যবহার করতে হয়। উল্লেখ্য যে নিম্নলিখিত কোড স্নিপেটগুলি একটি উদাহরণ হিসাবে TensorFlow Lite SDK ( play-services-tflite-java ) ব্যবহার করে, কিন্তু এই পদক্ষেপগুলি OptionalModuleApi এর সাথে সংহত যেকোন লাইব্রেরির জন্য প্রযোজ্য।

আপনি শুরু করার আগে

আপনার অ্যাপ প্রস্তুত করতে, নিম্নলিখিত বিভাগগুলিতে পদক্ষেপগুলি সম্পূর্ণ করুন৷

অ্যাপের পূর্বশর্ত

নিশ্চিত করুন যে আপনার অ্যাপের বিল্ড ফাইল নিম্নলিখিত মানগুলি ব্যবহার করে:

• 23 বা উচ্চতর একটি minSdkVersion

আপনার অ্যাপ কনফিগার করুন

1. আপনার টপ-লেভেল settings.gradle ফাইলে, Google-এর Maven রিপোজিটরি এবং Maven সেন্ট্রাল রিপোজিটরি ডিপেন্ডেন্সি dependencyResolutionManagement ব্লকের মধ্যে অন্তর্ভুক্ত করুন:

   dependencyResolutionManagement {
       repositories {
           google()
           mavenCentral()
       }
   }
   

2. আপনার মডিউলের Gradle বিল্ড ফাইলে (সাধারণত app/build.gradle ), play-services-base এবং play-services-tflite-java জন্য Google Play পরিষেবা নির্ভরতা যোগ করুন:

   dependencies {
     implementation 'com.google.android.gms:play-services-base:18.7.0'
     implementation 'com.google.android.gms:play-services-tflite-java:16.4.0'
   }
   

মডিউল উপলব্ধ কিনা পরীক্ষা করুন

আপনি একটি মডিউল ইনস্টল করার চেষ্টা করার আগে, আপনি এটি ইতিমধ্যে ডিভাইসে ইনস্টল করা আছে কিনা তা পরীক্ষা করতে পারেন। এটি আপনাকে অপ্রয়োজনীয় ইনস্টলেশন অনুরোধ এড়াতে সাহায্য করে।

1. ModuleInstallClient এর একটি উদাহরণ পান:

   কোটলিন

   val moduleInstallClient = ModuleInstall.getClient(context)

   জাভা

   ModuleInstallClient moduleInstallClient = ModuleInstall.getClient(context);

2. OptionalModuleApi ব্যবহার করে একটি মডিউলের প্রাপ্যতা পরীক্ষা করুন। এই APIটি Google Play পরিষেবা SDK দ্বারা সরবরাহ করা হয়েছে যা আপনি ব্যবহার করছেন৷

   কোটলিন

   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...
     }

   জাভা

   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 পরিষেবাগুলিকে ব্যাকগ্রাউন্ডে মডিউল ইনস্টল করার অনুমতি দেয়, সম্ভাব্যভাবে যখন ডিভাইসটি নিষ্ক্রিয় থাকে এবং Wi-Fi এর সাথে সংযুক্ত থাকে৷

1. ModuleInstallClient এর একটি উদাহরণ পান:

   কোটলিন

   val moduleInstallClient = ModuleInstall.getClient(context)

   জাভা

   ModuleInstallClient moduleInstallClient = ModuleInstall.getClient(context);

2. বিলম্বিত অনুরোধ পাঠান:

   কোটলিন

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

   জাভা

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

একটি জরুরী মডিউল ইনস্টল করার অনুরোধ করুন

যদি আপনার অ্যাপটির অবিলম্বে মডিউলটির প্রয়োজন হয়, আপনি একটি জরুরি ইনস্টলের অনুরোধ করতে পারেন। এটি মোবাইল ডেটা ব্যবহার করার অর্থ হলেও মডিউলটিকে যত তাড়াতাড়ি সম্ভব ইনস্টল করার চেষ্টা করবে৷

1. ModuleInstallClient এর একটি উদাহরণ পান:

   কোটলিন

   val moduleInstallClient = ModuleInstall.getClient(context)

   জাভা

   ModuleInstallClient moduleInstallClient = ModuleInstall.getClient(context);

2. (ঐচ্ছিক) ইনস্টলের অগ্রগতি নিরীক্ষণ করতে একটি InstallStatusListener তৈরি করুন।

   আপনি যদি আপনার অ্যাপের UI-তে ডাউনলোডের অগ্রগতি প্রদর্শন করতে চান (উদাহরণস্বরূপ, একটি অগ্রগতি বার সহ), আপনি আপডেটগুলি পেতে একটি InstallStatusListener তৈরি করতে পারেন।

   কোটলিন

   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()

   জাভা

   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();

3. ModuleInstallRequest কনফিগার করুন এবং অনুরোধে OptionalModuleApi যোগ করুন:

   কোটলিন

   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()

   জাভা

   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();

4. ইনস্টল করার অনুরোধ পাঠান:

   কোটলিন

   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…
     }

   জাভা

   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 দিয়ে আপনার অ্যাপ পরীক্ষা করুন

Google Play পরিষেবা SDKs FakeModuleInstallClient প্রদান করে যাতে আপনি নির্ভরতা ইনজেকশন ব্যবহার করে পরীক্ষায় মডিউল ইনস্টল API-এর ফলাফল অনুকরণ করতে পারেন। এটি আপনাকে একটি বাস্তব ডিভাইসে স্থাপন করার প্রয়োজন ছাড়াই বিভিন্ন পরিস্থিতিতে আপনার অ্যাপের আচরণ পরীক্ষা করতে সহায়তা করে।

অ্যাপের পূর্বশর্ত

হিল্ট নির্ভরতা ইনজেকশন ফ্রেমওয়ার্ক ব্যবহার করতে আপনার অ্যাপ কনফিগার করুন।

পরীক্ষায় FakeModuleInstallClient দিয়ে ModuleInstallClient প্রতিস্থাপন করুন

আপনার পরীক্ষায় FakeModuleInstallClient ব্যবহার করতে, আপনাকে জাল বাস্তবায়নের সাথে ModuleInstallClient বাইন্ডিং প্রতিস্থাপন করতে হবে।

1. নির্ভরতা যোগ করুন:

   আপনার মডিউলের Gradle বিল্ড ফাইলে (সাধারণত app/build.gradle ), আপনার পরীক্ষায় play-services-base-testing জন্য Google Play পরিষেবা নির্ভরতা যোগ করুন।

     dependencies {
       // other dependencies...
   
       testImplementation 'com.google.android.gms:play-services-base-testing:16.1.0'
     }
   

2. ModuleInstallClient প্রদান করতে একটি হিল্ট মডিউল তৈরি করুন:

   কোটলিন

   @Module
   @InstallIn(ActivityComponent::class)
   object ModuleInstallModule {
   
     @Provides
     fun provideModuleInstallClient(
       @ActivityContext context: Context
     ): ModuleInstallClient = ModuleInstall.getClient(context)
   }

   জাভা

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

3. কার্যকলাপে ModuleInstallClient ইনজেক্ট করুন:

   কোটলিন

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

   জাভা

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

4. পরীক্ষায় বাঁধাই প্রতিস্থাপন করুন:

   কোটলিন

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

   জাভা

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

   দ্রষ্টব্য: এই স্নিপেটটি হিল্ট নির্ভরতা গ্রাফে আপনার পরীক্ষায় একটি ModuleInstallClient ফিল্ডকে FakeModuleInstallClient এ আবদ্ধ করতে @BindValue ব্যবহার করার একটি মৌলিক উদাহরণ দেখায়। আপনি আপনার নিজস্ব পরীক্ষা মডিউল তৈরি করতে এবং সেখানে বাইন্ডিং প্রতিস্থাপন করতে হিল্ট টেস্টিং গাইড অনুসরণ করতে পারেন।

বিভিন্ন পরিস্থিতিতে অনুকরণ

FakeModuleInstallClient এর সাথে, আপনি বিভিন্ন পরিস্থিতিতে অনুকরণ করতে পারেন, যেমন:

• মডিউল ইতিমধ্যে ইনস্টল করা আছে.
• মডিউল ডিভাইসে উপলব্ধ নেই.
• ইনস্টলেশন প্রক্রিয়া ব্যর্থ হয়.
• বিলম্বিত ইনস্টল অনুরোধ সফল বা ব্যর্থ হয়.
• জরুরী ইনস্টলেশনের অনুরোধ সফল বা ব্যর্থ হয়েছে৷

কোটলিন

@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...
}

জাভা

@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...
}

একটি বিলম্বিত ইনস্টল অনুরোধের জন্য ফলাফল অনুকরণ

কোটলিন

@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...
}

জাভা

@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...
}

একটি জরুরী ইনস্টলেশন অনুরোধের জন্য ফলাফল অনুকরণ

কোটলিন

@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...
}

জাভা

@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...
}