اعتبارًا من عام 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.

TarUtil

public class TarUtil
extends Object

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

أداة لتعديل ملف tar. وهي تتضمّن commons-compress لتوفير إمكانية استخدام tar.

ملخّص

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

الإجراءات العامة
`static void`	`extractAndLog(ITestLogger listener, File targzFile, String baseName)` أداة مساعدة لاستخراج ملف tar gz وتسجيله للمراسلين ومحتواه
`static File`	`extractTarGzipToTemp(File targzFile, String nameHint)` فكّ ضغط ملف tar.gz في دليل مؤقت
`static File`	`gzip(File inputFile)` دالة مساعدة لضغط ملف باستخدام gzip ‏(‎.gz).
`static boolean`	`isGzip(File file)` تحديد ما إذا كان الملف بتنسيق gzip
`static File`	`unGzip(File inputFile, File outputDir)` إلغاء ضغط ملف: سيصبح ملف tar.gz أو tgz ملف tar.
`static List<File>`	`unTar(File inputFile, File outputDir, Collection<String> fileNames)` فك ضغط ملف tar في دليل
`static List<File>`	`unTar(File inputFile, File outputDir)` فك ضغط ملف tar في دليل

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

TarUtil

public TarUtil ()

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

extractAndLog

public static void extractAndLog (ITestLogger listener, 
                File targzFile, 
                String baseName)

أداة مساعدة لاستخراج ملف tar gz وتسجيله للمراسلين ومحتواه

المعلَمات
`listener`	`ITestLogger`: `ITestLogger` حيث يتم تسجيل الملفات.
`targzFile`	استبدِل `File` بملف tar.gz `File` الذي يحتاج إلى سجلّ المحتوى.
`baseName`	`String`: الاسم الأساسي الذي سيتم العثور على الملفات ضمنه.

عمليات الطرح
`FileNotFoundException`
`IOException`

extractTarGzipToTemp

public static File extractTarGzipToTemp (File targzFile, 
                String nameHint)

فكّ ضغط ملف tar.gz في دليل مؤقت

المعلَمات
`targzFile`	`File`: ملف tar.gz المطلوب استخراجه
`nameHint`	‫`String`: بادئة الدليل المؤقت

المرتجعات
`File`	دليل temp

عمليات الطرح
	java.io.FileNotFoundException
	java.io.IOException
`FileNotFoundException`
`IOException`

gzip

public static File gzip (File inputFile)

دالة مساعدة لضغط ملف باستخدام gzip ‏(‎.gz). سيتم إضافة الامتداد ‎ .gz إلى اسم الملف الأساسي.

المعلَمات
`inputFile`	`File`: `File` المطلوب ضغطه باستخدام gzip

المرتجعات
`File`	الملف المضغوط بتنسيق gzip

عمليات الطرح
	java.io.IOException
`IOException`

isGzip

public static boolean isGzip (File file)

تحديد ما إذا كان الملف بتنسيق gzip

المعلَمات
`file`	`File`: الملف المطلوب التحقّق منه

المرتجعات
`boolean`	ما إذا كان الملف بتنسيق gzip.

عمليات الطرح
`IOException`	إذا تعذّرت قراءة الملف

unGzip

public static File unGzip (File inputFile, 
                File outputDir)

إلغاء ضغط ملف: سيصبح ملف tar.gz أو tgz ملف tar.

المعلَمات
`inputFile`	`File`: `File` المراد فك ضغطه
`outputDir`	‫`File`: الدليل الذي سيتم وضع الملف غير المضغوط فيه.

المرتجعات
`File`	`File` يشير إلى الملف غير المضغوط.

عمليات الطرح
	java.io.FileNotFoundException
	java.io.IOException
`FileNotFoundException`
`IOException`

unTar

public static List<File> unTar (File inputFile, 
                File outputDir, 
                Collection<String> fileNames)

فك ضغط ملف tar في دليل، ويجب أولاً unGzip(File,File) ملف tar.gz.

المعلَمات
`inputFile`	`File`: ملف tar المطلوب استخراجه
`outputDir`	`File`: المجلد الذي سيتم وضع الملفات المستخرَجة فيه
`fileNames`	`Collection`: الملفات التي سيتم استخراجها من ملف tar.

المرتجعات
`List<File>`	تم فك ضغط قائمة `File`.

عمليات الطرح
	java.io.FileNotFoundException
	java.io.IOException
`FileNotFoundException`
`IOException`

unTar

public static List<File> unTar (File inputFile, 
                File outputDir)

فك ضغط ملف tar في دليل، ويجب أولاً unGzip(File,File) ملف tar.gz.

المعلَمات
`inputFile`	`File`: ملف tar المطلوب استخراجه
`outputDir`	`File`: المجلد الذي سيتم وضع الملفات المستخرَجة فيه

المرتجعات
`List<File>`	تم فك ضغط قائمة `File`.

عمليات الطرح
	java.io.FileNotFoundException
	java.io.IOException
`FileNotFoundException`
`IOException`