通过

为 Android 移动应用启用脱机同步

  • 项目

概述

本教程介绍适用于 Android 的 Azure 移动应用的脱机同步功能。 脱机同步允许最终用户与移动应用交互（查看、添加或修改数据），即使在没有网络连接时也是如此。 更改存储在本地数据库中。 设备重新联机后，这些更改会与远程后端同步。

对于首次体验 Azure 移动应用的读者，请先完成创建 Android 应用教程。 如果不使用下载的快速入门服务器项目，必须将数据访问扩展包添加到项目。 有关服务器扩展包的详细信息，请参阅使用适用于 Azure 移动应用的 .NET 后端服务器 SDK。

若要了解有关脱机同步功能的详细信息，请参阅主题 Azure 移动应用中的脱机数据同步。

更新应用以支持脱机同步

借助脱机同步，可从同步表读取和写入（使用 IMobileServiceSyncTable 接口），该表是设备上 SQLite 数据库的一部分。

若要在设备与 Azure 移动服务之间推送和拉取更改，可以使用同步上下文 (MobileServiceClient.SyncContext)，该上下文借助本地存储数据时所用的本地数据库进行初始化。

  1. 在 TodoActivity.java 中，注释掉 mToDoTable 的现有定义，取消注释同步表版本：

     private MobileServiceSyncTable<ToDoItem> mToDoTable;

  2. 在 onCreate 方法中，注释掉 mToDoTable 的现有初始化，取消注释以下定义：

     mToDoTable = mClient.getSyncTable("ToDoItem", ToDoItem.class);

  3. 在 refreshItemsFromTable 中，注释掉 results 的定义，取消注释以下定义：

     // Offline Sync
 final List<ToDoItem> results = refreshItemsFromMobileServiceTableSyncTable();

  4. 注释掉 refreshItemsFromMobileServiceTable 的定义。

  5. 取消注释 refreshItemsFromMobileServiceTableSyncTable 的定义：

     private List<ToDoItem> refreshItemsFromMobileServiceTableSyncTable() throws ExecutionException, InterruptedException {
     //sync the data
     sync().get();
     Query query = QueryOperations.field("complete").
             eq(val(false));
     return mToDoTable.read(query).get();
 }

  6. 取消注释 sync 的定义：

     private AsyncTask<Void, Void, Void> sync() {
     AsyncTask<Void, Void, Void> task = new AsyncTask<Void, Void, Void>(){
         @Override
         protected Void doInBackground(Void... params) {
             try {
                 MobileServiceSyncContext syncContext = mClient.getSyncContext();
                 syncContext.push().get();
                 mToDoTable.pull(null).get();
             } catch (final Exception e) {
                 createAndShowDialogFromTask(e, "Error");
             }
             return null;
         }
     };
     return runAsyncTask(task);
 }

测试应用程序

在此部分中，会在启用 WiFi 的情况下测试行为，然后关闭 WiFi 以创建脱机方案。

添加数据项时，它们保存在本地 SQLite 存储中，但直到按下“刷新”按钮才同步到移动服务。 根据数据需要同步的时间，其他应用可能具有不同的要求，但出于演示目的，本教程让用户显式请求它。

按下该按钮时，将启动新的后台任务。 首先它会使用同步上下文推送对本地存储所做的所有更改，然后将所有更改数据从 Azure 拉取到本地表。

脱机测试

  1. 将设备或模拟器置于飞行模式中。 这会创建脱机方案。

  2. 添加一些 ToDo 项或将一些项标记为“完成”。 退出设备或模拟器（或强制关闭应用），并重新启动。 验证所做更改是否保存在设备上，因为本地 SQLite 存储已保存这些更改。

  3. 使用 SQL 工具（如 SQL Server Management Studio）或 REST 客户端（如 Fiddler 或 Postman）查看 Azure TodoItem 表的内容。 验证新项是否未同步到服务器

    + For a Node.js backend, go to the [Azure portal](https://portal.azure.com/), and in your Mobile App backend click **Easy Tables** > **TodoItem** to view the contents of the `TodoItem` table.
+ For a .NET backend, view the table contents either with a SQL tool such as *SQL Server Management Studio*, or a REST client such as *Fiddler* or *Postman*.

  4. 在设备或模拟器中打开 WiFi。 接下来，按“刷新”按钮。

  5. 在 Azure 门户中再次查看 TodoItem 数据。 新的和更改的 TodoItem 现在应会出现。

其他资源