Lorixen.
AR

رسالة Apple عن Privacy Manifest: ملف PrivacyInfo لتطبيق iPhone

باختصار: إذا وصلت إلى مطور تطبيقك رسالة بريد من Apple بعد رفع تحديث، تقول إن التطبيق يستخدم واجهات برمجية تتطلب سبباً دون أن يذكره، أو إذا رُفض الرفع لهذا السبب، فالحل في ملف صغير اسمه PrivacyInfo.xcprivacy. توثيق Apple يشرح أن هذا الملف «بيان خصوصية» يسجل أنواع البيانات التي يجمعها التطبيق أو المكتبات الخارجية فيه، والواجهات البرمجية ذات «الأسباب المطلوبة» التي يستخدمها. ويذكر أن التطبيقات التي لا تصف استخدامها لهذه الواجهات في بيان الخصوصية لم تعد تُقبل في App Store Connect منذ 1 أيار 2024.

كيف تصل المشكلة إلى صاحب العمل؟

مطعم في عمّان لديه تطبيق طلبات على iPhone بناه مطور مستقل قبل فترة. أراد المطعم إضافة قسم عروض رمضان، فعدّل المطور التطبيق ورفع نسخة جديدة. بعد الرفع وصلت رسالة من Apple بلغة تقنية، أو لم تمر النسخة إلى المراجعة أصلاً. المطور يقول: «المشكلة من Apple»، وصاحب المطعم لا يعرف هل المشكلة في التطبيق أم في الحساب.

المطورون يتداولون لهذه الرسائل رموزاً مثل ITMS-91053، لكن المهم ليس الرمز بل المضمون: التطبيق أو إحدى مكتباته يستخدم واجهة من قائمة Apple دون شرح السبب. هذا مثال توضيحي لحالة شائعة في التطبيقات التي لم تُحدّث منذ مدة.

ما هو بيان الخصوصية؟

بحسب توثيق Apple، يمكن أن تحتوي التطبيقات والمكتبات الخارجية، سواء وُزعت كحزم أو مشاريع، على ملف بيان خصوصية اسمه PrivacyInfo.xcprivacy. هذا الملف قائمة خصائص تسجل:

  • أنواع البيانات التي يجمعها التطبيق أو المكتبة.
  • الواجهات البرمجية ذات الأسباب المطلوبة التي يستخدمها التطبيق أو المكتبة.
  • معلومات تتعلق بالتتبع، مثل ما إذا كان التطبيق يتتبع المستخدمين، ونطاقات الإنترنت المستخدمة في التتبع.

ويذكر التوثيق أن اسم الملف الافتراضي PrivacyInfo.xcprivacy هو الاسم المطلوب لبيانات الخصوصية المضمنة، وأنه يجب إضافته إلى موارد الهدف في المشروع كي يستخدمه Xcode عند إنشاء تقرير الخصوصية.

ما معنى «واجهة تتطلب سبباً»؟

Apple تحدد مجموعة من الواجهات البرمجية التي قد تُستخدم لجمع معلومات عن الجهاز، وتطلب من كل تطبيق يستخدمها أن يذكر سبب الاستخدام من قائمة أسباب محددة. توثيق Apple يقول إن فئات هذه الواجهات، وما يندرج تحت كل فئة، والأسباب المسموح ذكرها، موصوفة في توثيق مفاتيح الملف. ويضيف أن Apple تراجع هذه القائمة باستمرار وتحدّثها من وقت لآخر.

المهم لصاحب العمل: التطبيق قد يستخدم هذه الواجهات دون أن يقصد المطور ذلك، لأن مكتبة خارجية فيه تستخدمها. ومعظم تطبيقات المطاعم والمتاجر تحتوي مكتبات للإشعارات والتحليلات والخرائط والدفع.

ماذا يحدث إذا لم يكن الملف موجوداً؟

التوثيق يصف التسلسل بوضوح:

  1. إذا رفعت إلى App Store Connect تطبيقاً يستخدم واجهة ذات سبب مطلوب دون وصف السبب في بيان الخصوصية، ترسل Apple بريداً يذكّرك بإضافة السبب.
  2. ابتداءً من 1 أيار 2024، التطبيقات التي لا تصف استخدامها لهذه الواجهات في بيان الخصوصية لا تُقبل في App Store Connect.

أي أن الرسالة ليست مجرد تحذير يمكن تجاهله للأبد. إذا لم يُعالج الأمر، قد لا تستطيع نشر أي تحديث.

خطوات الإصلاح التي تطلبها من المطور

  1. قراءة الرسالة كاملة: رسالة Apple عادة تذكر فئة الواجهة التي تحتاج سبباً. هذه نقطة البداية.
  2. تحديث المكتبات الخارجية: كثير من مزودي المكتبات أضافوا بيانات خصوصية إلى إصداراتهم الأحدث. التوثيق يشير إلى أن المكتبة الخارجية يجب أن توفر بيان خصوصية إذا كانت تستخدم واجهة ذات سبب مطلوب، أو تجمع بيانات عن المستخدمين، أو تتصل بنطاقات تتبع. تحديث المكتبة قد يحل جزءاً كبيراً من المشكلة.
  3. إضافة بيان خصوصية للتطبيق نفسه: لكل فئة من الواجهات التي يستخدمها كود التطبيق، يُضاف مدخل في مصفوفة NSPrivacyAccessedAPITypes يذكر السبب، والقيم يجب أن تكون من القيم المرتبطة بتلك الفئة في توثيق Apple.
  4. التأكد أن الملف ضمن موارد التطبيق: إنشاء الملف وحده لا يكفي إذا لم يُضف إلى الهدف الصحيح في المشروع.
  5. إنشاء تقرير الخصوصية في Xcode ومراجعته: للتأكد أن ما يصرح به التطبيق ومكتباته يطابق الواقع.
  6. رفع نسخة جديدة ومراقبة البريد بعد الرفع.

لا تكتب أسباباً غير صحيحة

قد يغري الأمر بأن يختار المطور أي سبب كي تمر النسخة. هذا خطأ. التوثيق يطلب التأكد أن التطبيق أو المكتبة تستخدم الواجهات للأسباب المتوقعة فقط. السبب الذي يُكتب في البيان يجب أن يصف ما يفعله التطبيق فعلاً. إذا كان التطبيق يستخدم الواجهة لغرض غير مسموح، فالحل تعديل الكود، لا كتابة سبب آخر.

بيان الخصوصية ليس صفحة الخصوصية في المتجر

خلط شائع آخر: يظن صاحب العمل أن تعبئة قسم الخصوصية في صفحة التطبيق على App Store تكفي. توثيق Apple يذكر أن معلومات بيان الخصوصية تساعد في إنشاء تقرير الخصوصية الذي يلخص ممارسات التطبيق ومكتباته. لذلك يجب أن يتطابق ما تكتبه في صفحة المتجر مع ما يصرح به الملف داخل التطبيق. إذا قال الملف إن التطبيق يجمع رقم الهاتف لتأكيد الطلب، فيجب أن تعكس صفحة المتجر ذلك أيضاً. راجع الاثنين معاً مع المطور بعد كل تحديث يضيف ميزة تجمع بيانات جديدة.

تطبيقات Flutter وReact Native ليست استثناء

كثير من تطبيقات المطاعم والمتاجر في الأردن مبنية بأطر متعددة المنصات. هذه التطبيقات في النهاية تُبنى كتطبيق iOS عادي، وتحتوي إضافات ومكتبات أصلية تخضع للمتطلبات نفسها. اطلب من المطور التأكد من تحديث الإضافات التي يستخدمها التطبيق، ومن وجود بيان الخصوصية في مشروع iOS داخل التطبيق.

أسئلة لتسألها قبل التعاقد على تحديث

إذا كنت ستطلب تحديثاً من مطور جديد لتطبيق قديم، أضف هذه الأسئلة:

  • هل يحتوي التطبيق بيان خصوصية؟ ومتى رُوجع آخر مرة؟
  • ما المكتبات الخارجية في التطبيق، وهل إصداراتها حديثة؟
  • هل يتتبع التطبيق المستخدمين؟ وإذا نعم، هل النطاقات مذكورة في البيان؟
  • من سيتابع رسائل Apple بعد الرفع؟ أنت أم المطور؟

اجعل بريد الحساب في يدك

كثير من المحلات تكتشف رسائل Apple متأخرة لأن حساب المطور مسجل ببريد المطور الشخصي. تأكد أن رسائل حساب Apple Developer الخاص بتطبيقك تصل إلى بريد تملكه الشركة، أو على الأقل إلى بريد تراه بانتظام. التذكير الذي ترسله Apple عند الرفع لا يفيد إذا لم يقرأه أحد.

أسئلة شائعة

شو هو ملف PrivacyInfo.xcprivacy؟

بيان خصوصية يسجل البيانات التي يجمعها التطبيق ومكتباته، والواجهات ذات الأسباب المطلوبة التي يستخدمها، ومعلومات التتبع.

أبل بعتتلنا إيميل عن Privacy Manifest، شو يعني؟

يعني أن التطبيق يستخدم واجهة ذات سبب مطلوب دون ذكره في البيان. بحسب Apple، التطبيقات التي لا تصف ذلك لا تُقبل في App Store Connect.

المطور بيقول المشكلة من مكتبة خارجية، صح؟

قد يكون. المكتبات التي تستخدم هذه الواجهات يُفترض أن تحمل بيان خصوصية خاصاً بها، وتحديثها غالباً جزء من الحل.

هل أكتب أي سبب حتى ينقبل التطبيق؟

لا. السبب يجب أن يطابق ما يفعله التطبيق فعلاً.

إذا تعطل تحديث تطبيقك بسبب رسائل Apple عن بيان الخصوصية، راسلنا ونراجع التطبيق معك.

المصادر

WhatsAppاحجز مكالمة