本頁面由 Cloud Translation API 翻譯而成。

建立虛設常式內容供應程式

同步轉換介面架構旨在處理由彈性及高度安全的內容供應器架構因此，同步處理轉換介面架構會預期使用該架構的應用程式已針對本機資料定義內容供應器。如果同步轉換介面架構嘗試執行同步轉接程式，而您的應用程式沒有內容供應器，您的同步轉換介面當機。

如果您正在開發新的應用程式，以便將資料從伺服器轉移到裝置，建議您強烈建議將本機資料儲存在內容供應器中。除了對同步轉換介面、內容供應器提供各式各樣的安全性優勢，尤其專為處理 Android 系統上的資料儲存而設計。進一步瞭解如何建立內容請參閱建立內容供應器一文。

不過，如果您已以其他形式儲存本機資料，仍然可以使用同步處理功能處理資料移轉的轉接器。符合請將虛設常式內容供應器新增至應用程式。虛設常式供應商會內容供應器類別，但所有的必要方法都會傳回 null 或 0。如果發生以下情況：新增虛設常式供應商，即可使用同步轉換介面轉移任何儲存空間中的資料您選擇的機制

如果應用程式已有內容供應器，則不需要虛設常式內容供應器。這時，您可以略過本課程，直接繼續完成本課程。建立同步處理配接器。如果你還沒有這個單元將說明如何新增虛設常式內容供應器將同步轉換介面插入架構

新增虛設常式內容供應器

如要為應用程式建立虛設常式內容供應器，請擴充類別 ContentProvider 並找到其必要方法。下列下列程式碼片段說明如何建立虛設常式提供者：

Kotlin

/*
 * Define an implementation of ContentProvider that stubs out
 * all methods
 */
class StubProvider : ContentProvider() {
    /*
     * Always return true, indicating that the
     * provider loaded correctly.
     */
    override fun onCreate(): Boolean  = true

    /*
     * Return no type for MIME type
     */
    override fun getType(uri: Uri): String?  = null

    /*
     * query() always returns no results
     *
     */
    override fun query(
            uri: Uri,
            projection: Array<String>,
            selection: String,
            selectionArgs: Array<String>,
            sortOrder: String
    ): Cursor?  = null

    /*
     * insert() always returns null (no URI)
     */
    override fun insert(uri: Uri, values: ContentValues): Uri? = null

    /*
     * delete() always returns "no rows affected" (0)
     */
    override fun delete(uri: Uri, selection: String, selectionArgs: Array<String>): Int = 0

    /*
     * update() always returns "no rows affected" (0)
     */
    override fun update(
            uri: Uri,
            values: ContentValues,
            selection: String,
            selectionArgs: Array<String>
    ): Int = 0
}

Java

/*
 * Define an implementation of ContentProvider that stubs out
 * all methods
 */
public class StubProvider extends ContentProvider {
    /*
     * Always return true, indicating that the
     * provider loaded correctly.
     */
    @Override
    public boolean onCreate() {
        return true;
    }
    /*
     * Return no type for MIME type
     */
    @Override
    public String getType(Uri uri) {
        return null;
    }
    /*
     * query() always returns no results
     *
     */
    @Override
    public Cursor query(
            Uri uri,
            String[] projection,
            String selection,
            String[] selectionArgs,
            String sortOrder) {
        return null;
    }
    /*
     * insert() always returns null (no URI)
     */
    @Override
    public Uri insert(Uri uri, ContentValues values) {
        return null;
    }
    /*
     * delete() always returns "no rows affected" (0)
     */
    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        return 0;
    }
    /*
     * update() always returns "no rows affected" (0)
     */
    public int update(
            Uri uri,
            ContentValues values,
            String selection,
            String[] selectionArgs) {
        return 0;
    }
}

在資訊清單中宣告提供者

同步處理轉換介面架構會檢查您的應用程式應用程式已在應用程式資訊清單中宣告供應器。如要在資訊清單，請新增含有下列屬性的 <provider> 元素：

android:name="com.example.android.datasync.provider.StubProvider": 指定實作虛設常式內容供應器的類別完整名稱。
android:authorities="com.example.android.datasync.provider": 可識別虛設常式內容供應器的 URI 授權。將此值設為您應用程式的含有「.provider」字串的套件名稱。即使您宣告虛設常式供應商傳送至系統，並未嘗試存取供應器本身。
android:exported="false": 決定其他應用程式是否能存取內容供應器。適合存根內容提供者，請將值設為 false，因為您不需要允許其他應用程式查看。。這個值不會影響同步轉換介面架構之間的互動和內容供應者
android:syncable="true": 設定標記，以指出供應商可以同步。如果您將這個標記設為 true，您不必在程式碼中呼叫 setIsSyncable()。這個標記可讓同步轉換介面架構建立資料傳輸作業，但只有在您明確執行時才會轉移。

下列程式碼片段說明如何新增應用程式資訊清單中的 <provider> 元素：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.android.network.sync.BasicSyncAdapter"
    android:versionCode="1"
    android:versionName="1.0" >
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
    ...
    <provider
        android:name="com.example.android.datasync.provider.StubProvider"
        android:authorities="com.example.android.datasync.provider"
        android:exported="false"
        android:syncable="true"/>
    ...
    </application>
</manifest>

現在，您已建立同步轉換介面架構所需的依附元件，您可以然後建立封裝資料移轉程式碼的元件。這個元件稱為同步處理轉換介面下一堂課將說明如何將此元件新增至應用程式。