شارح Info.plist
الصق ملف Info.plist، أو ما تطبعه plutil -p. يُقرأ هنا داخل هذه الصفحة، ولا يُرسل شيء إلى أي مكان.
جرّب مثالًا:
ماذا تفعل
في كل تطبيق Mac ملف Info.plist داخله، في Contents. هو ملف إعدادات صغير يخبر macOS باسم التطبيق ومعرّف الحزمة والإصدار وأقدم macOS يعمل عليها وفئته وهل له أيقونة في Dock، والرسائل التي يعرضها macOS عندما يطلب التطبيق الكاميرا أو الميكروفون أو التحكم في تطبيقات أخرى. تقرأ هذه الأداة الملف الذي تلصقه وتقول بكلمات بسيطة ما يفعله كل مفتاح. وتضع أولاً ما سيوقف التطبيق أو تحديثاته أو مراجعته، ثم ما يستحق نظرة ثانية، ثم المفاتيح العادية.
الأوامر المطلوب تشغيلها
plutil -p YourApp.app/Contents/Info.plist plutil -lint YourApp.app/Contents/Info.plist
الأمر الأول يطبع الملف بصيغة يمكنك لصقها هنا، حتى لو كان مخزّناً بصيغة ثنائية. والثاني يتحقق من أن الملف صالح. وفي مشروع Xcode كثيراً ما يحتوي الملف على أشياء مثل $(MARKETING_VERSION)، ويملؤها Xcode عند البناء. لترى القيم الحقيقية، افحص النسخة الموجودة داخل التطبيق المبني.
معنى كل نتيجة
| العلامة | ماذا تعني |
|---|---|
| إصلاح | مفتاح مفقود أو فارغ بطريقة تعطّل التطبيق أو تحديثاته أو مراجعته في App Review، مثل غياب رقم البناء أو رسالة إذن فارغة. |
| المظهر | يعمل، لكنه قد يثير أسئلة في App Review أو يربك الناس، مثل رسالة إذن غامضة أو السماح بـ http العادي في كل مكان. |
| سليم | مضبوط كما تصف وثائق Apple. |
| ملاحظة | معلومة مفيدة، مثل ما أضافه Xcode عند بناء التطبيق. |
المصادر: Apple Developer, Information Property List وProtected resources وLSApplicationCategoryType وNSAppTransportSecurity ووثائق Sparkle، وكلها قُرئت في 9 نوفمبر 2026.
كيف يعمل
هي بضع قواعد نصية بسيطة تعمل داخل هذه الصفحة. تقرأ XML الخاص بملف Info.plist، أو المستوى الأعلى مما تطبعه plutil -p. وهي تعرف 80 من المفاتيح الشائعة ورسائل الأذونات. وكل ما عدا ذلك تضعه علامة «غير موجود في قائمتها» بدل التخمين. ولا تستطيع معرفة ما إذا كان تطبيقك يستخدم الكاميرا أو الميكروفون فعلاً، أو ما إذا كانت رسالة الإذن مفقودة لشيء يفعله التطبيق: يوقف macOS التطبيق الذي يطلب بدونها، لذا جرّب كل ميزة مرة واحدة. لا شيء مما تلصقه يُحفظ أو يُرسل.
الأسئلة
ما هو ملف Info.plist على Mac؟
ملف إعدادات داخل كل تطبيق، في المسار Contents/Info.plist. يحمل اسم التطبيق ومعرّف الحزمة والإصدار وأدنى macOS والفئة والرسائل التي يعرضها macOS عندما يطلب التطبيق إذناً.
كيف أقرأ ملف Info.plist الخاص بتطبيق؟
شغّل plutil -p متبوعاً بمسار Contents/Info.plist في Terminal. يطبع الملف كنص عادي، حتى لو كان مخزّناً بصيغة ثنائية.
ما الفرق بين CFBundleVersion وCFBundleShortVersionString؟
CFBundleShortVersionString هو الإصدار الذي يراه الناس، مثل 2.1. أما CFBundleVersion فهو رقم البناء الذي يقارن به macOS وMac App Store وSparkle لمعرفة أي نسخة أحدث.
لماذا ينهار تطبيق Mac الخاص بي عندما يطلب الكاميرا؟
يوقف macOS التطبيق الذي يطلب الكاميرا أو الميكروفون أو بيانات خاصة أخرى دون وصف الاستخدام المطابق في ملف Info.plist. أضف NSCameraUsageDescription مع سبب واضح.
هل يُرسل ما ألصقه إلى أي مكان؟
لا. يُقرأ النص داخل هذه الصفحة ولا يُرسل شيء ولا يُحفظ.