عیب یابی لینک های اپلیکیشن

این راهنما مشکلات رایج و نحوه عیب یابی آنها را شرح می دهد. همچنین می‌توانید از ابزارهای عیب‌یابی در صفحه پیوندهای عمیق کنسول Play یا دستیار پیوندهای برنامه Android Studio استفاده کنید. برای اطلاعات بیشتر، به ابزارهای توسعه دهنده App Links مراجعه کنید.

  • مشکل : روی پیوندی کلیک می‌کنید که باید برنامه شما را باز کند، اما در یک مرورگر وب باز می‌شود یا یک گفتگوی ابهام‌زدایی را نشان می‌دهد.
  • راه حل :
    • assetlinks.json را بررسی کنید : مطمئن شوید که فایل JSON معتبر است، در https://<your-domain>/.well-known/assetlinks.json قابل دسترسی است و از طریق HTTPS بدون تغییر مسیر ارائه می شود. از اعتبارسنجی آنلاین استفاده کنید.
    • اثر انگشت SHA-256 را تأیید کنید : دوباره بررسی کنید که sha256_cert_fingerprints در assetlinks.json دقیقاً با اثر انگشت کلید امضای انتشار برنامه شما مطابقت داشته باشد (اگر از Play App Signing استفاده می‌کنید، از یکی از کنسول Play استفاده کنید). امضا باید با حروف بزرگ باشد.
    • تأیید autoVerify : مطمئن شوید که <intent-filter> در AndroidManifest.xml شما دارای android:autoVerify="true " باشد.
    • تغییر مسیرهای سمت سرور را بررسی کنید : تغییر مسیر از http به https یا از دامنه غیرwww به www می تواند باعث عدم موفقیت در تأیید شود.
    • تأیید مجدد اجباری : دستورات ADB را در راهنمای پیوندهای برنامه آزمایشی اجرا کنید تا یک نتیجه تأیید جدید دریافت کنید.

قوانین پویا در Android 15+ به‌روزرسانی نمی‌شوند

  • مشکل: شما قوانین موجود در فایل assetlinks.json خود را به‌روزرسانی کرده‌اید، اما پیوندهای جدید توسط برنامه مدیریت نمی‌شوند.
  • راه حل :
    • تأیید مجدد اجباری : مطمئن‌ترین راه برای آزمایش تغییرات، واکشی مجدد با adb shell pm verify-app-links --re-verify. <your-package-name> .
    • اشتباهات تایپی را بررسی کنید : تطبیق‌های الگوی خود را با دقت در قوانین خود برای هرگونه خطای نحوی بررسی کنید.
    • قوانین فیلتر مانیفست را بررسی کنید : قوانین فیلتر قصد را در مانیفست برنامه مرور کنید تا مطمئن شوید که مسیر پیوند فیلتر نشده است. اگر پیوند در حال فیلتر شدن است، فیلتر قصد در مانیفست برنامه را کمتر محدود کنید.

رفع خطاهای رایج پیاده سازی

اگر نمی توانید پیوندهای برنامه Android خود را تأیید کنید، خطاهای رایج زیر را بررسی کنید. این بخش example.com به عنوان نام دامنه مکان‌دار استفاده می‌کند. هنگام انجام این بررسی ها، example.com با نام دامنه واقعی سرور خود جایگزین کنید.

فیلتر هدف نادرست تنظیم شده است
بررسی کنید که آیا نشانی اینترنتی را که برنامه شما متعلق به آن نیست در عنصر <intent-filter> وارد می‌کنید یا خیر.
پیکربندی سرور نادرست

پیکربندی JSON سرور خود را بررسی کنید و مطمئن شوید که مقدار SHA درست است.

همچنین آن example.com. (با دوره پایانی) همان محتوا را به عنوان example.com ارائه می دهد.

تغییر مسیرهای سمت سرور

اگر تغییر مسیری مانند موارد زیر را تنظیم کنید، سیستم هیچ پیوند برنامه Android را برای برنامه شما تأیید نمی کند:

  • http://example.com به https://example.com
  • example.com به www.example.com

این رفتار از امنیت برنامه شما محافظت می کند.

استحکام سرور

بررسی کنید که آیا برنامه های مشتری شما می توانند به سرور شما متصل شوند یا خیر.

لینک های غیر قابل تایید

برای اهداف آزمایشی، ممکن است عمداً پیوندهای غیرقابل تأیید اضافه کنید. به خاطر داشته باشید که در اندروید 11 و پایین‌تر، این پیوندها باعث می‌شوند که سیستم تمام پیوندهای برنامه Android را برای برنامه شما تأیید نکند.

امضای نادرست در assetlinks.json

بررسی کنید که امضای شما صحیح است و با امضای مورد استفاده برای امضای برنامه شما مطابقت دارد. اشتباهات رایج عبارتند از:

  • امضای برنامه با گواهی اشکال زدایی و فقط داشتن امضای انتشار در assetlinks.json .
  • داشتن امضای کوچک در assetlinks.json . امضا باید با حروف بزرگ باشد.
  • اگر از Play App Signing استفاده می‌کنید، مطمئن شوید که از امضایی استفاده می‌کنید که Google برای امضای هر یک از نسخه‌های شما استفاده می‌کند. با دنبال کردن دستورالعمل‌های مربوط به اعلام ارتباط وب‌سایت ، می‌توانید این جزئیات، از جمله یک قطعه کامل JSON را تأیید کنید.