تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يقدّم هذا المستند معلومات مرجعية حول ضبط أذونات وأدوار Test LabIAM. إذا أردت ضبط أدوار أكثر دقة، يوفّر Test Lab أذونات لتنفيذ الاختبارات وبث الأجهزة باستخدام Android Studio. يتطلّب تنفيذ الاختبار متطلبات إضافية لضبط الأذونات والأدوار بشكل صحيح في "إدارة الهوية وإمكانية الوصول" وأجهزة البث.
تنفيذ الاختبار
لضبط Test Lab بشكل صحيح حتى تتمكّن من تنفيذ الاختبارات وقراءة النتائج، عليك ضبط إذن الوصول إلى حِزم Cloud Storage. يتطلّب ذلك إعدادًا محدّدًا للأذونات غير المضمّنة كلها في أدوار Firebase المحدّدة مسبقًا العادية. لمنح إذن الوصول إلى Test Lab، استخدِم أحد الخيارَين التاليَين.
أضِف المستخدمين الذين يحتاجون إلى إذن الوصول إلى Test Lab وأسنِد إليهم أدوار المشاريع القديمة باستخدام وحدة تحكّم Firebase.
(اختياري) حدِّد دور المحرِّر في المشروع للسماح للمستخدم بإجراء اختبارات باستخدام Test Lab.
(اختياري) حدِّد دور المشاهد في المشروع للسماح للمستخدم بعرض نتائج الاختبار باستخدام Test Lab.
الاختبارات من خلال gcloud CLI
تستخدم الاختبارات التي تبدأ من gcloud CLI أو Testing API أو الأجهزة المُدارة من Gradle حزمة Cloud Storage أنشأتها Firebase تلقائيًا. يتطلّب ذلك أن يكون لدى الجهة الأساسية التي تنفّذ الاختبار دور "roles/editor" في مشروع Firebase.
إذا لم تتمكّن من منح هذا الدور، أو إذا أردت الاحتفاظ بنتائج الاختبار المفصّلة لمدة تزيد عن 90 يومًا، يمكنك إرسال نتائج الاختبار هذه إلى Cloud Storageحزمة تملكها باستخدام خيار سطر الأوامر --results-bucket في gcloud.
عند استخدام حزمة Cloud Storage خاصة بك:
يمكنك تعيين زوج من الأدوار المحدّدة مسبقًا، ما يمنح مجموعة الأذونات المطلوبة معًا، وذلك باستخدام وحدة تحكّم Google Cloud.
للسماح لأحد المستخدمين بإجراء اختبارات باستخدام Test Lab، يجب منحه الإذنَين التاليَين: "مشرف Firebase Test Lab" (roles/cloudtestservice.testAdmin) و"مُشاهد إحصاءات Firebase" (roles/firebase.analyticsViewer).
للسماح لأحد المستخدمين بعرض نتائج الاختبار في Test Lab، يجب منحه الإذنَين التاليَين: "مُشاهد في مختبر Firebase الافتراضي" (roles/cloudtestservice.testViewer) و"مُشاهد في إحصاءات Firebase" (roles/firebase.analyticsViewer).
تفعيل الأذونات في ميزة "بث المحتوى على الجهاز"
ميزة "بث المحتوى على الأجهزة" هي ميزة منفصلة تستند إلى أجهزة Test Lab. ويتيح لك الوصول مباشرةً إلى أجهزة Test Lab. يمكن لمشرفي Firebase ومحرّريه استخدام ميزة "بث الأجهزة" بدون أي أدوار إضافية، ولكن يمكنك أيضًا منح أدوار أكثر تفصيلاً إذا لزم الأمر.
للسماح لأحد المستخدمين باستخدام ميزة "بث التطبيقات على الأجهزة"، يجب منحه دورًا محدّدًا مسبقًا يمنح مجموعة الأذونات المطلوبة معًا، وذلك باستخدام وحدة تحكّم Google Cloud. الدور الذي يجب منحه هو "مسؤول الوصول المباشر إلى مركز الاختبار الافتراضي لمنصة Firebase" (roles/cloudtestservice.directAccessAdmin).
تاريخ التعديل الأخير: 2025-09-06 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-06 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["\u003cbr /\u003e\n\nThis document provides reference information about configuring Test Lab IAM\npermissions and roles. If you want to configure more granular roles, Test Lab\nprovides permissions for both executing tests and streaming devices using\nAndroid Studio. Test execution has extra requirements to properly configure\npermissions and roles for IAM and the streaming devices.\n\nTest Execution\n\nTo properly configure Test Lab so that you can execute and read the results\nof tests, you have to configure access to Cloud Storage buckets. This\nrequires a specific configuration of permissions that aren't all included in the\nstandard [Firebase predefined roles](/docs/projects/iam/roles-predefined). To\ngrant access to Test Lab, use one of the following options.\n\nTests through the Firebase console\n\nFor tests started from Firebase console or through the [Firebase Test Lab Device Matrix in Android Studio](https://developer.android.com/studio/test/test-in-android-studio#run-with-firebase-test-lab):\n\n1. Test your app in a dedicated separate Firebase project.\n2. Add users that need Test Lab access and assign them legacy project roles using the [Firebase console](//console.firebase.google.com/).\n3. (Optional) Assign the **Editor** project role to allow a user to run tests with Test Lab.\n4. (Optional) Assign the **Viewer** project role to allow a user to view test results with Test Lab.\n\nTests through gcloud CLI\n\nTests started from the [gcloud CLI](/docs/test-lab/android/command-line),\nthe [Testing API](/docs/test-lab/reference/testing/rest), or [Gradle Managed\nDevices](/docs/test-lab/android/android-studio#gmd-testlab-plugin) use a\nCloud Storage bucket created by Firebase by default. This requires the\nprincipal executing the test to have the \"roles/editor\" role for your firebase\nproject.\n\nIf you cannot grant that role, or you want to retain detailed test results for\nlonger than 90 days, you can send these test results to a Cloud Storage\nbucket that you own using the\n[**--results-bucket** gcloud command-line option](//cloud.google.com/sdk/gcloud/reference/firebase/test/android/run).\n\nWhen using your own Cloud Storage bucket:\n\n1. Assign a pair of predefined roles, which grants the required set of permissions together, using the [Google Cloud console](//cloud.google.com/iam/docs/granting-changing-revoking-access).\n2. To allow a user to run tests with Test Lab, assign both: Firebase Test Lab Admin (`roles/cloudtestservice.testAdmin`) and Firebase Analytics Viewer (`roles/firebase.analyticsViewer`)\n3. To allow a user to view test results in Test Lab, assign both: Firebase Test Lab Viewer (`roles/cloudtestservice.testViewer`) and Firebase Analytics Viewer (`roles/firebase.analyticsViewer`)\n\n| **Caution:** Users assigned these predefined roles can access *all* Cloud Storage buckets associated with the Firebase project, potentially including customer data.\n\nEnable permissions in Device Streaming\n\nDevice Streaming is a separate feature built on top of Test Lab devices. It\nprovides you with direct access to Test Lab devices. Firebase Editors and\nAdmins can use Device Streaming without any additional roles, however, you can\nalso provide more granular roles if necessary.\n\nTo allow a user to use device streaming, assign a predefined role which grants\nthe required set of permissions together, using the [Google Cloud console](//cloud.google.com/iam/docs/granting-changing-revoking-access)\n. The role to assign is Firebase Test Lab Direct Access\nAdmin (`roles/cloudtestservice.directAccessAdmin`).\n\nFor more information on Device Streaming in Android Studio, see [Device Streaming in Android Studio](https://developer.android.com/studio/preview/android-device-streaming)."]]
