«غير متوافق مع جهازك» في Google Play: راجع uses-feature
باختصار: إذا اشتكى بعض زبائنك أو موظفيك من أن متجر Google Play يقول إن تطبيقك «غير متوافق مع جهازك»، خصوصاً على الأجهزة اللوحية أو الهواتف القديمة، فراجع عناصر uses-feature وأذونات التطبيق. توثيق أندرويد يوضح أن Google Play يُخفي التطبيقات عن الأجهزة التي لا تملك الميزات التي يعلن التطبيق أنه يحتاجها، وأن القيمة الافتراضية لخاصية android:required هي «true». والأهم أن بعض الأذونات، مثل إذن الكاميرا، تُفهم كأنها طلب لميزة إجبارية. الحل أن تعلن كل ميزة اختيارية بقيمة «false»، وأن يتحقق التطبيق من وجودها أثناء التشغيل.
من أين تأتي الشكوى؟
مطعم في جبل الحسين أطلق تطبيق طلبات لزبائنه، وأضاف فيه زراً لمسح رمز QR الموجود على الطاولة. بعد الإطلاق بدأت رسائل مثل: «ما بقدر أنزل التطبيق على التابلت»، و«جهاز أمي بيقول غير متوافق». وفي الوقت نفسه، أراد المطعم تثبيت التطبيق نفسه على جهاز لوحي رخيص عند الكاشير لاستقبال الطلبات، فلم يظهر التطبيق في المتجر على ذلك الجهاز أصلاً.
لا يوجد خطأ في الكود، ولا تعطل في المتجر. التطبيق ببساطة أعلن، عن قصد أو بغير قصد، أنه لا يعمل إلا على أجهزة تملك كاميرا معينة. هذا مثال توضيحي لحالة شائعة.
كيف يقرر Google Play أن جهازاً «غير متوافق»؟
توثيق أندرويد لعنصر uses-feature يشرح أن Google Play يرشّح التطبيقات الظاهرة للمستخدمين بحيث لا يرون ولا يُنزّلون إلا التطبيقات المتوافقة مع أجهزتهم، وأن إحدى طرق هذا الترشيح هي توافق الميزات.
لكن هناك تفصيل مهم: التوثيق يقول إن عناصر uses-feature «معلوماتية فقط»، بمعنى أن نظام أندرويد نفسه لا يتحقق من وجود الميزة على الجهاز قبل تثبيت التطبيق. الذي يقرأها ويستخدمها هو خدمات أخرى، مثل Google Play. لهذا قد يعمل التطبيق بشكل طبيعي إذا ثُبّت يدوياً على جهاز، بينما يرفض المتجر عرضه على الجهاز نفسه.
الخاصية التي تصنع الفرق: android:required
لكل ميزة يعلنها التطبيق خاصية android:required. بحسب التوثيق:
- القيمة «true» تعني أن التطبيق لا يستطيع العمل، أو غير مصمم للعمل، عندما لا تكون الميزة موجودة.
- القيمة «false» تعني أن التطبيق يستخدم الميزة إذا وُجدت، لكنه مصمم للعمل دونها عند الحاجة.
- القيمة الافتراضية «true».
الجملة الأخيرة هي مصدر أغلب المشاكل. إذا كتب المطور عنصر ميزة دون أن يحدد الخاصية، فقد أعلن أنها إجبارية. في مثال المطعم، مسح رمز QR ميزة إضافية؛ الزبون يستطيع اختيار الطاولة يدوياً. لكن إعلان الكاميرا بلا «false» جعلها شرطاً للتثبيت.
الفخ الأكبر: الأذونات التي تعني ميزات
قد يقول المطور: «أنا ما كتبت أي uses-feature للكاميرا». هنا يأتي التحذير الذي يضعه التوثيق: الأذونات التي يطلبها التطبيق في عناصر uses-permission يمكن أن تؤثر مباشرة على طريقة ترشيح Google Play للتطبيق. ويخصص التوثيق قسماً كاملاً بعنوان «الأذونات التي تعني متطلبات ميزات»، يسرد فيه الأذونات التي تُفهم كأنها طلب ميزة، وبالتالي تؤدي إلى الترشيح.
ويعرض التوثيق مثالاً مباشراً: لتجنب الترشيح الناتج عن إذن الكاميرا، أعلن ميزة الكاميرا وميزة التركيز التلقائي للكاميرا بقيمة android:required="false". أي أن طلب إذن الكاميرا وحده، دون إعلان صريح، قد يجعل المتجر يفترض أن الكاميرا إجبارية.
لذلك عندما يضيف المطور مكتبة لمسح الرموز أو رفع الصور، يجب أن يراجع الأذونات التي أضافتها المكتبة أيضاً، لا فقط ما كتبه هو.
ما الذي يجب أن يفعله المطور؟
- اجرد الميزات: اطلب قائمة بكل عناصر uses-feature في التطبيق، وكل الأذونات المطلوبة، بما فيها ما أضافته المكتبات.
- صنّف كل ميزة: هل التطبيق مستحيل دونها فعلاً؟ تطبيق مسح باركود للمستودع قد يحتاج الكاميرا حقاً، أما تطبيق طلبات مطعم فلا.
- أعلن الاختياري صراحة: كل ميزة غير ضرورية تُعلن بقيمة android:required="false"، كما في مثال الكاميرا في التوثيق.
- تحقق أثناء التشغيل: إذا أعلنت الميزة اختيارية، يجب أن يتحقق التطبيق من وجودها قبل استخدامها، ويخفي الزر أو يعرض بديلاً عندما تكون غير موجودة. التوثيق يحيل إلى PackageManager كمرجع ذي صلة.
- راجع النتيجة قبل النشر: بعد التعديل، تأكد أن قائمة الأجهزة المتوافقة في لوحة النشر اتسعت كما تتوقع.
صمّم بديلاً للميزة الغائبة
إعلان الميزة اختيارية دون بديل يجعل المستخدم يصطدم بزر لا يعمل. فكّر في تجربة كل مستخدم:
- لا توجد كاميرا: بدل «امسح رمز الطاولة»، اعرض قائمة لاختيار رقم الطاولة.
- لا يوجد GPS دقيق: بدل تحديد الموقع تلقائياً، اطلب اختيار المنطقة من قائمة الأحياء التي توصل لها.
- لا توجد شريحة اتصال في الجهاز اللوحي: بدل زر «اتصل بالمطعم»، اعرض الرقم ليُنسخ، أو رابط واتساب.
هذه بدائل بسيطة، لكنها تجعل التطبيق يعمل على أجهزة أكثر بين زبائنك.
كيف ترد خدمة العملاء على الشكوى؟
إلى أن يصل التحديث، جهّز رداً واضحاً لفريقك. اطلب من الزبون اسم جهازه وطرازه، واسأله هل يظهر له التطبيق في المتجر أصلاً أم يظهر بلا زر تثبيت. سجّل هذه المعلومات في ملف واحد، لأن تكرار الطراز نفسه دليل قوي على ميزة معينة يفتقدها. وفي الوقت نفسه، وجّه الزبون إلى بديل يعمل فوراً، مثل الطلب من الموقع أو عبر الهاتف، حتى لا تخسر الطلب بسبب مشكلة في إعداد التطبيق. وعندما يُنشر التحديث، أبلغ الزبائن الذين اشتكوا أن بإمكانهم تجربة التثبيت مرة أخرى.
متى تكون الميزة إجبارية فعلاً؟
ليس كل ترشيح خطأ. التوثيق يوصي بإعلان كل الميزات التي يحتاجها التطبيق فعلاً، ويعطي مثالاً لتطبيق يحتاج البلوتوث والكاميرا معاً فيعلنهما إجباريتين. إذا كان تطبيقك لموظفي التوصيل يعتمد كلياً على مسح رموز الطرود، فإخفاؤه عن الأجهزة التي بلا كاميرا أفضل من تثبيته ثم فشله. المهم أن يكون القرار مقصوداً، لا نتيجة سطر نسيه المطور.
الأجهزة اللوحية عند الكاشير
كثير من المطاعم والمحلات في الأردن تستخدم أجهزة لوحية بسيطة عند الكاشير أو في المطبخ. هذه الأجهزة قد تفتقد ميزات تفترضها التطبيقات عادة. قبل شراء الأجهزة، اختبر التطبيق على نفس الطراز. وإذا كان التطبيق مخصصاً للموظفين فقط، فاسأل المطور هل يحتاج نسخة منفصلة بميزات مختلفة، بدل أن يحمل تطبيق الزبائن كل الأذونات.
أسئلة شائعة
ليش Google Play بيقول التطبيق غير متوافق مع جهازي؟
غالباً لأن التطبيق أعلن ميزة كإجبارية، أو طلب إذناً يعني ميزة، والجهاز لا يملكها، فيخفيه المتجر.
أنا ما طلبت الكاميرا كميزة، ليش بتأثر؟
لأن طلب إذن الكاميرا قد يُفهم كطلب ميزة الكاميرا. التوثيق يوصي بإعلانها مع التركيز التلقائي بقيمة false إذا كانت اختيارية.
إذا نزلت التطبيق يدوياً على الجهاز بيشتغل؟
غالباً نعم، لأن النظام نفسه لا يتحقق من هذه العناصر قبل التثبيت. الترشيح يحدث في المتجر.
هل أخلي كل الميزات اختيارية؟
لا. اجعل الإجباري ما يستحيل العمل دونه فقط، وأضف بديلاً لكل ميزة اختيارية.
إذا كان تطبيقك يختفي عن أجهزة بعض زبائنك في المتجر، تواصل معنا ونراجع ميزاته وأذوناته معك.