إنشاء مشروع أو استيراده
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يساعدك Android Studio for Platform (ASfP) في إعداد بيئة التطوير الخاصة بك
لمشروع Android المفتوح المصدر (AOSP). توضّح هذه الصفحة كيفية بدء مشروع جديد أو استيراد مشروع حالي.
خطوات إنشاء مشروع جديد
إذا لم يكن لديك مشروع مفتوح، انقر على مشروع جديد في شاشة الترحيب. 
إذا كان لديك مشروع مفتوح، انقر على ASfP > المشروع > مشروع جديد من القائمة.
املأ تفاصيل إعدادات المشروع في المعالج: 
- مسارات الوحدات: حدِّد المسار المطلق إلى جذر عملية استخراج رمز المصدر لنظام التشغيل AOSP (على سبيل المثال،
/path/to/aosp).
- هدف الغداء: أدخِل هدف الغداء الذي تستخدمه في عملية الإنشاء (على سبيل المثال،
aosp_arm64-eng).
- اسم المشروع: أدخِل اسمًا وصفيًا لمشروعك.
- الأدلة أو الوحدات: أدرِج الأدلة أو الوحدات الأولية التي تريد تضمينها في مشروعك، مع الفصل بينها بفواصل. يجب أن تكون هذه المسارات نسبية من جذر المستودع (على سبيل المثال،
frameworks/base,
packages/apps/Settings). ويمكنك إضافة المزيد أو تحسين هذا الاختيار لاحقًا.
انقر على إنهاء. ينشئ ASfP بنية المشروع وملف .asfp-project
الإعداد.
بعد إعداد المشروع الأوّلي، يمكنك تخصيص مشروعك بشكل أكبر من خلال تعديل ملف .asfp-project الموجود في جذر المشروع. يتيح لك هذا الملف إجراء ما يلي:
- إضافة الأدلة والوحدات أو إزالتها
- تفعيل إمكانية استخدام لغات أخرى، مثل Rust أو C++
- ضبط علامات الإنشاء ومتغيّرات البيئة
- تحديد مصادر الاختبار
للحصول على معلومات مفصّلة حول جميع خيارات الإعداد، يُرجى الاطّلاع على نظرة عامة حول المشاريع. بعد تعديل .asfp-project، عليك مزامنة المشروع حتى تصبح التغييرات سارية المفعول.
استيراد مشروع حالي
لا يتضمّن ASfP إجراء "استيراد" منفصلاً. لفتح إعدادات مشروع ASfP حالي، اتّبِع الخطوات التالية:
- اختَر ASfP > Project > New Project.
- في الحقل اسم المشروع، انتقِل إلى الدليل الذي يحتوي على ملف
.asfp-project الحالي الذي تريد فتحه واختَره. ستتم تعبئة الحقول في المعالج استنادًا إلى ملف .asfp-project المحدّد.
- انقر على إنهاء. يفتح ASfP المشروع ويفهرسه.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["Android Studio for Platform (ASfP) helps you set up your development environment\nfor the [Android Open Source Project (AOSP)](https://source.android.com/). This page explains how to\nstart a new project or import an existing one.\n\nCreate a new project\n\n1. If you don't have a project open, click **New Project** on the Welcome\n screen.\n\n2. If you already have a project open, select **ASfP \\\u003e Project \\\u003e New Project**\n from the menu.\n\n3. Fill in the project configuration details in the wizard:\n\n - **Module paths:** Specify the absolute path to the root of your AOSP source code checkout (for example, `/path/to/aosp`).\n - **Lunch target:** Enter the lunch target you use for building (for example, `aosp_arm64-eng`).\n - **Project name:** Give your project a descriptive name.\n - **Directories / modules:** List the initial directories or modules you want to include in your project, separated by commas. These should be relative paths from the repository root (for example, `frameworks/base,\n packages/apps/Settings`). You can add more or refine this selection later.\n4. Click **Finish** . ASfP creates the project structure and the `.asfp-project`\n configuration file.\n\nConfigure and customize your project\n\nAfter the initial project setup, you can further customize your project by\nediting the `.asfp-project` file located in the project root. This file lets\nyou:\n\n- Add or remove directories and modules.\n- Enable support for other languages like Rust or C++.\n- Configure build flags and environment variables.\n- Specify test sources.\n\nFor detailed information on all configuration options, see the [Projects\noverview](/studio/platform/projects). After editing `.asfp-project`, you'll need to sync the project for\nthe changes to take effect.\n\nImport an existing project\n\nASfP doesn't have a separate \"import\" action. To open an existing ASfP project\nconfiguration:\n\n1. Select **ASfP \\\u003e Project \\\u003e New Project**.\n2. In the **Project Name** field, navigate to and select the directory containing the existing `.asfp-project` file you want to open. The fields in the wizard will populate based on the selected `.asfp-project` file.\n3. Click **Finish**. ASfP opens and indexes the project."]]
