مشغِّلات مركز الاختبار الافتراضي لمنصة Firebase

الجيل الثاني الجيل الأول

استيراد الوحدات المطلوبة

للبدء، استورِد الوحدات المطلوبة لمعالجة أحداث Firebase Test Lab:

Node.js

 // The Cloud Functions for Firebase SDK to set up triggers and logging.
const {onTestMatrixCompleted} = require("firebase-functions/v2/testLab");
const {logger} = require("firebase-functions");
index.js

Python

 # The Cloud Functions for Firebase SDK to set up triggers and logging.
from firebase_functions import test_lab_fn, params

# The requests library to send web requests to Slack.
import requests
main.py

بدء وظيفة عند اكتمال TestMatrix

لتشغيل دالة Firebase Test Lab، حدِّد معالِجًا لحدث اكتمال مصفوفة الاختبار. في هذا المثال، يتم بدء الدالة عند اكتمال الاختبار، واسترداد بيانات مصفوفة الاختبار من عنصر CloudEvent، وإرسال نتائج الاختبار المقابلة إلى قناة Slack:

Node.js

exports.posttestresultstoslack = onTestMatrixCompleted(
    {secrets: ["SLACK_WEBHOOK_URL"]},
    async (event) => {
    // Obtain Test Matrix properties from the CloudEvent
      const {testMatrixId, state, outcomeSummary} = event.data;

      // Create the title of the message
      const title = `${getSlackmoji(state)} ${getSlackmoji(
          outcomeSummary,
      )} ${testMatrixId}`;

      // Create the details of the message
      const details = `Status: *${state}* ${getSlackmoji(
          state,
      )}\nOutcome: *${outcomeSummary}* ${getSlackmoji(outcomeSummary)}
    `;

      // Post the message to slack
      const slackResponse = await postToSlack(title, details);

      // Log the response
      logger.log(slackResponse);
    });
index.js

Python

@test_lab_fn.on_test_matrix_completed(secrets=["SLACK_WEBHOOK_URL"])
def posttestresultstoslack(
        event: test_lab_fn.CloudEvent[test_lab_fn.TestMatrixCompletedData]) -> None:
    """Posts a test matrix result to Slack."""

    # Obtain Test Matrix properties from the CloudEvent
    test_matrix_id = event.data.test_matrix_id
    state = event.data.state
    outcome_summary = event.data.outcome_summary

    # Create the title of the message
    title = f"{slackmoji(state)} {slackmoji(outcome_summary)} {test_matrix_id}"

    # Create the details of the message
    details = (f"Status: *{state}* {slackmoji(state)}\n"
               f"Outcome: *{outcome_summary}* {slackmoji(outcome_summary)}")

    # Post the message to Slack
    response = post_to_slack(title, details)

    # Log the response
    print(response.status_code, response.text)
main.py

الوصول إلى تفاصيل العميل

يمكن إنشاء مصفوفات الاختبار من مصادر أو مسارات عمل مختلفة. لذلك، من المفيد في كثير من الأحيان إنشاء دوالّ تُنفِّذ إجراءات مختلفة استنادًا إلى المصدر أو سياق مهم آخر للاختبار. للمساعدة في ذلك، تسمح لك دالة gcloud بتمرير معلومات عشوائية عند بدء اختبار يمكن الوصول إليها لاحقًا في وظيفتك. على سبيل المثال:

gcloud beta firebase test android run \
    --app=path/to/app.apk \
    --client-details testType=pr,link=<path/to/pull-request>

بعد ذلك، للوصول إلى المعلومات في دالتك:

Node.js

const testType = event.data.clientInfo.details.testType;
const link = event.data.clientInfo.details.link;

Python

test_type: str | None = event.data.client_info.details.get("testType")
link: str | None = event.data.client_info.details.get("link")