Wymaganie środowiska Xcode

Każda wersja platformy .NET dla systemów iOS, tvOS, Mac Catalyst lub macOS wymaga określonej wersji środowiska Xcode.

Podajemy w naszych informacjach o wydaniu dokładną wersję Xcode dla każdego wydania.

Uwaga / Notatka

W kilku ograniczonych scenariuszach użycie innej wersji programu Xcode może działać, ale nie jest to obsługiwane, nawet jeśli nie ma żadnych błędów kompilacji ani ostrzeżeń.

Nowe obciążenia

Nowa wersja obciążenia może wymagać innej wersji środowiska Xcode. Dzieje się tak zwykle za każdym razem, gdy firma Apple wyda nową wersję środowiska Xcode: wkrótce potem wydamy nowe wersje obciążeń, obsługując nową wersję środowiska Xcode. Aktualizacja obciążeń spowoduje w ten sposób wymaganie nowej wersji środowiska Xcode.

Często manifestuje się to z błędem kompilacji w następujący sposób:

Ta wersja systemu Microsoft.iOS wymaga zestawu SDK systemu iOS 18.4 (dostarczanego z programem Xcode 16.3). Bieżąca wersja programu Xcode to 16.2. Zainstaluj program Xcode 16.3 lub użyj innej wersji systemu Microsoft.iOS. Aby uzyskać więcej informacji, zobacz https://aka.ms/xcode-requirement.

lub:

Ta wersja platformy .NET dla systemu iOS (18.4.9288) wymaga programu Xcode 16.3. Bieżąca wersja programu Xcode to 16.2. Zainstaluj program Xcode 16.3 lub użyj innej wersji platformy .NET dla systemu iOS. Aby uzyskać więcej informacji, zobacz https://aka.ms/xcode-requirement.

Najprostszym rozwiązaniem jest zwykle uaktualnienie do wersji programu Xcode, o których wspomina komunikat o błędzie.

Istnieje również możliwość zainstalowania starszej wersji odpowiedniego obciążenia, aby uniknąć konieczności uaktualniania środowiska Xcode.

W niektórych przypadkach nowsza wersja programu Xcode wymaga również aktualizacji do nowszej wersji głównej systemu macOS (zwykle występuje to około kwietnia każdego roku). Jeśli nowa wersja systemu macOS nie jest obsługiwana na bieżącym sprzęcie dewelopera, jedyną opcją jest użycie starszej wersji obciążenia (lub uzyskanie nowego sprzętu).

Nowy kod Xcode

Istnieje przedział czasu między wydaniem przez firmę Apple nowej wersji programu Xcode i udostępnieniem obsługi tej nowej wersji programu Xcode. Czasami system macOS automatycznie zaktualizuje zainstalowaną wersję programu Xcode, co może powodować problemy w tym przedziale czasu.

Najprostszym rozwiązaniem jest zainstalowanie wielu wersji programu Xcode i wybranie wersji programu Xcode odpowiadającej wymaganiu środowiska Xcode dla zainstalowanych obciążeń.

Uwaga / Notatka

Zalecamy wyłączenie automatycznych aktualizacji w sklepie App Store w systemie macOS, aby uniknąć tego scenariusza.

Instalowanie wielu wersji programu Xcode

Istnieje możliwość jednoczesnego zainstalowania wielu wersji programu Xcode.

Można to zrobić, wykonując następujące czynności:

• Przejdź do strony Apple Developer Downloads.
• Zaloguj się przy użyciu identyfikatora Apple ID.
• Wyszukaj żądane wersje środowiska Xcode.
• .xip Pobierz plik(i).
• Wyodrębnij pliki, klikając je dwukrotnie.
• Zmień nazwę pliku Xcode.app w folderze Pobrane na coś bardziej opisowego (na przykład Xcode_15.app).
• Przenieś wyodrębniony *.app plik do /Applications/ katalogu.

Uwaga / Notatka

Widzieliśmy dziwne problemy, jeśli nazwa aplikacji Xcode została zmieniona po jej otwarciu co najmniej raz, dlatego zalecamy tylko zmianę nazwy aplikacji bezpośrednio po pobraniu i wyodrębnieniu jej.

Po zainstalowaniu żądanych wersji programu Xcode deweloperzy mogą wybierać między nimi z menu Xcode (menu Xcode — Ustawienia —>> Lokalizacje —> Narzędzia wiersza polecenia) lub za pomocą xcode-select narzędzia z wiersza polecenia:

$ sudo xcode-select --switch /Applications/Xcode_15.app

Ważne

~/Library/Preferences/Xamarin/Settings.plist Plik można również użyć do wybrania określonej wersji programu Xcode, a ten plik będzie mieć pierwszeństwo przed ustawieniem określonym w środowisku Xcode lub w wierszu polecenia przy użyciu polecenia xcode-select. Aby uniknąć nieporozumień, zalecamy po prostu usunięcie tego pliku.

Instalowanie starszej wersji obciążenia

Określona wersja obciążenia jest instalowana przy użyciu zestawu obciążeń.

Dokładna wersja zestawu obciążeń nie jest przewidywalna przed upływem czasu, ale określamy wersję zestawu obciążeń dla określonej wersji obciążenia z każdą wersją: https://github.com/dotnet/macios/releases.

Oto przykład dla naszej wersji z obsługą środowiska Xcode 16.3:

$ dotnet workload install ios --version 9.0.203

Często zadawane pytania

Czy uaktualnienie kodu Xcode jest bezpieczne?

Istnieje możliwość sprawdzenia, czy udostępniliśmy obsługę konkretnej wersji programu Xcode, przeglądając naszą listę wersji.

Jeśli udostępniliśmy obsługę konkretnej wersji środowiska Xcode, można bezpiecznie przeprowadzić uaktualnienie do tej wersji programu Xcode (dotyczy to również deweloperów MAUI). Inne dokumenty mogą znajdować się w innym miejscu, stwierdzające, że niektóre starsze wersje programu Xcode są wersją z wsparciem; dokumenty te zwykle są nieco w tyle za naszymi wydaniami.

Odwrotnie jest również prawdą: jeśli nie udostępniliśmy obsługi danej wersji środowiska Xcode, prawdopodobnie uaktualnienie środowiska Xcode spowoduje problemy. W przypadku deweloperów, którzy chcą nowszej wersji programu Xcode, najlepszym rozwiązaniem w tym przypadku jest zainstalowanie wielu wersji programu Xcode.