تطبيقك لا يرى إلا بعض صور الزبون؟ الوصول الجزئي في أندرويد 14
باختصار: إن كان تطبيقك يعرض معرض صور الجوال داخله، كتطبيق طباعة صور أو متجر يطلب صور المنتج من البائع، فقد يشتكي بعض المستخدمين: «التطبيق لا يرى إلا صورتين»، أو «اخترت الصور أمس واليوم اختفت». السبب غالباً ميزة الوصول الجزئي إلى الصور في أندرويد 14: يستطيع المستخدم في نافذة الإذن أن يختار «تحديد صور وفيديوهات» بدل منح الوصول الكامل. يوضح توثيق أندرويد أن هذا الوصول مؤقت وينتهي في النهاية، وأن على التطبيق أن يتعامل مع حالة عدم وجود وصول، وأن يوفر طريقة لإعادة الاختيار عبر إذن READ_MEDIA_VISUAL_USER_SELECTED.
الشكوى كما تصل
استوديو تصوير وطباعة في عمّان لديه تطبيق يرفع منه الزبائن صورهم لطلب ألبوم مطبوع. التطبيق يعرض معرضاً خاصاً بشبكة صور جميلة، يختار منها الزبون. بعد تحديث أندرويد عند كثير من الزبائن، بدأت رسائل مثل:
- «فتحت التطبيق وطلب إذناً، اخترت بعض الصور، والآن لا أرى غيرها.»
- «رجعت للتطبيق لأكمل الطلب، والصور التي اخترتها لم تعد موجودة.»
- «لا يوجد زر لإضافة صور أخرى.»
التطبيق لم يتعطل. هو ببساطة لا يعرف كيف يتعامل مع الخيار الثالث الذي صار يظهر للمستخدم.
ما الذي تغيّر في أندرويد 14
يشرح توثيق أندرويد أن أندرويد 14 يتيح للمستخدم تحديد صور وفيديوهات بعينها يريد أن يتيحها للتطبيق، إضافة إلى الخيارين المعتادين: منح الوصول الكامل أو رفض الوصول كله. ويذكر أن هذا التغيير يُفعّل فقط إن كان تطبيقك يستهدف أندرويد 14، أي API 34، أو أعلى.
وعندما يختار المستخدم «تحديد صور وفيديوهات» في المرة الأولى، يوضح التوثيق أن إذني READ_MEDIA_IMAGES وREAD_MEDIA_VIDEO يُمنحان خلال جلسة التطبيق فقط، كمنح مؤقت ووصول مؤقت إلى الصور المختارة. وحين ينتقل التطبيق إلى الخلفية، أو يغلقه المستخدم، يرفض النظام هذه الأذونات في النهاية، مثل الأذونات التي تُمنح لمرة واحدة.
التعامل مع الوصول كمؤقت
أهم نصيحة في التوثيق: إن اختار المستخدم تحديد صور معينة، فإن وصول التطبيق إليها ينتهي في النهاية، ويجب أن يتعامل التطبيق دائماً مع حالة عدم وجود وصول إلى أي رابط صورة.
ماذا يعني هذا عملياً لتطبيق الاستوديو:
- لا تحفظ روابط الصور المختارة وتفترض أنها ستبقى صالحة غداً.
- إن كان الزبون سيكمل الطلب لاحقاً، فارفع الصور إلى الخادم فور اختيارها، أو انسخها إلى مساحة التطبيق الخاصة، بدل الاعتماد على الوصول إليها من المعرض.
- إن عاد الزبون ولم يعد الوصول متاحاً، فاعرض رسالة واضحة: «لم يعد التطبيق يرى صورك المختارة، اضغط لاختيارها مرة أخرى»، لا شاشة فارغة. وأبقِ ما رُفع محفوظاً في الطلب حتى لا يبدأ الزبون من الصفر.
زر «اختر صوراً أخرى»
يذكر التوثيق أن التطبيق إن احتاج لاحقاً إلى صور وفيديوهات إضافية، فعليه طلب الأذونات مرة أخرى يدوياً. ويوصي بأن يعتمد التطبيق إذن READ_MEDIA_VISUAL_USER_SELECTED للتحكم في إعادة الاختيار، وأن يُحدّث واجهته ليتيح للمستخدم منح الوصول إلى مجموعة مختلفة من الصور. نافذة النظام الجديدة تتيح للمستخدم إعادة تحديد الصور التي يريد إتاحتها.
إذن، في رأس المعرض داخل تطبيقك، ضع شريطاً صغيراً حين يكون الوصول جزئياً: «يرى التطبيق الصور التي اخترتها فقط. إدارة الصور». الضغط عليه يطلب الأذونات مرة أخرى، فتظهر للمستخدم نافذة إعادة الاختيار.
إن لم تعتمد الإذن الجديد
يوضح التوثيق أن التطبيق الذي لا يستخدم الإذن الجديد يعمل في «وضع التوافق». ويعرض جدولاً: لتطبيق يستهدف SDK 34 دون إعلان READ_MEDIA_VISUAL_USER_SELECTED، تبقى ميزة تحديد الصور مفعّلة، لكن سلوك الواجهة يتحكم فيه النظام بدل التطبيق. ويقول التوثيق إن هذا قد لا يكون مثالياً بحسب حالة استخدام تطبيقك.
بمعنى آخر: الميزة ستظهر لمستخدميك سواء استعددت لها أم لا. الفرق هو هل يملك تطبيقك تجربة واضحة حولها، أم يترك المستخدم أمام معرض ناقص بلا تفسير.
كيف يعرف التطبيق أي حالة هو فيها
يعرض التوثيق منطقاً للتحقق يمكن أن يلخصه مطورك هكذا: إن كان إذن READ_MEDIA_IMAGES أو READ_MEDIA_VIDEO ممنوحاً على أندرويد 13 أو أحدث، فالوصول كامل. وإن لم يكن، لكن READ_MEDIA_VISUAL_USER_SELECTED ممنوح على أندرويد 14 أو أحدث، فالوصول جزئي. وإن لم يكن أي منهما ممنوحاً، فلا وصول.
هذه الحالات الثلاث يجب أن تقابلها ثلاث واجهات مختلفة في تطبيقك:
- كامل: المعرض كما هو.
- جزئي: المعرض مع الشريط الذي يشرح ويتيح «إدارة الصور».
- لا وصول: شاشة تشرح لماذا يحتاج التطبيق الصور، مع زر واحد واضح لطلبها، وبديل «اختيار من منتقي النظام».
ويُفحص هذا في كل مرة يعود فيها المستخدم إلى شاشة المعرض، لا مرة واحدة عند تشغيل التطبيق، لأن المستخدم قد يغيّر خياره من إعدادات الجهاز في أي وقت.
اطلب ما تحتاجه فقط
ملاحظة مفيدة في التوثيق: نافذة الاختيار تتأثر بنوع الإذن المطلوب. إن طلبت READ_MEDIA_IMAGES فقط، فلن تظهر للاختيار إلا الصور. وإن طلبت الفيديو فقط، فلن يظهر إلا الفيديو. وإن طلبت الاثنين، تظهر المكتبة كلها. تطبيق طباعة صور لا يحتاج إلى الفيديو، فلا تطلبه، فتصبح النافذة أبسط للزبون.
الحل الأبسط في كثير من الحالات
يذكر التوثيق أيضاً أن منتقي الصور Photo Picker في النظام يوفر تجربة متسقة لاختيار الصور والفيديو ويعزز الخصوصية دون الحاجة إلى طلب أي أذونات تخزين، ويوصي به لمن لا يستخدمه بعد. أما بناء معرض خاص بأذونات التخزين فيحتاج، بحسب التوثيق، إلى تطوير وصيانة كبيرين. إن كان معرضك الخاص لا يقدم شيئاً لا يقدمه منتقي النظام، فهذا وقت مناسب لسؤال مطورك: هل نحتاجه أصلاً؟
مثال توضيحي لخطة إصلاح
مثال توضيحي لما قد يتفق عليه الاستوديو مع المطور:
- رفع كل صورة يختارها الزبون إلى الخادم مباشرة، مع شريط تقدم.
- إضافة شريط «الوصول جزئي، إدارة الصور» أعلى المعرض.
- إعلان إذن READ_MEDIA_VISUAL_USER_SELECTED وطلبه مع إذن الصور.
- عدم طلب إذن الفيديو.
- اختبار السيناريو كاملاً على جهاز بأندرويد 14: اختيار جزئي، إغلاق التطبيق، العودة بعد ساعة.
- اختبار تغيير الإذن من إعدادات الجهاز أثناء وجود طلب غير مكتمل، والتأكد أن التطبيق لا يتعطل ولا يفقد ما رُفع.
أسئلة شائعة
لماذا يرى تطبيقي بعض الصور فقط؟
لأن المستخدم اختار في أندرويد 14 أو أحدث تحديد صور بعينها بدل منح الوصول الكامل، وهذا خياره.
لماذا اختفت الصور المختارة بعد إغلاق التطبيق؟
لأن الوصول الجزئي مؤقت. توثيق أندرويد يوضح أن النظام يرفض الأذونات في النهاية بعد انتقال التطبيق إلى الخلفية أو إغلاقه.
كيف أسمح للمستخدم بإضافة صور أخرى؟
اطلب الأذونات مرة أخرى مع READ_MEDIA_VISUAL_USER_SELECTED، فتظهر له نافذة إعادة الاختيار.
هل أحتاج إلى أذونات الصور أصلاً؟
ليس دائماً. منتقي الصور في النظام لا يحتاج إلى أذونات تخزين، بحسب توثيق أندرويد.
إذا كان زبائنك يشتكون من صور ناقصة أو مختفية داخل تطبيقك، تواصل معنا لمراجعة طريقة اختيار الصور فيه.