SyncService

public class SyncService
extends Object implements AutoCloseable

java.lang.Object
   ↳ com.android.tradefed.device.server.SyncService

ซิงค์คลาสบริการเพื่อพุช/ดึงไปยัง/จากอุปกรณ์/โปรแกรมจำลองผ่าน Debug Bridge

หากต้องการรับออบเจ็กต์ SyncService ให้ใช้ IDevice.getSyncService()

สรุป

คลาสที่ซ้อนกัน

class SyncService.FileStat

 

interface SyncService.ISyncProgressMonitor

คลาสที่ใช้การติดตั้งใช้งานอินเทอร์เฟซนี้จะมีเมธอดที่จัดการกับการแสดงความคืบหน้าในการโอน 

เครื่องมือสร้างสาธารณะ

SyncService(InetSocketAddress address, IDevice device)

สร้างออบเจ็กต์บริการซิงค์

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

void close()

ปิดการเชื่อมต่อ

static SyncService.ISyncProgressMonitor getNullProgressMonitor()

แสดงผลเครื่องมือตรวจสอบความคืบหน้าในการซิงค์ที่ไม่มีการดำเนินการใดๆ

boolean openSync()

เปิดการเชื่อมต่อการซิงค์

void pull(FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)

ดึงไฟล์หรือโฟลเดอร์

void pullFile(FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)

ดึงไฟล์เดียว

void pullFile(String remoteFilepath, String localFilename, SyncService.ISyncProgressMonitor monitor)

ดึงไฟล์เดียว

void push(String[] local, FileListingService.FileEntry remote, SyncService.ISyncProgressMonitor monitor)

ส่งไฟล์หรือไดเรกทอรีหลายรายการ

void push(String[] local, String remote, SyncService.ISyncProgressMonitor monitor)

ส่งไฟล์หรือไดเรกทอรีหลายรายการ

void pushFile(String local, String remote, SyncService.ISyncProgressMonitor monitor)

พุชไฟล์เดียว

SyncService.FileStat statFile(String path)

แสดงข้อมูลสถิติของไฟล์ระยะไกล

เครื่องมือสร้างสาธารณะ

SyncService

public SyncService (InetSocketAddress address, 
                IDevice device)

สร้างออบเจ็กต์บริการซิงค์

พารามิเตอร์
address InetSocketAddress: ที่อยู่ที่จะเชื่อมต่อ
device IDevice: IDevice ที่บริการเชื่อมต่อ

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

ปิด

public void close ()

ปิดการเชื่อมต่อ

getNullProgressMonitor

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

แสดงผลเครื่องมือตรวจสอบความคืบหน้าในการซิงค์ที่ไม่มีการดำเนินการใดๆ ซึ่งจะช่วยให้งานที่ทำงานอยู่เบื้องหลังซึ่งไม่ต้องการ/ไม่จำเป็นต้องแสดง UI ส่ง ISyncProgressMonitor ที่ถูกต้องได้

โดยสามารถนำออบเจ็กต์นี้กลับมาใช้ซ้ำได้หลายครั้งและใช้ได้โดยเธรดที่ทำงานพร้อมกัน

การคืนสินค้า
SyncService.ISyncProgressMonitor

openSync

public boolean openSync ()

เปิดการเชื่อมต่อการซิงค์ ต้องเรียกใช้ฟังก์ชันนี้ก่อนที่จะเรียกใช้ฟังก์ชัน push[File] / pull[File]

การคืนสินค้า
boolean จริงหากเปิดการเชื่อมต่อ เท็จหาก adb ปฏิเสธการเชื่อมต่อ ซึ่งอาจเกิดขึ้นได้ในกรณีต่อไปนี้ IDeviceไม่ถูกต้อง
ส่ง
AdbCommandRejectedException หาก adb ปฏิเสธคำสั่ง
TimeoutException ในกรณีที่การเชื่อมต่อหมดเวลา
IOException หากเชื่อมต่อกับ adb ไม่สำเร็จ

ดึง

public void pull (FileEntry[] entries, 
                String localPath, 
                SyncService.ISyncProgressMonitor monitor)

ดึงไฟล์หรือโฟลเดอร์

พารามิเตอร์
entries FileEntry: รายการจากระยะไกลที่จะดึง
localPath String: ปลายทางในพื้นที่ หากจำนวนรายการมากกว่า 1 หรือหากรายการที่ไม่ซ้ำกันเป็นโฟลเดอร์ รายการนี้ควรเป็นโฟลเดอร์
monitor SyncService.ISyncProgressMonitor: ตัวตรวจสอบความคืบหน้า ต้องไม่เป็นค่าว่าง
ส่ง
com.android.ddmlib.SyncException
com.android.ddmlib.TimeoutException
java.io.IOException
IOException
SyncException
TimeoutException

ดูเพิ่มเติม:

pullFile

public void pullFile (FileListingService.FileEntry remote, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

ดึงไฟล์เดียว

พารามิเตอร์
remote FileListingService.FileEntry: ไฟล์ระยะไกล
localFilename String: ปลายทางในพื้นที่
monitor SyncService.ISyncProgressMonitor: ตัวตรวจสอบความคืบหน้า ต้องไม่เป็นค่าว่าง
ส่ง
SyncException ในกรณีที่เกิดข้อยกเว้นในการซิงค์
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา
IOException ในกรณีที่เกิดข้อยกเว้น IO

ดูเพิ่มเติม:

pullFile

public void pullFile (String remoteFilepath, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

ดึงไฟล์เดียว

เนื่องจากวิธีนี้จัดการเฉพาะสตริงสำหรับไฟล์ระยะไกลแทนที่จะเป็น FileEntry จึงไม่ทราบขนาดของไฟล์ที่ดึงมาและ ISyncProgressMonitor จะไม่แสดงความคืบหน้าอย่างถูกต้อง

พารามิเตอร์
remoteFilepath String: เส้นทางแบบเต็มไปยังไฟล์ระยะไกล
localFilename String: ปลายทางในพื้นที่
monitor SyncService.ISyncProgressMonitor: ตัวตรวจสอบความคืบหน้า ต้องไม่เป็นค่าว่าง
ส่ง
SyncException ในกรณีที่เกิดข้อยกเว้นในการซิงค์
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา
IOException ในกรณีที่เกิดข้อยกเว้น IO

ดูเพิ่มเติม:

พุช

public void push (String[] local, 
                FileListingService.FileEntry remote, 
                SyncService.ISyncProgressMonitor monitor)

ส่งไฟล์หรือไดเรกทอรีหลายรายการ

พารามิเตอร์
local String: ไฟล์ในเครื่องที่จะพุช
remote FileListingService.FileEntry: FileEntryระยะไกลที่แสดงถึงไดเรกทอรี
monitor SyncService.ISyncProgressMonitor: จอภาพความคืบหน้า
ส่ง
SyncException หากพุชบางไฟล์ไม่ได้
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์หมดเวลา
IOException ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

พุช

public void push (String[] local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

ส่งไฟล์หรือไดเรกทอรีหลายรายการ

พารามิเตอร์
local String: ไฟล์ในเครื่องที่จะพุช
remote String: เส้นทางระยะไกลที่แสดงถึงไดเรกทอรี
monitor SyncService.ISyncProgressMonitor: จอภาพความคืบหน้า
ส่ง
SyncException หากพุชบางไฟล์ไม่ได้
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์หมดเวลา
IOException ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ

pushFile

public void pushFile (String local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

พุชไฟล์เดียว

พารามิเตอร์
local String: เส้นทางไฟล์ในเครื่อง
remote String: เส้นทางไฟล์ระยะไกล
monitor SyncService.ISyncProgressMonitor: ตัวตรวจสอบความคืบหน้า ต้องไม่เป็นค่าว่าง
ส่ง
SyncException หากส่งไฟล์ไม่ได้
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา
IOException ในกรณีที่เกิดข้อผิดพลาดเกี่ยวกับ I/O ในการเชื่อมต่อ

statFile

public SyncService.FileStat statFile (String path)

แสดงข้อมูลสถิติของไฟล์ระยะไกล

พารามิเตอร์
path String: ไฟล์ระยะไกล
การคืนสินค้า
SyncService.FileStat an FileStat containing the mode, size and last modified info if all went well or null otherwise
ส่ง
TimeoutException ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา
java.io.IOException
IOException