Přidání offline synchronizace dat do aplikace .NET MAUI

Článek
01/12/2024

Poznámka

Tento produkt je vyřazený. Náhradu za projekty používající .NET 8 nebo novější najdete v knihovně Community Toolkit Datasync.

Tento kurz se zabývá funkcí offline synchronizace Azure Mobile Apps pro .NET MAUI. Offline synchronizace umožňuje koncovým uživatelům pracovat s mobilní aplikací i v případě, že připojení k síti není k dispozici. Změny se ukládají v místní databázi. Jakmile je zařízení zase online, tyto změny se synchronizují se vzdáleným back-endem.

Před zahájením tohoto kurzu byste měli mít dokončený kurz .NET MAUI Rychlý start, který zahrnuje vytvoření vhodné back-endové služby.

Další informace o funkci offline synchronizace najdete v tématu Offline synchronizace dat v Azure Mobile Apps.

Aktualizace aplikace tak, aby podporovala offline synchronizaci

V online provozu budete číst a zapisovat z IRemoteTable<T>. Při použití offline synchronizace se místo toho čte a zapisuje z IOfflineTable<T>. IOfflineTable je zajištěna databází SQLite na zařízení a je synchronizovaná s back-endovou databází.

V sadě Visual Studio:

Klikněte pravým tlačítkem na řešení TodoApp a pak vyberte Spravovat balíčky NuGet pro řešení....
Na nové kartě vyberte Procházeta do vyhledávacího pole zadejte Microsoft.Datasync.Client.
Vyberte balíček Microsoft.Datasync.Client.SQLiteStore.
V pravém podokně vyberte všechny klientské projekty (s výjimkou projektu TodoAppService.NET6).
Vyberte Nainstalovat.
Po zobrazení výzvy přijměte licenční smlouvu.

Aktualizace klienta vzdálené služby

Otevřete projekt TodoApp.Data a vyhledejte třídu RemoteTodoService.cs (v adresáři Services). Aktualizujte třídu následujícím způsobem:

Na začátek souboru přidejte následující příkaz using:
```
using Microsoft.Datasync.Client.SQLiteStore;
```

Změňte definici _table na IOfflineTable<TodoItem>:

/// <summary>
/// Reference to the table used for datasync operations.
/// </summary>
private IOfflineTable<TodoItem> _table = null;

Přidejte novou vlastnost pro ukládání umístění offline databáze:

/// <summary>
/// The path to the offline database
/// </summary>
public string OfflineDb { get; set; }

Aktualizujte metodu InitializeAsync tak, aby definovala offline databázi:

// Create the offline store definition
var connectionString = new UriBuilder { Scheme = "file", Path = OfflineDb, Query = "?mode=rwc" }.Uri.ToString();
var store = new OfflineSQLiteStore(connectionString);
store.DefineTable<TodoItem>();
var options = new DatasyncClientOptions
{
    OfflineStore = store,
    HttpPipeline = new HttpMessageHandler[] { new LoggingHandler() }
};

// Create the datasync client.
_client = TokenRequestor == null 
    ? new DatasyncClient(Constants.ServiceUri, options)
    : new DatasyncClient(Constants.ServiceUri, new GenericAuthenticationProvider(TokenRequestor), options);

// Initialize the database
await _client.InitializeOfflineStoreAsync();

// Get a reference to the offline table.
_table = _client.GetOfflineTable<TodoItem>();

// Set _initialized to true to prevent duplication of locking.
_initialized = true;

Aktualizujte RefreshItemsAsync() a proveďte offline synchronizaci:

/// <summary>
/// Refreshes the TodoItems list manually.
/// </summary>
/// <returns>A task that completes when the refresh is done.</returns>
public async Task RefreshItemsAsync()
{
    await InitializeAsync();

    // First, push all the items in the table.
    await _table.PushItemsAsync();

    // Then, pull all the items in the table.
    await _table.PullItemsAsync();

    return;
}

Nastavení umístění offline databáze

V projektu TodoApp.MAUI upravte soubor MainPage.xaml.cs. Změňte definici RemoteTodoService následujícím způsobem:

TodoService = new RemoteTodoService(GetAuthenticationToken)
{
    OfflineDb = FileSystem.CacheDirectory + "/offline.db"
};

Pokud jste nedokončili kurz ověřování , měla by definice vypadat takto:

TodoService = new RemoteTodoService()
{
    OfflineDb = FileSystem.CacheDirectory + "/offline.db"
};

Otestování aplikace

Aplikace se nesynchronizuje s back-endem, dokud se nestiskne ikona aktualizace. Postup testování:

Otevřetewebu Azure Portal.
Otevřete skupinu prostředků, která obsahuje prostředky pro rychlý start.
Vyberte databázi quickstart.
Vyberteeditoru dotazů (Preview).
Přihlaste se pomocí ověřování SQL Serveru pomocí stejných přihlašovacích údajů, které jste nastavili pro databázi.
- V případě potřeby se zobrazí výzva k povolení přístupu pro vaši IP adresu. Výběrem odkazu aktualizujte seznam povolených a stisknutím OK zkuste přihlášení zopakovat.
V editoru dotazů zadejte SELECT * FROM [dbo].[TodoItems]. Pak vyberte Spustit.

Zobrazí se seznam aktuálních položek TodoItems.

snímek obrazovky s výsledky v editoru dotazů S Q L

Teď v aplikaci udělejte nějaké změny. JEŠTĚ NESTISKEJTE TLAČÍTKO AKTUALIZOVAT (dosud).

Opakujte příkaz SQL na webu Azure Portal a ověřte, že se v datech v databázi neprovedou žádné změny.

Výběrem ikony Aktualizovat v aplikaci odešlete data do fronty do back-endové služby. Transakce HTTP se zobrazí v okně Výstupní ladění.

Opakujte příkaz SQL na webu Azure Portal a ověřte, že se změny odeslaly do vzdálené služby.

Vyčištění prostředků

Pokud neděláte další rychlý úvodní kurz, můžete teď odstranit prostředky přidružené k back-endové službě.

Otevřetewebu Azure Portal.
Vyberte skupinu prostředků, ve které jsou prostředky rychlého startu.
Vyberte Odstranit skupinu prostředků.
Odstranění potvrďte podle pokynů.

Můžete také použít Azure CLI:

az group delete -g quickstart

Pokud jste k nasazení prostředků použili Azure Developer CLI, můžete místo toho použít příkaz azd down.

Odstranění bude trvat několik minut.

Další kroky

Projděte si dokumentaci POSTUPY:
- ASP. Dokumentace ke službě NET6
- klientské dokumentace k .NET

Sdílet prostřednictvím