为什么 ContentResolver.requestSync 不触发同步？

Question

我正在尝试实现 Content-Provider-Sync Adapter 模式，如 Google IO - 幻灯片 26。我的内容提供商正在工作，并且当我从开发工具同步测试器应用程序触发它时，我的同步可以工作，但是当我从以下位置调用 ContentResolver.requestSync(account,authority,bundle) 时我的 ContentProvider，我的同步从未被触发。

ContentResolver.requestSync(
        account, 
        AUTHORITY, 
        new Bundle());

编辑——添加清单片段 我的清单 xml 包含：

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

--编辑

与我的同步服务关联的syncadapter.xml 包含：

<?xml version="1.0" encoding="utf-8"?>
<sync-adapter xmlns:android="http://schemas.android.com/apk/res/android"  
    android:contentAuthority="AUTHORITY"
    android:accountType="myaccounttype"
    android:supportsUploading="true"
/>

不确定还有哪些其他代码有用。传递给 requestSync 的帐户属于“myaccounttype”，并且传递给调用的权限与我的 syc 适配器 xml 匹配。

ContentResolver.requestSync 是请求同步的正确方法吗？看起来同步测试工具直接绑定到服务并调用启动同步，但这似乎违背了与同步架构集成的目的。

如果这是请求同步的正确方法，那么为什么同步测试器可以工作，但我对 ContentResolver.requestSync 的调用却不能工作？我需要在捆绑包中传递一些东西吗？

我正在运行 2.1 和 2.2 的设备上的模拟器中进行测试。

Answer 1

调用 requestSync() 仅适用于系统已知的 {Account, ContentAuthority} 对。您的应用程序需要执行多个步骤来告诉 Android 您能够使用特定类型的帐户同步特定类型的内容。它在 AndroidManifest.xml 中执行此操作。

1.通知 Android 您的应用程序包提供同步

首先，在 AndroidManifest.xml 中，您必须声明您有一个同步服务：

<service android:name=".sync.mySyncService" android:exported="true">
   <intent-filter>
      <action android:name="android.content.SyncAdapter" /> 
    </intent-filter>
    <meta-data 
        android:name="android.content.SyncAdapter" 
        android:resource="@xml/sync_myapp" /> 
</service>

标记的 name 属性是用于连接同步的班级名称...我稍后会谈到这个问题。

设置导出为 true 使其对其他组件可见（需要 ContentResolver 可以调用它）。

意图过滤器可以捕获请求同步的意图。 （当您调用 ContentResolver.requestSync() 或相关调度方法时，此 Intent 来自 ContentResolver。）

; 标签将在下面讨论。

2.为 Android 提供一个用于查找您的 SyncAdapter 的服务，

因此该类本身...下面是一个示例：

public class mySyncService extends Service {

    private static mySyncAdapter mSyncAdapter = null;

    public SyncService() {
        super();
    }

    @Override
    public void onCreate() {
        super.onCreate();
        if (mSyncAdapter == null) {
            mSyncAdapter = new mySyncAdapter(getApplicationContext(), true);
        }
    }

    @Override
    public IBinder onBind(Intent arg0) {
        return mSyncAdapter.getSyncAdapterBinder();
    }
}

您的类必须扩展 Service 或其子类之一，必须实现 public IBinder onBind （意图），并且在调用时必须返回 SyncAdapterBinder...您需要一个 AbstractThreadedSyncAdapter 类型的变量。正如您所看到的，这几乎就是该课程中的所有内容。它存在的唯一原因是提供一个服务，该服务为 Android 提供一个标准接口来查询您的类，了解您的 SyncAdapter 本身是什么。

3.提供一个类SyncAdapter来实际执行同步。

mySyncAdapter是真正的同步逻辑本身的存储位置。当需要同步时，它的 onPerformSync() 方法会被调用。我想你已经准备好了。

4.在帐户类型和内容权限之间建立绑定

再次回顾 AndroidManifest，我们服务中那个奇怪的 标记是在帐户类型和内容权限之间建立绑定的关键部分一个 ContentAuthority 和一个帐户。它从外部引用了另一个 xml 文件（您可以随意称呼它，与您的应用程序相关）。让我们看一下sync_myapp.xml：

<?xml version="1.0" encoding="utf-8" ?> 
<sync-adapter 
    xmlns:android="http://schemas.android.com/apk/res/android"   
    android:contentAuthority="com.android.contacts"
    android:accountType="com.google" 
    android:userVisible="true" /> 

好的，那么它有什么作用呢？它告诉 Android 我们已经定义了同步适配器（在 标记的 name 元素中调用的类，其中包含 引用此文件的标签...）将使用 com.google 风格的帐户同步联系人。

您的所有 contentAuthority 字符串必须全部匹配，并与您正在同步的内容匹配 - 如果您正在创建自己的数据库，这应该是您定义的字符串，或者如果您正在同步已知的内容，则应该使用一些现有的设备字符串数据类型（如联系人或日历事件或您拥有的其他内容）。上面的（“com.android.contacts”）恰好是联系人类型数据的 ContentAuthority 字符串（惊喜，惊喜。）

accountType 也必须与已知的其中之一匹配已输入的帐户类型，或者它必须与您正在创建的帐户类型相匹配（这涉及创建 AccountAuthenticator 的子类以在您的服务器上获得身份验证...本身就值得一篇文章。）同样，“com.google”是定义的字符串标识... google.com 风格的帐户凭据（同样，这不应该是一个惊喜。）

5。在给定的帐户/ContentAuthority 对上启用同步

最后，必须启用同步。您可以在“帐户和帐户”中执行此操作。通过转到您的应用程序并在匹配帐户中设置应用程序旁边的复选框来同步控制面板中的页面。或者，您可以在应用程序中的某些设置代码中执行此操作：

ContentResolver.setSyncAutomatically(account, AUTHORITY, true);

要进行同步，您的帐户/权限对必须启用同步（如上所述）并且系统上的整体全局同步标志必须设置后，且设备必须具有网络连接。

如果您的帐户/权限同步或全局同步被禁用，则调用 RequestSync() 确实会产生影响 - 它设置一个已请求同步的标志，并且在启用同步后立即执行。

另外，根据 mgv，在 requestSync 的额外包中将 ContentResolver.SYNC_EXTRAS_MANUAL 设置为 true 会询问 android即使全局同步关闭也可以强制同步（在这里尊重您的用户！）

最后，您可以再次使用 ContentResolver 函数设置定期计划同步。

6.考虑多个帐户的影响

可以拥有多个相同类型的帐户（在一台设备上设置两个 @gmail.com 帐户或两个 Facebook 帐户或两个 Twitter 帐户等...）应该考虑这样做的应用程序影响...如果您有两个帐户，您可能不想尝试将它们同步到相同的数据库表中。也许您需要指定一次只能有一个处于活动状态，并在切换帐户时刷新表并重新同步。 （通过查询存在哪些帐户的属性页）。也许您为每个帐户创建不同的数据库，也许不同的表，也许每个表中的关键列。所有的应用都是特定的，值得思考。 ContentResolver.setIsSyncable(Account account, Stringauthority, intsyncable) 这里可能会感兴趣。 setSyncAutomatically() 控制帐户/权限对是选中还是未选中，而 setIsSyncable() 提供了一种方法取消选中并使该行变灰，以便用户无法打开它。您可以将一个帐户设置为可同步，而将另一个帐户设置为不可同步 (dsabled)。

7.请注意 ContentResolver.notifyChange()

一件棘手的事情。 ContentResolver.notifyChange() 是 ContentProvider 用来通知 Android 本地数据库已更改的函数。这有两个功能，首先，它会导致内容 uri 后面的游标更新，然后重新查询、无效和重绘 ListView 等...这非常神奇，数据库发生变化，您的 < code>ListView 只是自动更新。惊人的。此外，当数据库发生更改时，Android 会为您请求同步（即使超出您的正常计划），以便这些更改能够从设备上尽快同步到服务器。也很棒。

但有一种极端情况。如果您从服务器拉取更新，并将更新推送到 ContentProvider 中，它会尽职尽责地调用 notifyChange() 并且 android 会说，“哦，数据库更改，最好将它们放入在服务器上！” （哦！）编写良好的 ContentProviders 将进行一些测试，以查看更改是否来自网络或用户，如果是，则将布尔 syncToNetwork 标志设置为 false ，以防止这种浪费的双同步。如果您要将数据输入 ContentProvider，那么您有必要弄清楚如何使其正常工作 - 否则，当只需要一次同步时，您最终将始终执行两次同步。

8.高兴吧！

一旦您准备好所有这些 xml 元数据并启用同步，Android 将知道如何为您连接所有内容，并且同步应该开始工作。此时，很多美好的事情就会水到渠成，感觉就像魔术一样。享受！

Answer 2

我在 AccountManager setAuthToken 方法之后调用 setIsSyncable 。但在到达 setIsSyncable 之前，setAuthToken 返回了函数。订单更改后一切正常！

Answer 3

我注意到当有互联网连接时 requestSync 将触发 sync 实现