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

아티클
06/25/2019

개요

이 자습서에서는 Azure 모바일 앱 백 엔드를 사용하여 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 Store
유니버설 Windows 플랫폼용 SQLite 개발

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

Azure 모바일 앱 오프라인 기능을 사용하면 오프라인 시나리오에서 로컬 데이터베이스를 조작할 수 있습니다. 앱에서 이러한 기능을 사용하려면 로컬 저장소에서 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");
```
디바이스에서 Wi-Fi 및 셀룰러 네트워크를 사용하지 않도록 설정하여 오프라인 동작을 시연하거나 비행기 모드를 사용할 수 있습니다.
F5 키를 눌러 앱을 빌드하고 실행합니다. 앱을 시작하는 경우 동기화는 새로 고침에 실패합니다.
새 항목을 입력하고 저장 을 클릭할 때마다 푸시가 CancelledByNetworkError상태로 실패하는지 확인합니다. 그러나 새 todo 항목은 모바일 앱 백 엔드에 푸시할 수 있을 때까지 로컬 저장소에 위치합니다. 프로덕션 앱에서 이러한 예외를 무시하는 경우 클라이언트 앱은 모바일 앱 백 엔드에 연결된 것처럼 작동합니다.
앱을 닫았다가 다시 시작하여 만든 새 항목이 로컬 저장소에 유지되는지 확인합니다.
(옵션) Visual Studio에서 서버 탐색기를 엽니다. Azure-SQL>Database에서 데이터베이스로 이동합니다. 데이터베이스를 마우스 오른쪽 단추로 클릭하고 SQL Server 개체 탐색기에서 열기를 선택합니다. 이제 SQL 데이터베이스 테이블 및 콘텐츠를 찾아볼 수 있습니다. 백 엔드 데이터베이스의 데이터가 변경되지 않은 것을 확인합니다.
(옵션) Fiddler 또는 Postman과 같은 REST 도구를 사용하여 https://<your-mobile-app-backend-name>.azurewebsites.net/tables/TodoItem형식의 GET 쿼리를 통해 모바일 백 엔드를 쿼리합니다.

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

이 섹션에서는 앱을 Mobile App 백 엔드에 다시 연결합니다. 이렇게 변경하면 앱의 네트워크 다시 연결이 시뮬레이트됩니다.

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

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

UpdateCheckedTodoItem은 SyncAsync를 호출하여 Mobile App 백 엔드와 전체 항목을 동기화합니다. 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의 오프라인 동기화 기능에 추가 배경 정보를 제공합니다.

Share via