تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك ميزة "بث أجهزة Android"، المستندة إلى Firebase، الاتصال بشكل آمن بأجهزة Android فعلية بعيدة تتم استضافتها في مراكز بيانات Google الآمنة وفي مختبرات أجهزة شركاء Android. وهي الطريقة الأسرع والأسهل لاختبار تطبيقك على بعض أحدث أجهزة Android، بما في ذلك هواتف Google Pixel 9 و9a و9 Pro وPixel Fold، ومجموعة متنوعة من الطُرز من Samsung وOPPO وOnePlus وXiaomi وvivo.
في الوقت الحالي، تتوفّر لك ميزة البث المباشر على الأجهزة لتجربتها بدون أي تكلفة مع مشاريع Firebase ضمن خطة Spark. قد يتم تحصيل رسوم مقابل الاستخدام الذي يتجاوز عدد الدقائق الشهرية بدون تكلفة. لمزيد من المعلومات، يُرجى الاطّلاع على أسعار ميزة "بث التطبيقات على أجهزة Android".
بعد الاتصال بجهاز، يمكنك نشر تطبيقك وعرض الشاشة والتفاعل مع الجهاز (بما في ذلك تدويره أو فتحه) وتنفيذ أي إجراء آخر يمكنك تنفيذه باستخدام اتصال ADB عبر SSL، وكل ذلك بدون مغادرة Android Studio. عند الانتهاء من استخدام الجهاز، تمحو Google جميع بياناتك وتعيد ضبط الجهاز على الإعدادات الأصلية قبل إتاحته لمطوّر آخر.
البدء
للبدء، اتّبِع الخطوات التالية:
إذا لم يسبق لك إجراء ذلك، نزِّل الإصدار الأخير من Android Studio وثبِّته. إذا أردت استخدام الميزات قبل إطلاقها،
نزِّل أحدث إصدار من Canary وثبِّته.
افتح مشروعًا في "استوديو Android".
انتقِل إلى عرض > نوافذ الأدوات > "إدارة الأجهزة" (View > Tool Windows > Device Manager) وانقر على زر Firebase بالقرب من أعلى النافذة.
إذا لم يسبق لك تسجيل الدخول إلى حساب المطوّر، انقر على تسجيل الدخول إلى Google واتّبِع التعليمات. بعد منح Android Studio الإذن بالوصول إلى Firebase، ارجع إلى بيئة التطوير المتكاملة.
اختَر مشروعًا على Firebase. يمكنك أيضًا الاطّلاع على مقدار مساحة التخزين المتبقية أو الدقائق المستخدَمة في دورة الفوترة الحالية.
إذا لم يكن لديك مشروع على Firebase، يمكنك إنشاء مشروع بدون أي تكلفة في وحدة تحكّم Firebase. يُرجى العِلم أنّه قد يحدث تأخير بسيط بين إنشاء مشروع جديد وإمكانية اختياره من "استوديو Android".
إذا ظهرت لك رسالة خطأ تفيد بأنّه ليس لديك الأذونات اللازمة لاستخدام ميزة "بث الجهاز" مع المشروع المحدّد، اتّبِع التعليمات لتفعيل الأذونات.
انقر على تأكيد.
من المفترض أن تظهر مجموعة تلقائية من الأجهزة تلقائيًا في "إدارة الأجهزة" لتتمكّن من استخدامها. يمكنك الاتصال بجهاز من خلال النقر على الإجراء بدء بجانب أحد الأجهزة، أو من خلال اختيار جهاز من القائمة المنسدلة الخاصة بهدف النشر في شريط الأدوات الرئيسي ونشر تطبيقك كما تفعل عادةً.
بعد أن يحجز Android Studio الجهاز الذي طلبته ويتصل به، ستظهر نافذة الأجهزة قيد التشغيل. لتمديد جلسة، انقر على الزر تمديد الحجز من شريط أدوات نافذة الأجهزة قيد التشغيل، ثم اختَر المدة التي تريد تمديد جلستك بها.
تفعيل الأذونات
لاستخدام ميزة "بث الأجهزة"، يجب استخدام مشروع على Firebase لديك فيه إذن محرِّر أو مالك.
إذا لم تكن لديك هذه الأذونات لمشاريعك الحالية على Firebase، يمكنك إما إنشاء مشروع جديد بصفتك "مالك" بدون أي تكلفة في وحدة تحكّم Firebase، أو أن تطلب من أحد أعضاء فريقك الذي لديه هذه الأذونات اتّباع الخطوات التالية:
أضِف أرقام تعريف المستخدمين لكل مستخدم تريد أن يتمكّن من الوصول إلى ميزة "بث الشاشة من الجهاز".
باستخدام القائمة المنسدلة اختيار دور، اختَر دور مشرف الوصول المباشر إلى Firebase Test Lab.
انقر على إضافة دور آخر واختَر مستخدم خدمة من القائمة المنسدلة اختيار دور.
احفظ التغييرات من خلال النقر على حفظ.
تجربة قائمة الأجهزة الكاملة
لتصفّح أجهزة إضافية وإضافتها إلى "مدير الأجهزة"، اتّبِع الخطوات التالية:
من "إدارة الأجهزة"، انقر على + > اختيار جهاز عن بُعد.
في الكتالوج الذي يظهر، يمكنك اختيار الأجهزة التي تريدها من خلال وضع علامة في المربّع بجانب كل جهاز.
انقر على تأكيد. من المفترض أن تظهر الأجهزة التي اخترتها الآن في "إدارة الأجهزة".
إنهاء جلستك
عند الانتهاء من استخدام جهاز، تذكَّر النقر على الرجوع إلى الجهاز ومحو بياناته
إما من قائمة الخيارات الإضافية للجهاز في "إدارة الأجهزة" أو من
الإشعار الذي يظهر بعد إغلاق علامة تبويب الجهاز في نافذة
الأجهزة قيد التشغيل. يضمن ذلك عدم إضاعة دقائق الجهاز بدون داعٍ، كما يتم محو بيانات جهازك وإعادة ضبطه على الإعدادات الأصلية فورًا قبل إتاحته لمطوّر آخر. يتم ردّ أي دقائق غير مستخدَمة من جلستك إلى مشروعك.
الاتصال بـ "مختبرات أجهزة شركاء Android"
مختبرات أجهزة شركاء Android هي مختبرات أجهزة يديرها شركاء Google من المصنّعين الأصليين للأجهزة، مثل Samsung وXiaomi وOPPO وOnePlus وvivo وغيرهم، وتوسّع مجموعة الأجهزة المتاحة في خدمة "بث أجهزة Android". تتوفّر هذه الخدمة في القناة الثابتة، بدءًا من إصدار Narwhal من "استوديو Android" ضمن Feature Drop.
للبدء، يمكنك تنفيذ ما يلي:
في "إدارة الأجهزة"، انقر على + > اختيار الأجهزة البعيدة.
في قائمة الأجهزة التي تظهر، اختَر جهازًا من مختبر Android Partner
Device Lab الذي تريد استخدامه. يتم تمييز الأجهزة من مختبرات الشركاء من خلال رمز الجهاز وعمود "المختبر" في الكتالوج. تساعدك فلاتر مختبر الأجهزة في فلترة الأجهزة من مختبر واحد أو أكثر.
انقر على تأكيد.
من "إدارة الأجهزة"، يمكنك الاتصال بجهاز المختبر الشريك كما تفعل مع أي جهاز آخر من أجهزة "بث التطبيقات على أجهزة Android".
تفعيل "مختبرات الأجهزة الشريكة" في Google Cloud Console
إذا لم يتم تفعيل مختبر الشريك المطلوب لمشروع Firebase الذي اخترته، سيُعلمك Android Studio بذلك، ويمكنك اتّباع التعليمات لتفعيل مختبرات الشريك المحدّدة.
يجب أن يكون لديك دور "محرِّر" أو "مالك" للمشروع لتفعيل كل مختبر شريك في صفحة مختبرات الأجهزة الشريكة في Google Cloud Console.
في ما يلي كيفية تفعيل ميزة اختبارية خاصة بشركاء Google:
تأكَّد من اختيار مشروع Google Cloud الصحيح في أعلى الصفحة.
انقر على زر التبديل الخاص بمختبر الأجهزة الذي تريد تفعيله واتّبِع التعليمات.
بعد تفعيل مختبر الشريك، يمكنك أنت وفريقك استخدام الأجهزة في Android Studio.
ما الذي يميّز ميزة "بث التطبيقات على أجهزة Android" المستندة إلى Firebase؟
الأجهزة والأمان والميزات من خلال برنامج "بث التطبيقات على أجهزة Android"، يمكنك الحصول على بعض أحدث أجهزة Android في أسرع وقت ممكن. بالإضافة إلى ذلك، تتيح الخدمة عددًا محددًا من الأجهزة القديمة، ما يتيح لك الوصول إلى مجموعة كبيرة من الإعدادات ومستويات واجهة برمجة التطبيقات. وبما أنّ هذه الأجهزة يتم تخزينها في مراكز بيانات آمنة، تكون جلساتك آمنة ويتم إعادة ضبط أجهزتك على الإعدادات الأصلية ومحو بياناتها قبل إتاحتها لمستخدم آخر.
أخيرًا، يتم دمج الخدمة مباشرةً مع Android Studio ويمكن الوصول إليها عبر اتصال ADB عبر طبقة المقابس الآمنة، وبالتالي تعمل الأدوات التي تستخدمها يوميًا عبر ADB بسلاسة مع ميزة "بث الجهاز".
يقع كل جهاز في مراكز بيانات Google الآمنة ويتصل بمحطة العمل باستخدام اتصال ADB عبر SSL. عند انتهاء جلستك، يتم محو بيانات الجهاز بالكامل وإعادة ضبطه على الإعدادات الأصلية قبل إتاحته لمطوّر آخر.
هل يجب استخدام "استوديو Android"؟
مع أنّ خدمة "الأجهزة الافتراضية على Android" تتطلّب استخدام Android Studio Jellyfish أو إصدار أحدث للاتصال بالخدمة وطلب جهاز، يتيح لك الاتصال المباشر عبر تصحيح أخطاء Android باستخدام طبقة المقابس الآمنة (SSL) استخدام أي أدوات أو بيئات تطوير متكاملة تستخدم تصحيح أخطاء Android للتواصل مع الأجهزة الاختبارية بعد حجز جهاز والاتصال به.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-08-12 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Android Device Streaming, powered by Firebase, lets you securely connect to\nremote physical Android devices hosted in Google's secure data centers and\nAndroid Partner Device Labs. It's the fastest and easiest way to test your app\nagainst physical units of some of the latest Android devices, including the Google\nPixel 9, 9a 9 Pro, Pixel Fold, and a diverse set of models from Samsung, OPPO,\nOnePlus, Xiaomi, and vivo.\n\nCurrently, **device streaming is available to you to try at no cost** with Firebase\nprojects on a Spark plan. Usage beyond the monthly no cost\nminutes may incur billing. See [Pricing for Android Device Streaming](https://firebase.google.com/docs/test-lab/usage-quotas-pricing#device-streaming) for\nmore information.\n\nAfter connecting to a device, you can deploy your app, view the display,\ninteract with the device (including rotating or unfolding the device), and\nanything else you might do with a device using an ADB over SSL\nconnection---all without leaving Android Studio. When you're done using the\ndevice, Google wipes all your data and factory resets the device before making\nit available to another developer.\n| **Now available:** The following devices are now available from Android Device Streaming:\n|\n| - Google Pixel 9a\n| - Google Pixel 9\n| - Google Pixel 9 Pro\n| - Google Pixel 9 Pro XL\n| - Google Pixel 9 Pro Fold\n| - Select devices from Samsung, Xiaomi, OPPO, OnePlus, and vivo Android Partner Device Labs\n| **Note:** Android Device Streaming is only available in the current stable channel version of Android Studio, the three most recent previous major versions, and patches associated with those versions. If you are using an older version of Android Studio, you will need to update to use Android Device Streaming. [More\n| information](/studio/releases#service-compat).\n\nGet started\n-----------\n\nTo get started, follow these steps:\n\n1. If you haven't already done so, download and install the latest version of [Android Studio](https://developer.android.com/studio). If you'd like early access to unreleased features, download and install the [latest Canary release](https://developer.android.com/studio/preview).\n2. Open an Android Studio project.\n3. Navigate to **View \\\u003e Tool Windows \\\u003e Device Manager** and click the Firebase button near the top of the window.\n4. If you're not already signed in to your developer account, click **Log in to\n Google** and follow the prompts. After authorizing Android Studio to access Firebase, return to the IDE.\n5. Select a Firebase project. You can also see the amount of quota you have remaining or minutes used for current billing cycle.\n - If you don't have a Firebase project, you can create one at no cost in the [Firebase Console](https://console.firebase.google.com/). Keep in mind, there might be a small delay between creating a new project and having it be selectable from Android Studio.\n - If you get an error that you lack the proper permissions to use device streaming with the selected project, follow the [instructions to enable\n permissions](https://developer.android.com/studio/run/android-device-streaming#permissions).\n6. Click **Confirm**.\n\nA default set of devices should appear automatically in the Device Manager\nfor you to use. You can connect to a device by either clicking **Start** action\nnext to a device, or by selecting a device from the deploy target drop-down in\nthe main toolbar and deploying your app, like you normally would.\n\nAfter Android Studio reserves and connects to the device you requested, the\n**Running Devices** window will appear. To extend a session, click the **Extend\nReservation** button from the **Running Devices** window toolbar and select the\nduration you want to extend your session by.\n\n### Enable permissions\n\nTo use device streaming, you need to use a Firebase project for which you have\neither **Editor** or **Owner** permissions.\n\nIf you don't have these permissions\nfor your existing Firebase projects, you can either create a new one as an Owner\nat no cost in the [Firebase Console](https://console.firebase.google.com), or\nask someone on your team who does to follow these steps:\n\n1. Navigate to the IAM section of the [Google Cloud Console](https://console.cloud.google.com/iam-admin).\n2. Click **View by principles \\\u003e Grant access**.\n3. Add the user IDs for each user you want to be able to access device streaming.\n4. Using the **Select a role** drop-down, select the **Firebase Test Lab Direct\n Access Admin** role.\n5. Click **Add another role** and select **Service Usage Consumer** from the **Select a role** drop-down.\n6. Save the changes by clicking **Save**\n\n### Try the full catalog of devices\n\nTo browse additional devices and add them to the Device Manager, do the\nfollowing:\n\n1. From the Device Manager, click **+ \\\u003e Select Remote Device**.\n2. In the catalog that appears, you can select the devices you want by checking the box next to each one. \n\n3. Click **Confirm**. The device(s) you selected should now appear in the Device Manager.\n\n### End your session\n\nWhen you're done using a device, remember to click **Return and Erase Device**\neither from the overflow menu for the device in the Device Manager or from the\nnotification that appears after closing the device tab in the Running Devices\nwindow. This ensures that you don't spend device minutes unnecessarily, and your\ndevice is immediately wiped and factory reset after before it is made available\nto another developer. Any unused minutes from your session are returned to your\nproject.\n\nConnect to Android Partner Device Labs\n--------------------------------------\n\nAndroid Partner Device Labs are device labs operated by Google OEM partners,\nsuch as Samsung, Xiaomi, OPPO, OnePlus, vivo and others, and expand the\nselection of devices available in Android Device Streaming. This service\nis available in the Stable channel, starting with Android Studio Narwhal\nFeature Drop.\n\nTo get started, do the following:\n\n1. In the Device Manager, click **+ \\\u003e Select Remote Devices**.\n2. In the device catalog that appears, select a device from an Android Partner Device Lab that you'd like to use. Devices from partner labs are denoted by their device icon and the \"Lab\" column in the catalog. **Device Lab** filters help you filter for devices from one only or more device labs. \n\n3. Click **Confirm**.\n4. From the Device Manager, you can connect to the partner lab device like you would any other Android Device Streaming device.\n\n| **Note:** Standard [pricing for Android Device Streaming](https://firebase.google.com/docs/test-lab/usage-quotas-pricing#device-streaming) applies for all Android Partner Device Lab devices, unless specified.\n\n### Enable Partner Device Labs in Google Cloud Console\n\nIf the required partner lab is not enabled for your selected Firebase project\nAndroid Studio will notify you, and you can follow the prompts to enable the\nselected partner labs.\n\n\n\u003cbr /\u003e\n\n\nAn Editor or Owner of the project is required to enable\neach partner lab on the [Partner Device Labs](https://console.cloud.google.com/omnilab/partner-lab) page in Google Cloud Console.\nHere's how to enable a partner lab:\n\n1. Check to make sure that the correct Google Cloud project is selected at the top of the page.\n2. Click the toggle for the device lab you want to enable and follow the prompts.\n3. After the partner lab is enabled, you and your team can use the devices in Android Studio.\n\nPricing for Android Device Streaming\n------------------------------------\n\nFor more information, see [Firebase usage levels, quotas, and pricing](https://firebase.google.com/docs/test-lab/usage-quotas-pricing#device-streaming).\n\nFrequently asked questions\n--------------------------\n\n### What makes Android Device Streaming, powered by Firebase, different?\n\nDevices, security, and features. Android Device Streaming is where\nyou can expect to have access to some of the latest Android devices as quickly\nas possible. Additionally, the service supports a select number of older\ndevices, so that you have access to a wide range of configurations and API\nlevels. And because these devices are housed in secure data centers,\nyour sessions are secure and your devices are factory reset and wiped before\nthey are made available to another user.\n\nFinally, the service is integrated directly with Android Studio and accessible\nover an ADB over SSL connection, so the tools you use every day over ADB work\nseamlessly with device streaming.\n\n### How much does the service cost?\n\nFor pricing details, see [Pricing for Android Device Streaming](https://firebase.google.com/docs/test-lab/usage-quotas-pricing#device-streaming).\n\n### Is my session secure and what happens when my session ends?\n\nEach device is located in Google's secure data centers and connects to your\nworkstation using an ADB over SSL connection. When your session ends, device\ndata is fully wiped and factory reset before the device is made\navailable to another developer.\n\n### Do I need to use Android Studio?\n\nWhile Android Studio Jellyfish or later is required to connect to the service\nand request a device, the direct ADB over SSL connection lets you use any tools\nor IDEs that use ADB to communicate with test devices after you reserve and\nconnect to a device."]]
