تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

برنامج ZipUtil

public class ZipUtil
extends Object

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

فئة مساعد للعمليات المتعلقة بالضغط

الملخّص

شركة إنشاءات عامة
`ZipUtil()`

الطرق العامة
`static void`	`addToZip(ZipOutputStream out, File file, relativePathSegs)` إضافة ملف محدد ومحتواه بشكل متكرر إلى ZipOutputStream
`static void`	`applyPermission(File targetFile, CentralDirectoryInfo zipEntry)` تطبيق إذن الملف المهيأ في إدخال الدليل المركزي
`static void`	`closeZip(ZipFile zipFile)` إغلاق `ERROR(/ZipFile)` مفتوح مع تجاهل أي استثناءات
`static File`	`createZip(File dir)` الأداة المساعدة لإنشاء ملف ZIP مؤقت يحتوي على الدليل المعني وجميع محتواه.
`static File`	`createZip( files, String name)` الأداة المساعدة لإنشاء ملف ZIP مؤقت يحتوي على الملفات المحددة.
`static File`	`createZip(File dir, String name)` الأداة المساعدة لإنشاء ملف ZIP مؤقت يحتوي على الدليل المعني وجميع محتواه.
`static File`	`createZip( files)` طريقة استخدام أداة لإنشاء ملف ZIP مؤقت يحتوي على الملفات المحدّدة
`static void`	`createZip(File dir, File zipFile)` الأداة المساعدة لإنشاء ملف ZIP يحتوي على الدليل المعني وجميع محتواه.
`static void`	`createZip( files, File zipFile)` طريقة الأداة لإنشاء ملف ZIP يحتوي على الملفات المحددة
`static File`	`extractFileFromZip(ZipFile zipFile, String filePath)` طريقة الأداة لاستخراج ملف واحد محدد من ملف zip إلى ملف tmp
`static void`	`extractZip(ZipFile zipFile, File destDir)` طريقة الأداة لاستخراج محتوى ملف ZIP بالكامل إلى دليل معيّن
`static void`	`extractZip(ZipFile zipFile, File destDir, shouldExtract)` طريقة الأداة لاستخراج محتوى ملف ZIP إلى دليل محدد
`static File`	`extractZipToTemp(File zipFile, String nameHint)` استخراج ملف ZIP إلى دليل مؤقت مزود بسلسلة
`static`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, boolean useZip64)` احصل على قائمة {link CentralDirectoryInfo} الخاصة بالملفات في ملف ZIP.
`static`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset)` احصل على قائمة {link CentralDirectoryInfo} الخاصة بالملفات في ملف ZIP.
`static`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo)` احصل على قائمة {link CentralDirectoryInfo} الخاصة بالملفات في ملف ZIP.
`static`	`getZipCentralDirectoryInfos(File partialZipFile, EndCentralDirectoryInfo endCentralDirInfo, long offset, boolean useZip64)` احصل على قائمة {link CentralDirectoryInfo} الخاصة بالملفات في ملف ZIP.
`static void`	`gzipFile(File file, File gzipFile)` طريقة مساعدة لإنشاء نسخة مضغوطة بتنسيق gzip من ملف واحد.
`static boolean`	`isZipFileValid(File zipFile, boolean thorough)` طريقة الأداة للتحقق من أن ملف zip غير تالف.
`static void`	`unzipPartialZipFile(File partialZip, File targetFile, CentralDirectoryInfo zipEntry, LocalFileHeader localFileHeader, long startOffset)` يمكنك استخراج ملف واحد مطلوب من ملف ZIP جزئي.
`static void`	`unzipPartialZipFolder(File targetFile, CentralDirectoryInfo zipEntry)` استخرِج المجلد المطلوب من ملف ZIP جزئي واستخدِم الإذن المناسب.

الطرق المحمية
`static void`	`validateDestinationDir(File destDir, String filename)`

شركة إنشاءات عامة

برنامج ZipUtil

public ZipUtil ()

الطرق العامة

إضافة ToZip

public static void addToZip (ZipOutputStream out, 
                File file, 
                 relativePathSegs)

إضافة ملف محدد ومحتواه بشكل متكرر إلى ZipOutputStream

المعلّمات
`out`	`ZipOutputStream`: `ERROR(/ZipOutputStream)`
`file`	`File`: `ERROR(/File)` المطلوب إضافته إلى ساحة المشاركات
`relativePathSegs`	: المسار النسبي للملف، بما في ذلك الفواصل

الرميات
	في حال تعذّر إضافة الملف إلى الملف بتنسيق zip

تطبيق الإذن

public static void applyPermission (File targetFile, 
                CentralDirectoryInfo zipEntry)

تطبيق إذن الملف المهيأ في إدخال الدليل المركزي

المعلّمات
`targetFile`	`File`: السمة `ERROR(/File)` المطلوب ضبط الإذن لها.
`zipEntry`	`CentralDirectoryInfo`: كائن `CentralDirectoryInfo` يحتوي على أذونات الملف

الرميات
	في حالة فشل الوصول إلى الملف.

إغلاق

public static void closeZip (ZipFile zipFile)

إغلاق ERROR(/ZipFile) مفتوح مع تجاهل أي استثناءات

المعلّمات
`zipFile`	`ZipFile`: الملف المطلوب إغلاقه

إنشاء Zip

public static File createZip (File dir)

الأداة المساعدة لإنشاء ملف ZIP مؤقت يحتوي على الدليل المعني وجميع محتواه.

المعلّمات
`dir`	`File`: الدليل المراد ضغطه

الركلات المردودة
`File`	ملف ZIP `ERROR(/File)` مؤقت يحتوي على محتوى الدليل

الرميات
	في حال تعذّر إنشاء ملف ZIP

إنشاء Zip

public static File createZip ( files, 
                String name)

الأداة المساعدة لإنشاء ملف ZIP مؤقت يحتوي على الملفات المحددة.

المعلّمات
`files`	: قائمة بالملفات المطلوب ضغطها
`name`	`String`: الاسم الأساسي لملف ZIP الذي تم إنشاؤه بدون الإضافة.

الركلات المردودة
`File`	ملف ZIP `ERROR(/File)` مؤقت يحتوي على محتوى الدليل

الرميات
	في حال تعذّر إنشاء ملف ZIP

إنشاء Zip

public static File createZip (File dir, 
                String name)

الأداة المساعدة لإنشاء ملف ZIP مؤقت يحتوي على الدليل المعني وجميع محتواه.

المعلّمات
`dir`	`File`: الدليل المراد ضغطه
`name`	`String`: الاسم الأساسي لملف ZIP الذي تم إنشاؤه بدون الإضافة.

الركلات المردودة
`File`	ملف ZIP `ERROR(/File)` مؤقت يحتوي على محتوى الدليل

الرميات
	في حال تعذّر إنشاء ملف ZIP

إنشاء Zip

public static File createZip ( files)

طريقة استخدام أداة لإنشاء ملف ZIP مؤقت يحتوي على الملفات المحدّدة

المعلّمات
`files`	: قائمة بالملفات المطلوب ضغطها

الركلات المردودة
`File`	ملف ZIP `ERROR(/File)` مؤقت يحتوي على محتوى الدليل

الرميات
	في حال تعذّر إنشاء ملف ZIP

إنشاء Zip

public static void createZip (File dir, 
                File zipFile)

الأداة المساعدة لإنشاء ملف ZIP يحتوي على الدليل المعني وجميع محتواه.

المعلّمات
`dir`	`File`: الدليل المراد ضغطه
`zipFile`	`File`: ملف ZIP الذي سيتم إنشاؤه، ليس من المفترض أن يكون متوفّرًا

الرميات
	في حال تعذّر إنشاء ملف ZIP

إنشاء Zip

public static void createZip ( files, 
                File zipFile)

طريقة الأداة لإنشاء ملف ZIP يحتوي على الملفات المحددة

المعلّمات
`files`	: قائمة بالملفات المطلوب ضغطها
`zipFile`	`File`: ملف ZIP الذي سيتم إنشاؤه، ليس من المفترض أن يكون متوفّرًا

الرميات
	في حال تعذّر إنشاء ملف ZIP

استخراجملف منZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

طريقة الأداة لاستخراج ملف واحد محدد من ملف zip إلى ملف tmp

المعلّمات
`zipFile`	`ZipFile`: السمة `ERROR(/ZipFile)` المطلوب استخراجها
`filePath`	`String`: مسار filePath المطلوب استخراجه

الركلات المردودة
`File`	في حال عدم العثور على السمة `ERROR(/File)` أو قيمة فارغة

الرميات
	في حال تعذّر استخراج الملف

استخراج ملفات ضغط

public static void extractZip (ZipFile zipFile, 
                File destDir)

طريقة الأداة لاستخراج محتوى ملف ZIP بالكامل إلى دليل معيّن

المعلّمات
`zipFile`	`ZipFile`: السمة `ERROR(/ZipFile)` المطلوب استخراجها
`destDir`	`File`: الأمر dir المحلي المطلوب استخراج الملف إليه

الرميات
	في حال تعذّر استخراج الملف

استخراج ملفات ضغط

public static void extractZip (ZipFile zipFile, 
                File destDir, 
                 shouldExtract)

طريقة الأداة لاستخراج محتوى ملف ZIP إلى دليل محدد

المعلّمات
`zipFile`	`ZipFile`: السمة `ERROR(/ZipFile)` المطلوب استخراجها
`destDir`	`File`: الأمر dir المحلي المطلوب استخراج الملف إليه
`shouldExtract`	: التسمية إلى dermin إذا كان يجب استخراج ZipEntry

الرميات
	في حال تعذّر استخراج الملف

استخراجZipToTemp

public static File extractZipToTemp (File zipFile, 
                String nameHint)

استخراج ملف ZIP إلى دليل مؤقت مزود بسلسلة

المعلّمات
`zipFile`	`File`: ملف ZIP المطلوب استخراجه
`nameHint`	`String`: بادئة للدليل المؤقت

الركلات المردودة
`File`	`ERROR(/File)` يشير إلى الدليل المؤقت

GetZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                boolean useZip64)

احصل على قائمة {link CentralDirectoryInfo} الخاصة بالملفات في ملف ZIP.

المعلّمات
`partialZipFile`	`File`: كائن `ERROR(/File)` لملف ZIP الجزئي الذي يحتوي على إدخالات الدليل المركزي.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: كائن `EndCentralDirectoryInfo` في ملف ZIP.
`useZip64`	`boolean`: قيمة منطقية لإتاحة تنسيق zip64 في التنزيل الجزئي.

الركلات المردودة
	قائمة بـ `CentralDirectoryInfo` من ملف ZIP

الرميات
	IOاستثناء

GetZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                long offset)

احصل على قائمة {link CentralDirectoryInfo} الخاصة بالملفات في ملف ZIP.

المعلّمات
`partialZipFile`	`File`: كائن `ERROR(/File)` لملف ZIP الجزئي الذي يحتوي على إدخالات الدليل المركزي.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: كائن `EndCentralDirectoryInfo` في ملف ZIP.
`offset`	`long`: الإزاحة في ملف ZIP الجزئي الذي يبدأ فيه محتوى إدخالات الدليل المركزي.

الركلات المردودة
	قائمة بـ `CentralDirectoryInfo` من ملف ZIP

الرميات
	IOاستثناء

GetZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo)

احصل على قائمة {link CentralDirectoryInfo} الخاصة بالملفات في ملف ZIP.

المعلّمات
`partialZipFile`	`File`: كائن `ERROR(/File)` لملف ZIP الجزئي الذي يحتوي على إدخالات الدليل المركزي.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: كائن `EndCentralDirectoryInfo` في ملف ZIP.

الركلات المردودة
	قائمة بـ `CentralDirectoryInfo` من ملف ZIP

الرميات
	IOاستثناء

GetZipCentralDirectoryInfos

public static  getZipCentralDirectoryInfos (File partialZipFile, 
                EndCentralDirectoryInfo endCentralDirInfo, 
                long offset, 
                boolean useZip64)

احصل على قائمة {link CentralDirectoryInfo} الخاصة بالملفات في ملف ZIP.

المعلّمات
`partialZipFile`	`File`: كائن `ERROR(/File)` لملف ZIP الجزئي الذي يحتوي على إدخالات الدليل المركزي.
`endCentralDirInfo`	`EndCentralDirectoryInfo`: كائن `EndCentralDirectoryInfo` في ملف ZIP.
`offset`	`long`: الإزاحة في ملف ZIP الجزئي الذي يبدأ فيه محتوى إدخالات الدليل المركزي.
`useZip64`	`boolean`: قيمة منطقية لإتاحة تنسيق zip64 في التنزيل الجزئي.

الركلات المردودة
	قائمة بـ `CentralDirectoryInfo` من ملف ZIP

الرميات
	IOاستثناء

ملف gzip

public static void gzipFile (File file, 
                File gzipFile)

طريقة مساعدة لإنشاء نسخة مضغوطة بتنسيق gzip من ملف واحد.

المعلّمات
`file`	`File`: الملف الأصلي
`gzipFile`	`File`: الملف الذي تريد وضع المحتوى المضغوط فيه

الرميات
	IOاستثناء

ملف isZipFileValid

public static boolean isZipFileValid (File zipFile, 
                boolean thorough)

طريقة الأداة للتحقق من أن ملف zip غير تالف.

المعلّمات
`zipFile`	`File`: السمة `ERROR(/File)` المطلوب الاطّلاع عليها
`thorough`	`boolean`: لتحديد ما إذا كنت تريد محاولة استخراج الأرشيف بالكامل إذا كانت القيمة `false`، لن تتمكّن هذه الطريقة من رصد أخطاء CRC في أرشيف تم تنسيقه بشكل صحيح.

الركلات المردودة
`boolean`	`false` إذا كان يبدو أن الملف تالفًا، و`true` في الحالات الأخرى

الرميات
	إذا تعذّر فتح الملف أو قراءته

ملف UnzipPartialZipFile

public static void unzipPartialZipFile (File partialZip, 
                File targetFile, 
                CentralDirectoryInfo zipEntry, 
                LocalFileHeader localFileHeader, 
                long startOffset)

يمكنك استخراج ملف واحد مطلوب من ملف ZIP جزئي.

تفترض هذه الطريقة أن جميع الملفات موجودة على نفس القرص عند ضغطها.

إذا كان ERROR(/targetFile) دليلاً، سيتم إنشاء دليل فارغ بدون محتواه.

إذا كان ERROR(/targetFile) رابطًا رمزيًا، سيتم إنشاء رابط رمزي ولكن لن يتم حله.

لا يوفّر بعد الميزات التالية:

حجم ملف ZIP أكبر من 4 غيغابايت

ZIP64(طلب تحديث ZipLocalFileHeader على الحجم المضغوط)

ملف zip مشفّر

المعلّمات
`partialZip`	`File`: `ERROR(/File)` وهو جزء من ملف zip.
`targetFile`	`File`: السمة `ERROR(/File)` التي تريد حفظ الملف المستخرَج فيها
`zipEntry`	`CentralDirectoryInfo`: كائن `CentralDirectoryInfo` للملف المطلوب استخراجه من ملف ZIP الجزئي.
`localFileHeader`	`LocalFileHeader`: كائن `LocalFileHeader` للملف المطلوب استخراجه من ملف ZIP الجزئي.
`startOffset`	`long`: إزاحة بداية الملف المطلوب استخراجه

الرميات
	IOاستثناء

طريقة فك ضغط الرمز البرمجي حسب الطلب

public static void unzipPartialZipFolder (File targetFile, 
                CentralDirectoryInfo zipEntry)

استخرِج المجلد المطلوب من ملف ZIP جزئي واستخدِم الإذن المناسب.

المعلّمات
`targetFile`	`File`: السمة `ERROR(/File)` التي تريد حفظ الملف المستخرَج فيها
`zipEntry`	`CentralDirectoryInfo`: كائن `CentralDirectoryInfo` للملف المطلوب استخراجه من ملف ZIP الجزئي.

الرميات
	IOاستثناء

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

التحقّق من صحة الوجهة

protected static void validateDestinationDir (File destDir, 
                String filename)

المعلّمات
`destDir`	`File`
`filename`	`String`