ما ملف AndroidManifest.xml، ولماذا هو مهم للتطبيق؟

يُعدّ ملف AndroidManifest.xml مكونًا أساسيًا في كل تطبيق Android، إذ يعمل كملف تهيئة محوري يحدد الخصائص والمكونات الأساسية للتطبيق. ومن بين أمور أخرى، يحدد اسم التطبيق وأيقوناته والأذونات التي يحتاجها ليعمل على النحو الصحيح، بينما يُضبط الإصدار عادة في بناء Gradle ويُضاف إلى ملف البيان النهائي. وعند تثبيت التطبيق، يقرأ نظام Android هذا الملف ليفهم كيف ينبغي دمج التطبيق في النظام وما الموارد التي يحتاجها.

وفضلًا عن ذلك، يتضمن ملف AndroidManifest.xml تصريحات بمكونات التطبيق، مثل الأنشطة والخدمات ومستقبلات البث وموفري المحتوى. وهذه التصريحات ضرورية لكي يسجل نظام Android الأجزاء المختلفة من التطبيق ويتعامل معها على النحو الصحيح. فمثلًا، يمكن للتطبيق نفسه تشغيل نشاط مُصرَّح به في ملف البيان، وإذا وُسم بأنه مُصدَّر، فيمكن أيضًا للتطبيقات الأخرى والنظام تشغيله، ما يتيح للتطبيق التفاعل مع التطبيقات الأخرى ووظائف النظام.

ومقارنة بملفات التهيئة الأخرى في تطبيق Android، يُعدّ AndroidManifest.xml فريدًا، لأنه لا يحدد بنية التطبيق وأذوناته فحسب، بل يتحكم أيضًا في طريقة تصرف التطبيق في سياقات وبيئات مختلفة. وهذا يجعل ملف البيان جزءًا حاسمًا من تطوير التطبيق وتوزيعه، إذ يساعد على ضمان عمل التطبيق على النحو الصحيح وبأمان عبر أجهزة وإصدارات Android المختلفة.

يُصرَّح بالأذونات في AndroidManifest.xml بالعنصر uses-permission، الذي يوضع مباشرة داخل العنصر manifest وخارج العنصر application. ويسمّي كل عنصر إذنًا، مثل android.permission.INTERNET للوصول إلى الشبكة أو android.permission.CAMERA للكاميرا. ومن دون هذا التصريح، لا يستطيع التطبيق استخدام الوظيفة المحمية، بصرف النظر عما تحاول الشيفرة فعله. وهذا يشبه iOS، حيث تُوصف أسباب استخدام التطبيق للموارد المحمية في ملف Info.plist.

ويقسّم Android الأذونات إلى مستويات حماية. فالأذونات العادية، مثل الوصول إلى الإنترنت، تُمنح تلقائيًا عند تثبيت التطبيق. أما الأذونات الخطرة، مثل الكاميرا والموقع وجهات الاتصال والميكروفون، فيجب أيضًا طلبها من المستخدم أثناء التشغيل بدءًا من Android 6.0، ويجب على التطبيق التعامل مع رفض المستخدم. ومنذ Android 13، يجب أيضًا طلب إذن عرض الإشعارات بهذه الطريقة. ويمكن قصر بعض الأذونات على إصدارات معينة من Android بالسمة android:maxSdkVersion.

ومن الممارسات الجيدة ألا يطلب التطبيق إلا الأذونات التي يحتاجها فعلًا، إذ تقلل الأذونات غير الضرورية ثقة المستخدمين وقد تثير أسئلة أثناء المراجعة في Google Play. كما يمكن للمكتبات إضافة أذونات عبر دمج ملفات البيان، لذا ينبغي فحص ملف البيان المدمج قبل الإصدار، مثلًا بعرض Merged Manifest في Android Studio. وحيثما أمكن، ينبغي تفضيل البدائل التي لا تتطلب أي إذن، مثل أداة اختيار الصور الخاصة بالنظام.

يُحدد نشاط التشغيل الخاص بالتطبيق في AndroidManifest.xml بمنح نشاط مرشح نوايا يتضمن الإجراء android.intent.action.MAIN والفئة android.intent.category.LAUNCHER. ويخبر هذا النظام بأن النشاط ينبغي تشغيله عندما ينقر المستخدم على أيقونة التطبيق.

بدءًا من Android 12، يجب أيضًا أن تُحدد في الأنشطة التي تملك مرشح نوايا السمة android:exported، ويجب ضبطها على true بالنسبة إلى نشاط التشغيل. وإذا امتلكت عدة أنشطة هذه التركيبة، فقد تظهر عدة أيقونات في المشغّل، لذا لا يملكها عادة إلا نشاط واحد. وكثيرًا ما تُعالج شاشات البدء التي تتضمن شعارًا مثلًا في الوقت الحاضر بواجهة SplashScreen البرمجية.

لا يتحكم AndroidManifest.xml في دورة الحياة نفسها، لكنه يخبر النظام بالمكونات التي يتألف منها التطبيق وكيف يجوز تشغيلها. ويجب التصريح بالأنشطة والخدمات ومستقبلات البث وموفري المحتوى في الملف؛ وإلا فلن يستطيع النظام إنشاءها.

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

يحدد الحد الأدنى من إصدار SDK والإصدار المستهدف إصدارات Android التي يدعمها التطبيق والإصدار الذي بُني واختُبر من أجله. وفي السابق، كانا يُحددان في AndroidManifest.xml بالعنصر uses-sdk، أما في المشاريع الحديثة فيُضبطان في ملف build.gradle الخاص بالوحدة بـ minSdk و targetSdk. ثم يُدرج Gradle القيم في ملف البيان النهائي.

يمثل minSdk أدنى إصدار من Android يمكن تثبيت التطبيق عليه. أما targetSdk فيخبر النظام بسلوك الإصدار وقواعده التي كُيّف التطبيق معها. ويشترط Google Play تحديث targetSdk بانتظام إلى إصدار حديث لكي تُنشر التطبيقات وتُحدَّث.

يمكن للتطبيق تعريف أذوناته الخاصة في AndroidManifest.xml بالعنصر permission. وهنا يُحدد اسم فريد، يستند عادة إلى اسم حزمة التطبيق، إلى جانب وصف ومستوى حماية. ويعني المستوى signature أن التطبيقات الموقّعة بالمفتاح نفسه وحدها يمكنها الحصول على الإذن، بينما يمنح المستويان normal و dangerous التطبيقات الأخرى الوصول بشروط مختلفة.

ويُستخدم الإذن لحماية مكونات التطبيق، مثلًا بضبط السمة android:permission على نشاط أو خدمة أو موفر محتوى. ويجب على التطبيقات الأخرى التي تريد استخدام المكون أن تطلب الإذن بـ uses-permission. وكثيرًا ما يُستخدم المستوى signature عندما تحتاج عدة تطبيقات من المطور نفسه إلى مشاركة البيانات بأمان.