ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

คลาสย่อยโดยอ้อมที่ทราบ

FileDownloadCacheWrapper, GCSFileDownloader

FileDownloadCacheWrapper	คลาส Wrapper ที่ให้สิ่งอำนวยความสะดวก `FileDownloadCache` ขณะติดตั้งใช้งานอินเทอร์เฟซ `IFileDownloader`
GCSFileDownloader	เครื่องมือดาวน์โหลดไฟล์เพื่อดาวน์โหลดไฟล์จาก Google Cloud Storage (GCS)

อินเทอร์เฟซสำหรับการดาวน์โหลดไฟล์ระยะไกล

สรุป

เมธอดสาธารณะ
`default void`	`acquireDownloadPermit()` หากรองรับขีดจํากัดการเรียกใช้พร้อมกัน ให้ขอใบอนุญาตการดาวน์โหลด
`default void`	`downloadFile(String remoteFilePath, File destFile, long startOffset, long size)` รูปแบบอื่นของ `downloadFile(String, File)` ซึ่งอนุญาตให้ผู้เรียกให้ดาวน์โหลดส่วนหนึ่งของไฟล์และบันทึกลงในไฟล์ปลายทางที่เฉพาะเจาะจง
`abstract void`	`downloadFile(String relativeRemotePath, File destFile)` รูปแบบอื่นของ `downloadFile(String)` ซึ่งช่วยให้ผู้เรียกใช้ระบุไฟล์ปลายทางที่จะวางเนื้อหาระยะไกลได้
`abstract File`	`downloadFile(String remoteFilePath)` ดาวน์โหลดไฟล์ระยะไกลไปยังไฟล์ชั่วคราวในดิสก์ในเครื่อง
`default void`	`downloadZippedFiles(File destDir, String remoteFilePath, includeFilters, excludeFilters)` ดาวน์โหลดไฟล์ที่ตรงกับตัวกรองที่ระบุในไฟล์ ZIP ระยะไกล
`default boolean`	`isFresh(File localFile, String remoteFilePath)` ตรวจสอบความใหม่ของไฟล์ในเครื่อง
`default void`	`releaseDownloadPermit()` หากรองรับขีดจำกัดการเรียกใช้พร้อมกัน ให้ปล่อยใบอนุญาตการดาวน์โหลด

เมธอดสาธารณะ

acquireDownloadPermit

public void acquireDownloadPermit ()

หากรองรับขีดจํากัดการเรียกใช้พร้อมกัน ให้ขอใบอนุญาตการดาวน์โหลด

downloadFile

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

รูปแบบอื่นของ downloadFile(String, File) ซึ่งอนุญาตให้ผู้เรียกให้ดาวน์โหลดส่วนหนึ่งของไฟล์และบันทึกลงในไฟล์ปลายทางที่เฉพาะเจาะจง

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางระยะไกลไปยังไฟล์ที่จะดาวน์โหลด โดยสัมพันธ์กับรูทเฉพาะการติดตั้งใช้งาน
`destFile`	`File`: ไฟล์ที่จะวางเนื้อหาที่ดาวน์โหลด ไม่ควรมี
`startOffset`	`long`: ออฟเซ็ตเริ่มต้นในไฟล์ระยะไกล
`size`	`long`: จํานวนไบต์ที่จะดาวน์โหลดจากไฟล์ระยะไกล ตั้งค่าเป็นค่าลบเพื่อดาวน์โหลดทั้งไฟล์

การโยน
`BuildRetrievalError`	if file could not be downloaded

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

รูปแบบอื่นของ downloadFile(String) ซึ่งช่วยให้ผู้เรียกใช้ระบุไฟล์ปลายทางที่จะวางเนื้อหาระยะไกลได้

พารามิเตอร์
`relativeRemotePath`	`String`: เส้นทางระยะไกลไปยังไฟล์ที่จะดาวน์โหลด โดยสัมพันธ์กับรูทเฉพาะการติดตั้งใช้งาน
`destFile`	`File`: ไฟล์ที่จะวางเนื้อหาที่ดาวน์โหลด ไม่ควรมี

การโยน
`BuildRetrievalError`	if file could not be downloaded

downloadFile

public abstract File downloadFile (String remoteFilePath)

ดาวน์โหลดไฟล์ระยะไกลไปยังไฟล์ชั่วคราวในดิสก์ในเครื่อง

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางระยะไกลไปยังไฟล์ที่จะดาวน์โหลด โดยสัมพันธ์กับรูทที่เจาะจงของการใช้งาน

คิกรีเทิร์น
`File`	`ERROR(/File)` ที่ดาวน์โหลดไว้ชั่วคราวในเครื่อง

การโยน
`BuildRetrievalError`	if file could not be downloaded

downloadZippedFiles

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

ดาวน์โหลดไฟล์ที่ตรงกับตัวกรองที่ระบุในไฟล์ ZIP ระยะไกล

ระบบจะดาวน์โหลดไฟล์ในไฟล์ ZIP ระยะไกลไปยังเส้นทางที่ตรงกับตัวกรองรวมเท่านั้น แต่จะไม่ดาวน์โหลดไปยังเส้นทางที่ตรงกับตัวกรองยกเว้น

พารามิเตอร์
`destDir`	`File`: ไฟล์ที่จะวางเนื้อหาที่ดาวน์โหลด
`remoteFilePath`	`String`: เส้นทางระยะไกลไปยังไฟล์ที่จะดาวน์โหลด โดยสัมพันธ์กับรูทที่เจาะจงของการใช้งาน
`includeFilters`	: รายการตัวกรองเพื่อดาวน์โหลดไฟล์ที่ตรงกัน
`excludeFilters`	: รายการตัวกรองเพื่อข้ามการดาวน์โหลดไฟล์ที่ตรงกัน

การโยน
`BuildRetrievalError`	หากดาวน์โหลดไฟล์ไม่ได้
	IOException

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

ตรวจสอบความใหม่ของไฟล์ในเครื่อง หากไฟล์ในเครื่องเหมือนกับไฟล์ระยะไกล แสดงว่าไฟล์เป็นเวอร์ชันล่าสุด หากไม่เป็นเช่นนั้น แสดงว่าไฟล์ในเครื่องล้าสมัย ซึ่งใช้สำหรับแคชเป็นหลัก การใช้งานเริ่มต้นจะแสดงผลลัพธ์เป็น "จริง" เสมอ ดังนั้นหากไฟล์เป็นแบบคงที่ ก็จะไม่จําเป็นต้องตรวจสอบความใหม่

พารามิเตอร์
`localFile`	`File`: ไฟล์ในเครื่อง
`remoteFilePath`	`String`: เส้นทางไฟล์ระยะไกล

คิกรีเทิร์น
`boolean`	จริงหากไฟล์ในเครื่องเป็นไฟล์ล่าสุด หรือเป็นเท็จ

การโยน
	com.android.tradefed.build.BuildRetrievalError
`BuildRetrievalError`

releaseDownloadPermit

public void releaseDownloadPermit ()

หากรองรับขีดจำกัดการเรียกใช้พร้อมกัน ให้ปล่อยใบอนุญาตการดาวน์โหลด