অ্যাপ লিঙ্ক সংক্রান্ত সমস্যার সমাধান করা

এই নির্দেশিকায় সাধারণ সমস্যা এবং কীভাবে সেগুলির সমাধান করতে হয় তা বর্ণনা করা হয়েছে। এছাড়াও, আপনি Play Console-এর ডিপ লিঙ্ক পৃষ্ঠা বা Android Studio অ্যাপ লিঙ্ক অ্যাসিস্ট্যান্টে সমস্যার সমাধানকরণ টুল ব্যবহার করতে পারেন। আরও তথ্যের জন্য, অ্যাপ লিঙ্ক ডেভেলপার টুল দেখুন।

  • সমস্যা: আপনি এমন একটি লিঙ্কে ক্লিক করেছেন যা আপনার অ্যাপ খুলবে, কিন্তু এটি একটি ওয়েব ব্রাউজারে খোলে বা একটি দ্ব্যর্থতা নিরসন ডায়ালগ দেখায়।
  • সমাধান:
    • চেক করুন assetlinks.json: ফাইলটি সঠিক JSON কিনা, https://<your-domain>/.well-known/assetlinks.json-এ অ্যাক্সেস করা যায় কিনা এবং কোনও রিডাইরেক্ট ছাড়াই HTTPS-এর মাধ্যমে পরিবেশন করা হয় কিনা তা নিশ্চিত করুন। অনলাইন ভ্যালিডেটর ব্যবহার করুন।
    • SHA-256 ফিঙ্গারপ্রিন্ট যাচাই করুন: assetlinks.json-এ থাকা sha256_cert_fingerprints আপনার অ্যাপ রিলিজের জন্য সাইনিং কী-এর ফিঙ্গারপ্রিন্টের সাথে সম্পূর্ণভাবে মিলছে কিনা তা ডবল-চেক করুন (আপনি Play অ্যাপ সাইনিং ব্যবহার করলে Play Console থেকে পাওয়া ফিঙ্গারপ্রিন্ট ব্যবহার করুন)। স্বাক্ষর বড় হাতের অক্ষরে হতে হবে।
    • autoVerify যাচাই করুন: আপনার AndroidManifest.xml-এ <intent-filter>-এর মধ্যে android:autoVerify="true" অন্তর্ভুক্ত আছে কিনা তা ভাল করে দেখে নিন।
    • সার্ভার-সাইড রিডাইরেক্ট চেক করুন: http থেকে https-এ রিডাইরেক্ট করা হলে অথবা www ছাড়া ডোমেন থেকে www-এ রিডাইরেক্ট করা হলে যাচাইকরণ সম্পূর্ণ নাও হতে পারে।
    • আবার যাচাই করতে বাধ্য করা: নতুন যাচাইকরণের ফলাফল পেতে অ্যাপ লিঙ্ক পরীক্ষা করুন গাইডে ADB কমান্ড রান করুন।
    • লিঙ্ক রেজোলিউশন ডায়াগনসিস করা (Android 17+): কোন কোন ক্যান্ডিডেট অ্যাপ, ম্যানিফেস্ট ইনটেন্ট ফিল্টার এবং ডায়নামিক অ্যাপ লিঙ্ক সংক্রান্ত নিয়ম URL-এর সাথে ম্যাচ করে তা পরীক্ষা করতে adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>" রান করুন। বিস্তারিত জানতে, debug-link ফ্ল্যাগ সহ লিঙ্ক রেজোলিউশন ডায়াগনসিস করুন দেখুন।

Android 15+ ভার্সনে ডায়নামিক নিয়ম আপডেট হচ্ছে না

  • সমস্যা: আপনি assetlinks.json ফাইলে নিয়ম আপডেট করেছেন, কিন্তু নতুন লিঙ্ক অ্যাপের মাধ্যমে ম্যানেজ করা হচ্ছে না।
  • সমাধান:
    • আবার যাচাই করার জন্য বাধ্য করা: পরিবর্তন পরীক্ষা করার সবচেয়ে নির্ভরযোগ্য উপায় হল adb shell pm verify-app-links --re-verify <your-package-name>-এর মাধ্যমে আবার ফেচ করার জন্য বাধ্য করা।
    • টাইপো চেক করুন: আপনার নিয়মে সিনট্যাক্স সংক্রান্ত কোনও ভুল আছে কিনা তা জানতে প্যাটার্ন ম্যাচিং ভাল করে পর্যালোচনা করুন।
    • মেনিফেস্ট ফিল্টার সংক্রান্ত নিয়ম চেক করা: অ্যাপ মেনিফেস্টে ইনটেন্ট ফিল্টার সংক্রান্ত নিয়ম পর্যালোচনা করে দেখুন যে লিঙ্ক পাথ ফিল্টার করা হচ্ছে কিনা। লিঙ্কটি ফিল্টার করা হলে, অ্যাপ ম্যানিফেস্টে ইনটেন্ট ফিল্টারটি কম সীমাবদ্ধ করুন।
    • ম্যাচিং রুল ডায়াগনসিস করা (Android 17+): কোন রুল মূল্যায়ন করা হয়েছে তা পরীক্ষা করতে adb shell am start --debug-link -a android.intent.action.VIEW -d "<URL>" রান করুন এবং বাদ দেওয়ার রুল (allow = 1) অ্যাপ খোলা থেকে বিরত করেছে কিনা তা নির্ধারণ করুন। ডিবাগ-লিঙ্ক ফ্ল্যাগ ব্যবহার করে লিঙ্ক রেজোলিউশন ডায়াগনসিস করা দেখুন।

প্রয়োগ সংক্রান্ত সাধারণ সমস্যার সমাধান করা

আপনার Android অ্যাপ লিঙ্ক যাচাই করতে না পারলে, নিম্নলিখিত সাধারণ সমস্যাগুলি চেক করুন। এই বিভাগে example.com-কে প্লেসহোল্ডার ডোমেন নাম হিসেবে ব্যবহার করা হয়; এইসব চেক করার সময়, example.com-এর জায়গায় আপনার সার্ভারের আসল ডোমেন নাম ব্যবহার করুন।

ভুল ইনটেন্ট ফিল্টার সেট-আপ করা হয়েছে
আপনি এমন কোনও URL অন্তর্ভুক্ত করেছেন কিনা তা চেক করে দেখুন যা আপনার অ্যাপের মালিকানাধীন নয়, <intent-filter> এলিমেন্টে।
সার্ভার কনফিগারেশন ভুল আছে

আপনার সার্ভারের JSON কনফিগারেশন চেক করুন এবং SHA ভ্যালু সঠিক কিনা তা নিশ্চিত করুন।

এছাড়াও, example.com. (শেষে ফুলস্টপ সহ) example.com-এর মতো একই কন্টেন্ট দেখায় কিনা তা চেক করুন।

সার্ভার-সাইড রিডাইরেক্ট

আপনি যদি নিম্নলিখিত রিডাইরেক্ট সেট-আপ করেন, তাহলে সিস্টেম আপনার অ্যাপের জন্য কোনও Android App Links যাচাই করে না:

  • http://example.com থেকে https://example.com
  • example.com থেকে www.example.com

এই আচরণ আপনার অ্যাপের নিরাপত্তা সুরক্ষিত রাখে।

সার্ভারের রোবাস্টনেস

আপনার ক্লায়েন্ট অ্যাপ সার্ভারের সাথে কানেক্ট করতে পারছে কিনা তা চেক করুন।

যাচাই করা যায় না এমন লিঙ্ক

পরীক্ষা করার জন্য, আপনি ইচ্ছাকৃতভাবে যাচাই করা যায় না এমন লিঙ্ক যোগ করতে পারেন। মনে রাখবেন যে Android ১১ ও তার আগের ভার্সনে, এইসব লিঙ্কের কারণে সিস্টেম আপনার অ্যাপের জন্য সব Android App Link যাচাই করতে পারে না।

assetlinks.json-এ ভুল স্বাক্ষর

আপনার স্বাক্ষর সঠিক কিনা এবং আপনার অ্যাপে সাইন করার জন্য ব্যবহৃত স্বাক্ষরের সাথে মিলছে কিনা তা যাচাই করুন। সাধারণ ভুলগুলির মধ্যে রয়েছে:

  • ডিবাগ সার্টিফিকেট দিয়ে অ্যাপে সাইন-ইন করা এবং assetlinks.json-এ শুধুমাত্র রিলিজ স্বাক্ষর থাকা।
  • assetlinks.json-এ ছোট হাতের অক্ষরে স্বাক্ষর আছে। স্বাক্ষর বড় হাতের অক্ষরে হতে হবে।
  • আপনি Play অ্যাপ সাইনিং ব্যবহার করলে, আপনার প্রতিটি রিলিজ সাইন করার জন্য Google যে স্বাক্ষর ব্যবহার করে, আপনিও সেটি ব্যবহার করছেন কিনা তা নিশ্চিত করুন। আপনি ওয়েবসাইট অ্যাসোসিয়েশন ঘোষণা করা সম্পর্কিত নির্দেশাবলী অনুসরণ করে সম্পূর্ণ JSON স্নিপেট সহ এইসব বিবরণ যাচাই করতে পারবেন।

সমস্যার রিপোর্ট ক্যাপচার করুন

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