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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

‫TargetFileUtils

public class TargetFileUtils
extends Object

java.lang.Object
↳	com.android.tradefed.util.TargetFileUtils

ملخّص

طُرق وضع التصميم العامة
`TargetFileUtils()`

الإجراءات العامة
`static ArrayList<String>`	`findFile(String path, String namePattern, List<String> options, ITestDevice device)` طريقة مساعدة تنفّذ أمر البحث في واجهة سطر الأوامر adb وتعرض النتائج على شكل `ERROR(/ArrayList)`.
`static String`	`getPermission(String filepath, ITestDevice device)` قراءة أجزاء إذن الملف لمسار معيّن
`static boolean`	`hasPermission(TargetFileUtils.FilePermission permission, String permissionBits)` تحديد ما إذا كانت أجزاء الإذن تمنح الإذن المحدّد لأي مجموعة
`static boolean`	`isReadOnly(String filepath, ITestDevice device)` التحقّق مما إذا كان الإذن لمسار معيّن للقراءة فقط
`static boolean`	`isReadWriteOnly(String filepath, ITestDevice device)` التحقّق مما إذا كان الإذن لمسار معيّن للقراءة والكتابة

طُرق وضع التصميم العامة

TargetFileUtils

public TargetFileUtils ()

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

findFile

public static ArrayList<String> findFile (String path, 
                String namePattern, 
                List<String> options, 
                ITestDevice device)

طريقة مساعدة تنفّذ أمر البحث في واجهة سطر الأوامر adb وتعرض النتائج على شكل ERROR(/ArrayList).

المعلَمات
`path`	`String`: المسار الذي سيتم البحث فيه على الجهاز
`namePattern`	`String`: نمط اسم الملف
`options`	`List`: `List` من `String` للخيارات الأخرى التي يتم تمريرها إلى أمر البحث
`device`	`ITestDevice`: جهاز الاختبار

المرتجعات
`ArrayList<String>`	النتيجة في `ERROR(/ArrayList)`

عمليات الطرح
`DeviceNotAvailableException`	إذا تم فقدان الاتصال بالجهاز ولا يمكن استرداده

getPermission

public static String getPermission (String filepath, 
                ITestDevice device)

قراءة أجزاء إذن الملف لمسار معيّن

المعلَمات
`filepath`	`String`: مسار لملف أو دليل
`device`	`ITestDevice`: جهاز الاختبار

المرتجعات
`String`	أجزاء الإذن الثماني للمسار

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

hasPermission

public static boolean hasPermission (TargetFileUtils.FilePermission permission, 
                String permissionBits)

تحديد ما إذا كانت أجزاء الإذن تمنح الإذن المحدّد لأي مجموعة

المعلَمات
`permission`	`TargetFileUtils.FilePermission`: الأذونات المحدّدة
`permissionBits`	`String`: سلسلة الأذونات الثمانية (مثل 741)

المرتجعات
`boolean`	صحيح إذا كان أي مالك أو مجموعة أو مستخدم عالمي يملك الإذن المحدّد

isReadOnly

public static boolean isReadOnly (String filepath, 
                ITestDevice device)

التحقّق مما إذا كان الإذن لمسار معيّن للقراءة فقط

المعلَمات
`filepath`	`String`: مسار لملف أو دليل
`device`	`ITestDevice`: جهاز الاختبار

المرتجعات
`boolean`	صحيح إذا كان المسار للقراءة فقط، وخطأ في الحالات الأخرى

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

isReadWriteOnly

public static boolean isReadWriteOnly (String filepath, 
                ITestDevice device)

التحقّق مما إذا كان الإذن لمسار معيّن للقراءة والكتابة

المعلَمات
`filepath`	`String`: مسار لملف أو دليل
`device`	`ITestDevice`: جهاز الاختبار

المرتجعات
`boolean`	صحيح إذا كان المسار للقراءة والكتابة، وخطأ في الحالات الأخرى

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