Unified API에 기존 앱 업데이트Updating Existing Apps to the Unified API

중요

Unified API 앞에 있는 Xamarin Classic API은 더 이상 사용 되지 않습니다.The Xamarin Classic API, which preceded the Unified API, has been deprecated.

  • Classic API (monotouch.dialog)를 지원 하기 위한 최신 버전의 Xamarin.ios는 Xamarin.ios 9.10입니다.The last version of Xamarin.iOS to support the Classic API (monotouch.dll) was Xamarin.iOS 9.10.
  • Xamarin.ios는 여전히 Classic API을 지원 하지만 더 이상 업데이트 되지 않습니다.Xamarin.Mac still supports the Classic API, but it is no longer updated. 개발자는 더 이상 사용 되지 않으므로 응용 프로그램을 Unified API로 이동 해야 합니다.Since it is deprecated, developers should move their applications to the Unified API.

앱을 업데이트 하는 방법How to Update Your Apps

앱을 업데이트 하는 세 가지 단계가 있습니다.There are three steps to update your apps:

  1. 기존 코드, 특히 사용 되지 않는 Api와 관련 된 모든 컴파일러 경고를 수정 합니다.Fix any compiler warnings in your existing code, particularly those relating to deprecated APIs.

  2. 기본 제공 되는 마이그레이션 도구를 사용 하 여 프로젝트 파일 및 네임 스페이스를 업데이트 Mac용 Visual Studio 합니다.Use the Migration Tool built in to Visual Studio for Mac to update your project files and namespaces.

  3. 64 형식 및 변경 된 다른 api 와 관련 된 나머지 컴파일러 오류를 수정 합니다.Fix remaining compiler errors relating to the new 64-types and other APIs that have changed. 필요할 수 있는 수동 업데이트에 대 한 자세한 내용은 다음 팁 을 확인 하세요.Check out these tips for additional information on manual updates that might be required.

앱을 Unified API 및 64 비트 지원으로 업데이트 하는 데 도움이 되는 각 제품에 대 한 특정 가이드가 있습니다.There are specific guides available for each product to help you update your apps to the Unified API and 64-bit support:

Xamarin.ios 앱Xamarin.iOS apps

Mac용 Visual Studio 기본 제공 되는 자동화 된 마이그레이션 도구를 사용 하 여 기존 Xamarin.ios 앱을 Unified API으로 업데이트할 수 있습니다.Existing Xamarin.iOS apps can be updated to the Unified API using the automated migration tool built in to Visual Studio for Mac. 이러한 지침에 설명 된 대로 몇 가지 추가 수정이 필요할 수 있습니다.Some additional fixes may then be required, as explained in these instructions and tips.

Xamarin.ios 앱Xamarin.Mac apps

Mac용 Visual Studio 기본 제공 되는 자동화 된 마이그레이션 도구를 사용 하 여 기존 Xamarin.ios 앱을 Unified API으로 업데이트할 수 있습니다.Existing Xamarin.Mac apps can be updated to the Unified API using the automated migration tool built in to Visual Studio for Mac. 이러한 지침에 설명 된 대로 몇 가지 추가 수정이 필요할 수 있습니다.Some additional fixes may then be required, as explained in these instructions and tips.

Xamarin.Forms 앱Xamarin.Forms apps

Unified API 사용 하려면 다음 지침에 따라 iOS 프로젝트를 사용 하 여 기존 Xamarin.ios 솔루션을 업데이트 합니다.Follow these instructions to update an existing Xamarin.Forms solution with an iOS project to use the Unified API. Unified API 지원은 Xamarin.ios 1.3 이상 에서만 사용할 수 있으므로, Xamarin. Forms 앱을 버전 1.3로 업데이트 하는 방법에 대해서도 설명 합니다 .Unified API support is only available in Xamarin.Forms 1.3 and later, so the instructions also explain how to update your Xamarin.Forms app to version 1.3. 이러한 은 사용자 지정 렌더러 또는 종속성 서비스에서 네이티브 iOS 코드를 업데이트 하는 데 도움이 될 수 있습니다.These tips may help updating any native iOS code in custom renderers or dependency services.

플랫폼 간 앱에서의 네이티브 형식 작업Working with Native Types in Cross-Platform Apps

이 문서에서는 Android 또는 Windows Phone Os와 같은 비 iOS 장치와 코드를 공유 하는 플랫폼 간 응용 프로그램에서 새로운 iOS Unified API 네이티브 형식 (nint, nuint, nint)을 사용 하는 방법을 설명 합니다.This article covers using the new iOS Unified API Native types (nint, nuint, nfloat) in a cross-platform application where code is shared with non-iOS devices such as Android or Windows Phone OSes. 네이티브 형식을 사용 해야 하는 경우에 대 한 통찰력을 제공 하 고 플랫폼 간 코드에서 새 형식을 사용 해야 하는 경우에 대 한 몇 가지 가능한 해결 방법을 제공 합니다.It provides insight into when the Native types should be used and provides several possible solutions to cases where the new type must be used with cross-platform code.

Unified API에 대 한 바인딩을 업데이트 합니다.Update Bindings to the Unified API

목적-C 라이브러리에 대 한 바인딩을 만든 고객은 기본 API (이제는 64 비트)의 변경 내용을 반영 하도록 바인딩 프로젝트를 업데이트 해야 합니다.Customers that have created bindings to Objective-C libraries will need to update the binding project to reflect changes in the underlying API (where some types will now be 64-bit). Unified API를 지원 하도록 기존 바인딩 프로젝트를 업데이트하려면 다음 지침을 따르세요.Follow these instructions to update an existing Binding Project to support the Unified API.