Xamarin.iOS 모바일 앱에 대해 오프라인 동기화 사용

개요

이 자습서에서는 Xamarin.iOS용 Azure Mobile Apps의 오프라인 동기화 기능을 소개합니다. 오프라인 동기화를 사용하면 최종 사용자가 네트워크 연결이 없는 경우에도 데이터를 보거나 추가하거나 수정하는 모바일 앱과 상호 작용할 수 있습니다. 변경 내용은 로컬 데이터베이스에 저장됩니다. 디바이스가 다시 온라인 상태가 되면 이러한 변경 내용이 원격 서비스와 동기화됩니다.

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

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

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

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

Xamarin iOS 앱 만들기 자습서에서 완료한 프로젝트에서 NuGet 패키지 관리자를 연 다음, Microsoft.Azure.Mobile.Client.SQLiteStore NuGet 패키지를 검색하여 설치합니다.
QSTodoService.cs 파일을 열고 #define OFFLINE_SYNC_ENABLED 정의의 주석을 제거합니다.
클라이언트 앱을 다시 빌드하고 실행합니다. 앱은 오프라인 동기화를 사용하도록 설정하기 전과 동일하게 작동합니다. 그러나 로컬 데이터베이스는 이제 오프라인 시나리오에서 사용할 수 있는 데이터로 채워집니다.

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

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

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

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

이 섹션에서는 모바일 앱 백 엔드에 앱을 다시 연결합니다. 모바일 앱 백 엔드를 사용하여 오프라인 상태에서 온라인 상태로 이동하는 앱을 시뮬레이트합니다. 네트워크 연결을 해제하여 네트워크 중단을 시뮬레이션한 경우 코드 변경이 필요하지 않습니다. 네트워크를 다시 켭니다. 애플리케이션을 처음 실행하면 메서드가 RefreshDataAsync 호출됩니다. 그러면 로컬 저장소를 백 엔드 데이터베이스와 동기화하기 위해 호출 SyncAsync 됩니다.

공유 프로젝트에서 QSToDoService.cs 열고 applicationURL 속성의 변경 내용을 되돌려 줍니다.
앱을 다시 빌드하고 실행합니다. 앱은 OnRefreshItemsSelected 메서드가 실행되면 푸시 및 끌어오기 작업을 사용하여 로컬 변경 내용을 Azure Mobile App 백 엔드와 동기화합니다.
(선택 사항) SQL Server 개체 탐색기 또는 Fiddler와 같은 REST 도구를 사용하여 업데이트된 데이터를 봅니다. 데이터가 Azure Mobile App 백 엔드 데이터베이스와 로컬 저장소 간에 동기화되었습니다.
앱에서 몇 가지 항목 옆에 있는 확인란을 클릭하여 로컬 저장소에서 완료합니다.

CompleteItemAsync SyncAsync 호출하여 완료된 각 항목을 모바일 앱 백 엔드와 동기화합니다. SyncAsync는 푸시와 풀을 둘 다 호출합니다. 클라이언트가 변경한 테이블에 대해 끌어오기를 실행할 때마다 클라이언트 동기화 컨텍스트에 대한 푸시가 항상 먼저 자동으로 실행됩니다. 자동 푸시는 관계를 포함하여 로컬 저장소의 모든 테이블이 일관성을 유지하도록 합니다. 이 동작에 대한 자세한 내용은 Azure Mobile Apps 오프라인 데이터 동기화참조하세요.

클라이언트 동기화 코드 검토

자습서를 완료했을 때 다운로드한 Xamarin 클라이언트 프로젝트에는 로컬 SQLite 데이터베이스를 사용하여 오프라인 동기화를 지원하는 코드가 이미 포함되어 있습니다. 자습서 코드에 이미 포함된 내용에 대한 간략한 개요는 다음과 같습니다. 이 기능에 대한 개념적 개요는 Azure Mobile Apps 오프라인 데이터 동기화참조하세요.

테이블 작업을 수행하려면 먼저 로컬 저장소를 초기화해야 합니다. 로컬 저장소 데이터베이스는 QSTodoListViewController.ViewDidLoad()QSTodoService.InitializeStoreAsync()실행할 때 초기화됩니다. 이 메서드는 Azure Mobile App 클라이언트 SDK에서 제공하는 클래스를 MobileServiceSQLiteStore 사용하여 새 로컬 SQLite 데이터베이스를 만듭니다.

DefineTable 메서드는 제공된 형식의 필드와 일치하는 테이블을 로컬 저장소에 만듭니다. 이 경우 ToDoItem. 형식에 원격 데이터베이스에 있는 모든 열을 포함할 필요는 없습니다. 열의 하위 집합만 저장할 수 있습니다.
```
  // QSTodoService.cs

  public async Task InitializeStoreAsync()
  {
      var store = new MobileServiceSQLiteStore(localDbPath);
      store.DefineTable<ToDoItem>();

      // Uses the default conflict handler, which fails on conflict
      await client.SyncContext.InitializeAsync(store);
  }
```
todoTable의 QSTodoService 멤버는 IMobileServiceSyncTable대신 IMobileServiceTable 종류입니다. IMobileServiceSyncTable은 모든 만들기, 읽기, 업데이트 및 삭제(CRUD) 테이블 작업을 로컬 저장소 데이터베이스로 전달합니다.

이러한 변경 내용을 호출 IMobileServiceSyncContext.PushAsync()하여 Azure Mobile App 백 엔드로 푸시되는 시기를 결정합니다. 동기화 컨텍스트는 PushAsync 호출될 때 클라이언트 앱이 수정한 모든 테이블의 변경 내용을 추적하고 푸시하여 테이블 관계를 유지하는 데 도움이 됩니다.

제공된 코드는 todoitem 목록을 새로 고치거나 todoitem이 추가되거나 완료될 때마다 동기화할 QSTodoService.SyncAsync() 호출합니다. 앱은 로컬 변경 후 동기화됩니다. 컨텍스트에서 추적되는 보류 중인 로컬 업데이트가 있는 테이블에 대해 끌어오기를 실행하면 해당 끌어오기 작업이 컨텍스트 푸시를 먼저 자동으로 트리거합니다.

제공된 코드에서 원격 TodoItem 테이블의 모든 레코드가 쿼리되지만, 쿼리 ID와 쿼리를 입력하여 레코드를 PushAsync에서 필터링할 수도 있습니다. 자세한 내용은 Azure 모바일 앱의 오프라인 데이터 동기화의 증분 동기화 섹션을 참조하세요.
```
  // QSTodoService.cs
  public async Task SyncAsync()
  {
      try
      {
          await client.SyncContext.PushAsync();
          await todoTable.PullAsync("allTodoItems", todoTable.CreateQuery()); // query ID is used for incremental sync
      }

      catch (MobileServiceInvalidOperationException e)
      {
          Console.Error.WriteLine(@"Sync Failed: {0}", e.Message);
      }
  }
```

추가 리소스

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

Last updated on 2019-06-25

다음을 통해 공유

Xamarin.iOS 모바일 앱에 대해 오프라인 동기화 사용

개요

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

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

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

클라이언트 동기화 코드 검토

추가 리소스

추가 리소스