Přidání offline synchronizace dat do aplikace Xamarin.Forms
Tento kurz se zabývá funkcí offline synchronizace Azure Mobile Apps pro Xamarin Forms. Offline synchronizace umožňuje koncovým uživatelům pracovat s mobilní aplikací – prohlížením, přidáváním nebo úpravou dat – i když není k dispozici žádné síťové připojení. 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 dokončit kurz rychlého startu pro Xamarin.Forms, 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 operaci, číst do a zapisovat z .IRemoteTable<T>
Při použití offline synchronizace se místo toho čte a zapisuje z něj IOfflineTable<T>
. Tato IOfflineTable
databáze je podporována databází SQLite na zařízení a synchronizuje se s back-endovou databází.
V sadě Visual Studio:
Klikněte pravým tlačítkem na
TodoApp
řešení a pak vyberte Spravovat balíčky NuGet pro řešení....Na nové kartě vyberte Procházet a do vyhledávacího pole zadejte Microsoft.Datasync.Client .
Microsoft.Datasync.Client.SQLiteStore
Vyberte balíček.V pravém podokně vyberte všechny klientské projekty (s výjimkou
TodoAppService.NET6
projektu).Vyberte volbu Instalovat.
Po zobrazení výzvy přijměte licenční smlouvu.
Aktualizace klienta vzdálené služby
TodoApp.Data
Otevřete projekt a vyhledejte RemoteTodoService.cs
třídu (v adresářiServices
). Aktualizujte třídu následujícím způsobem:
Na začátek souboru přidejte následující
using
příkaz: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;
RefreshItemsAsync()
Aktualizujte synchronizaci offline:/// <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
TodoApp.Forms
V projektu upravte App.xaml.cs
soubor. Změňte definici následujícím RemoteTodoService
způsobem:
TodoService = new RemoteTodoService(async () => await GetAuthenticationToken())
{
OfflineDb = Xamarin.Essentials.FileSystem.AppDataDirectory + "/offline.db"
};
Pokud jste kurz ověřování nedokončili, měla by definice vypadat takto:
TodoService = new RemoteTodoService()
{
OfflineDb = Xamarin.Essentials.FileSystem.AppDataDirectory + "/offline.db"
};
Otestování aplikace
Aplikace se nesynchronizuje s back-endem, dokud se nestiskne ikona aktualizace. Postup testování:
Otevřete Azure Portal.
Otevřete skupinu prostředků, která obsahuje prostředky pro rychlý start.
quickstart
Vyberte databázi.Vyberte editor 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 klávesy 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.
Teď v aplikaci udělejte nějaké změny. 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řete 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 azd down
příkaz.
Odstranění bude trvat několik minut.
Další kroky
- Projděte si dokumentaci POSTUPY:
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro