Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

Subclass tidak langsung yang umum

FileDownloadCacheWrapper, GCSFileDownloader

FileDownloadCacheWrapper	Class wrapper yang menyediakan fasilitas `FileDownloadCache` saat menerapkan antarmuka `IFileDownloader`.
GCSFileDownloader	File downloader untuk mendownload file dari Google Cloud Storage (GCS).

Antarmuka untuk mendownload file jarak jauh.

Ringkasan

Metode publik
`default void`	`acquireDownloadPermit()` Jika batas serentak didukung, ambil izin download.
`default void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` Bentuk alternatif `downloadFile(String, File)`, yang memungkinkan pemanggil mendownload bagian file dan menyimpannya ke file tujuan tertentu.
`abstract void`	`downloadFile(String relativeRemotePath, File destFile)` Bentuk alternatif `downloadFile(String)`, yang memungkinkan pemanggil menentukan file tujuan tempat konten jarak jauh harus ditempatkan.
`abstract File`	`downloadFile(String remoteFilePath)` Mendownload file jarak jauh ke file sementara di disk lokal.
`default void`	`downloadZippedFiles(File destDir, String remoteFilePath, includeFilters, excludeFilters)` Mendownload file yang cocok dengan filter yang diberikan dalam file zip jarak jauh.
`default boolean`	`isFresh(File localFile, String remoteFilePath)` Periksa keaktualan file lokal.
`default void`	`releaseDownloadPermit()` Jika batas serentak didukung, lepaskan izin download.

Metode publik

acquireDownloadPermit

public void acquireDownloadPermit ()

Jika batas serentak didukung, ambil izin download.

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile, 
                long startOffset, 
                long size)

Bentuk alternatif downloadFile(String, File), yang memungkinkan pemanggil mendownload bagian file dan menyimpannya ke file tujuan tertentu.

Parameter
`remoteFilePath`	`String`: jalur jarak jauh ke file yang akan didownload, relatif terhadap root khusus implementasi.
`destFile`	`File`: file tempat konten yang didownload akan ditempatkan. Seharusnya tidak ada.
`startOffset`	`long`: offset awal dalam file jarak jauh.
`size`	`long`: jumlah byte yang akan didownload dari file jarak jauh. Tetapkan ke nilai negatif untuk mendownload seluruh file.

Menampilkan
`BuildRetrievalError`	jika file tidak dapat didownload

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

Bentuk alternatif downloadFile(String), yang memungkinkan pemanggil menentukan file tujuan tempat konten jarak jauh harus ditempatkan.

Parameter
`relativeRemotePath`	`String`: jalur jarak jauh ke file yang akan didownload, relatif terhadap root khusus implementasi.
`destFile`	`File`: file tempat konten yang didownload akan ditempatkan. Seharusnya tidak ada.

Menampilkan
`BuildRetrievalError`	jika file tidak dapat didownload

downloadFile

public abstract File downloadFile (String remoteFilePath)

Mendownload file jarak jauh ke file sementara di disk lokal.

Parameter
`remoteFilePath`	`String`: jalur jarak jauh ke file yang akan didownload, relatif terhadap root khusus implementasi.

Hasil
`File`	`ERROR(/File)` lokal sementara yang didownload.

Menampilkan
`BuildRetrievalError`	jika file tidak dapat didownload

downloadZippedFiles

public void downloadZippedFiles (File destDir, 
                String remoteFilePath, 
                 includeFilters, 
                 excludeFilters)

Mendownload file yang cocok dengan filter yang diberikan dalam file zip jarak jauh.

File di dalam file zip jarak jauh hanya didownload jika jalurnya cocok dengan salah satu filter yang disertakan, tetapi tidak dengan filter yang dikecualikan.

Parameter
`destDir`	`File`: file tempat konten yang didownload akan ditempatkan.
`remoteFilePath`	`String`: jalur jarak jauh ke file yang akan didownload, relatif terhadap root khusus penerapan.
`includeFilters`	: daftar filter untuk mendownload file yang cocok.
`excludeFilters`	: daftar filter untuk melewati download file yang cocok.

Menampilkan
`BuildRetrievalError`	jika file tidak dapat didownload.
	IOException

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

Periksa keaktualan file lokal. Jika file lokal sama dengan file jarak jauh, file tersebut baru. Jika tidak, file lokal sudah tidak berlaku. Ini terutama digunakan untuk cache. Implementasi default akan selalu menampilkan true, sehingga jika file tidak dapat diubah, file tersebut tidak akan pernah perlu memeriksa keaktualan.

Parameter
`localFile`	`File`: file lokal.
`remoteFilePath`	`String`: jalur file jarak jauh.

Hasil
`boolean`	Benar jika file lokal baru, salah jika tidak.

Menampilkan
	com.android.tradefed.build.BuildRetrievalError
`BuildRetrievalError`

releaseDownloadPermit

public void releaseDownloadPermit ()

Jika batas serentak didukung, lepaskan izin download.