Android Manifest: Difference between revisions

Latest revision as of 11:29, 22 April 2025

Android Manifest (ملف البيان)

ملف البيان (Android Manifest) هو ملف أساسي في أي تطبيق أندرويد. يعتبر بمثابة "بطاقة تعريف" التطبيق للنظام، حيث يحدد خصائص التطبيق الأساسية، والمكونات التي يتكون منها، والأذونات التي يحتاجها، ومتطلبات النظام لتشغيله. فهم ملف البيان ضروري لأي مطور أندرويد، سواء كان مبتدئًا أو محترفًا.

ما هو ملف البيان؟

ملف البيان هو ملف XML يسمى `AndroidManifest.xml`، يقع في الدليل الجذر لمشروع التطبيق. يحتوي هذا الملف على معلومات مهمة حول التطبيق، بما في ذلك:

اسم الحزمة (Package Name): معرف فريد للتطبيق، مثل `com.example.myapp`.
اسم التطبيق (Application Name): الاسم الذي يظهر للمستخدم على الجهاز.
الأيقونات (Icons): أيقونات التطبيق المستخدمة في شاشة التطبيقات والقوائم.
الأذونات (Permissions): الأذونات التي يحتاجها التطبيق للوصول إلى موارد النظام، مثل الكاميرا والميكروفون والشبكة.
المكونات (Components): تعريف جميع المكونات الرئيسية للتطبيق، مثل الأنشطة (Activities)، والخدمات (Services)، ومستقبلات البث (Broadcast Receivers)، وموفري المحتوى (Content Providers).
متطلبات النظام (System Requirements): متطلبات الأجهزة والبرامج التي يحتاجها التطبيق للتشغيل.
إصدارات أندرويد المدعومة (Supported Android Versions): تحديد الحد الأدنى لإصدار أندرويد الذي يدعمه التطبيق.
الخصائص الأخرى (Other Properties): مثل ميزات الأجهزة التي يحتاجها التطبيق (مثل الكاميرا أو البلوتوث).

بنية ملف البيان

ملف البيان يتكون من عدة عناصر رئيسية:

`<manifest>`: العنصر الجذر الذي يحيط بجميع العناصر الأخرى.
`<application>`: يحتوي على معلومات حول التطبيق بأكمله، مثل الاسم والأيقونات والأذونات.
`<activity>`: يعرّف كل نشاط (Activity) في التطبيق. النشاط هو شاشة واحدة في التطبيق يتفاعل معها المستخدم.
`<service>`: يعرّف الخدمات (Services) التي يمكن للتطبيق تشغيلها في الخلفية.
`<receiver>`: يعرّف مستقبلات البث (Broadcast Receivers) التي تستجيب للأحداث التي تحدث في النظام.
`<provider>`: يعرّف موفري المحتوى (Content Providers) الذين يوفرون الوصول إلى البيانات للتطبيقات الأخرى.
`<uses-permission>`: يحدد الأذونات التي يحتاجها التطبيق.
`<uses-feature>`: يحدد ميزات الأجهزة التي يحتاجها التطبيق.
`<supports-screens>`: يحدد أحجام الشاشات التي يدعمها التطبيق.

أهمية الأذونات

الأذونات (Permissions) هي جزء حيوي من ملف البيان. تحدد الأذونات التي يحتاجها التطبيق للوصول إلى موارد النظام. يجب على المطورين طلب الأذونات الضرورية فقط، وتوضيح سبب الحاجة إليها للمستخدم. طلب الأذونات غير الضرورية يمكن أن يؤدي إلى رفض المستخدم تثبيت التطبيق. هناك نوعان رئيسيان من الأذونات:

أذونات عادية (Normal Permissions): لا تتطلب موافقة المستخدم.
أذونات خطيرة (Dangerous Permissions): تتطلب موافقة المستخدم، مثل الوصول إلى الموقع والكاميرا والميكروفون.

تعديل ملف البيان

عادةً ما يتم تعديل ملف البيان مباشرةً من خلال بيئة التطوير المتكاملة (IDE) مثل Android Studio. يوفر Android Studio واجهة رسومية سهلة الاستخدام لتعديل ملف البيان. يمكن أيضًا تعديل الملف يدويًا باستخدام محرر نصوص، ولكن هذا يتطلب معرفة جيدة بتركيب XML.

دور ملف البيان في عملية التثبيت

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

أمثلة على عناصر ملف البيان

| العنصر | الوصف | مثال | |---|---|---| | `<activity>` | يعرّف نشاطًا في التطبيق. | `<activity android:name=".MainActivity" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity>` | | `<permission>` | يعرّف إذنًا مخصصًا. | `<permission android:name="com.example.myapp.permission.READ_DATA" android:label="@string/permission_read_data" android:description="@string/permission_read_data_description" android:permissionGroup="android.permission-group.STORAGE" />` | | `<uses-feature>` | يحدد ميزة الجهاز المطلوبة. | `<uses-feature android:name="android.hardware.camera" android:required="true" />` |

علاقة ملف البيان بـ Gradle

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

مصادر إضافية

استراتيجيات تداول الخيارات الثنائية والتحليل الفني وحجم التداول (للمبتدئين)

على الرغم من أن هذا المقال يركز على ملف البيان في تطوير الأندرويد، إلا أن فهم البيانات والتحليل يمكن أن يكون له تطبيقات أوسع. إليك بعض الاستراتيجيات ذات الصلة:

روابط داخلية إضافية

ابدأ التداول الآن

سجل في IQ Option (الحد الأدنى للإيداع $10) افتح حساباً في Pocket Option (الحد الأدنى للإيداع $5)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin للحصول على: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات باتجاهات السوق ✓ مواد تعليمية للمبتدئين

@@ Line 1: / Line 1: @@
-=== ملف Android Manifest ===
+=== Android Manifest (ملف البيان) ===
-ملف Android Manifest هو قلب أي تطبيق أندرويد، وهو بمثابة خريطة طريق لنظام التشغيل أندرويد. يصف هذا الملف المكونات الأساسية للتطبيق، والأذونات التي يحتاجها، والحد الأدنى من متطلبات النظام، وخصائص أخرى مهمة. فهم ملف Android Manifest أمر بالغ الأهمية لأي مطور [[تطبيقات أندرويد]]، حيث يؤثر بشكل مباشر على كيفية عمل التطبيق وتفاعله مع النظام.
+ملف البيان (Android Manifest) هو ملف أساسي في أي تطبيق [[أندرويد]]. يعتبر بمثابة "بطاقة تعريف" التطبيق للنظام، حيث يحدد خصائص التطبيق الأساسية، والمكونات التي يتكون منها، والأذونات التي يحتاجها، ومتطلبات النظام لتشغيله. فهم ملف البيان ضروري لأي [[مطور أندرويد]]، سواء كان مبتدئًا أو محترفًا.
-== الغرض من ملف Android Manifest ==
+== ما هو ملف البيان؟ ==
-ببساطة، ملف Android Manifest (الموجود عادةً باسم `AndroidManifest.xml`) يخبر نظام أندرويد بكل شيء عن تطبيقك. يتضمن ذلك:
+ملف البيان هو ملف XML يسمى `AndroidManifest.xml`، يقع في الدليل الجذر لمشروع التطبيق. يحتوي هذا الملف على معلومات مهمة حول التطبيق، بما في ذلك:
-*   اسم التطبيق، ورمزه، والإصدار.
+*   اسم الحزمة (Package Name): معرف فريد للتطبيق، مثل `com.example.myapp`.
-*   مكونات التطبيق: [[الأنشطة]]، [[الخدمات]]، [[بث الاستقبال]]، و[[موفري المحتوى]].
+*   اسم التطبيق (Application Name): الاسم الذي يظهر للمستخدم على الجهاز.
-*   الأذونات التي يحتاجها التطبيق للوصول إلى موارد النظام (مثل الكاميرا والموقع والتخزين).
+*   الأيقونات (Icons): أيقونات التطبيق المستخدمة في شاشة التطبيقات والقوائم.
-*   الميزات التي يستخدمها التطبيق (مثل البلوتوث وWi-Fi).
+*   الأذونات (Permissions): الأذونات التي يحتاجها التطبيق للوصول إلى موارد النظام، مثل الكاميرا والميكروفون والشبكة.
-*   الحد الأدنى من مستوى واجهة برمجة التطبيقات (API level) الذي يدعمه التطبيق.
+*   المكونات (Components): تعريف جميع المكونات الرئيسية للتطبيق، مثل الأنشطة (Activities)، والخدمات (Services)، ومستقبلات البث (Broadcast Receivers)، وموفري المحتوى (Content Providers).
-*   متطلبات الأجهزة (مثل حجم الشاشة والدقة).
+*   متطلبات النظام (System Requirements): متطلبات الأجهزة والبرامج التي يحتاجها التطبيق للتشغيل.
+*   إصدارات أندرويد المدعومة (Supported Android Versions): تحديد الحد الأدنى لإصدار أندرويد الذي يدعمه التطبيق.
+*   الخصائص الأخرى (Other Properties): مثل ميزات الأجهزة التي يحتاجها التطبيق (مثل الكاميرا أو البلوتوث).
-== هيكل ملف Android Manifest ==
+== بنية ملف البيان ==
-ملف Android Manifest هو ملف XML منظم باستخدام علامات (tags) وخصائص. إليك نظرة عامة على الهيكل الأساسي:
+ملف البيان يتكون من عدة عناصر رئيسية:
-{| class="wikitable"
+*   `<manifest>`: العنصر الجذر الذي يحيط بجميع العناصر الأخرى.
-|+ هيكل ملف Android Manifest
+*   `<application>`: يحتوي على معلومات حول التطبيق بأكمله، مثل الاسم والأيقونات والأذونات.
-|-
+*   `<activity>`: يعرّف كل نشاط (Activity) في التطبيق. النشاط هو شاشة واحدة في التطبيق يتفاعل معها المستخدم.
-| العلامة || الوصف || مثال
+*   `<service>`: يعرّف الخدمات (Services) التي يمكن للتطبيق تشغيلها في الخلفية.
-|-
+*   `<receiver>`: يعرّف مستقبلات البث (Broadcast Receivers) التي تستجيب للأحداث التي تحدث في النظام.
-| <manifest> || العنصر الجذر للملف. يجب أن يحتوي على سمات مثل `xmlns:android` و `package`. || `<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapp" />`
+*   `<provider>`: يعرّف موفري المحتوى (Content Providers) الذين يوفرون الوصول إلى البيانات للتطبيقات الأخرى.
-|-
+*   `<uses-permission>`: يحدد الأذونات التي يحتاجها التطبيق.
-| <application> || يحتوي على معلومات حول التطبيق ككل. || `<application android:icon="@drawable/ic_launcher" android:label="@string/app_name">`
+*   `<uses-feature>`: يحدد ميزات الأجهزة التي يحتاجها التطبيق.
-|-
+*   `<supports-screens>`: يحدد أحجام الشاشات التي يدعمها التطبيق.
-| <activity> || يعلن عن نشاط (شاشة) في التطبيق. || `<activity android:name=".MainActivity" android:label="@string/app_name">`
-|-
-| <service> || يعلن عن خدمة (عملية في الخلفية). || `<service android:name=".MyService" />`
-|-
-| <receiver> || يعلن عن بث استقبال (يستجيب للأحداث النظامية). || `<receiver android:name=".MyReceiver" />`
-|-
-| <provider> || يعلن عن موفر محتوى (يوفر الوصول إلى البيانات). || `<provider android:name=".MyContentProvider" />`
-|-
-| <permission> || يعلن عن إذن مخصص. || `<permission android:name="com.example.myapp.permission.READ_DATA" />`
-|-
-| <uses-permission> || يطلب إذنًا لاستخدام ميزة النظام. || `<uses-permission android:name="android.permission.CAMERA" />`
-|}
-== المكونات الرئيسية لملف Android Manifest ==
+== أهمية الأذونات ==
-*   '''علامة <application>''' : هذه العلامة هي مكان إعلان معظم خصائص التطبيق.  تشمل هذه الخصائص:
+الأذونات (Permissions) هي جزء حيوي من ملف البيان. تحدد الأذونات التي يحتاجها التطبيق للوصول إلى موارد النظام. يجب على المطورين طلب الأذونات الضرورية فقط، وتوضيح سبب الحاجة إليها للمستخدم. طلب الأذونات غير الضرورية يمكن أن يؤدي إلى رفض المستخدم تثبيت التطبيق. هناك نوعان رئيسيان من الأذونات:
-    *   `android:icon`: أيقونة التطبيق التي تظهر على شاشة المستخدم.
-    *   `android:label`: اسم التطبيق الذي يظهر للمستخدم.
-    *   `android:theme`: سمة التطبيق (مثل النمط العام).
-    *   `android:allowBackup`: يحدد ما إذا كان يمكن عمل نسخة احتياطية من بيانات التطبيق.
-*   '''علامة <activity>''' :  تعلن عن كل نشاط في التطبيق. يجب أن تحتوي كل علامة `<activity>` على السمة `android:name` التي تحدد اسم فئة النشاط. يمكن أيضًا تحديد خصائص أخرى مثل `android:label` و `android:launchMode`.
-*   '''علامة <permission>''' : تستخدم لتعريف أذونات مخصصة يمكن أن يطلبها التطبيق.
-*   '''علامة <uses-permission>''' : تستخدم لطلب أذونات من نظام أندرويد. على سبيل المثال، لطلب إذن الوصول إلى الكاميرا، يجب إضافة `<uses-permission android:name="android.permission.CAMERA" />`.
-== الأذونات (Permissions) ==
+*   أذونات عادية (Normal Permissions): لا تتطلب موافقة المستخدم.
+*   أذونات خطيرة (Dangerous Permissions): تتطلب موافقة المستخدم، مثل الوصول إلى الموقع والكاميرا والميكروفون.
-الأذونات ضرورية لحماية خصوصية المستخدم وأمان النظام. يجب على التطبيقات طلب الأذونات اللازمة فقط للوظائف التي تحتاجها.  يتم تصنيف الأذونات إلى:
+== تعديل ملف البيان ==
-*   '''أذونات عادية (Normal Permissions)''' : لا تشكل خطرًا كبيرًا على خصوصية المستخدم. يتم منحها تلقائيًا عند تثبيت التطبيق.
+عادةً ما يتم تعديل ملف البيان مباشرةً من خلال بيئة التطوير المتكاملة (IDE) مثل [[Android Studio]]. يوفر Android Studio واجهة رسومية سهلة الاستخدام لتعديل ملف البيان. يمكن أيضًا تعديل الملف يدويًا باستخدام محرر نصوص، ولكن هذا يتطلب معرفة جيدة بتركيب XML.
-*   '''أذونات خطيرة (Dangerous Permissions)''' : يمكن أن تؤثر على معلومات المستخدم الخاصة.  يجب على التطبيق طلب هذه الأذونات بشكل صريح من المستخدم في وقت التشغيل. أمثلة: الوصول إلى الموقع، الكاميرا، جهات الاتصال.
-*   '''أذونات التوقيع (Signature Permissions)''' : لا يمكن منحها إلا للتطبيقات الموقعة بنفس المفتاح.
-*   '''أذونات النظام (System Permissions)''' : محجوزة لتطبيقات النظام.
-== أهمية ملف Android Manifest ==
+== دور ملف البيان في عملية التثبيت ==
-*   '''تثبيت التطبيق:''' لا يمكن تثبيت التطبيق على جهاز أندرويد إذا كان ملف Android Manifest غير صالح أو يحتوي على أخطاء.
+عند تثبيت تطبيق أندرويد، يقوم النظام بقراءة ملف البيان للتحقق من توافق التطبيق مع الجهاز، والتحقق من الأذونات المطلوبة، وتحديد المكونات التي يجب تسجيلها في النظام. إذا لم يتمكن النظام من قراءة ملف البيان أو إذا كان يحتوي على أخطاء، فلن يتم تثبيت التطبيق.
-*   '''تشغيل التطبيق:''' يعتمد نظام أندرويد على ملف Android Manifest لتحديد كيفية تشغيل التطبيق وكيفية تفاعل مكوناته.
-*   '''الأمان:''' يضمن ملف Android Manifest أن التطبيق يطلب الأذونات اللازمة فقط، مما يحمي خصوصية المستخدم.
-*   '''التوافق:''' يساعد ملف Android Manifest على ضمان توافق التطبيق مع مختلف أجهزة أندرويد وإصدارات النظام.
-== أدوات لمساعدة في إدارة ملف Android Manifest ==
+== أمثلة على عناصر ملف البيان ==
-*   [[Android Studio]]: يوفر واجهة رسومية سهلة الاستخدام لتحرير ملف Android Manifest.
+| العنصر | الوصف | مثال |
-*   [[Gradle]]: نظام بناء يستخدم لإدارة تبعيات المشروع وأتمتة مهام البناء، بما في ذلك معالجة ملف Android Manifest.
+|---|---|---|
-*   [[Manifest Merger]]: أداة لدمج ملفات Android Manifest المتعددة.
+| `<activity>` | يعرّف نشاطًا في التطبيق. | `<activity android:name=".MainActivity" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity>` |
+| `<permission>` | يعرّف إذنًا مخصصًا. | `<permission android:name="com.example.myapp.permission.READ_DATA" android:label="@string/permission_read_data" android:description="@string/permission_read_data_description" android:permissionGroup="android.permission-group.STORAGE" />` |
+| `<uses-feature>` | يحدد ميزة الجهاز المطلوبة. | `<uses-feature android:name="android.hardware.camera" android:required="true" />` |
-== استراتيجيات تداول الخيارات الثنائية ذات الصلة (للمقارنة وفهم المخاطر) ==
+== علاقة ملف البيان بـ [[Gradle]] ==
-على الرغم من أن هذا المقال يتعلق بتطوير تطبيقات أندرويد، إلا أن فهم المخاطر والتحليل مهم بشكل عام.  في عالم تداول الخيارات الثنائية، هناك استراتيجيات متعددة:
+يعتمد بناء تطبيق [[أندرويد]] على نظام البناء [[Gradle]]. يقوم Gradle بمعالجة ملف البيان وإعداده للتثبيت على الجهاز. يمكن استخدام Gradle لتعديل ملف البيان ديناميكيًا، على سبيل المثال، لتغيير اسم التطبيق أو إصدار التطبيق.
-*   [[استراتيجية 60 ثانية]]: تداول سريع مع وقت انتهاء صلاحية قصير.
+== مصادر إضافية ==
-*   [[استراتيجية مارتينجال]]: مضاعفة الرهان بعد كل خسارة. (عالية المخاطر)
-*   [[استراتيجية فيبوناتشي]]: استخدام مستويات فيبوناتشي لتحديد نقاط الدخول والخروج.
-*   [[استراتيجية المتوسطات المتحركة]]: استخدام المتوسطات المتحركة لتحديد الاتجاه.
-*   [[استراتيجية الاختراق]]: البحث عن اختراقات في مستويات الدعم والمقاومة.
-*   [[استراتيجية النطاق]]: التداول في نطاقات سعرية محددة.
-*   [[استراتيجية التداول الاتجاهي]]: التداول مع الاتجاه السائد.
-*   [[استراتيجية التداول العكسي]]: التداول عكس الاتجاه السائد (عالية المخاطر).
-*   [[استراتيجية التداول المتأرجح]]: الاستفادة من تقلبات الأسعار.
-*   [[استراتيجية التحوط]]: تقليل المخاطر عن طريق اتخاذ مراكز متعاكسة.
-*   [[استراتيجية التداول في الأخبار]]: التداول بناءً على الأحداث الإخبارية الهامة.
-*    [[استراتيجية Pin Bar]]: تحديد أنماط Pin Bar في الرسوم البيانية.
-*    [[استراتيجية Engulfing]]: تحديد أنماط Engulfing في الرسوم البيانية.
-*    [[استراتيجية Morning Star]]: تحديد أنماط Morning Star في الرسوم البيانية.
-*    [[استراتيجية Evening Star]]: تحديد أنماط Evening Star في الرسوم البيانية.
-== التحليل الفني وحجم التداول ==
+*   [[دليل مطوري أندرويد الرسمي: ملف البيان]]
+*   [[فهم الأذونات في أندرويد]]
+*   [[استخدام Gradle لبناء تطبيقات أندرويد]]
+*   [[Intent Filters]]
+*   [[Android Components]]
+*   [[Android Security]]
-*   [[مؤشر القوة النسبية (RSI)]]: قياس زخم السعر.
+== استراتيجيات تداول الخيارات الثنائية والتحليل الفني وحجم التداول (للمبتدئين) ==
-*   [[مؤشر الماكد (MACD)]]: تحديد التغيرات في زخم السعر.
-*   [[مؤشر ستوكاستيك]]: مقارنة سعر الإغلاق بسعر النطاق خلال فترة زمنية محددة.
-*   [[تحليل حجم التداول]]: فهم قوة الاتجاه.
-*   [[الشموع اليابانية]]: تحليل أنماط الشموع اليابانية.
-*   [[خطوط الدعم والمقاومة]]: تحديد مستويات الدعم والمقاومة المحتملة.
-*   [[أنماط الرسوم البيانية]]: التعرف على أنماط الرسوم البيانية المختلفة.
-*   [[تحليل الموجات الإيليوت]]: تحديد أنماط الموجات في الأسعار.
-== روابط ذات صلة ==
+على الرغم من أن هذا المقال يركز على ملف البيان في تطوير الأندرويد، إلا أن فهم البيانات والتحليل يمكن أن يكون له تطبيقات أوسع. إليك بعض الاستراتيجيات ذات الصلة:
-*   [[Android Developers]]
+*   [[استراتيجية الاتجاه]]
-*   [[Android SDK]]
+*   [[استراتيجية الاختراق]]
+*   [[استراتيجية ارتداد]]
+*   [[تحليل الشموع اليابانية]]
+*   [[مؤشر المتوسط المتحرك]]
+*   [[مؤشر القوة النسبية (RSI)]]
+*   [[مؤشر الماكد (MACD)]]
+*   [[تحليل حجم التداول]]
+*   [[مؤشر بولينجر باندز]]
+*   [[نموذج الرأس والكتفين]]
+*   [[نموذج القاع المزدوج]]
+*   [[نموذج القمة المزدوجة]]
+*   [[استراتيجية مارتينجال]]
+*   [[استراتيجية فيبوناتشي]]
+*   [[تحليل الفجوات السعرية]]
+=== روابط داخلية إضافية ===
+*   [[Android Studio]]
+*   [[Java]]
 *   [[Kotlin]]
-*   [[Java]]
+*   [[XML]]
-*   [[IDE]]
+*   [[API]]
+*   [[SDK]]
+*   [[UI/UX Design]]
 *   [[Debugging]]
 *   [[Testing]]
-*   [[UI Design]]
+*   [[Version Control]]
-*   [[Permissions in Android]]
-*   [[Android Architecture Components]]
-*   [[Jetpack Compose]]
-*   [[Firebase]]
-*   [[Android Studio Documentation]]
-*   [[Android API Levels]]
-*   [[Android Intents]]
-[[Category:تطوير تطبيقات أندرويد]]
+[[Category:تطوير_أندرويد]]
 == ابدأ التداول الآن ==