اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

AndroidCompatibility

public final class AndroidCompatibility
extends Object

java.lang.Object
↳	com.android.tradefed.result.resultdb.utils.AndroidCompatibility

توفّر هذه السمة طرقًا لتسهيل تحميل الحقول الخاصة بنظام Android إلى ResultDB.

يتم نسخ هذه الفئة من قاعدة الرموز البرمجية ResultDB لضمان التوافق. تتم إزالة بعض الوظائف بسبب عدم توفّر التبعيات.

ملخّص

الثوابت
`int`	`MAX_TAG_KEY_BYTES` الحد الأقصى لحجم مفتاح العلامة بالبايت.
`String`	`PRIMARY_ERROR_CODE_TAG_KEY` مفتاح العلامة المستخدَم لتسجيل رمز خطأ مرتبط باسم الخطأ المرتبط بالخطأ الأساسي (failure_reason.errors[0]).
`String`	`PRIMARY_ERROR_NAME_TAG_KEY` مفتاح العلامة المستخدَم لتسجيل معرّف خطأ (مثل OUT_OF_QUOTA أو MOBLY_TEST_CASE_ERROR أو EXPECTED_TESTS_MISMATCH) مرتبط بالخطأ الأساسي (failure_reason.errors[0]).
`String`	`PRIMARY_ERROR_ORIGIN_TAG_KEY` مفتاح العلامة المستخدَم لتسجيل اسم فئة Java المؤهَّل بالكامل الذي أنشأ الاستثناء المرتبط بالخطأ الأساسي (failure_reason.errors[0]) وأطلقه.
`String`	`PRIMARY_ERROR_TYPE_TAG_KEY` مفتاح العلامة المستخدَم لتسجيل نوع خطأ للخطأ الأساسي (failure_reason.errors[0]).
`String`	`SKIP_BUG_TAG_KEY` مفتاح العلامة المستخدَم لتخزين رقم تعريف Buganizer للمشكلة التي تسبّبت في تخطّي الاختبارات
`String`	`SKIP_TRIGGER_TAG_KEY` مفتاح العلامة المستخدَم لتخزين الشرط الذي أدّى إلى تخطّي الاختبار

الإجراءات العامة
`static String`	`makeValidTagKey(String key)` تحوّل الدالة MakeValidTagKey مفتاح إحدى سمات AnTS إلى مفتاح علامة صالح في ResultDB.
`static Struct`	`marshalTestResultProperties(TestResultProperties properties)` تحويل TestResultProperties proto (نسخة من wireless.android.busytown.proto.TestResultProperties) إلى google.protobuf.Struct لتخزينها في ResultDB
`static StringPair`	`primaryErrorCodeTag(long code)` تعرض هذه السمة StringPair يمكن استخدامها لتسجيل رمز خطأ مرتبط بالخطأ الأساسي (failure_reason.errors[0]).
`static StringPair`	`primaryErrorNameTag(String name)` تعرض هذه الدالة StringPair يمكن استخدامه لتسجيل معرّف خطأ (مثل OUT_OF_QUOTA أو MOBLY_TEST_CASE_ERROR أو EXPECTED_TESTS_MISMATCH) مرتبط بالخطأ الأساسي (failure_reason.errors[0]).
`static StringPair`	`primaryErrorOriginTag(String origin)` تعرِض هذه الدالة StringPair يمكن استخدامه لتسجيل اسم فئة Java المؤهَّل بالكامل الذي أنشأ الاستثناء المرتبط بالخطأ الأساسي (failure_reason.errors[0]) وأصدره.
`static StringPair`	`skipBugTag(String bugId)` تعرض هذه السمة StringPair يمكن استخدامها لتسجيل رقم تعريف Buganizer للمشكلة التي تسبّبت في تخطّي الاختبارات.
`static StringPair`	`skipTriggerTag(String trigger)` تعرِض هذه السمة StringPair يمكن استخدامها لتسجيل الشرط الذي أدّى إلى تخطّي الاختبار.

الثوابت

MAX_TAG_KEY_BYTES

public static final int MAX_TAG_KEY_BYTES

الحد الأقصى لحجم مفتاح العلامة بالبايت

القيمة الثابتة: 64 (0x00000040)

PRIMARY_ERROR_CODE_TAG_KEY

public static final String PRIMARY_ERROR_CODE_TAG_KEY

مفتاح العلامة المستخدَم لتسجيل رمز خطأ مرتبط باسم الخطأ المرتبط بالخطأ الأساسي (failure_reason.errors[0]).

القيمة الثابتة: "primary_error_code"

PRIMARY_ERROR_NAME_TAG_KEY

public static final String PRIMARY_ERROR_NAME_TAG_KEY

مفتاح العلامة المستخدَم لتسجيل معرّف خطأ (مثل OUT_OF_QUOTA أو MOBLY_TEST_CASE_ERROR أو EXPECTED_TESTS_MISMATCH) مرتبط بالخطأ الأساسي (failure_reason.errors[0]).

القيمة الثابتة: "primary_error_name"

PRIMARY_ERROR_ORIGIN_TAG_KEY

public static final String PRIMARY_ERROR_ORIGIN_TAG_KEY

مفتاح العلامة المستخدَم لتسجيل اسم فئة Java المؤهَّل بالكامل الذي أنشأ الاستثناء المرتبط بالخطأ الأساسي (failure_reason.errors[0]) وأطلقه.

القيمة الثابتة: "primary_error_origin"

PRIMARY_ERROR_TYPE_TAG_KEY

public static final String PRIMARY_ERROR_TYPE_TAG_KEY

مفتاح العلامة المستخدَم لتسجيل نوع خطأ للخطأ الأساسي (failure_reason.errors[0]).

القيمة الثابتة: "primary_error_type"

SKIP_BUG_TAG_KEY

public static final String SKIP_BUG_TAG_KEY

مفتاح العلامة المستخدَم لتخزين رقم تعريف Buganizer للمشكلة التي تسبّبت في تخطّي الاختبارات

القيمة الثابتة: "skip_bug_id"

SKIP_TRIGGER_TAG_KEY

public static final String SKIP_TRIGGER_TAG_KEY

مفتاح العلامة المستخدَم لتخزين الشرط الذي أدّى إلى تخطّي الاختبار

القيمة الثابتة: "skip_trigger"

الإجراءات العامة

makeValidTagKey

public static String makeValidTagKey (String key)

تحوّل الدالة MakeValidTagKey مفتاح إحدى سمات AnTS إلى مفتاح علامة صالح في ResultDB.

هذا الإجراء ضروري لأنّ مفاتيح علامات ResultDB تقتصر على المطابقة مع ^[a-z][a-z0-9_]*(/[a-z][a-z0-9_]*)*$.

ملاحظة: يفرض ResultDB حدًا أقصى يبلغ 64 بايت على المفاتيح. إذا كانت مفاتيحك أطول من ذلك، قد تحتاج إلى تحميل البيانات بطرق أخرى لتجنُّب فقدانها. راجِع go/resultdb-uploader-guidance#ants-field-properties للاطّلاع على الخيارات.

المعلَمات
`key`	`String`

المرتجعات
`String`

marshalTestResultProperties

public static Struct marshalTestResultProperties (TestResultProperties properties)

تحويل TestResultProperties proto (نسخة من wireless.android.busytown.proto.TestResultProperties) إلى google.protobuf.Struct لتخزينها في ResultDB

المعلَمات
`properties`	`TestResultProperties`

القيم المُعادة
`Struct`

عمليات الطرح
`InvalidProtocolBufferException`

primaryErrorCodeTag

public static StringPair primaryErrorCodeTag (long code)

تعرض هذه السمة StringPair يمكن استخدامها لتسجيل رمز خطأ مرتبط بالخطأ الأساسي (failure_reason.errors[0]).

المعلَمات
`code`	`long`

المرتجعات
`StringPair`

primaryErrorNameTag

public static StringPair primaryErrorNameTag (String name)

تعرض هذه الدالة StringPair يمكن استخدامه لتسجيل معرّف خطأ (مثل OUT_OF_QUOTA أو MOBLY_TEST_CASE_ERROR أو EXPECTED_TESTS_MISMATCH) مرتبط بالخطأ الأساسي (failure_reason.errors[0]).

المعلَمات
`name`	`String`

المرتجعات
`StringPair`

primaryErrorOriginTag

public static StringPair primaryErrorOriginTag (String origin)

تعرِض هذه السمة StringPair يمكن استخدامها لتسجيل اسم فئة Java المؤهَّل بالكامل الذي أنشأ الاستثناء المرتبط بالخطأ الأساسي (failure_reason.errors[0]) وأطلقه.

المعلَمات
`origin`	`String`

المرتجعات
`StringPair`

skipBugTag

public static StringPair skipBugTag (String bugId)

تعرض هذه السمة StringPair يمكن استخدامها لتسجيل رقم تعريف Buganizer للمشكلة التي تسبّبت في تخطّي الاختبارات.

المعلَمات
`bugId`	`String`

المرتجعات
`StringPair`

skipTriggerTag

public static StringPair skipTriggerTag (String trigger)

تعرِض هذه السمة StringPair يمكن استخدامها لتسجيل الشرط الذي أدّى إلى تخطّي الاختبار.

المعلَمات
`trigger`	`String`

المرتجعات
`StringPair`