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

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, subFiles, 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

القيمة الثابتة: "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`

downloadFile

public InputStream downloadFile (String bucketName, 
                String filename)

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

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

المرتجعات
`InputStream`	`ERROR(/InputStream)` مع محتوى الملف

downloadFile

public void downloadFile (String remotePath, 
                File destFile)

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

downloadFile

public File downloadFile (String remoteFilePath)

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

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

getRemoteFileMetaData

public StorageObject getRemoteFileMetaData (String bucketName, 
                String remoteFilename)

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

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

isRemoteFolder

public boolean isRemoteFolder (String bucketName, 
                String filename)

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

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

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

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

sanitizeDirectoryName

public String sanitizeDirectoryName (String name)

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

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

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

createTempFile

protected File createTempFile (String remoteFilePath, 
                File rootDir)

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

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

downloadFile

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

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

getStorage

protected Storage getStorage ()

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

listRemoteFilesUnderFolder

protected void listRemoteFilesUnderFolder (String bucketName, 
                String folder, 
                 subFiles, 
                 subFolders)

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

parseGcsPath

protected String[] parseGcsPath (String remotePath)

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

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