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

GCSFileDownloaderBase

public class GCSFileDownloaderBase
extends GCSCommon

java.lang.Object
↳	com.android.tradefed.util.gcs.GCSCommon
	↳	com.android.tradefed.util.gcs.GCSFileDownloaderBase

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

GCSFileDownloader

GCSFileDownloader أداة تنزيل الملفات لتنزيل ملف من Google Cloud Storage (GCS).

أداة تنزيل الملفات لتنزيل ملف من Google Cloud Storage (GCS).

ملخّص

الثوابت
`String`	`GCS_APPROX_PREFIX`
`String`	`GCS_PREFIX`

الحقول
`protected Boolean`	`mCreateEmptyFile`

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

الإجراءات العامة
`static File`	`createTempFileForRemote(String remoteFilePath, File rootDir)` ينشئ هذا الإجراء ملفًا فريدًا على القرص المؤقت لتخزين الملف الذي تم تنزيله باستخدام المسار المحدّد.
`InputStream`	`downloadFile(String bucketName, String filename)` تنزيل ملف من ملف حزمة GCS
`void`	`downloadFile(String remotePath, File destFile)`
`File`	`downloadFile(String remoteFilePath)`
`StorageObject`	`getRemoteFileMetaData(String bucketName, String remoteFilename)`
`boolean`	`isRemoteFolder(String bucketName, String filename)` التحقّق مما إذا كان اسم الملف المحدّد هو مجلد أم لا
`String`	`sanitizeDirectoryName(String name)`

طُرق محمية
`File`	`createTempFile(String remoteFilePath, File rootDir)`
`void`	`downloadFile(String bucketName, String remoteFilename, File localFile)`
`Storage`	`getStorage()`
`void`	`listRemoteFilesUnderFolder(String bucketName, String folder, List<StorageObject> subFiles, List<String> subFolders)`
`String[]`	`parseGcsPath(String remotePath)`

الثوابت

GCS_APPROX_PREFIX

public static final String GCS_APPROX_PREFIX

Constant Value: "gs:/"

GCS_PREFIX

public static final String GCS_PREFIX

Constant Value: "gs://"

الحقول

mCreateEmptyFile

protected Boolean mCreateEmptyFile

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

GCSFileDownloaderBase

public GCSFileDownloaderBase ()

GCSFileDownloaderBase

public GCSFileDownloaderBase (Boolean createEmptyFile)

المعلَمات
`createEmptyFile`	`Boolean`

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

createTempFileForRemote

public static File createTempFileForRemote (String remoteFilePath, 
                File rootDir)

ينشئ هذا الإجراء ملفًا فريدًا على القرص المؤقت لتخزين الملف الذي تم تنزيله باستخدام المسار المحدّد.

تنشئ هذه السمة اسم الملف استنادًا إلى اسم الملف الأساسي من المسار

المعلَمات
`remoteFilePath`	‫`String`: المسار البعيد الذي سيتم إنشاء الاسم منه
`rootDir`	`File`

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

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

downloadFile

public InputStream downloadFile (String bucketName, 
                String filename)

تنزيل ملف من ملف حزمة GCS

المعلَمات
`bucketName`	‫`String`: اسم حزمة GCS
`filename`	`String`: اسم الملف

المرتجعات
`InputStream`	`InputStream` مع محتوى الملف

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

downloadFile

public void downloadFile (String remotePath, 
                File destFile)

المعلَمات
`remotePath`	`String`
`destFile`	`File`

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

downloadFile

public File downloadFile (String remoteFilePath)

المعلَمات
`remoteFilePath`	`String`

القيم المُعادة
`File`

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

getRemoteFileMetaData

public StorageObject getRemoteFileMetaData (String bucketName, 
                String remoteFilename)

المعلَمات
`bucketName`	`String`
`remoteFilename`	`String`

القيم المُعادة
`StorageObject`

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

isRemoteFolder

public boolean isRemoteFolder (String bucketName, 
                String filename)

التحقّق مما إذا كان اسم الملف المحدّد هو مجلد أم لا

هناك نوعان من المجلدات في نظام التخزين السحابي من Google: تم إنشاؤه بشكل صريح من واجهة المستخدم. المجلد هو ملف نصي بحجم 0 (أي أنّه عنصر). 2. عند تحميل ملف، سيتم إنشاء جميع المجلدات الرئيسية الخاصة به، ولكن هذه المجلدات غير متوفّرة (ليست عناصر) في GCS. تعمل هذه الدالة في كلتا الحالتين. ولكن لا يجب محاولة تنزيل المجلدات التي يبلغ حجمها 0. في حال رفض منح الإذن، سنفترض أنّها ملف لتجنُّب إيقاف التنفيذ.

المعلَمات
`bucketName`	`String`: هو اسم حزمة GCS.
`filename`	‫`String`: هو المسار النسبي إلى الحزمة.

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

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

sanitizeDirectoryName

public String sanitizeDirectoryName (String name)

المعلَمات
`name`	`String`

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

طُرق محمية

createTempFile

protected File createTempFile (String remoteFilePath, 
                File rootDir)

المعلَمات
`remoteFilePath`	`String`
`rootDir`	`File`

القيم المُعادة
`File`

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

downloadFile

protected void downloadFile (String bucketName, 
                String remoteFilename, 
                File localFile)

المعلَمات
`bucketName`	`String`
`remoteFilename`	`String`
`localFile`	`File`

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

getStorage

protected Storage getStorage ()

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

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

listRemoteFilesUnderFolder

protected void listRemoteFilesUnderFolder (String bucketName, 
                String folder, 
                List<StorageObject> subFiles, 
                List<String> subFolders)

المعلَمات
`bucketName`	`String`
`folder`	`String`
`subFiles`	`List`
`subFolders`	`List`

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

parseGcsPath

protected String[] parseGcsPath (String remotePath)

المعلَمات
`remotePath`	`String`

القيم المُعادة
`String[]`

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