از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

TestMapping

public class TestMapping
extends Object

java.lang.object
↳	com.android.tradefed.util.testmapping.TestMapping

کلاسی برای بارگیری یک فایل TEST_MAPPING.

خلاصه

فیلدها
`public static final Pattern`	`MAINLINE_REGEX`
`public static final String`	`TEST_MAPPINGS_ZIP`
`public static final String`	`TEST_SOURCES`

سازندگان عمومی
`TestMapping ()` سازنده برای مقداردهی اولیه یک شیء خالی `TestMapping` .
`TestMapping ( testMappingRelativePaths, boolean ignoreTestMappingImports)` `TestMapping ( testMappingRelativePaths, boolean ignoreTestMappingImports)` سازنده برای ایجاد یک شی `TestMapping` .

روش های عمومی
`static File`	`extractTestMappingsZip (File testMappingsZip)` یک فایل فشرده را استخراج کنید و دایرکتوری حاوی محتوای فایل های زیپ نشده را برگردانید.
	`getAllTests (File testMappingsDir)` کمکی برای یافتن همه آزمایش‌ها در فایل‌های TEST_MAPPING از یک فهرست مشخص.
`static Matcher`	`getMainlineTestModuleName ( TestInfo info)` کمک کننده برای به دست آوردن تطبیق برای تست های خط اصلی پارامتری شده.
	`getTests ( IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords)` `getTests ( IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords)` `getTests ( IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords)` کمکی برای یافتن همه آزمایش‌ها در همه فایل‌های TEST_MAPPING بر اساس یک مصنوع در ساخت دستگاه.
	`getTests ( IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords, extraZipNames, matchedPatternPaths)` `getTests ( IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords, extraZipNames, matchedPatternPaths)` `getTests ( IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords, extraZipNames, matchedPatternPaths)` `getTests ( IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords, extraZipNames, matchedPatternPaths)` `getTests ( IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords, extraZipNames, matchedPatternPaths)` کمک کننده برای یافتن همه آزمایش ها در همه فایل های TEST_MAPPING بر اساس مصنوع داده شده.
`void`	`listTestMappingFiles (Path testMappingDir, Path testMappingsRootDir, filePaths)` `listTestMappingFiles (Path testMappingDir, Path testMappingsRootDir, filePaths)` کمکی برای فهرست کردن همه فایل‌های نگاشت آزمایشی، جستجوی همه فهرست‌های والد و مسیرهای واردات مرتبط.

فیلدها

MAINLINE_REGEX

public static final Pattern MAINLINE_REGEX

TEST_MAPPINGS_ZIP

public static final String TEST_MAPPINGS_ZIP

TEST_SOURCES

public static final String TEST_SOURCES

سازندگان عمومی

TestMapping

public TestMapping ()

سازنده برای مقداردهی اولیه یک شیء خالی TestMapping .

TestMapping

public TestMapping ( testMappingRelativePaths, 
                boolean ignoreTestMappingImports)

سازنده برای ایجاد یک شی TestMapping .

پارامترها
`testMappingRelativePaths`	: `ERROR(/List )` `ERROR(/List )` به مسیرهای فایل TEST_MAPPING.
`ignoreTestMappingImports`	`boolean` : `ERROR(/boolean)` برای نادیده گرفتن واردات.

روش های عمومی

extractTestMappingsZip

public static File extractTestMappingsZip (File testMappingsZip)

یک فایل فشرده را استخراج کنید و دایرکتوری حاوی محتوای فایل های زیپ نشده را برگردانید.

پارامترها
`testMappingsZip`	`File` : یک `ERROR(/File)` از زیپ نگاشت های آزمایشی برای استخراج.

برمی گرداند
`File`	یک `ERROR(/File)` که به دایرکتوری موقت برای زیپ نگاشت های آزمایشی اشاره می کند.

getAllTests

public  getAllTests (File testMappingsDir)

کمکی برای یافتن همه آزمایش‌ها در فایل‌های TEST_MAPPING از یک فهرست مشخص.

پارامترها
`testMappingsDir`	`File` : `ERROR(/File)` دایرکتوری حاوی تمام فایل های Test Mapping.

برمی گرداند
	`Map<String, Set<TestInfo>>` از تست ها در دایرکتوری داده شده و دایرکتوری های فرزند آن.

getMainlineTestModuleName

public static Matcher getMainlineTestModuleName (TestInfo info)

کمک کننده برای به دست آوردن تطبیق برای تست های خط اصلی پارامتری شده.

پارامترها
`info`	`TestInfo`

برمی گرداند
`Matcher`	یک `ERROR(/Matcher)` برای تست های خط اصلی پارامتری شده.

پرتاب می کند
`ConfigurationException`

getTests

public  getTests (IBuildInfo buildInfo, 
                String testGroup, 
                boolean hostOnly, 
                 keywords, 
                 ignoreKeywords)

کمکی برای یافتن همه آزمایش‌ها در همه فایل‌های TEST_MAPPING بر اساس یک مصنوع در ساخت دستگاه.

پارامترها
`buildInfo`	`IBuildInfo` : `IBuildInfo` ساخت را توصیف می کند.
`testGroup`	`String` : `String` از گروه آزمایشی.
`hostOnly`	`boolean` : درست است اگر فقط آزمایش‌هایی که روی میزبان اجرا می‌شوند و نیازی به دستگاه ندارند باید برگردانده شوند. false برای بازگرداندن تست هایی که برای اجرا به دستگاه نیاز دارند.
`keywords`	: مجموعه‌ای از `String` که هنگام فیلتر کردن آزمایش‌ها برای اجرا در مجموعه نقشه‌برداری آزمایشی مطابقت داده می‌شوند.
`ignoreKeywords`	: مجموعه ای از `String` کلمات کلیدی که باید نادیده گرفته شوند.

برمی گرداند
	`Set<TestInfo>` در build artifact، test_mappings.zip.

getTests

public  getTests (IBuildInfo buildInfo, 
                String testGroup, 
                boolean hostOnly, 
                 keywords, 
                 ignoreKeywords, 
                 extraZipNames, 
                 matchedPatternPaths)

کمک کننده برای یافتن همه آزمایش ها در همه فایل های TEST_MAPPING بر اساس مصنوع داده شده. این زمانی مورد نیاز است که یک مجموعه نیاز به اجرای همه آزمایش‌ها در فایل‌های TEST_MAPPING برای یک گروه معین داشته باشد، به عنوان مثال، از پیش ارسال کنید.

پارامترها
`buildInfo`	`IBuildInfo` : `IBuildInfo` ساخت را توصیف می کند.
`testGroup`	`String` : `String` از گروه آزمایشی.
`hostOnly`	`boolean` : درست است اگر فقط آزمایش‌هایی که روی میزبان اجرا می‌شوند و نیازی به دستگاه ندارند باید برگردانده شوند. false برای بازگرداندن تست هایی که برای اجرا به دستگاه نیاز دارند.
`keywords`	: مجموعه‌ای از `String` که هنگام فیلتر کردن آزمایش‌ها برای اجرا در مجموعه نقشه‌برداری آزمایشی مطابقت داده می‌شوند.
`ignoreKeywords`	: مجموعه ای از `String` کلمات کلیدی که باید نادیده گرفته شوند.
`extraZipNames`	: مجموعه ای از `String` برای نام test_mappings.zip اضافی که ادغام خواهد شد.
`matchedPatternPaths`	: `ERROR(/Set )` `ERROR(/Set )` به فایل مسیرهای الگوهای همسان.

برمی گرداند
	`Set<TestInfo>` در build artifact، test_mappings.zip.

listTestMappingFiles

public void listTestMappingFiles (Path testMappingDir, 
                Path testMappingsRootDir, 
                 filePaths)

کمکی برای فهرست کردن همه فایل‌های نگاشت آزمایشی، جستجوی همه فهرست‌های والد و مسیرهای واردات مرتبط.

پارامترها
`testMappingDir`	`Path` : `ERROR(/Path)` به فهرست اصلی فایل TEST_MAPPING.
`testMappingsRootDir`	`Path` : `ERROR(/Path)` به پوشه همه فایل‌های TEST_MAPPING برای ساخت.
`filePaths`	: A `ERROR(/Set )` `ERROR(/Set )` برای ذخیره همه مسیرهای TEST_MAPPING.