অ্যাপ লিঙ্কের জন্য ইনটেন্ট ফিল্টার যোগ করুন

অ্যাপ লিঙ্ক হল ডিপ লিঙ্ক যা HTTP বা HTTPS স্কিম ব্যবহার করে এবং Android দ্বারা আপনার ওয়েবসাইটের সাথে সম্পর্কিত হিসেবে যাচাই করা হয়। অ্যাপ লিঙ্ক ম্যানেজ করার জন্য রেজিস্টার করতে, এইসব ধাপ অনুসরণ করুন:

  1. আপনার অ্যাপ ম্যানিফেস্টে এক বা একাধিক ইনটেন্ট ফিল্টার যোগ করুন যা আপনার ওয়েবসাইট ডোমেন বা URL নির্দিষ্ট করে।
  2. ইনটেন্ট ফিল্টার এলিমেন্টে autoVerify="true"attribute যোগ করুন। এটি সিস্টেমকে সিগন্যাল দেয় যে আপনার ওয়েবসাইটের assetlinks.json কনফিগারেশনের সাথে স্কিম ও হোস্ট ডোমেন যাচাই করার চেষ্টা করা উচিত।
  3. ওয়েবসাইট অ্যাসোসিয়েশন ঘোষণা করুন।

নিচে স্কিম ও হোস্ট সহ অ্যাপ লিঙ্ক ঘোষণার উদাহরণ দেওয়া হল, সেইসাথে autoVerify="true":

<activity
    android:name=".MainActivity"
    android:exported="true"
    ...>
    <!-- Make sure you explicitly set android:autoVerify to "true". -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <!-- If a user clicks on a link that uses the "http" scheme, your
             app should be able to delegate that traffic to "https". -->
        <!-- Do not include other schemes, as this will prevent verification. -->
        <data android:scheme="http" />
        <data android:scheme="https" />

        <!-- Include one or more domains that should be verified. -->
        <data android:host="www.example.com" />
        <data android:host="*.example.com" />
    </intent-filter>
</activity>

কোড সম্পর্কে গুরুত্বপূর্ণ পয়েন্ট

  • AutoVerify: অ্যাপ লিঙ্কের জন্য android:autoVerify="true" অ্যাট্রিবিউট প্রয়োজন। এটি সিস্টেমকে সিগন্যাল দেয় যে <data> ট্যাগে উল্লেখ করা স্কিম ও ডোমেনের সাথে আপনার অ্যাপের অ্যাসোসিয়েশন যাচাই করার চেষ্টা করা উচিত। আপনি যাচাই করতে চান এমন প্রতিটি ইনটেন্ট ফিল্টারে autoVerify="true" যোগ করার সাজেশন দেওয়া হয়।
  • ডেটা এলিমেন্ট: প্রতিটি অ্যাপ লিঙ্ক ইনটেন্ট ফিল্টারে এক বা একাধিক <data> এলিমেন্ট থাকতে হবে যা আপনার যাচাইযোগ্য ওয়েবসাইট ডোমেনের সাথে মেলে এমন স্কিম এবং হোস্ট ফর্ম্যাট নির্দিষ্ট করে।
  • স্কিম: ইনটেন্ট ফিল্টারে http এবং https স্কিম, উভয়ের জন্যই <data> এলিমেন্ট থাকতে হবে।
  • হোস্ট: এক বা একাধিক হোস্টের সাথে ম্যাচ করার জন্য আপনি বিকল্প হিসেবে <data>টি এলিমেন্ট যোগ করতে পারবেন। একাধিক সাবডোমেন (যেমন, *.example.com) ম্যাচ করতে ওয়াইল্ডকার্ড (*) ব্যবহার করুন। সিস্টেম আপনার ওয়েবসাইটে assetlinks.json ফাইলের সাথে প্রতিটি হোস্ট যাচাই করার চেষ্টা করবে। মনে রাখবেন যে কোনও পাথ-লেভেল রাউটিং assetlinks.json ফাইলের মাধ্যমে ম্যানেজ করতে হবে (নিচে পেশাদার পদ্ধতি বিভাগ দেখুন)।

  • একাধিক হোস্ট: আপনি একাধিক হোস্ট ডোমেন ঘোষণা করলে, সিস্টেম (Android 12+ ভার্সনে) প্রতিটি যাচাই করার চেষ্টা করে। কোনও হোস্ট যাচাই করা হলে, অ্যাপটি সেই যাচাই করা হোস্টের লিঙ্কের জন্য ডিফল্ট হ্যান্ডলার হয়ে যায়। Android 11 এবং তার আগের ভার্সনে, একটি হোস্ট যাচাই করা না গেলেও যাচাইকরণ ব্যর্থ হয়।

  • একাধিক ইনটেন্ট ফিল্টার: আপনার উদ্দেশ্য অনন্য URL (যেমন, স্কিম ও হোস্টের নির্দিষ্ট কম্বিনেশন) ঘোষণা করা হলে, আলাদা ফিল্টার তৈরি করা গুরুত্বপূর্ণ, কারণ একই ইনটেন্ট ফিল্টারে একাধিক <data> এলিমেন্ট একসাথে মার্জ করা হয় যাতে তাদের কম্বাইন করা অ্যাট্রিবিউটের সব ভেরিয়েশন বিবেচনা করা যায়।

ম্যানিফেস্ট ফিল্টার সংক্রান্ত নিয়মের ক্ষেত্রে বিবেচ্য বিষয়

আপনি যদি Android 15 এবং তার পরবর্তী ভার্সনে ডায়নামিক অ্যাপ লিঙ্কের সাথে ব্যবহার করার জন্য ফিল্টার সেট-আপ করেন, তাহলে এটি মনে রাখা গুরুত্বপূর্ণ যে সার্ভার-সাইড assetlinks.json ফাইলে ঘোষিত ডায়নামিক নিয়মগুলি আপনার অ্যাপ ম্যানিফেস্টে স্ট্যাটিক্যালি ঘোষিত URL নিয়মের পরিধি প্রসারিত করতে পারে না।

এই কারণে, আমরা এই পদ্ধতি ব্যবহার করার সাজেশন দিই:

  • আপনার অ্যাপ ম্যানিফেস্টে, যতটা সম্ভব বিস্তৃত স্কোপ সেট করুন, যেমন শুধু স্কিম ও ডোমেন ঘোষণা করার মাধ্যমে
  • পাথ-লেভেল রাউটিংয়ের মতো আরও রিফাইনমেন্টের জন্য সার্ভার-সাইড assetlinks.json নিয়মের উপর নির্ভর করুন।

এই আদর্শ কনফিগারেশনের মাধ্যমে, আপনি প্রয়োজন অনুযায়ী assetlinks.json ফাইলে ডায়নামিকভাবে নতুন অ্যাপ লিঙ্ক পাথ যোগ করতে পারবেন, কারণ আপনি জানেন যে সেগুলি অ্যাপ ম্যানিফেস্টে আপনার সেট করা বিস্তৃত স্কোপের মধ্যে ফিট করবে।

একাধিক হোস্টের জন্য অ্যাপ লিঙ্ক কাজ করে

অ্যাপের URL ইনটেন্ট ফিল্টারের ডেটা এলিমেন্টে উল্লেখ করা হোস্টকে সিস্টেম যেন যাচাই করতে পারে। এই যাচাইকরণ ইনটেন্ট ফিল্টারের সংশ্লিষ্ট ওয়েব ডোমেনে হোস্ট করা ডিজিটাল অ্যাসেট লিঙ্ক ফাইলের সাথে মিলিয়ে করা হয়। যাচাইকরণ ব্যর্থ হলে, সিস্টেম তখন ইনটেন্ট সমাধান করার জন্য তার স্ট্যান্ডার্ড আচরণে ডিফল্ট হয়ে যায়, যেমন অ্যাপ কন্টেন্টে ডিপ লিঙ্ক তৈরি করুন-এ বর্ণনা করা হয়েছে। তবে, অ্যাপের অন্যান্য ইনটেন্ট ফিল্টারে সংজ্ঞায়িত যেকোনও URL প্যাটার্নের জন্য অ্যাপটি এখনও ডিফল্ট হ্যান্ডলার হিসেবে যাচাই করা যেতে পারে।

যেমন, নিম্নলিখিত ইনটেন্ট ফিল্টার সহ কোনও অ্যাপ শুধুমাত্র https://www.example.com-এর জন্য যাচাইকরণ পাস করবে যদি assetlinks.json ফাইলটি https://www.example.com/.well-known/assetlinks.json-এ পাওয়া যায়, কিন্তু https://www.example.net/.well-known/assetlinks.json-এ নয়:

<application>

  <activity android:name="MainActivity">
    <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="http" />
      <data android:scheme="https" />
      <data android:host="www.example.com" />
    </intent-filter>
  </activity>
  <activity android:name="SecondActivity">
    <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="https" />
     <data android:host="www.example.net" />
    </intent-filter>
  </activity>

</application>

একাধিক সাবডোমেনের জন্য অ্যাপ লিঙ্কিংয়ের সুবিধা

ডিজিটাল অ্যাসেট লিঙ্ক প্রোটোকল আপনার ইনটেন্ট ফিল্টারে সাবডোমেনকে অনন্য, আলাদা হোস্ট হিসেবে বিবেচনা করে। তাই আপনার ইনটেন্ট ফিল্টারে বিভিন্ন সাবডোমেন সহ একাধিক হোস্টের তালিকা থাকলে, আপনাকে প্রতিটি ডোমেনে একটি বৈধ assetlinks.json প্রকাশ করতে হবে। যেমন, নিম্নলিখিত ইনটেন্ট ফিল্টারে www.example.com এবং mobile.example.com ইনটেন্ট URL হোস্ট হিসেবে অন্তর্ভুক্ত করা হয়েছে। তাই একটি সঠিক assetlinks.json অবশ্যই https://www.example.com/.well-known/assetlinks.json এবং https://mobile.example.com/.well-known/assetlinks.json, দুটিতেই প্রকাশ করতে হবে।

<application>
  <activity android:name="MainActivity">
    <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="https" />
      <data android:scheme="https" />
      <data android:host="www.example.com" />
      <data android:host="mobile.example.com" />
    </intent-filter>
  </activity>
</application>

বিকল্প হিসেবে, আপনি যদি ওয়াইল্ডকার্ড (যেমন *.example.com) দিয়ে হোস্টনেম ঘোষণা করেন, তাহলে আপনাকে অবশ্যই রুট হোস্টনেমে (example.com) assetlinks.json ফাইল প্রকাশ করতে হবে। উদাহরণস্বরূপ, নিম্নলিখিত ইনটেন্ট ফিল্টার সহ একটি অ্যাপ example.com-এর যেকোনও সাব-নেমের (যেমন foo.example.com) জন্য যাচাইকরণ পাস করবে, যতক্ষণ না assetlinks.json ফাইলটি https://example.com/.well-known/assetlinks.json-এ প্রকাশিত হয়:

<application>
  <activity android:name="MainActivity">
    <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="https" />
      <data android:host="*.example.com" />
    </intent-filter>
  </activity>
</application>

একই ডোমেনের সাথে একাধিক অ্যাপ যুক্ত আছে কিনা তা চেক করুন

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

এই ধরনের ক্ষেত্রে, ব্যবহারকারীর ডিভাইসে সম্ভাব্য বিরোধপূর্ণ অ্যাপ চেক করুন, তবে আপনার কাছে প্রয়োজনীয় প্যাকেজ দৃশ্যমানতা থাকতে হবে। তারপর, আপনার অ্যাপে, একটি কাস্টম বাছাইকারী ডায়ালগ দেখান যাতে queryIntentActivities কল করার ফলাফল থাকে। ব্যবহারকারী ডায়ালগে দেখানো ম্যাচিং অ্যাপের তালিকা থেকে তার পছন্দের অ্যাপ বেছে নিতে পারবেন।

assetlinks.json-এ উন্নত ম্যাচিং নিয়ম এবং <uri-relative-filter-group>-এর ব্যবহার সহ ডায়নামিক অ্যাপ লিঙ্ক ফিচার, শুধুমাত্র Android 15 (API লেভেল 35) এবং তার পরবর্তী যেকোনও ভার্সনে সম্পূর্ণভাবে কাজ করে।

Android 14 (API লেভেল 34) এবং তার আগের ভার্সনে, সিস্টেম শুধুমাত্র অ্যাপ লিঙ্ক যাচাইকরণের জন্য আপনার ম্যানিফেস্টের <data> এলিমেন্টে ঘোষিত scheme এবং host বিবেচনা করে। assetlinks.json থেকে পাথ-নির্দিষ্ট নিয়ম, বাদ দেওয়া এবং ডায়নামিক আপডেট প্রয়োগ করা হয় না।

এর অর্থ হল, আপনার মেনিফেস্টে শুধুমাত্র scheme এবং host উল্লেখ করা থাকলে, Android 14 এবং তার আগের ভার্সনে আপনার অ্যাপ অপ্রত্যাশিতভাবে যাচাই করা ডোমেনের সব পাথ ক্যাপচার করতে পারে, Android 15 এবং তার পরের ভার্সনের জন্য আপনার assetlinks.json-এ পাথ-নির্দিষ্ট নিয়ম সংজ্ঞায়িত করা থাকলেও।

Android 14 এবং তার আগের ভার্সনে কোনও ডোমেনের সব লিঙ্ক আপনার অ্যাপ যাতে ম্যানেজ না করে, তা আটকাতে, আপনি Android 15 এবং তার পরের ভার্সনে আরও নির্দিষ্ট পাথের জন্য ডাইনামিক অ্যাপ লিঙ্ক ব্যবহার করতে চাইলে, আপনার ম্যানিফেস্টের ইনটেন্ট ফিল্টারে একটি অমিল পাথ যোগ করুন। android:path অ্যাট্রিবিউট সহ একটি <data> এলিমেন্ট যোগ করুন যা আপনার লিঙ্কের জন্য কখনও সঠিক পাথ হওয়ার সম্ভাবনা নেই। এটি নিশ্চিত করে যে ইনটেন্ট ফিল্টার নিম্নতর ভার্সনের সব পাথের সাথে ম্যাচ করে না।

উদাহরণ:

<activity
    android:name=".MainActivity"
    android:exported="true"
    ...>
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" />
        <data android:scheme="https" />
        <data android:host="www.example.com" />

        <!-- Add a non-matching path for backward compatibility -->
        <data android:path="/no_match_for_older_android_versions" />

        <uri-relative-filter-group android:allow="true">
          <data android:pathPattern="/.*"/>
        </uri-relative-filter-group>
    </intent-filter>
</activity>

<data android:path="/no_match_for_older_android_versions" /> যোগ করার মাধ্যমে, আপনি নিশ্চিত করেন যে Android 14 এবং তার আগের ভার্সনে, এই ইনটেন্ট ফিল্টার কোনও ইনকামিং লিঙ্কের সাথে মেলে না, তবে আপনার assetlinks.json নিয়মে উন্নত ম্যাচিং নিয়মের উপর ভিত্তি করে Android 15 এবং তার পরের ভার্সনে ডায়নামিক অ্যাপ লিঙ্কের সাথে ব্যবহারের জন্য ডোমেনটি যাচাই করার অনুমতি দেয়।

আপনার ম্যানিফেস্টে নির্দিষ্ট পাথ রুল (যেমন android:pathPrefix) সহ অ্যাপ লিঙ্ক আগে থেকেই থাকলে এবং Android 15 ও তার পরবর্তী ভার্সনে ডায়নামিক অ্যাপ লিঙ্ক ব্যবহার শুরু করতে চাইলে, আপনি নিরাপদে সরাসরি আপনার বর্তমান ইনটেন্ট ফিল্টারে <uri-relative-filter-group> এলিমেন্ট যোগ করতে পারবেন।

Android 14 এবং তার আগের ভার্সন <uri-relative-filter-group> এলিমেন্টকে উপেক্ষা করে, তাই আপনার আগে থেকে থাকা অ্যাপ লিঙ্কগুলি Android-এর পুরনো ভার্সন চালানো ডিভাইসে ঠিক আগের মতোই কাজ করতে থাকবে।

তবে, Android 15 এবং তার পরবর্তী ভার্সন কীভাবে "মিক্সড" কনফিগারেশন মূল্যায়ন করে তা আপনাকে অবশ্যই মনোযোগ সহকারে বিবেচনা করতে হবে:

  • টু-লেয়ার ফিল্টারিং: Android 15 ও তার পরবর্তী ভার্সনে, সিস্টেম ইনটেন্ট ফিল্টারকে ইউনিয়ন হিসেবে মূল্যায়ন করে। কোনও URL ম্যানিফেস্ট চেক পাস করে যদি এটি আপনার পুরনো স্ট্যাটিক <data> ট্যাগ অথবা আপনার <uri-relative-filter-group>-এর বিস্তৃত নিয়ম পূরণ করে। URL এই প্রাথমিক ম্যানিফেস্ট চেক পাস করলে, সিস্টেম আপনার assetlinks.json ফাইলে সংজ্ঞায়িত ডাইনামিক নিয়মগুলি সূক্ষ্ম-দানাযুক্ত ফিল্টারিংয়ের দ্বিতীয় স্তর হিসাবে প্রয়োগ করে। এর অর্থ হল, সার্ভার-সাইড JSON নিয়ম শেষ পর্যন্ত নির্ধারণ করে যে মিলে যাওয়া URL-এর মধ্যে কোনটি আসলে অ্যাপটি খুলবে।

হাইব্রিড কনফিগারেশনের উদাহরণ:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="https" />
    <data android:host="www.example.com" />

    <!-- Legacy rule: Android 14 and lower use this. Android 15 and higher
         also use this. -->
    <data android:pathPrefix="/store" />

    <!--
      Dynamic rule: Android 14 and lower ignore this. Android 15 and higher
      evaluate this as a union between all paths and the configuration
      specified in the assetlinks.json file. Make sure to apply further
      refinements in the assetlinks.json file to prevent all URL paths from
      opening in the app.
    -->
    <uri-relative-filter-group android:allow="true">
        <data android:pathPrefix="/" />
    </uri-relative-filter-group>
</intent-filter>