অ্যাপ-মধ্যস্থ আপডেট (Unity) সংক্রান্ত সহায়তা

Unity ব্যবহার করে আপনার অ্যাপে কীভাবে অ্যাপ-মধ্যস্থ আপডেট সংক্রান্ত সহায়তা প্রদান করবেন তা এই নির্দেশিকায় বর্ণনা করা হয়েছে। আপনার ইমপ্লিমেন্টেশন Kotlin প্রোগ্রামিং ল্যাঙ্গুয়েজ বা Java প্রোগ্রামিং ল্যাঙ্গুয়েজ ব্যবহার করলে এবং আপনার ইমপ্লিমেন্টেশন নেটিভ কোড (C/C++) ব্যবহার করলে, সেইসব ক্ষেত্রে আলাদা আলাদা নির্দেশিকা আছে।

Unity SDK ওভারভিউ

Play ইন-অ্যাপ আপডেট API হল Play Core SDK ফ্যামিলির অংশ। Unity প্লাগ-ইন আপনার অ্যাপ ও Google Play API-এর মধ্যে যোগাযোগ ম্যানেজ করার জন্য AppUpdateManager ক্লাস অফার করে। ইন-অ্যাপ আপডেট ম্যানেজ করার জন্য এই ক্লাস ব্যবহার করার আগে আপনাকে অবশ্যই এটি ইনস্ট্যানশিয়েট করতে হবে:

AppUpdateManager appUpdateManager = new AppUpdateManager();

আপনার ডেভেলপমেন্ট এমভায়রনমেন্ট সেট-আপ করুন

OpenUPM-CLI

আপনার ডিভাইসে OpenUPM CLI ইনস্টল করা থাকলে, নিম্নলিখিত কমান্ডের সাহায্যে OpenUPM রেজিস্ট্রি ইনস্টল করতে পারবেন:

openupm add com.google.play.appupdate

OpenUPM

  1. Unity মেনু বিকল্প এডিট করুন > প্রোজেক্ট সেটিংস > প্যাকেজ ম্যানেজার বেছে নিয়ে প্যাকেজ ম্যানেজার সেটিংস খুলুন।

  2. প্যাকেজ ম্যানেজার উইন্ডোতে স্কোপড রেজিস্ট্রি হিসেবে OpenUPM যোগ করুন:

    Name: package.openupm.com
    URL: https://package.openupm.com
    Scopes: com.google.external-dependency-manager
      com.google.play.common
      com.google.play.core
      com.google.play.appupdate
    
  3. Unity মেনু বিকল্প Window > Package Manager বেছে নিয়ে প্যাকেজ ম্যানেজার মেনু খুলুন।

  4. ম্যানেজার স্কোপ ড্রপ-ডাউন সেট করে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

  5. প্যাকেজের তালিকা থেকে Unity-র জন্য Google Play Integrity প্লাগ-ইন প্যাকেজ বেছে নিন এবং ইনস্টল করুন বিকল্পে প্রেস করুন।

GitHub থেকে ইমপোর্ট করুন

  1. GitHub থেকে লেটেস্ট .unitypackage রিলিজ ডাউনলোড করুন।

  2. Unity মেনু বিকল্প বেছে নিয়ে .unitypackage ফাইল ইমপোর্ট করুন অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ এবং সব আইটেম ইমপোর্ট করুন।

আপডেট উপলভ্য আছে কিনা তা চেক করুন

আপডেটের অনুরোধ করার আগে, আপনার অ্যাপের জন্য কোনও আপডেট উপলভ্য আছে কিনা তা চেক করুন। coroutine-এ আপডেট চেক করতে AppUpdateManager ব্যবহার করুন:

IEnumerator CheckForUpdate()
{
  PlayAsyncOperation<AppUpdateInfo, AppUpdateErrorCode> appUpdateInfoOperation =
    appUpdateManager.GetAppUpdateInfo();

  // Wait until the asynchronous operation completes.
  yield return appUpdateInfoOperation;

  if (appUpdateInfoOperation.IsSuccessful)
  {
    var appUpdateInfoResult = appUpdateInfoOperation.GetResult();
    // Check AppUpdateInfo's UpdateAvailability, UpdatePriority,
    // IsUpdateTypeAllowed(), ... and decide whether to ask the user
    // to start an in-app update.
  }
  else
  {
    // Log appUpdateInfoOperation.Error.
  }
}

ফেরত আসা AppUpdateInfo ইনস্ট্যান্সে আপডেট উপলভ্যতার স্ট্যাটাস থাকে। ইন-অ্যাপ আপডেট আগে থেকেই প্রসেসে থাকলে, ইনস্ট্যান্সটি প্রসেসে থাকা আপডেটের স্ট্যাটাসও রিপোর্ট করে।

আপডেট বাসি হয়ে গেছে কিনা তা চেক করুন

কোনও আপডেট উপলভ্য আছে কিনা তা চেক করার পাশাপাশি, আপনি হয়ত Play Store-এর মাধ্যমে ব্যবহারকারীকে শেষবার আপডেট সম্পর্কে জানানোর পর থেকে কত সময় পেরিয়ে গেছে তাও চেক করতে চাইবেন। এটি আপনাকে সিদ্ধান্ত নিতে সাহায্য করতে পারে যে আপনার একটি ফ্লেক্সিবল আপডেট নাকি অবিলম্বে আপডেট শুরু করা উচিত। যেমন, আপনি হয়ত ব্যবহারকারীকে ফ্লেক্সিবল আপডেট সম্পর্কে জানানোর আগে কয়েকদিন অপেক্ষা করতে পারেন এবং তার কয়েকদিন পরে অবিলম্বে আপডেট করার জন্য বলতে পারেন।

Play Store-এর মাধ্যমে আপডেট উপলভ্য হওয়ার পর থেকে কত দিন কেটে গেছে তা চেক করতে ClientVersionStalenessDays ব্যবহার করুন:

var stalenessDays = appUpdateInfoOperation.ClientVersionStalenessDays;

আপডেটের অগ্রাধিকার চেক করুন

Google Play Developer API আপনাকে প্রতিটি আপডেটের অগ্রাধিকার সেট করতে দেয়। এটি আপনার অ্যাপকে ব্যবহারকারীর কাছে কোনও আপডেট কতটা জোরালোভাবে সাজেস্ট করতে হবে তা সিদ্ধান্ত নিতে দেয়। যেমন, আপডেট প্রায়োরিটি সেট করার জন্য নিম্নলিখিত স্ট্র্যাটেজি বিবেচনা করুন:

  • UI-তে ছোটখাটো উন্নতি: কম-অগ্রাধিকার আপডেট; ফ্লেক্সিবল আপডেট বা অবিলম্বে আপডেট করার অনুরোধ করে না।
  • পারফর্ম্যান্সের উন্নতি: মাঝারি-অগ্রাধিকার আপডেট; একটি নমনীয় আপডেটের অনুরোধ করুন।
  • গুরুত্বপূর্ণ নিরাপত্তা আপডেট: উচ্চ-অগ্রাধিকার আপডেট; অবিলম্বে আপডেট করার অনুরোধ করুন।

অগ্রাধিকার নির্ধারণ করতে, Google Play ০ থেকে ৫-এর মধ্যে একটি পূর্ণসংখ্যা ব্যবহার করে, যেখানে ০ ডিফল্ট এবং ৫ হল সর্বোচ্চ অগ্রাধিকার। আপডেটের জন্য অগ্রাধিকার সেট করতে, Google Play Developer API-তে Edits.tracks.releases-এর অধীনে inAppUpdatePriority ফিল্ড ব্যবহার করুন। রিলিজে নতুন যোগ করা সব ভার্সন রিলিজের মতোই একই অগ্রাধিকারের বলে বিবেচনা করা হয়। নতুন রিলিজ রোল-আউট করার সময় অগ্রাধিকার সেট করা যায় এবং পরে তা পরিবর্তন করা যায় না।

Play Developer API ডকুমেন্টেশনে যেভাবে বর্ণনা করা হয়েছে সেই অনুযায়ী Google Play Developer API ব্যবহার করে অগ্রাধিকার সেট করুন। অ্যাপ-মধ্যস্থ আপডেট সংক্রান্ত অগ্রাধিকার Edit.tracks: update পদ্ধতিতে পাস করা Edit.tracks রিসোর্সে নির্দিষ্ট করা উচিত। নিম্নলিখিত উদাহরণে ভার্সন কোড ৮৮ এবং inAppUpdatePriority ৫ সহ অ্যাপ রিলিজ করার প্রক্রিয়া দেখানো হয়েছে:

{
  "releases": [{
      "versionCodes": ["88"],
      "inAppUpdatePriority": 5,
      "status": "completed"
  }]
}

আপনার অ্যাপের কোডে, আপনি UpdatePriority ব্যবহার করে কোনও নির্দিষ্ট আপডেটের জন্য অগ্রাধিকার লেভেল চেক করতে পারেন:

var priority = appUpdateInfoOperation.UpdatePriority;

আপডেট শুরু করুন

আপডেট উপলভ্য আছে কিনা তা নিশ্চিত করার পরে, আপনি AppUpdateManager.StartUpdate() ব্যবহার করে আপডেটের জন্য অনুরোধ করতে পারবেন। আপডেটের অনুরোধ করার আগে, আপনার কাছে আপ-টু-ডেট AppUpdateInfo অবজেক্ট আছে কিনা তা নিশ্চিত করুন। আপডেট ফ্লো কনফিগার করতে আপনাকে অবশ্যই একটি AppUpdateOptions অবজেক্ট তৈরি করতে হবে।

নিম্নলিখিত উদাহরণটি অবিলম্বে আপডেট ফ্লোয়ের জন্য একটি AppUpdateOptions অবজেক্ট তৈরি করে:

// Creates an AppUpdateOptions defining an immediate in-app
// update flow and its parameters.
var appUpdateOptions = AppUpdateOptions.ImmediateAppUpdateOptions();

নিম্নলিখিত উদাহরণটি একটি ফ্লেক্সিবল আপডেট ফ্লোর জন্য একটি AppUpdateOptions অবজেক্ট তৈরি করে:

// Creates an AppUpdateOptions defining a flexible in-app
// update flow and its parameters.
var appUpdateOptions = AppUpdateOptions.FlexibleAppUpdateOptions();

AppUpdateOptions অবজেক্টে একটি AllowAssetPackDeletion ফিল্ডও থাকে যা নির্ধারণ করে যে ডিভাইসের স্টোরেজ সীমিত হলে আপডেটটি অ্যাসেট প্যাক মুছে ফেলার অনুমতি দেয় কিনা। এই ফিল্ডটি ডিফল্ট হিসেবে false-এ সেট করা থাকে, তবে আপনি allowAssetPackDeletion ঐচ্ছিক আর্গুমেন্টটি ImmediateAppUpdateOptions() বা FlexibleAppUpdateOptions()-এ পাস করতে পারেন, যাতে এটি true-এ সেট করা যায়:

// Creates an AppUpdateOptions for an immediate flow that allows
// asset pack deletion.
var appUpdateOptions =
  AppUpdateOptions.ImmediateAppUpdateOptions(allowAssetPackDeletion: true);

// Creates an AppUpdateOptions for a flexible flow that allows asset
// pack deletion.
var appUpdateOptions =
  AppUpdateOptions.FlexibleAppUpdateOptions(allowAssetPackDeletion: true);

আপনি ফ্লেক্সিবল আপডেট নাকি ইমিডিয়েট আপডেট-এর অনুরোধ করছেন তার উপর পরবর্তী ধাপগুলি নির্ভর করে।

ফ্লেক্সিবল আপডেট ম্যানেজ করা

আপনার কাছে আপ-টু-ডেট AppUpdateInfo অবজেক্ট এবং সঠিকভাবে কনফিগার করা AppUpdateOptions অবজেক্ট থাকলে, আপনি আপডেট ফ্লোয়ের জন্য অ্যাসিঙ্ক্রোনাস অনুরোধ করতে AppUpdateManager.StartUpdate()-এ কল করতে পারেন।

IEnumerator StartFlexibleUpdate()
{
  // Creates an AppUpdateRequest that can be used to monitor the
  // requested in-app update flow.
  var startUpdateRequest = appUpdateManager.StartUpdate(
    // The result returned by PlayAsyncOperation.GetResult().
    appUpdateInfoResult,
    // The AppUpdateOptions created defining the requested in-app update
    // and its parameters.
    appUpdateOptions);

  while (!startUpdateRequest.IsDone)
  {
  // For flexible flow,the user can continue to use the app while
  // the update downloads in the background. You can implement a
  // progress bar showing the download status during this time.
  yield return null;
  }

}

ফ্লেক্সিবল আপডেট ফ্লোয়ের জন্য, ডাউনলোড সম্পূর্ণ হওয়ার পরে আপনাকে অ্যাপ আপডেট ইনস্টল করার প্রক্রিয়া ট্রিগার করতে হবে। এটি করতে, AppUpdateManager.CompleteUpdate() কল করুন, যেমন নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

IEnumerator CompleteFlexibleUpdate()
{
  var result = appUpdateManager.CompleteUpdate();
  yield return result;

  // If the update completes successfully, then the app restarts and this line
  // is never reached. If this line is reached, then handle the failure (e.g. by
  // logging result.Error or by displaying a message to the user).
}

অবিলম্বে আপডেট ম্যানেজ করা

আপনার কাছে আপ-টু-ডেট AppUpdateInfo অবজেক্ট এবং সঠিকভাবে কনফিগার করা AppUpdateOptions অবজেক্ট থাকলে, আপনি আপডেট ফ্লোয়ের জন্য অ্যাসিঙ্ক্রোনাস অনুরোধ করতে AppUpdateManager.StartUpdate()-এ কল করতে পারেন।

IEnumerator StartImmediateUpdate()
{
  // Creates an AppUpdateRequest that can be used to monitor the
  // requested in-app update flow.
  var startUpdateRequest = appUpdateManager.StartUpdate(
    // The result returned by PlayAsyncOperation.GetResult().
    appUpdateInfoResult,
    // The AppUpdateOptions created defining the requested in-app update
    // and its parameters.
    appUpdateOptions);
  yield return startUpdateRequest;

  // If the update completes successfully, then the app restarts and this line
  // is never reached. If this line is reached, then handle the failure (for
  // example, by logging result.Error or by displaying a message to the user).
}

অবিলম্বে আপডেট করার ফ্লোয়ের জন্য, Google Play ব্যবহারকারীর কনফার্মেশন ডায়ালগ দেখায়। ব্যবহারকারী অনুরোধ গ্রহণ করলে, Google Play অটোমেটিক আপডেট ডাউনলোড ও ইনস্টল করে, তারপর ইনস্টলেশন সম্পূর্ণ হলে আপডেট করা ভার্সনে অ্যাপ রিস্টার্ট করে।

সমস্যা ম্যানেজ করা

এই বিভাগে সাধারণ সমস্যার সমাধান বর্ণনা করা হয়েছে।

  • StartUpdate()-এর জন্য ArgumentNullException হলে, এর অর্থ হল AppUpdateInfo-এর মান শূন্য। আপডেট ফ্লো শুরু করার আগে, GetAppUpdateInfo() থেকে রিটার্ন করা AppUpdateInfo অবজেক্টটি নাল নয় তা নিশ্চিত করুন।
  • PlayAsyncOperation যদি ErrorUpdateUnavailable ত্রুটি কোড দেখায়, তাহলে নিশ্চিত করুন যে একই অ্যাপ্লিকেশন আইডি ও সাইনিং কী সহ অ্যাপের কোনও আপডেট করা ভার্সন উপলভ্য আছে।
  • PlayAsyncOperation যদি ErrorUpdateNotAllowed ত্রুটি কোড দেখায়, তাহলে তার অর্থ হল AppUpdateOptions অবজেক্ট এমন একটি আপডেটের ধরন নির্দেশ করে যা উপলভ্য আপডেটের জন্য অনুমোদিত নয়। আপডেট ফ্লো শুরু করার আগে, বেছে নেওয়া আপডেটের ধরন অনুমোদিত কিনা তা AppUpdateInfo অবজেক্ট থেকে চেক করুন।

পরবর্তী ধাপ

আপনার ইন্টিগ্রেশন সঠিকভাবে কাজ করছে কিনা তা যাচাই করতে আপনার অ্যাপের ইন-অ্যাপ আপডেট টেস্ট করুন।