أدوات سطر الأوامر
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتكون حزمة تطوير البرامج (SDK) لنظام التشغيل Android من حزم متعددة مطلوبة لتطوير التطبيق.
تسرد هذه الصفحة أهم أدوات سطر الأوامر
المتاحة، والتي يتم تنظيمها حسب الحزم التي تم تسليمها.
يمكنك تثبيت كل حزمة وتحديثها باستخدام إدارة SDK في "استوديو Android" أو باستخدام sdkmanager أداة سطر الأوامر.
يتم تنزيل جميع الحزم إلى دليل حزمة تطوير البرامج (SDK) لنظام التشغيل Android، والذي يمكنك العثور عليه على النحو التالي:
- في "استوديو Android"، انقر على ملف > بنية المشروع.
- اختَر موقع حزمة تطوير البرامج (SDK) في اللوحة اليمنى.
يظهر المسار ضمن موقع حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
ضبط متغيرات البيئة
ننصح بإعداد متغيّر البيئة للسمة ANDROID_HOME عند استخدام سطر الأوامر. ويمكنك أيضًا ضبط مسار بحث الأوامر ليشمل
ANDROID_HOME/tools وANDROID_HOME/tools/bin و
ANDROID_HOME/platform-tools للعثور على الأدوات الأكثر شيوعًا. تختلف الخطوات
حسب نظام التشغيل الذي تستخدمه، ولكن اقرأ
كيفية ضبط متغيرات البيئة للحصول على إرشادات عامة.
موجود في: android_sdk/cmdline-tools/version/bin/
ملاحظة: تحلّ حزمة أدوات سطر الأوامر لحزمة تطوير البرامج (SDK) لنظام التشغيل Android في cmdline-tools محلّ حزمة أدوات SDK في tools. باستخدام
الحزمة الجديدة، يمكنك اختيار الإصدار الذي تريد تثبيته من أدوات سطر الأوامر،
كما يمكنك تثبيت إصدارات متعددة في الوقت نفسه. باستخدام الحزمة القديمة، يمكنك تثبيت أحدث إصدار من الأدوات فقط. وبالتالي، تتيح لك الحزمة الجديدة الاعتماد على إصدارات معيّنة من أدوات سطر الأوامر بدون الحاجة إلى فاصل الرموز عند إطلاق إصدارات جديدة. للاطّلاع على معلومات
حول حزمة أدوات SDK المتوقّفة نهائيًا، يُرجى الاطّلاع على
ملاحظات إصدار "أدوات SDK".
إذا لم تكن تستخدم "استوديو Android"، يمكنك تنزيل حزمة أدوات سطر الأوامر من هنا.
apkanalyzer- يقدِّم إحصاءات حول تركيبة APK بعد اكتمال عملية الإنشاء.
avdmanager- يسمح لك بإنشاء أجهزة Android الافتراضية (AVD) وإدارتها
من سطر الأوامر.
lint- يمسح الرمز ضوئيًا الرموز لمساعدتك في تحديد وتصحيح المشاكل المتعلقة بالجودة الهيكلية للرموز البرمجية.
retrace- بالنسبة إلى التطبيقات التي تم تجميعها من خلال R8، يفكّ
retrace ترميز تتبُّع تسلسل استدعاء الدوال البرمجية الذي
يتم إخفاء مفاتيح فك تشفيرها باستخدام رمز المصدر الأصلي.
sdkmanager- يتيح لك هذا الخيار عرض الحِزم وتثبيتها وتحديثها وإلغاء تثبيتها لحزمة تطوير البرامج (SDK) لنظام التشغيل Android.
متوفّرة في: android_sdk/build-tools/version/
يمكنك الاطّلاع على ملاحظات إصدار "أدوات إصدار SDK" للحصول على مزيد من المعلومات.
هذه الحزمة مطلوبة لإنشاء تطبيقات Android. يتم استدعاء معظم الأدوات في هذه الحزمة
من خلال أدوات الإنشاء وهي ليست مخصصة لك. ومع ذلك، قد تكون أدوات سطر
الأوامر التالية مفيدة:
AAPT2- تحليل موارد Android وفهرستها وتجميعها في تنسيق ثنائي
تم تحسينه ليلائم نظام Android الأساسي ودمج الموارد المجمّعة
في نتيجة واحدة
apksigner- تشير إلى ملفات APK وتحقّق مما إذا كان سيتم التحقّق من توقيعات APK
بنجاح على جميع إصدارات النظام الأساسي التي تتوافق معها حزمة APK معيّنة.
zipalign- يحسّن ملفات APK من خلال التأكد من أن جميع البيانات غير المضغوطة تبدأ بمحاذاة معينة ذات صلة ببداية الملف.
ملاحظة: يمكنك استخدام إصدارات متعدّدة من أدوات الإصدار
لإنشاء تطبيقك لإصدارات مختلفة من Android.
متوفّرة في: android_sdk/platform-tools/
يمكنك الاطّلاع على ملاحظات إصدار أدوات SDK Platform لمعرفة المزيد من المعلومات.
يتم تحديث هذه الأدوات لكل إصدار جديد من نظام Android الأساسي لدعم الميزات الجديدة وإصلاح الأدوات أو تحسينها، ويتوافق كل تحديث مع الإصدارات السابقة مع الإصدارات السابقة للنظام الأساسي.
إضافةً إلى التنزيل من "أداة إدارة SDK"، يمكنك تنزيل أدوات SDK Platform
هنا.
adb- Android Debug Bridge (adb) هو أداة متعددة الاستخدامات تتيح لك إدارة حالة
مثيل المحاكي أو الجهاز الذي يعمل بنظام التشغيل Android. يمكنك أيضًا استخدامه لتثبيت حزمة APK على
جهاز معيّن.
etc1tool- أداة سطر أوامر تتيح لك ترميز صور PNG وفقًا لمعيار الضغط ETC1 وفك ترميز الصور المضغوطة بتنسيق ETC1 وإعادة ترميزها إلى PNG.
fastboot- وميض على الجهاز يتضمّن صور النظام الأساسي وصور النظام الأخرى. للحصول على تعليمات الفلاش، راجِع الصور الأصلية لأجهزة Nexus وPixel.
logcat- تم استدعاؤه من قِبل adb لعرض سجلات التطبيق والنظام.
موجودة في: android_sdk/emulator/
يمكنك الاطّلاع على ملاحظات إصدار Android Emulator للحصول على مزيد من المعلومات.
هذه الحزمة مطلوبة لاستخدام محاكي Android. ويشمل ما يلي:
emulator- أداة لمحاكاة الأجهزة تستند إلى QEMU، ويمكنك استخدامها لتصحيح أخطاء تطبيقاتك واختبارها في بيئة تشغيل Android فعلية.
mksdcard- يساعدك هذا الإجراء في إنشاء نسخة من القرص لاستخدامها مع المحاكي لمحاكاة توفّر بطاقة تخزين خارجية، مثل بطاقة SD.
ملاحظة: قبل الإصدار 25.3.0، كان يتم تضمين أدوات المحاكي في حزمة أدوات SDK.
جهاز نظّارات
يقرأ Jetifier مكتبة تستخدم فئات Support Library ويخرج مكتبة مكافئة تستخدم فئات AndroidX الأحدث.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Command-line tools\n\nThe Android SDK is composed of multiple packages that are required for app development.\nThis page lists the most important command-line tools that are\navailable, organized by the packages in which they're delivered.\n\nYou can install and update each package using\nAndroid Studio's [SDK Manager](/studio/intro/update#sdk-manager)\nor the [`sdkmanager`](/studio/command-line/sdkmanager)\ncommand-line tool.\nAll of the packages are downloaded into your Android SDK directory, which\nyou can locate as follows:\n\n1. In Android Studio, click **File \\\u003e Project Structure**.\n2. Select **SDK Location** in the left pane. The path is shown under **Android SDK location**.\n\n### Set environment variables\n\nWe recommend setting the environment variable for\n[\u003cvar translate=\"no\"\u003eANDROID_HOME\u003c/var\u003e](/studio/command-line/variables#envar) when using\nthe command line. Also, set your command search path to include\n\u003cvar translate=\"no\"\u003eANDROID_HOME/tools\u003c/var\u003e, \u003cvar translate=\"no\"\u003eANDROID_HOME/tools/bin\u003c/var\u003e, and\n\u003cvar translate=\"no\"\u003eANDROID_HOME/platform-tools\u003c/var\u003e to find the most common tools. The steps\nvary depending on your OS, but read\n[How to set environment variables](/studio/command-line/variables#set) for general guidance.\n\nAndroid SDK Command-Line Tools\n------------------------------\n\n\nLocated in: \u003cvar translate=\"no\"\u003eandroid_sdk\u003c/var\u003e`/cmdline-tools/`\u003cvar translate=\"no\"\u003eversion\u003c/var\u003e`/bin/` \n\nNote: The Android SDK Command-Line Tools package, located in\n`cmdline-tools`, replaces the SDK Tools package, located in `tools`. With\nthe new package, you can select the version of the command line tools you want to install,\nand you can install multiple versions at a time. With the old package, you can only install the\nlatest version of the tools. Thus, the new package lets you depend on specific versions of the\ncommand-line tools without having your code break when new versions are released. For information\nabout the deprecated SDK Tools package, see the\n[SDK Tools release notes](/studio/releases/sdk-tools).\n\nIf you are not using Android Studio, you can download the command-line tools package\n[here](/studio#command-tools).\n\n[apkanalyzer](/studio/command-line/apkanalyzer)\n: Provides insight into the composition of your APK after the build process completes.\n\n[avdmanager](/studio/command-line/avdmanager)\n: Lets you create and manage Android Virtual Devices (AVDs)\n from the command line.\n\n[lint](/studio/write/lint#commandline)\n: Scans code to help you identify and correct problems\n with the structural quality of your code.\n\n[`retrace`](/studio/command-line/retrace)\n: For applications compiled by R8, `retrace` decodes an obfuscated stack trace that\n maps back to your original source code.\n\n[sdkmanager](/studio/command-line/sdkmanager)\n: Lets you view, install, update, and uninstall packages for the Android SDK\n\nAndroid SDK Build Tools\n-----------------------\n\n\nLocated in: \u003cvar translate=\"no\"\u003eandroid_sdk\u003c/var\u003e`/build-tools/`\u003cvar translate=\"no\"\u003eversion\u003c/var\u003e`/` \n\nSee [SDK Build Tools release notes](/studio/releases/build-tools) for more\ninformation.\n\nThis package is required to build Android apps. Most of the tools in this package are\ninvoked by the build tools and not intended for you. However, the following\ncommand-line tools might be useful:\n\n[`AAPT2`](/studio/command-line/aapt2)\n: Parses, indexes, and compiles Android resources into a binary format that\n is optimized for the Android platform and packages the compiled resources\n into a single output.\n\n[`apksigner`](/studio/command-line/apksigner)\n: Signs APKs and checks whether APK signatures will be verified\n successfully on all platform versions that a given APK supports.\n\n[`zipalign`](/studio/command-line/zipalign)\n: Optimizes APK files by ensuring that all uncompressed data starts with\n a particular alignment relative to the start of the file.\n\n**Note:** You can have multiple versions of the build tools\nto build your app for different Android versions.\n\nAndroid SDK Platform Tools\n--------------------------\n\n\nLocated in: \u003cvar translate=\"no\"\u003eandroid_sdk\u003c/var\u003e`/platform-tools/` \n\nSee [SDK Platform Tools release notes](/studio/releases/platform-tools) for more\ninformation.\n\nThese tools are updated for every new version of the Android platform to support new features\nand fix or improve the tools, and each update\nis backward compatible with earlier platform versions.\n\nIn addition to downloading from the SDK Manager, you can download the SDK Platform Tools\n[here](/studio/releases/platform-tools#downloads.html).\n\n[`adb`](/studio/command-line/adb)\n: Android Debug Bridge (adb) is a versatile tool that lets you manage the state of an\n emulator instance or Android-powered device. You can also use it to install an APK on a\n device.\n\n[`etc1tool`](/studio/command-line/etc1tool)\n: A command-line utility that lets you encode PNG images to the ETC1\n compression standard and decode ETC1 compressed images back to PNG.\n\n`fastboot`\n: Flashes a device with platform and other system images. For flashing instructions,\n see [Factory Images for Nexus and\n Pixel Devices](https://developers.google.com/android/images).\n\n[`logcat`](/studio/command-line/logcat)\n: Invoked by adb to view app and system logs.\n\nAndroid Emulator\n----------------\n\n\nLocated in: \u003cvar translate=\"no\"\u003eandroid_sdk\u003c/var\u003e`/emulator/` \n\nSee [Android Emulator release notes](/studio/releases/emulator) for more\ninformation.\n\nThis package is required to use the Android Emulator. It includes the following:\n\n[emulator](/studio/run/emulator-commandline)\n: A QEMU-based device-emulation tool that you can use to debug and test\n your applications in an actual Android run-time environment.\n\n[mksdcard](/studio/command-line/mksdcard)\n: Helps you create a disk image that you can use with the emulator\n to simulate the presence of an external storage card, such as an SD card.\n\n**Note:** Prior to revision 25.3.0, the emulator tools were included with the\nSDK Tools package.\n\nJetifier\n--------\n\n[Jetifier](/studio/command-line/jetifier) reads a library that uses\nSupport Library classes and outputs an equivalent library that uses the newer\nAndroidX classes."]]
