SyncService

public class SyncService
extends Object

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

सिंक सेवा क्लास, डिवाइसों/इम्यूलेटर पर/से पुश/पुल करने के लिए होती है. यह काम, डीबग ब्रिज के ज़रिए किया जाता है.

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 ()

यह एक ऐसा सिंक प्रोग्रेस मॉनिटर दिखाता है जो कुछ नहीं करता. इससे बैकग्राउंड टास्क, मान्य ISyncProgressMonitor पास कर सकते हैं. हालांकि, इन टास्क को यूज़र इंटरफ़ेस (यूआई) दिखाने की ज़रूरत नहीं होती.

इस ऑब्जेक्ट का इस्तेमाल एक से ज़्यादा बार किया जा सकता है. साथ ही, इसका इस्तेमाल एक साथ कई थ्रेड कर सकती हैं.

रिटर्न
SyncService.ISyncProgressMonitor

openSync

public boolean openSync ()

सिंक कनेक्शन खोलता है. push[File] / pull[File] को कॉल करने से पहले, इसे कॉल करना ज़रूरी है.

रिटर्न
boolean कनेक्शन खुलने पर true और adb के कनेक्शन अस्वीकार करने पर false दिखाता है. ऐसा तब हो सकता है, जब IDevice अमान्य हो.
थ्रो
TimeoutException कनेक्शन टाइम आउट होने पर.
AdbCommandRejectedException अगर adb निर्देश को अस्वीकार करता है, तो
अगर adb से कनेक्ट नहीं किया जा सका.

पुल

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

यह फ़ाइलें या फ़ोल्डर खींचता है.

पैरामीटर
entries FileEntry: पुल करने के लिए रिमोट आइटम
localPath String: स्थानीय डेस्टिनेशन. अगर एंट्री की संख्या 1 से ज़्यादा है या यूनीक एंट्री कोई फ़ोल्डर है, तो यह फ़ोल्डर होना चाहिए.
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर. इसे शून्य नहीं किया जा सकता.
थ्रो
com.android.ddmlib.SyncException
IOException
com.android.ddmlib.TimeoutException
SyncException
TimeoutException

pullFile

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

एक फ़ाइल को पुल करता है.

पैरामीटर
remote FileListingService.FileEntry: रिमोट फ़ाइल
localFilename String: स्थानीय डेस्टिनेशन.
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर. इसे शून्य नहीं किया जा सकता.
थ्रो
IO से जुड़ी गड़बड़ी होने पर.
TimeoutException डिवाइस से जवाब पाने में समय लगने पर.
SyncException सिंक करने में समस्या आने पर.

pullFile

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

एक फ़ाइल को पुल करता है.

इस तरीके में, रिमोट फ़ाइल के लिए सिर्फ़ एक स्ट्रिंग का इस्तेमाल किया जाता है. इसमें FileEntry का इस्तेमाल नहीं किया जाता. इसलिए, डाउनलोड की जा रही फ़ाइल का साइज़ पता नहीं चलता. साथ ही, ISyncProgressMonitor प्रोग्रेस को सही तरीके से नहीं दिखाएगा

पैरामीटर
remoteFilepath String: रिमोट फ़ाइल का पूरा पाथ
localFilename String: स्थानीय डेस्टिनेशन.
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर. इसे शून्य नहीं किया जा सकता.
थ्रो
IO से जुड़ी गड़बड़ी होने पर.
TimeoutException डिवाइस से जवाब पाने में समय लगने पर.
SyncException सिंक करने में समस्या आने पर.

यह भी देखें:

पुश

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

कई फ़ाइलों या डायरेक्ट्री को पुश करता है.

पैरामीटर
local String: पुश करने के लिए स्थानीय फ़ाइलें
remote FileListingService.FileEntry: यह किसी डायरेक्ट्री को दिखाने वाला रिमोट FileEntry है
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर
थ्रो
SyncException अगर कुछ फ़ाइलें पुश नहीं की जा सकीं
कनेक्शन पर I/O में गड़बड़ी होने पर
TimeoutException डिवाइस से जवाब मिलने में समय लगने पर

पुश

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

कई फ़ाइलों या डायरेक्ट्री को पुश करता है.

पैरामीटर
local String: पुश करने के लिए स्थानीय फ़ाइलें
remote String: डायरेक्ट्री को दिखाने वाला रिमोट पाथ
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर
थ्रो
SyncException अगर कुछ फ़ाइलें पुश नहीं की जा सकीं
कनेक्शन पर I/O में गड़बड़ी होने पर
TimeoutException डिवाइस से जवाब मिलने में समय लगने पर

pushFile

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

किसी एक फ़ाइल को पुश करें.

पैरामीटर
local String: यह लोकल फ़ाइलपाथ होता है.
remote String: रिमोट फ़ाइलपाथ.
monitor SyncService.ISyncProgressMonitor: प्रोग्रेस मॉनिटर. इसे शून्य नहीं किया जा सकता.
थ्रो
SyncException अगर फ़ाइल को पुश नहीं किया जा सका
कनेक्शन पर I/O में गड़बड़ी होने पर.
TimeoutException डिवाइस से जवाब पाने में समय लगने पर.

statFile

public SyncService.FileStat statFile (String path)

यह फ़ंक्शन, रिमोट फ़ाइल की स्थिति के बारे में जानकारी देता है.

पैरामीटर
path String: रिमोट फ़ाइल
रिटर्न
SyncService.FileStat अगर सब कुछ ठीक रहा, तो FileStat में मोड, साइज़, और पिछली बार बदलाव करने की जानकारी शामिल होती है. अगर ऐसा नहीं होता है, तो यह जानकारी शून्य होती है
थ्रो
IOException
TimeoutException डिवाइस से जवाब पाने में समय लगने पर.