Windows 앱에 대해 오프라인 동기화 사용

개요

이 자습서에서는 Azure Mobile App 백 엔드를 사용하여 UWP(유니버설 Windows 플랫폼) 앱에 오프라인 지원을 추가하는 방법을 보여 줍니다. 오프라인 동기화를 사용하면 최종 사용자가 네트워크 연결이 없는 경우에도 데이터를 보거나 추가하거나 수정하는 모바일 앱과 상호 작용할 수 있습니다. 변경 내용은 로컬 데이터베이스에 저장됩니다. 디바이스가 다시 온라인 상태가 되면 이러한 변경 내용이 원격 백 엔드와 동기화됩니다.

이 자습서에서는 Azure Mobile Apps의 오프라인 기능을 지원하기 위해 Windows 앱 만들기 자습서에서 UWP 앱 프로젝트를 업데이트합니다. 다운로드한 빠른 시작 서버 프로젝트를 사용하지 않는 경우 프로젝트에 데이터 액세스 확장 패키지를 추가해야 합니다. 서버 확장 패키지에 대한 자세한 내용은 Azure Mobile Apps용 .NET 백 엔드 서버 SDK작업을 참조하세요.

오프라인 동기화 기능에 대한 자세한 내용은 Azure Mobile Apps 오프라인 데이터 동기화항목을 참조하세요.

요구 사항

이 자습서에는 다음과 같은 필수 구성 요소가 필요합니다.

Windows 8.1 이상에서 실행되는 Visual Studio 2013.
Windows 앱 만들기 완료.
Azure Mobile Services SQLite 스토어
유니버설 Windows 플랫폼 개발용 SQLite

오프라인 기능을 지원하도록 클라이언트 앱 업데이트

Azure Mobile App 오프라인 기능을 사용하면 오프라인 시나리오에서 로컬 데이터베이스와 상호 작용할 수 있습니다. 앱에서 이러한 기능을 사용하려면, SyncContext을 로컬 저장소에 초기화해야 합니다. 그런 다음 IMobileServiceSyncTable 인터페이스를 통해 테이블을 참조합니다. SQLite는 디바이스의 로컬 저장소로 사용됩니다.

유니버설 Windows 플랫폼 대한SQLite 런타임을 설치합니다.
Visual Studio에서 Windows 앱 만들기 자습서에서 완료한 UWP 앱 프로젝트에 대한 NuGet 패키지 관리자를 엽니다. Microsoft.Azure.Mobile.Client.SQLiteStore NuGet 패키지를 검색하고 설치합니다.
솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭하고>참조 추가...>유니버설 Windows>확장을 선택합니다. 그런 다음, 유니버설 Windows 플랫폼 SQLite와 유니버설 Windows 플랫폼 앱 Visual C++ 2015 런타임을 모두 사용하도록 설정합니다.

추가
MainPage.xaml.cs 파일을 열고 #define OFFLINE_SYNC_ENABLED 정의의 주석 처리를 제거합니다.
Visual Studio에서 F5 키를 눌러 클라이언트 앱을 다시 빌드하고 실행합니다. 앱은 오프라인 동기화를 사용하도록 설정하기 전과 동일하게 작동합니다. 그러나 로컬 데이터베이스는 이제 오프라인 시나리오에서 사용할 수 있는 데이터로 채워집니다.

백 엔드에서 연결을 끊도록 앱 업데이트

이 섹션에서는 모바일 앱 백 엔드에 대한 연결을 끊어 오프라인 상황을 시뮬레이션합니다. 데이터 항목을 추가하면 예외 처리기가 앱이 오프라인 모드임을 알려줍니다. 이 상태에서 로컬 저장소에 추가된 새 항목은 푸시가 연결된 상태에서 다음에 실행될 때 모바일 앱 백 엔드에 동기화됩니다.

공유 프로젝트에서 App.xaml.cs 편집합니다. MobileServiceClient 초기화를 주석으로 처리하고 잘못된 모바일 앱 URL을 사용하는 다음 줄을 추가합니다.
```
  public static MobileServiceClient MobileService = new MobileServiceClient("https://your-service.azurewebsites.fail");
```
디바이스에서 Wifi 및 셀룰러 네트워크를 사용하지 않도록 설정하거나 비행기 모드를 사용하여 오프라인 동작을 시연할 수도 있습니다.
F5 눌러 앱을 빌드하고 실행합니다. 앱이 시작될 때 새로 고침 시 동기화가 실패했습니다.
새 항목을 입력하고 저장을 클릭할 때마다 CancelledByNetworkError 상태로 푸시가 실패하는 것을 알립니다. 그러나 새 할 일 항목은 모바일 앱 백 엔드로 푸시할 수 있을 때까지 로컬 저장소에 존재합니다. 프로덕션 앱에서 이러한 예외를 표시하지 않으면 클라이언트 앱이 모바일 앱 백 엔드에 연결된 것처럼 동작합니다.
앱을 닫고 다시 시작하여 만든 새 항목이 로컬 저장소에 유지되는지 확인합니다.
(선택 사항) Visual Studio에서 서버 탐색기엽니다. Azure ->내의데이터베이스로 이동합니다. 데이터베이스를 마우스 오른쪽 단추로 클릭하고 SQL Server 개체 탐색기 열기를 선택합니다. 이제 SQL 데이터베이스 테이블 및 해당 내용을 찾아볼 수 있습니다. 백 엔드 데이터베이스의 데이터가 변경되지 않은지 확인합니다.
(선택 사항) Fiddler 또는 Postman과 같은 REST 도구를 사용하여 https://<your-mobile-app-backend-name>.azurewebsites.net/tables/TodoItem양식의 GET 쿼리를 사용하여 모바일 백 엔드를 쿼리합니다.

모바일 앱 백 엔드를 다시 연결하도록 앱 업데이트

이 섹션에서는 모바일 앱 백 엔드에 앱을 다시 연결합니다. 이러한 변경 내용은 앱에서 네트워크 다시 연결을 시뮬레이션합니다.

애플리케이션을 처음 실행하면 OnNavigatedTo 이벤트 처리기가 InitLocalStoreAsync호출합니다. 이 메서드는 SyncAsync 호출하여 로컬 저장소를 백 엔드 데이터베이스와 동기화합니다. 앱이 시작 시 동기화를 시도합니다.

공유 프로젝트에서 App.xaml.cs를 열고, 이전에 주석 처리한 MobileServiceClient 초기화를 제거하여 모바일 앱의 올바른 URL을 사용하십시오.
F5 키를 눌러 앱을 다시 빌드하고 실행합니다. 앱은 OnNavigatedTo 이벤트 처리기가 실행되면 푸시 및 끌어오기 작업을 사용하여 로컬 변경 내용을 Azure Mobile App 백 엔드와 동기화합니다.
(선택 사항) SQL Server 개체 탐색기 또는 Fiddler와 같은 REST 도구를 사용하여 업데이트된 데이터를 봅니다. 데이터가 Azure Mobile App 백 엔드 데이터베이스와 로컬 저장소 간에 동기화되었습니다.
앱에서 몇 가지 항목 옆에 있는 확인란을 클릭하여 로컬 저장소에서 완료합니다.

UpdateCheckedTodoItem SyncAsync 호출하여 완료된 각 항목을 모바일 앱 백 엔드와 동기화합니다. SyncAsync 푸시 및 풀을 모두 호출합니다. 그러나 클라이언트가 변경한 테이블에 대해 끌어오기를 실행할 때마다 항상 자동으로푸시가 실행됩니다. 이 동작은 관계와 함께 로컬 저장소의 모든 테이블이 일관성을 유지하도록 합니다. 이 동작으로 인해 예기치 않은 푸시가 발생할 수 있습니다. 이 동작에 대한 자세한 내용은 Azure Mobile Apps 오프라인 데이터 동기화참조하세요.

API 요약

모바일 서비스의 오프라인 기능을 지원하기 위해 IMobileServiceSyncTable 인터페이스를 사용하고 로컬 SQLite 데이터베이스를 사용하여 mobileServiceClient.SyncContext 초기화했습니다. 오프라인일 때 Mobile Apps에 대한 일반적인 CRUD 작업은 로컬 저장소에 대해 작업이 발생하는 동안 앱이 여전히 연결된 것처럼 작동합니다. 다음 메서드는 로컬 저장소를 서버와 동기화하는 데 사용됩니다.

PushAsync 이 메서드는 IMobileServicesSyncContext멤버이므로 모든 테이블의 변경 내용이 백 엔드로 푸시됩니다. 로컬 변경 내용이 있는 레코드만 서버로 전송됩니다.
PullAsync는 IMobileServiceSyncTable에서부터 시작하는 끌어오기입니다. 테이블에 변경 내용이 추적되면 암시적 푸시를 실행하여 관계와 함께 로컬 저장소의 모든 테이블이 일관성을 유지하도록 합니다. pushOtherTables 매개 변수는 컨텍스트의 다른 테이블이 암시적 푸시에서 푸시되는지 여부를 제어합니다. 쿼리 매개 변수는 IMobileServiceTableQuery<T>또는 OData 쿼리 문자열을 사용하여 반환된 데이터를 필터링합니다. queryId 매개 변수는 증분 동기화를 정의하는 데 사용됩니다. 자세한 내용은 Azure Mobile Apps 오프라인 데이터 동기화참조하세요.
PurgeAsync 앱은 정기적으로 이 메서드를 호출하여 로컬 저장소에서 부실 데이터를 제거해야 합니다. 아직 동기화되지 않은 변경 내용을 제거해야 하는 경우 force 매개 변수를 사용합니다.

이러한 개념에 대한 자세한 내용은 Azure Mobile Apps 오프라인 데이터 동기화참조하세요.

추가 정보

다음 항목에서는 Mobile Apps의 오프라인 동기화 기능에 대한 추가 배경 정보를 제공합니다.

Azure Mobile Apps에서의 오프라인 데이터 동기화
Azure 모바일 앱 .NET SDK 사용 방법

Last updated on 2019-06-25