زر واتساب في تطبيقك لا يعمل: queries وLSApplicationQueriesSchemes
باختصار: إذا كان في تطبيقك زر «تواصل عبر واتساب» أو «افتح الموقع على الخريطة»، والزر لا يفعل شيئاً على بعض الهواتف، أو يقول التطبيق إن واتساب غير مثبت مع أنه مثبت، فالسبب غالباً أن التطبيق «يسأل» أولاً هل التطبيق الآخر موجود، والنظام يخفي عنه الجواب. في أندرويد، التطبيقات التي تستهدف أندرويد 11 فما فوق ترى قائمة محدودة من التطبيقات المثبتة ما لم تعلن حاجتها في عنصر queries. وفي iOS، الدالة canOpenURL تعيد false لأي نظام روابط غير معلن في LSApplicationQueriesSchemes. والحل الأبسط في الحالتين: حاول فتح الرابط مباشرة وتعامل مع الفشل.
أين تظهر المشكلة؟
مكتب عقارات في عمّان أطلق تطبيقاً يعرض الشقق المتاحة. في كل إعلان زران: «اسأل عبر واتساب» و«الموقع على الخريطة». بعد تحديث التطبيق ليستهدف إصدار أندرويد أحدث، بدأ الزبائن يقولون إن زر واتساب يُظهر رسالة «واتساب غير مثبت على جهازك». وعلى iPhone، لم يكن زر الخريطة يفتح تطبيق خرائط Google، بل لا يحدث شيء.
لم يتغير شيء في الأزرار نفسها. ما تغير هو قواعد الأنظمة حول معرفة التطبيقات المثبتة. هذا مثال توضيحي لحالة شائعة في تطبيقات المكاتب والمحلات التي تعتمد على واتساب كقناة تواصل رئيسية مع الزبائن، وقد يستمر الخلل أسابيع قبل أن ينتبه إليه أحد.
أندرويد: رؤية التطبيقات الأخرى محدودة
توثيق أندرويد عن «تصفية رؤية الحزم» يشرح أنه عندما يستهدف التطبيق أندرويد 11 أو أعلى ويستعلم عن معلومات التطبيقات الأخرى المثبتة على الجهاز، يصفّي النظام هذه المعلومات افتراضياً. هذا يعني أن تطبيقك لا يستطيع اكتشاف كل التطبيقات المثبتة.
ويذكر التوثيق أن الرؤية المحدودة تؤثر في نتائج الدوال التي تعطي معلومات عن التطبيقات الأخرى، وفي التفاعلات الصريحة مع التطبيقات الأخرى. ويوضح سبب هذا التغيير: Google Play تعتبر قائمة التطبيقات المثبتة بيانات شخصية وحساسة للمستخدم.
فإذا كان كود التطبيق يتحقق أولاً «هل واتساب مثبت؟» قبل فتحه، فقد يحصل على جواب «لا» حتى لو كان مثبتاً، فيعرض الرسالة الخاطئة.
الحل في أندرويد: عنصر queries
التوثيق يشرح طريقتين لإعلان الحاجة في ملف التطبيق داخل عنصر queries:
- بأسماء حزم محددة: إذا كنت تعرف التطبيقات التي تريد التفاعل معها، تضع أسماء حزمها داخل عناصر package. عندها يظهر التطبيق المعلن في نتائج الاستعلامات المطابقة.
- بنوع الإجراء: إذا كنت لا تعرف أسماء الحزم، تعلن «توقيع» الإجراء الذي تحتاجه، مثل إرسال صورة أو فتح نوع معين من الروابط، فيرى التطبيق التطبيقات التي تدعم هذا الإجراء. والتوثيق يذكر قيوداً لهذا العنصر، منها وجوب وجود إجراء واحد بالضبط في كل عنصر intent.
ويذكر التوثيق أيضاً صلاحية QUERY_ALL_PACKAGES للحالات النادرة التي لا يكفي فيها عنصر queries، وينبه إلى أن استخدامها في التطبيقات المنشورة على Google Play يخضع للموافقة. لتطبيق عقارات أو مطعم، هذه الصلاحية ليست الحل، وطلبها دون حاجة حقيقية قد يعقّد مراجعة التطبيق.
لماذا يعمل على هاتفي ولا يعمل عند الزبون؟
هذا سؤال يتكرر. توثيق أندرويد يذكر أن بعض الحزم مرئية تلقائياً، وأن تطبيقك يستطيع دائماً اكتشافها في استعلاماته. كما أن التصفية تنطبق على التطبيقات التي تستهدف أندرويد 11 أو أعلى، فنسخة قديمة من تطبيقك مثبتة على هاتف الموظف قد تتصرف بشكل مختلف عن النسخة الجديدة عند الزبون.
لذلك اختبر دائماً النسخة نفسها التي نُشرت في المتجر، لا نسخة المطور، وعلى أكثر من هاتف. وإذا جاءتك شكوى من زبون، اسأله عن نوع الهاتف وإصدار التطبيق قبل أي شيء آخر، فهذا يختصر نصف الطريق إلى السبب.
iOS: canOpenURL والأنظمة المعلنة
في iOS، كثير من التطبيقات تستخدم الدالة canOpenURL لتسأل: «هل يوجد تطبيق يفتح هذا النوع من الروابط؟» توثيق Apple يقول إن التطبيقات المربوطة على iOS 9 أو أحدث يجب أن تعلن أنظمة الروابط التي تمررها لهذه الدالة بإضافة مفتاح LSApplicationQueriesSchemes إلى ملف Info.plist، وإن الدالة تعيد دائماً false للأنظمة غير المعلنة، حتى لو كان التطبيق مثبتاً.
ويذكر التوثيق حدوداً لعدد المدخلات: التطبيقات المربوطة على iOS 15 أو أحدث محدودة بخمسين مدخلاً في هذا المفتاح، ويذكر أن التطبيقات المربوطة على iOS 27 أو أحدث محدودة بخمسة وعشرين.
والأهم: صفحة الدالة في توثيق Apple تحمل ملاحظة إيقاف تقترح محاولة فتح الرابط والتعامل مع أي فشل بدلاً من التحقق المسبق، وتذكر أن استخدام الروابط العامة بدل أنظمة الروابط المخصصة يلغي الحاجة لهذا التحقق كلياً.
الحل الأبسط للنظامين: افتح الرابط مباشرة
بدلاً من سؤال النظام «هل واتساب مثبت؟»، اجعل الزر يحاول فتح الرابط، وإذا فشل، اعرض بديلاً:
- واتساب: روابط wa.me روابط ويب عادية تبدأ بـ https. إذا كان واتساب مثبتاً، يفتحه النظام عادة، وإذا لم يكن، يفتح الرابط في المتصفح. لا حاجة للسؤال المسبق في أغلب الحالات.
- الخرائط: رابط خرائط بصيغة https يفتح تطبيق الخرائط إن وُجد، أو المتصفح إن لم يوجد.
- الاتصال الهاتفي: إذا فشل فتح رابط الاتصال، اعرض الرقم ليُنسخ.
هذا الأسلوب يتفق مع ما يقترحه توثيق Apple، ويقلل اعتمادك على قوائم الإعلان في النظامين.
متى تحتاج الإعلان فعلاً؟
إذا كان التطبيق يحتاج حقاً أن يعرف مسبقاً، مثل إخفاء زر «افتح في تطبيق كذا» عند عدم وجوده، أو استخدام نظام روابط مخصص لا بديل له بصيغة https:
- في أندرويد: أعلن اسم الحزمة أو نوع الإجراء في عنصر queries.
- في iOS: أضف نظام الرابط إلى LSApplicationQueriesSchemes، والتزم بالحد الأقصى لعدد المدخلات.
أعلن فقط ما تحتاجه. القائمة الطويلة لا تفيد، وفي iOS لها سقف. واكتب بجانب كل مدخل في وثيقة المشروع سبب وجوده، كي يعرف أي مطور لاحق ما يمكن حذفه بأمان.
قائمة اختبار
- جرّب كل زر خارجي على هاتف أندرويد حديث وواتساب مثبت.
- احذف واتساب مؤقتاً من هاتف اختبار وتأكد أن البديل يعمل.
- كرر على iPhone مع تطبيق خرائط Google وبدونه.
- بعد كل رفع لإصدار أندرويد المستهدف، أعد الاختبار، لأن المشكلة تبدأ غالباً مع هذا التغيير.
- تأكد أن رسائل الخطأ لا تقول «غير مثبت» إلا إذا كان ذلك صحيحاً فعلاً.
أسئلة شائعة
ليش التطبيق بيقول واتساب مش مثبت وهو مثبت؟
لأن أندرويد 11 فما فوق يصفّي قائمة التطبيقات المثبتة التي يراها تطبيقك، فيحصل الكود على جواب خاطئ إذا لم يعلن حاجته في عنصر queries.
شو هو LSApplicationQueriesSchemes؟
مفتاح في Info.plist في iOS تعلن فيه أنظمة الروابط التي تسأل عنها بالدالة canOpenURL. بدونه تعيد الدالة false.
هل أطلب صلاحية QUERY_ALL_PACKAGES؟
غالباً لا. التوثيق يصفها للحالات النادرة، واستخدامها على Google Play يخضع للموافقة.
شو الحل الأسهل؟
افتح رابط wa.me أو رابط الخرائط بصيغة https مباشرة، وتعامل مع الفشل ببديل، دون سؤال مسبق.
إذا كانت أزرار واتساب والخرائط في تطبيقك لا تعمل عند بعض الزبائن، راسلنا ونصلحها معك.