تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسهّل Android Studio إنشاء تطبيقات Android لمختلف أشكال الأجهزة، مثل الهواتف والأجهزة اللوحية وأجهزة التلفزيون وأجهزة Wear. توضّح هذه الصفحة كيفية بدء مشروع تطبيق Android جديد أو استيراد مشروع حالي.
إذا لم يكن لديك مشروع مفتوح، أنشئ مشروعًا جديدًا بالنقر على مشروع جديد في شاشة الترحيب في Android Studio.
إذا كان لديك مشروع مفتوح، يمكنك إنشاء مشروع جديد من خلال النقر على
ملف > جديد > مشروع جديد من القائمة الرئيسية.
اختيار نوع مشروعك
في شاشة مشروع جديد التي تظهر، يمكنك اختيار نوع المشروع الذي تريد إنشاءه من فئات عوامل شكل الجهاز، والتي تظهر في لوحة النماذج. على سبيل المثال، يعرض الشكل 1 نماذج المشاريع للهاتف والجهاز اللوحي.
الشكل 1. اختَر نوع المشروع الذي تريد إنشاءه في شاشة مشروع جديد.
يسمح لك اختيار نوع المشروع الذي تريد إنشاءه بأن يضمّن "استوديو Android" عيّنات من الرموز والموارد في مشروعك لمساعدتك في البدء.
بعد اختيار نوع مشروعك، انقر على التالي.
إعداد مشروعك
الخطوة التالية في إنشاء مشروعك هي ضبط بعض الإعدادات، كما هو موضّح في الشكل 2. إذا كنت بصدد إنشاء مشروع Native C++، يُرجى قراءة مقالة إنشاء مشروع جديد يتوافق مع C/C++ للتعرّف على المزيد من المعلومات حول الخيارات التي عليك ضبطها.
الشكل 2. اضبط مشروعك الجديد
باستخدام بعض الإعدادات.
حدِّد اسم مشروعك.
حدِّد اسم الحزمة. يصبح اسم الحزمة هذا تلقائيًا مساحة اسم مشروعك (المستخدَمة للوصول إلى موارد مشروعك) ومعرّف تطبيق مشروعك (المستخدَم كمعرّف للنشر). لمزيد من المعلومات، اطّلِع على
ضبط وحدة التطبيق.
حدِّد موقع الحفظ الذي تريد تخزين مشروعك فيه على جهازك.
اختَر اللغة، Kotlin أو Java، التي تريد أن يستخدمها "استوديو Android" عند إنشاء نموذج رموز لمشروعك الجديد. يُرجى العِلم أنّه ليس عليك استخدام تلك اللغة فقط في المشروع.
اختَر الحد الأدنى لمستوى واجهة برمجة التطبيقات الذي تريد أن يتوافق معه تطبيقك. عند اختيار مستوى واجهة برمجة تطبيقات أقل، لن يتمكّن تطبيقك من استخدام العديد من واجهات برمجة التطبيقات الحديثة لنظام Android.
في المقابل، يمكن لنسبة أكبر من أجهزة Android تشغيل تطبيقك، ويحدث العكس عند اختيار مستوى أعلى لواجهة برمجة التطبيقات.
إذا أردت الاطّلاع على المزيد من البيانات لمساعدتك في اتخاذ القرار، انقر على ساعدني في الاختيار.
يعرض هذا الخيار مربّع حوار يعرض التوزيع التراكمي لمستوى واجهة برمجة التطبيقات الذي اخترته، ويتيح لك الاطّلاع على تأثير استخدام مستويات مختلفة من الحد الأدنى لمستوى واجهة برمجة التطبيقات.
الشكل 3. شاشة مساعدة تعرض التوزيع التراكمي لمستويات واجهة برمجة التطبيقات المختلفة.
تم إعداد مشروعك لاستخدام مكتبات AndroidX تلقائيًا، وهي
تحل محل مكتبات Android Support. لاستخدام مكتبات الدعم القديمة بدلاً من ذلك، اختَر استخدام مكتبات android.support القديمة. ومع ذلك، لا يُنصح بذلك لأنّ مكتبات الدعم القديمة لم تعُد متاحة. لمزيد من المعلومات، يُرجى الاطّلاع على
نظرة عامة على AndroidX.
عندما تكون مستعدًا لإنشاء مشروعك، انقر على إنهاء.
ينشئ Android Studio مشروعك الجديد باستخدام بعض الرموز والموارد الأساسية لمساعدتك في البدء. إذا قررت إضافة دعم لعامل شكل جهاز مختلف في وقت لاحق، يمكنك إضافة وحدة إلى مشروعك.
وإذا أردت مشاركة الرموز والموارد بين الوحدات، يمكنك إجراء ذلك من خلال إنشاء مكتبة Android.
لاستيراد مشروع محلي حالي إلى "استوديو Android"، اتّبِع الخطوات التالية:
انقر على ملف > جديد > استيراد مشروع.
في النافذة التي تظهر، انتقِل إلى الدليل الجذر للمشروع الذي تريد استيراده.
انقر على موافق.
يفتح Android Studio المشروع في نافذة جديدة لبيئة التطوير المتكاملة (IDE) ويفهرس محتوياته.
إذا كنت تستورد مشروعًا من نظام التحكّم بالإصدارات، اختَر ملف > جديد > مشروع من نظام التحكّم بالإصدارات. لمزيد من المعلومات حول استيراد المشاريع من نظام التحكّم بالإصدارات، يُرجى الاطّلاع على معلومات IntelliJ حول التحكّم بالإصدارات.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Create a project\n\nAndroid Studio makes it easy to create Android apps for various form factors,\nsuch as phones, tablets, TVs, and Wear devices. This page explains how to\nstart a new Android app project or import an existing project.\n\nIf you don't have a project opened, create a new project by clicking\n**New Project** on the Android Studio Welcome screen.\n\nIf you do have a project opened, create a new project by selecting\n**File \\\u003e New \\\u003e New Project** from the main menu.\n\nChoose your project type\n------------------------\n\nIn the **New Project** screen that appears, you can select the type of\nproject you want to create from categories of device form factors, shown in\nthe **Templates** pane. For example, figure 1 shows the project\ntemplates for phone and tablet.\n**Figure 1.** Choose the type of project you want to create on the **New Project** screen.\n\nSelecting the type of project you want to create lets Android Studio include\nsample code and resources in your project to help you get started.\n\nOnce you select your project type, click **Next**.\n\nConfigure your project\n----------------------\n\nThe next step in creating your project is to configure some settings, as\nshown in figure 2. If you're creating a **Native C++**\nproject, read\n[Create a new project with C/C++\nsupport](/studio/projects/add-native-code#new-project) to learn more about the\noptions you need to configure.\n**Figure 2.** Configure your new project with a few settings.\n\n1. Specify the **Name** of your project.\n2. Specify the **Package name** . By default, this package name becomes your project's namespace (used to access your project resources) and your project's application ID (used as the ID for publishing). To learn more, see [Configure the app module](/studio/build/configure-app-module).\n3. Specify the **Save location** where you want to locally store your project.\n4. Select the **Language**, Kotlin or Java, you want Android Studio to use when creating sample code for your new project. Keep in mind that you aren't limited to using only that language in the project.\n5. Select the **Minimum API level** you want your app to support. When you\n select a lower API level, your app can't use as many modern Android APIs.\n However, a larger percentage of Android devices can run your app. The\n opposite is true when selecting a higher API level.\n\n If you want to see more data to help you decide, click **Help me choose**.\n This displays a dialog showing the cumulative distribution for the API\n level you have selected and lets you see the impact of using different\n minimum API levels.\n **Figure 3.** A help screen that shows the cumulative distribution of different API levels.\n6. Your project is configured to use AndroidX libraries by default, which\n replace the Android Support libraries. To use the\n legacy support libraries instead, select **Use legacy\n android.support libraries** . However, this is not recommended, as the legacy\n support libraries are no longer supported. To learn more, read the\n [AndroidX overview](/jetpack/androidx).\n\n7. When you're ready to create your project, click **Finish**.\n\nAndroid Studio creates your new project with some basic code and resources to\nget you started. If you decide to add support for a different device form\nfactor later, you can [add a module](/studio/projects/add-app-module) to your project.\nAnd if you want to share code and resources between modules, you can do\nso by creating an [Android library](/studio/projects/android-library).\n\nFor more information about the Android project structure and module types,\nread the [Projects overview](/studio/projects). If you're new to Android\ndevelopment altogether, start with the [Android Developer Guides](/training).\n\nImport an existing project\n--------------------------\n\nTo import an existing local project into Android Studio, proceed as follows:\n\n1. Click **File** \\\u003e **New** \\\u003e **Import Project**.\n2. In the window that appears, navigate to the root directory of the project you want to import.\n3. Click **OK**.\n\nAndroid Studio opens the project in a new IDE window and indexes its\ncontents.\n\nIf you are importing a project from version control, select **File** \\\u003e\n**New** \\\u003e **Project from Version Control** . For more\ninformation about importing projects from version control, read IntelliJ's\ninformation about\n[Version control](https://www.jetbrains.com/help/idea/version-control-integration.html)."]]
