기존 iOS 앱 업데이트

통합 API를 사용하도록 기존 Xamarin.iOS 앱을 업데이트하려면 다음 단계를 수행합니다.

통합 API를 사용하도록 기존 앱을 업데이트하려면 프로젝트 파일 자체와 애플리케이션 코드에 사용되는 네임스페이스 및 API를 변경해야 합니다.

64비트로 가는 길

Xamarin.iOS 모바일 애플리케이션에서 64비트 디바이스 아키텍처를 지원하려면 새 통합 API가 필요합니다. 2015년 2월 1일부터 Apple은 iTunes App Store에 대한 모든 새 앱 제출이 64비트 아키텍처를 지원하도록 요구합니다.

Xamarin은 클래식 API에서 Unified API로 마이그레이션 프로세스를 자동화하거나 프로젝트 파일을 수동으로 변환할 수 있도록 Mac용 Visual Studio 및 Visual Studio 모두에 대한 도구를 제공합니다. 자동 도구를 사용하는 것이 좋습니다. 이 문서에서는 두 가지 방법을 모두 설명합니다.

시작하기 전에...

기존 코드를 통합 API로 업데이트하기 전에 모든 컴파일 경고를 제거하는 것이 좋습니다. Unified로 마이그레이션하면 클래식 API의 많은 경고 가 오류가 발생합니다. 클래식 API의 컴파일러 메시지는 업데이트할 항목에 대한 힌트를 제공하는 경우가 많으므로 시작하기 전에 수정하는 것이 더 쉽습니다.

자동화된 업데이트

경고가 해결되면 Mac용 Visual Studio 또는 Visual Studio에서 기존 iOS 프로젝트를 선택하고 프로젝트 메뉴에서 Xamarin.iOS 통합 API로 마이그레이션을 선택합니다. 예시:

자동화된 마이그레이션이 실행되기 전에 이 경고에 동의해야 합니다(이 모험에 착수하기 전에 백업/소스 제어가 있는지 확인해야 합니다).

이 도구는 기본적으로 아래에 제시된 수동 업데이트 섹션에 설명된 모든 단계를 자동화하며 기존 Xamarin.iOS 프로젝트를 통합 API로 변환하는 제안된 방법입니다.

수동으로 업데이트하는 단계

경고가 수정되면 다음 단계에 따라 Xamarin.iOS 앱을 수동으로 업데이트하여 새 통합 API를 사용합니다.

1. 프로젝트 유형 및 빌드 대상 업데이트

csproj 파일의 프로젝트 버전을 .로 6BC8ED88-2882-458C-8E55-DFD12B67127BFEACFBD2-3405-455C-9665-78FE426C6842변경합니다. 텍스트 편집기 에서 csproj 파일을 편집하고 다음과 같이 요소의 <ProjectTypeGuids> 첫 번째 항목을 바꿉니다.

다음과 같이 포함된 Import 요소를 변경합니다.Xamarin.iOS.CSharp.targetsXamarin.MonoTouch.CSharp.targets

2. 프로젝트 참조 업데이트

iOS 애플리케이션 프로젝트의 참조 노드를 확장합니다 . 처음에는 이 스크린샷과 유사한 *broken- monotouch 참조가 표시됩니다(프로젝트 형식을 변경했기 때문).

iOS 애플리케이션 프로젝트를 마우스 오른쪽 단추로 클릭하여 참조를 편집한 다음, monotouch 참조를 클릭하고 빨간색 "X" 단추를 사용하여 삭제합니다.

이제 참조 목록의 끝으로 스크롤하여 Xamarin.iOS 어셈블리를 선택합니다.

프로젝트 참조 변경 내용을 저장하려면 [확인]을 누릅니다.

3. 네임스페이스에서 MonoTouch 제거

문의 네임스페이스에서 using 또는 클래스 이름이 정규화된 모든 위치에서 MonoTouch 접두사를 제거합니다(예: <a0/>MonoTouch.UIKit).

4. 형식 다시 매핑

네이티브 형식이 도입되어 이전에 사용된 일부 형식(예: 해당 인스턴스)을 CoreGraphics.CGRect 대체합니다System.Drawing.RectangleF. 형식의 전체 목록은 네이티브 형식 페이지에서 찾을 수 있습니다.

5. 메서드 재정의 수정

일부 UIKit 메서드는 새 네이티브 형식 (예: nint)을 사용하도록 서명을 변경했습니다. 사용자 지정 서브클래스가 이러한 메서드를 재정의하면 서명이 더 이상 일치하지 않으며 오류가 발생합니다. 네이티브 형식을 사용하여 새 서명과 일치하도록 서브클래스를 변경하여 이러한 메서드 재정의를 수정합니다.

예를 들어 반환하도록 변경 public override int NumberOfSections (UITableView tableView) 하고 반환 nint 형식과 매개 변수 형식을 모두 .로 public override int RowsInSection (UITableView tableView, int section) 변경하는 것이 nint있습니다.

고려 사항

기존 Xamarin.iOS 프로젝트를 클래식 API에서 새 통합 API로 변환할 때 해당 앱이 하나 이상의 구성 요소 또는 NuGet 패키지를 사용하는 경우 다음 사항을 고려해야 합니다.

구성 요소

애플리케이션에 포함된 모든 구성 요소도 통합 API로 업데이트해야 합니다. 그렇지 않으면 컴파일하려고 할 때 충돌이 발생합니다. 포함된 구성 요소의 경우 현재 버전을 통합 API를 지원하는 Xamarin 구성 요소 저장소의 새 버전으로 바꾸고 클린 빌드를 수행합니다. 작성자가 아직 변환하지 않은 구성 요소는 구성 요소 저장소에 32비트 경고만 표시합니다.

NuGet 지원

통합 API 지원과 함께 작동하도록 NuGet 변경에 기여한 반면 NuGet의 새 릴리스는 없으므로 NuGet에서 새 API를 인식하는 방법을 평가하고 있습니다.

그 때까지는 구성 요소와 마찬가지로 프로젝트에 포함된 NuGet 패키지를 통합 API를 지원하는 버전으로 전환하고 나중에 클린 빌드를 수행해야 합니다.

Important

"오류 3 동일한 Xamarin.iOS 프로젝트에 'monotouch.dll'과 'Xamarin.iOS.dll'을 모두 포함할 수 없습니다. 'Xamarin.iOS.dll'은 명시적으로 참조됩니다. 애플리케이션을 통합 API로 변환한 후 'xxx, Version=0.0.000, Culture=neutral, PublicKeyToken=null'에서 'monotouch.dll'을 참조하지만 일반적으로 통합 API로 업데이트되지 않은 프로젝트에 구성 요소 또는 NuGet 패키지가 있기 때문입니다. 기존 구성 요소/NuGet을 제거하고 통합 API를 지원하는 버전으로 업데이트하고 클린 빌드를 수행해야 합니다.

Xamarin.iOS 앱의 64비트 빌드 사용

통합 API로 변환된 Xamarin.iOS 모바일 애플리케이션의 경우 개발자는 앱의 옵션에서 64비트 컴퓨터에 애플리케이션을 빌드할 수 있도록 설정해야 합니다. 64비트 빌드를 사용하도록 설정하는 방법에 대한 자세한 지침은 32/64비트 플랫폼 고려 사항 문서의 Xamarin.iOS 앱 64비트 빌드 사용 문서를 참조하세요.

마무리 중

자동 또는 수동 메서드를 사용하여 Xamarin.iOS 애플리케이션을 클래식에서 통합 API로 변환할지 여부에 관계없이 추가 수동 개입이 필요한 몇 가지 인스턴스가 있습니다. 알려진 문제 및 해결 방법은 통합 API 문서로 코드를 업데이트하기 위한 팁 참조하세요.

관련 링크

• 코드를 Unified API로 업데이트하는 팁
• 플랫폼 간 앱에서의 네이티브 형식 작업
• 클래식 및 통합 API 차이점