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

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

IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

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

CdmaDeviceFlasher, FastbootDeviceFlasher, OtaUpdateDeviceFlasher, SystemUpdaterDeviceFlasher

CdmaDeviceFlasher	คลาสที่แสดงรูปภาพในอุปกรณ์ Android จริงที่มีวิทยุ CDMA
FastbootDeviceFlasher	คลาสที่ใช้ Fastboot เพื่อแฟลชรูปภาพในฮาร์ดแวร์ Android จริง
OtaUpdateDeviceFlasher	โปรแกรมแฟลชอุปกรณ์ที่เรียกใช้สคริปต์ system/update_engine/scripts/update_device.py พร้อมแพ็กเกจ OTA แบบเต็ม หรือแบบเพิ่มเพื่ออัปเดตอิมเมจอุปกรณ์
SystemUpdaterDeviceFlasher	`IDeviceFlasher` ที่ใช้โปรแกรมอัปเดตระบบเพื่อติดตั้งอิมเมจระบบที่รวมอยู่ในแพ็กเกจการอัปเดต OTA

แฟลชอิมเมจของอุปกรณ์ในอุปกรณ์

สรุป

เมธอดสาธารณะ
`abstract void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` แฟลชจะสร้างขึ้นในอุปกรณ์
`default`	`getAdditionalFileFilters()` รับตัวกรองสำหรับอาร์ติแฟกต์การสร้างเพิ่มเติม
`abstract CommandStatus`	`getSystemFlashingStatus()` ดึงข้อมูลสถานะการเรียกใช้คำสั่งสำหรับการแฟลชพาร์ติชันระบบหลัก
`abstract IDeviceFlasher.UserDataFlashOption`	`getUserDataFlashOption()` รับว่าควรแฟลช ล้าง หรือเก็บรักษาอิมเมจข้อมูลผู้ใช้หรือไม่
`abstract void`	`overrideDeviceOptions(ITestDevice device)` ลบล้างตัวเลือกสำหรับอุปกรณ์
`default void`	`postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)` การดำเนินการและตรวจสอบการล้างข้อมูลทั้งหมดที่ต้องเกิดขึ้นหลังจากแฟลชส่วนที่สำคัญจริง
`default void`	`preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)` การดำเนินการและการตรวจสอบการตั้งค่าทั้งหมดที่ต้องเกิดขึ้นก่อนการแฟลชส่วนที่สำคัญจริง
`abstract void`	`setDataWipeSkipList( dataWipeSkipList)` ตั้งค่ารายการเส้นทางใน `/data` เพื่อหลีกเลี่ยงการล้างเมื่อใช้ `ITestsZipInstaller` โปรดทราบว่าระดับความละเอียดของรายการข้ามคือรายการย่อยโดยตรงของ `/data`
`default void`	`setExtraMetadata( metadata)` อนุญาตให้โปรแกรมแฟลชรับตัวเลือกข้อมูลเมตาเพิ่มเติม
`abstract void`	`setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)` กำหนดกลไกที่โปรแกรมแฟลชใช้เพื่อดึงไฟล์ทรัพยากรสำหรับการแฟลช
`abstract void`	`setForceSystemFlash(boolean forceSystemFlash)` กำหนดว่าควรแฟลชระบบเสมอหรือไม่ แม้ว่าจะใช้บิลด์ปัจจุบันอยู่ก็ตาม
`default void`	`setRamdiskPartition(String ramdiskPartition)` ตั้งค่าพาร์ติชัน Ramdisk
`default void`	`setShouldFlashRamdisk(boolean shouldFlashRamdisk)` กำหนดว่าจะแฟลช ramdisk เพิ่มเติมหลังจากอัปเดตอุปกรณ์ผ่านไฟล์ ZIP ของอิมเมจหรือไม่
`abstract void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` สลับว่าจะแฟลช ล้าง หรือเก็บรักษาอิมเมจข้อมูลผู้ใช้
`abstract void`	`setWipeTimeout(long timeout)` ตั้งค่าการหมดเวลาสำหรับการล้างข้อมูล
`default boolean`	`shouldFlashRamdisk()` ตรวจสอบว่าตั้งค่าโปรแกรมแฟลชให้มี ramdisk เพิ่มเติมที่ควรแฟลชหลังจากอัปเดต อุปกรณ์ผ่านไฟล์ ZIP ของอิมเมจหรือไม่
`default boolean`	`supportsFlashingInFastbootD()` อุปกรณ์ที่ใช้โปรแกรมแฟลชสามารถแฟลชในโหมด fastbootd ได้หรือไม่
`default void`	`tearDownFlasher()` โอกาสสุดท้ายที่การติดตั้งโปรแกรมแฟลชจะล้างข้อมูลของตัวเอง

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

Flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

แฟลชจะสร้างขึ้นในอุปกรณ์

กลับมาทันทีหลังจากแฟลชเสร็จสมบูรณ์ ผู้โทรควรรอให้อุปกรณ์ ออนไลน์และพร้อมใช้งานก่อนดำเนินการทดสอบ

พารามิเตอร์
`device`	`ITestDevice`: `ITestDevice` เพื่อแฟลช
`deviceBuild`	`IDeviceBuildInfo`: `IDeviceBuildInfo` เพื่อแฟลช

การขว้าง
`TargetSetupError`	หากแฟลชบิลด์ไม่สำเร็จ
`DeviceNotAvailableException`	หากอุปกรณ์ไม่ตอบสนอง

getAdditionalFileFilters

public  getAdditionalFileFilters ()

รับตัวกรองสำหรับอาร์ติแฟกต์การสร้างเพิ่มเติม

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

โปรดทราบว่าเมธอดนี้จะเรียกใช้ในอินสแตนซ์ชั่วคราวของ IDeviceFlasher ดังนั้นจึงไม่ควรใช้สถานะอื่นนอกเหนือจากที่ระบุไว้ในตัวสร้างเริ่มต้น

ระบบจะตีความสตริงในชุดเป็นรูปแบบไฟล์ และจะดึงไฟล์ทั้งหมดที่ตรงกับรูปแบบ

โดยค่าเริ่มต้น เมธอดนี้จะแสดงผลเป็น Set ว่าง

คิกรีเทิร์น

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

ดึงข้อมูลสถานะการเรียกใช้คำสั่งสำหรับการแฟลชพาร์ติชันระบบหลัก

โปรดทราบว่าหากไม่ได้แฟลชพาร์ติชันของระบบ (ระบบมีบิลด์ที่จะแฟลชอยู่แล้ว) สถานะคำสั่งอาจเป็น null

คิกรีเทิร์น
`CommandStatus`

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

รับว่าควรแฟลช ล้าง หรือเก็บรักษาอิมเมจข้อมูลผู้ใช้หรือไม่

คิกรีเทิร์น
`IDeviceFlasher.UserDataFlashOption`	ควรแฟลช ล้าง หรือเก็บรักษาอิมเมจข้อมูลผู้ใช้หรือไม่

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

ลบล้างตัวเลือกสำหรับอุปกรณ์ ใช้เพื่อลบล้างค่าตัวเลือกเริ่มต้นหากอุปกรณ์บางเครื่องไม่รองรับค่าเริ่มต้น

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

การดำเนินการและตรวจสอบการล้างข้อมูลทั้งหมดที่ต้องเกิดขึ้นหลังจากแฟลชส่วนที่สำคัญจริง การดำเนินการเหล่านั้นจะไม่อยู่ในส่วนที่สำคัญซึ่งควบคุมการทำงานพร้อมกัน

พารามิเตอร์
`device`	`ITestDevice`: `ITestDevice` เพื่อแฟลช
`deviceBuild`	`IDeviceBuildInfo`: `IDeviceBuildInfo` เพื่อแฟลช

การขว้าง
`TargetSetupError`	หากการตั้งค่าไม่สำเร็จ
`DeviceNotAvailableException`	หากอุปกรณ์ไม่ตอบสนอง

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

การดำเนินการและการตรวจสอบการตั้งค่าทั้งหมดที่ต้องเกิดขึ้นก่อนการแฟลชส่วนที่สำคัญจริง การดำเนินการเหล่านั้นจะไม่อยู่ในส่วนที่สำคัญซึ่งควบคุมการทำงานพร้อมกัน

พารามิเตอร์
`device`	`ITestDevice`: `ITestDevice` เพื่อแฟลช
`deviceBuild`	`IDeviceBuildInfo`: `IDeviceBuildInfo` เพื่อแฟลช

การขว้าง
`TargetSetupError`	หากการตั้งค่าไม่สำเร็จ
`DeviceNotAvailableException`	หากอุปกรณ์ไม่ตอบสนอง

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

ตั้งค่ารายการเส้นทางใน /data เพื่อหลีกเลี่ยงการล้างเมื่อใช้ ITestsZipInstaller

โปรดทราบว่าระดับความละเอียดของรายการข้ามคือรายการย่อยโดยตรงของ /data

พารามิเตอร์
`dataWipeSkipList`

setExtraMetadata

public void setExtraMetadata ( metadata)

อนุญาตให้โปรแกรมแฟลชรับตัวเลือกข้อมูลเมตาเพิ่มเติม

พารามิเตอร์
`metadata`

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

กำหนดกลไกที่โปรแกรมแฟลชใช้เพื่อดึงไฟล์ทรัพยากรสำหรับการแฟลช

พารามิเตอร์
`retriever`	`IFlashingResourcesRetriever`: `IFlashingResourcesRetriever` ที่จะใช้

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

กำหนดว่าควรแฟลชระบบเสมอหรือไม่ แม้ว่าจะใช้บิลด์ปัจจุบันอยู่ก็ตาม

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

ตั้งค่าพาร์ติชัน Ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

กำหนดว่าจะแฟลช ramdisk เพิ่มเติมหลังจากอัปเดตอุปกรณ์ผ่านไฟล์ ZIP ของอิมเมจหรือไม่

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

สลับว่าจะแฟลช ล้าง หรือเก็บรักษาอิมเมจข้อมูลผู้ใช้

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

ตั้งค่าการหมดเวลาสำหรับการล้างข้อมูล

พารามิเตอร์
`timeout`	`long`

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

ตรวจสอบว่าตั้งค่าโปรแกรมแฟลชให้มี ramdisk เพิ่มเติมที่ควรแฟลชหลังจากอัปเดต อุปกรณ์ผ่านไฟล์ ZIP ของอิมเมจหรือไม่

คิกรีเทิร์น
`boolean`

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

อุปกรณ์ที่ใช้โปรแกรมแฟลชสามารถแฟลชในโหมด fastbootd ได้หรือไม่

คิกรีเทิร์น
`boolean`

tearDownFlasher

public void tearDownFlasher ()

โอกาสสุดท้ายที่การติดตั้งโปรแกรมแฟลชจะล้างข้อมูลของตัวเอง