AbstractThreadedSyncAdapter 類別

定義

[Android.Runtime.Register("android/content/AbstractThreadedSyncAdapter", DoNotGenerateAcw=true)]
public abstract class AbstractThreadedSyncAdapter : Java.Lang.Object

[<Android.Runtime.Register("android/content/AbstractThreadedSyncAdapter", DoNotGenerateAcw=true)>]
type AbstractThreadedSyncAdapter = class
    inherit Object

繼承

Object

Object

AbstractThreadedSyncAdapter

屬性

RegisterAttribute

備註

SyncAdapter 的抽象實作，會繁衍線程以叫用同步作業。 如果同步處理作業在收到同步要求時已在進行中，則會將錯誤傳回至新的要求，並允許現有的要求繼續。 不過，如果進行中沒有同步處理，則會繁衍線程，並在 #onPerformSync 該線程上叫用。

架構可以隨時取消同步處理。 例如，未由使用者起始且持續超過30分鐘的同步處理會被視為逾時並取消。 同樣地，架構也會嘗試透過監視其網路活動一分鐘的時間，來判斷配接器是否正在進行中。 如果此視窗上的網路流量接近零，將會取消同步處理。 您也可以透過 ContentResolver#cancelSync(Account, String) 或 ContentResolver#cancelSync(SyncRequest)要求取消同步處理。

同步處理會藉由在同步線程上發出 Thread#interrupt() 來取消。 <強>中的程式代碼#onPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult)必須檢查 Thread#interrupted()，或者您必須覆寫 /strong> 的#onSyncCanceled()#onSyncCanceled(Thread)/<其中一個 （視您的配接器是否支援平行同步處理多個帳戶而定）。 如果您的配接器未遵守架構所發出的取消，您就會面臨應用程式整個進程遭到終止的風險。

若要成為同步配接器，必須擴充這個類別，請提供抽象方法的android.app.Service#onBind(android.content.Intent)實作，並撰寫服務，以使用動作android.content.SyncAdapter叫用時，傳回服務的結果#getSyncAdapterBinder()。 此服務必須在其AndroidManifest.xml檔案中指定下列意圖篩選和元數據標記

<intent-filter>
                <action android:name="android.content.SyncAdapter" />
              </intent-filter>
              <meta-data android:name="android.content.SyncAdapter"
                        android:resource="@xml/syncadapter" />

屬性 android:resource 必須指向看起來如下的資源：

<sync-adapter xmlns:android="http://schemas.android.com/apk/res/android"
               android:contentAuthority="authority"
               android:accountType="accountType"
               android:userVisible="true|false"
               android:supportsUploading="true|false"
               android:allowParallelSyncs="true|false"
               android:isAlwaysSyncable="true|false"
               android:syncAdapterSettingsAction="ACTION_OF_SETTINGS_ACTIVITY"
            />

<ul><li>和 android:contentAuthority android:accountType 屬性會指出此同步配接器提供的內容授權單位和帳戶類型。 <li>android:userVisible 預設為 true，並控制此同步配接器是否顯示在 [同步設定] 畫面中。 <li>android:supportsUploading 預設為 true，如果為 true，每當該授權單位的內容提供者對 ContentResolver#notifyChange(android.net.Uri, android.database.ContentObserver, boolean) syncToNetwork 設定為 true 時，所有與授權單位相關聯的 syncadapter 都會要求僅上傳同步處理。 <li>android:allowParallelSyncs 預設為 false，如果為 true，表示同步配接器可以同時處理多個帳戶的同步處理。 否則 SyncManager 會等到同步配接器未使用，再要求同步處理帳戶的數據。 <li>android:isAlwaysSyncable 預設為 false，如果 true 會告訴 SyncManager 針對每個新增的帳戶，將 isSyncable 狀態初始化為 1。 <li>android:syncAdapterSettingsAction 預設為 null，如果提供，則會指定可用來調整同步適配卡同步設定之活動的意圖動作。 活動必須存在於與同步配接器相同的套件中。 </ul>

的 android.content.AbstractThreadedSyncAdapterJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

欄位

屬性

方法

明確介面實作

擴充方法

適用於