기존 Mac 앱 업데이트
통합 API를 사용하도록 기존 앱을 업데이트하려면 프로젝트 파일 자체와 애플리케이션 코드에 사용되는 네임스페이스 및 API를 변경해야 합니다.
64비트로 가는 길
Xamarin.Mac 애플리케이션에서 64비트 디바이스 아키텍처를 지원하려면 새 통합 API가 필요합니다. 2015년 2월 1일부터 Apple은 Mac App Store에 대한 모든 새 앱 제출이 64비트 아키텍처를 지원하도록 요구합니다.
Xamarin은 클래식 API에서 Unified API로 마이그레이션 프로세스를 자동화하거나 프로젝트 파일을 수동으로 변환할 수 있도록 Mac용 Visual Studio 및 Visual Studio 모두에 대한 도구를 제공합니다. 자동 도구를 사용하는 것이 좋습니다. 이 문서에서는 두 가지 방법을 모두 설명합니다.
시작하기 전에...
기존 코드를 통합 API로 업데이트하기 전에 모든 컴파일 경고를 제거하는 것이 좋습니다. Unified로 마이그레이션하면 클래식 API의 많은 경고 가 오류가 발생합니다. 클래식 API의 컴파일러 메시지는 업데이트할 항목에 대한 힌트를 제공하는 경우가 많으므로 시작하기 전에 수정하는 것이 더 쉽습니다.
자동화된 업데이트
경고가 해결되면 Mac용 Visual Studio 또는 Visual Studio에서 기존 Mac 프로젝트를 선택하고 프로젝트 메뉴에서 Xamarin.Mac 통합 API로 마이그레이션을 선택합니다. 예시:
자동화된 마이그레이션이 실행되기 전에 이 경고에 동의해야 합니다(이 모험에 착수하기 전에 백업/소스 제어가 있는지 확인해야 합니다).
Xamarin.Mac 애플리케이션에서 통합 API를 사용할 때 선택할 수 있는 두 가지 지원되는 대상 프레임워크 유형이 있습니다.
- Xamarin.Mac Mobile Framework - 전체 데스크톱 프레임워크의 하위 집합을 지원하는 Xamarin.iOS 및 Xamarin.Android에서 사용하는 것과 동일한 조정된 .NET 프레임워크입니다. 뛰어난 연결 동작으로 인해 더 작은 평균 이진 파일을 제공하기 때문에 권장되는 프레임워크입니다.
- Xamarin.Mac .NET 4.5 프레임워크 - 이 프레임워크는 데스크톱 프레임워크의 하위 집합입니다. 그러나 모바일 프레임워크보다 전체 데스크톱 프레임워크를 훨씬 적게 잘라내고 대부분의 NuGet 패키지 또는 타사 라이브러리에서 "작동"해야 합니다. 이를 통해 개발자는 지원되는 프레임워크를 계속 사용하는 동안 표준 데스크톱 어셈블리를 사용할 수 있지만 이 옵션은 더 큰 애플리케이션 번들을 생성합니다. Xamarin.Mac Mobile Framework와 호환되지 않는 타사 .NET 어셈블리가 사용되는 권장 프레임워크입니다. 지원되는 어셈블리 목록은 어셈블리 설명서를 참조하세요.
대상 프레임워크에 대한 자세한 내용과 Xamarin.Mac 애플리케이션에 대한 특정 대상을 선택하는 경우의 의미는 대상 프레임워크 설명서를 참조하세요.
이 도구는 기본적으로 아래에 제시된 수동 업데이트 섹션에 설명된 모든 단계를 자동화하며 기존 Xamarin.Mac 프로젝트를 통합 API로 변환하는 권장 방법입니다.
수동으로 업데이트하는 단계
경고가 수정되면 다음 단계에 따라 Xamarin.Mac 앱을 수동으로 업데이트하여 새 통합 API를 사용합니다.
1. 프로젝트 유형 및 빌드 대상 업데이트
csproj 파일의 프로젝트 버전을 .로 42C0BBD9-55CE-4FC1-8D90-A7348ABAFB23A3F8F2AB-B479-4A4A-A458-A89E7DC349F1변경합니다. 텍스트 편집기 에서 csproj 파일을 편집하고 다음과 같이 요소의 <ProjectTypeGuids> 첫 번째 항목을 바꿉니다.
다음과 같이 포함된 Import 요소를 변경합니다.Xamarin.Mac.CSharp.targetsXamarin.Mac.targets
요소 다음에 다음 코드 줄을 추가합니다 <AssemblyName> .
<TargetFrameworkVersion>v2.0</TargetFrameworkVersion>
<TargetFrameworkIdentifier>Xamarin.Mac</TargetFrameworkIdentifier>
예시:
2. 프로젝트 참조 업데이트
Mac 애플리케이션 프로젝트의 참조 노드를 확장합니다 . 처음에는 이 스크린샷과 유사한 *broken- XamMac 참조가 표시됩니다(프로젝트 형식을 변경했기 때문).
XamMac 항목 옆에 있는 기어 아이콘을 클릭하고 삭제를 선택하여 끊어진 참조를 제거합니다.
그런 다음 솔루션 탐색기 참조 폴더를 마우스 오른쪽 단추로 클릭하고 참조 편집을 선택합니다. 참조 목록의 맨 아래로 스크롤하고 Xamarin.Mac 외에 검사 배치합니다.
프로젝트 참조 변경 내용을 저장하려면 [확인]을 누릅니다.
3. 네임스페이스에서 MonoMac 제거
문의 네임스페이스에서 using 또는 클래스 이름이 정규화된 모든 위치에서 MonoMac 접두사를 제거합니다(예: <MonoMac.AppKit).
4. 형식 다시 매핑
네이티브 형식이 도입되어 이전에 사용된 일부 형식(예: 해당 인스턴스)을 CoreGraphics.CGRect 대체합니다System.Drawing.RectangleF. 형식의 전체 목록은 네이티브 형식 페이지에서 찾을 수 있습니다.
5. 메서드 재정의 수정
일부 AppKit 메서드는 새 네이티브 형식 (예: nint)을 사용하도록 서명을 변경했습니다. 사용자 지정 서브클래스가 이러한 메서드를 재정의하면 서명이 더 이상 일치하지 않으며 오류가 발생합니다. 네이티브 형식을 사용하여 새 서명과 일치하도록 서브클래스를 변경하여 이러한 메서드 재정의를 수정합니다.
고려 사항
앱이 하나 이상의 구성 요소 또는 NuGet 패키지를 사용하는 경우 기존 Xamarin.Mac 프로젝트를 클래식 API에서 새 통합 API로 변환할 때는 다음 사항을 고려해야 합니다.
구성 요소
애플리케이션에 포함된 모든 구성 요소도 통합 API로 업데이트해야 합니다. 그렇지 않으면 컴파일하려고 할 때 충돌이 발생합니다. 포함된 구성 요소의 경우 현재 버전을 통합 API를 지원하는 Xamarin 구성 요소 저장소의 새 버전으로 바꾸고 클린 빌드를 수행합니다. 작성자가 아직 변환하지 않은 구성 요소는 구성 요소 저장소에 32비트 경고만 표시합니다.
NuGet 지원
통합 API 지원과 함께 작동하도록 NuGet 변경에 기여한 반면 NuGet의 새 릴리스는 없으므로 NuGet에서 새 API를 인식하는 방법을 평가하고 있습니다.
그 때까지는 구성 요소와 마찬가지로 프로젝트에 포함된 NuGet 패키지를 통합 API를 지원하는 버전으로 전환하고 나중에 클린 빌드를 수행해야 합니다.
Important
"오류 3 같은 Xamarin.Mac 프로젝트에 'monomac.dll'과 'Xamarin.Mac.dll'을 모두 포함할 수 없습니다. 'Xamarin.Mac.dll' 형식 의 오류가 있는 경우 명시적으로 참조됩니다. 애플리케이션을 통합 API로 변환한 후 'xxx, Version=0.0.000, Culture=neutral, PublicKeyToken=null'에서 'monomac.dll' 을 참조하지만 일반적으로 통합 API로 업데이트되지 않은 프로젝트에 구성 요소 또는 NuGet 패키지가 있기 때문입니다. 기존 구성 요소/NuGet을 제거하고 통합 API를 지원하는 버전으로 업데이트하고 클린 빌드를 수행해야 합니다.
Xamarin.Mac 앱의 64비트 빌드 사용
통합 API로 변환된 Xamarin.Mac 모바일 애플리케이션의 경우 개발자는 앱의 옵션에서 64비트 컴퓨터에 애플리케이션을 빌드할 수 있도록 설정해야 합니다. 64비트 빌드를 사용하도록 설정하는 방법에 대한 자세한 지침은 32/64비트 플랫폼 고려 사항 문서의 Xamarin.Mac 앱 64비트 빌드 사용 문서를 참조하세요.
마무리 중
자동 또는 수동 메서드를 사용하여 Xamarin.Mac 애플리케이션을 클래식에서 통합 API로 변환할지 여부에 관계없이 추가 수동 개입이 필요한 몇 가지 인스턴스가 있습니다. 알려진 문제 및 해결 방법은 통합 API 문서로 코드를 업데이트하기 위한 팁 참조하세요.