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

SecurityTestCase

public class SecurityTestCase
extends StsExtraBusinessLogicHostTestBase

java.lang.Object
↳	com.android.tradefed.testtype.junit4.BaseHostJUnit4Test
	↳	com.android.compatibility.common.tradefed.testtype.BusinessLogicHostTestBase
		↳	com.android.compatibility.common.tradefed.testtype.ExtraBusinessLogicHostTestBase
			↳	com.android.sts.common.tradefed.testtype.StsExtraBusinessLogicHostTestBase
				↳	com.android.sts.common.tradefed.testtype.SecurityTestCase

الفئات الفرعية المباشرة المعروفة

NonRootSecurityTestCase وRootSecurityTestCase

NonRootSecurityTestCase	فئة الاختبارات التي يتم إجراؤها على الأجهزة التي لا تتضمّن إذن الوصول إلى الجذر من adb ولا يُفترض أن تتضمّنه
RootSecurityTestCase	فئة الاختبارات التي تحتاج إلى إذن الوصول إلى الجذر على الجهاز لتنفيذها

فئة الاختبار الأساسية لجميع اختبارات STS

استخدِم RootSecurityTestCase أو NonRootSecurityTestCase بدلاً من ذلك.

ملخّص

الثابتات
`int`	`TIMEOUT_DEFAULT`
`int`	`TIMEOUT_NONDETERMINISTIC`

الحقول
`public PocPusher`	`pocPusher`
`public TestName`	`testName`

وظائف الإنشاء العامة
`SecurityTestCase()`

الطرق العامة
`void`	`assertMatches(String pattern, String input)`
`void`	`assertMatchesMultiLine(String pattern, String input)`
`void`	`assertNotKernelPointer(Callable<String> getPtrFunction, ITestDevice deviceToReboot)` يُشغِّل هذه الدالة المقدَّمة التي تجمع سلسلة اختبارًا لمنع تسرُّب مؤشرات النواة.
`void`	`assertNotMatches(String pattern, String input)`
`void`	`assertNotMatchesMultiLine(String pattern, String input)`
`void`	`assertWifiConnected(ITestDevice device)` يؤكد أنّ حالة اتصال Wi-Fi متصلة.
`void`	`assumeIsSupportedNfcDevice(ITestDevice device)`
`static MetricsReportLog`	`buildMetricsReportLog(ITestDevice device)`
`WifiHelper`	`createWifiHelper()`
`static IAbi`	`getAbi(ITestDevice device)`
`static IBuildInfo`	`getBuildInfo(ITestDevice device)`
`static PocPusher`	`getPocPusher(ITestDevice device)`
`static String`	`getTestName(ITestDevice device)`
`boolean`	`moduleIsPlayManaged(String modulePackageName)` عرض True إذا كانت الوحدة مُدارة من Play
`void`	`safeReboot()`
`void`	`setUp()` ينتظر حتى يصبح الجهاز متصلاً بالإنترنت، ويحدِّد آخر وقت تم فيه تشغيل الجهاز.
`void`	`tearDown()` التأكّد من اتصال الهاتف بالإنترنت والتحقّق مما إذا تعطّل الجهاز
`void`	`updateKernelStartTime()` يسمح بنجاح الاختبار في حال تمّ استدعاؤه بعد إعادة تشغيل مخطّط لها.

الطرق المحمية
`boolean`	`containsDriver(ITestDevice device, String driver, boolean checkReadable)` تحقَّق مما إذا كان هناك برنامج تشغيل على الجهاز.
`boolean`	`containsDriver(ITestDevice device, String driver)` تحقَّق ممّا إذا كان هناك برنامج تشغيل متاح وقابل للقراءة.

الثابتات

TIMEOUT_DEFAULT

protected static final int TIMEOUT_DEFAULT

القيمة الثابتة: 60 (0x0000003c)

TIMEOUT_NONDETERMINISTIC

public static final int TIMEOUT_NONDETERMINISTIC

القيمة الثابتة: 315 (0x0000013b)

الحقول

pocPusher

public PocPusher pocPusher

testName

public TestName testName

وظائف الإنشاء العامة

SecurityTestCase

public SecurityTestCase ()

الطرق العامة

assertMatches

public void assertMatches (String pattern, 
                String input)

المعلمات
`pattern`	`String`
`input`	`String`

عمليات الرمي
`Exception`

assertMatchesMultiLine

public void assertMatchesMultiLine (String pattern, 
                String input)

المعلمات
`pattern`	`String`
`input`	`String`

عمليات الرمي
`Exception`

assertNotKernelPointer

public void assertNotKernelPointer (Callable<String> getPtrFunction, 
                ITestDevice deviceToReboot)

يُشغِّل هذه الدالة المقدَّمة التي تجمع سلسلة اختبارًا ضد تسرُّب مؤشر النواة. يجب أن يعرض تنفيذ الدالة getPtrFunction سلسلة تبدأ بالمؤشر. أي "01234567". يُسمح بالأحرف اللاحقة باستثناء [0-9a-fA-F]. في حال بدا المؤشر معرّضًا للاختراق، يتم طرح تأكيد JUnit. بما أنّه يمكن تجزئة مؤشرات النواة، من المحتمل أن يتداخل المؤشر المجزأ مع مساحة النواة العادية. تتم إعادة تنفيذ اختبار لجعل النتائج الموجبة الخاطئة غير ذات دلالة إحصائية. عندما لا يتم تغيير مؤشرات النواة بدون إعادة تشغيل الجهاز، عليك توفير جهاز لإعادة تشغيله.

المعلمات
`getPtrFunction`	`Callable`: دالة تعرض سلسلة تبدأ بمؤشر
`deviceToReboot`	‫`ITestDevice`: إعادة تشغيل الجهاز عندما لا تتغيّر مؤشرات النواة

عمليات الرمي
`Exception`

assertNotMatches

public void assertNotMatches (String pattern, 
                String input)

المعلمات
`pattern`	`String`
`input`	`String`

عمليات الرمي
`Exception`

assertNotMatchesMultiLine

public void assertNotMatchesMultiLine (String pattern, 
                String input)

المعلمات
`pattern`	`String`
`input`	`String`

عمليات الرمي
`Exception`

assertWifiConnected

public void assertWifiConnected (ITestDevice device)

يؤكد أنّ حالة اتصال Wi-Fi متصلة. بما أنّ أداة STS يمكنها إعادة تشغيل الجهاز مباشرةً قبل إجراء الاختبار، قد لا يكون الاتصال بشبكة Wi-Fi متوفّرًا قبل إجراء الاختبار. نبحث عن شبكة Wi-Fi إلى أن تنتهي المهلة أو يتم الاتصال بشبكة Wi-Fi.

المعلمات
`device`	`ITestDevice`: الجهاز الذي سيتم تشغيل التطبيق عليه

عمليات الرمي
`Exception`

assumeIsSupportedNfcDevice

public void assumeIsSupportedNfcDevice (ITestDevice device)

المعلمات
`device`	`ITestDevice`

عمليات الرمي
`Exception`

buildMetricsReportLog

public static MetricsReportLog buildMetricsReportLog (ITestDevice device)

المعلمات
`device`	`ITestDevice`

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

createWifiHelper

public WifiHelper createWifiHelper ()

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

عمليات الرمي
`DeviceNotAvailableException`

getAbi

public static IAbi getAbi (ITestDevice device)

المعلمات
`device`	`ITestDevice`

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

getBuildInfo

public static IBuildInfo getBuildInfo (ITestDevice device)

المعلمات
`device`	`ITestDevice`

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

getPocPusher

public static PocPusher getPocPusher (ITestDevice device)

المعلمات
`device`	`ITestDevice`

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

getTestName

public static String getTestName (ITestDevice device)

المعلمات
`device`	`ITestDevice`

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

moduleIsPlayManaged

public boolean moduleIsPlayManaged (String modulePackageName)

عرض True إذا كانت الوحدة مُدارة من Play

مثال على تخطّي اختبار استنادًا إلى وحدات الإصدار الرئيسي:

  @Test
  public void testPocCVE_1234_5678() throws Exception {
      // This will skip the test if MODULE_METADATA mainline module is play managed.
      assumeFalse(moduleIsPlayManaged("com.google.android.captiveportallogin"));
      // Do testing...
  }

المعلمات
`modulePackageName`	`String`

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

عمليات الرمي
`Exception`

safeReboot

public void safeReboot ()

عمليات الرمي
`DeviceNotAvailableException`

setUp

public void setUp ()

ينتظر حتى يصبح الجهاز متصلاً بالإنترنت، ويحدِّد آخر وقت تم فيه تشغيل الجهاز.

عمليات الرمي
`Exception`

tearDown

public void tearDown ()

التأكّد من اتصال الهاتف بالإنترنت والتحقّق مما إذا تعطّل الجهاز

عمليات الرمي
`Exception`

updateKernelStartTime

public void updateKernelStartTime ()

يسمح بنجاح الاختبار في حال تمّ استدعاؤه بعد إعادة تشغيل مخطّط لها.

عمليات الرمي
`DeviceNotAvailableException`

الطرق المحمية

containsDriver

protected boolean containsDriver (ITestDevice device, 
                String driver, 
                boolean checkReadable)

تحقَّق مما إذا كان هناك برنامج تشغيل على الجهاز.

المعلمات
`device`	`ITestDevice`
`driver`	`String`
`checkReadable`	`boolean`

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

عمليات الرمي
`Exception`

containsDriver

protected boolean containsDriver (ITestDevice device, 
                String driver)

تحقَّق ممّا إذا كان هناك برنامج تشغيل متاح وقابل للقراءة.

المعلمات
`device`	`ITestDevice`
`driver`	`String`

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

عمليات الرمي
`Exception`