Persyaratan Xcode

Setiap versi beban kerja .NET untuk iOS, tvOS, Mac Catalyst, atau macOS memerlukan versi Xcode tertentu.

Kami menyatakan dalam catatan rilis kami versi Xcode yang tepat untuk setiap rilis.

Nota

Dalam beberapa skenario terbatas menggunakan versi Xcode yang berbeda dapat berfungsi, tetapi ini tidak didukung, bahkan jika tidak ada kesalahan build atau peringatan.

Beban kerja baru

Versi baru beban kerja mungkin memerlukan versi Xcode yang berbeda. Ini biasanya terjadi setiap kali Apple merilis versi baru Xcode: segera setelah itu kami merilis versi baru beban kerja, mendukung versi baru Xcode. Memperbarui beban kerja akan akhirnya memerlukan versi baru Xcode.

Ini sering bermanifestasi dengan kesalahan build seperti ini:

Versi Microsoft.iOS ini memerlukan iOS 18.4 SDK (dikirim dengan Xcode 16.3). Versi Xcode saat ini adalah 16.2. Instal Xcode 16.3, atau gunakan versi Microsoft.iOS yang berbeda. Lihat https://aka.ms/xcode-requirement untuk informasi lebih lanjut.

atau:

Versi .NET untuk iOS (18.4.9288) ini memerlukan Xcode 16.3. Versi Xcode saat ini adalah 16.2. Instal Xcode 16.3, atau gunakan versi .NET yang berbeda untuk iOS. Lihat https://aka.ms/xcode-requirement untuk informasi lebih lanjut.

Solusi paling sederhana biasanya untuk meningkatkan ke versi Xcode yang disebutkan pesan kesalahan.

Anda juga dapat menginstal versi lama dari beban kerja yang sesuai untuk menghindari harus meningkatkan Xcode.

Dalam beberapa kasus, versi Xcode yang lebih baru juga memerlukan pembaruan ke versi utama macOS yang lebih baru (ini umumnya terjadi sekitar April setiap tahun). Jika versi macOS baru tidak didukung pada perangkat keras pengembang saat ini, satu-satunya opsi adalah menggunakan versi beban kerja yang lebih lama (atau mendapatkan perangkat keras baru).

Xcode Baru

Ada jendela waktu antara Apple merilis versi baru Xcode dan kami merilis dukungan untuk versi Xcode baru ini. Terkadang macOS akan memperbarui versi Xcode yang diinstal secara otomatis, yang dapat menyebabkan masalah selama jangka waktu ini.

Solusi paling sederhana adalah menginstal beberapa versi Xcode, dan memilih versi Xcode yang sesuai dengan persyaratan Xcode untuk beban kerja yang diinstal.

Nota

Sebaiknya nonaktifkan pembaruan otomatis di App Store di macOS untuk menghindari skenario ini.

Menginstal beberapa versi Xcode

Dimungkinkan untuk menginstal beberapa versi Xcode secara bersamaan.

Ini dapat dicapai dengan langkah-langkah berikut:

• Kunjungi situs Unduhan Pengembang Apple.
• Masuk dengan ID Apple Anda.
• Cari versi Xcode yang diinginkan.
• .xip Unduh file.
• Ekstrak file dengan mengklik dua kali.
• Ganti nama Xcode.app di folder Unduhan menjadi sesuatu yang lebih deskriptif (misalnya Xcode_15.app).
• Pindahkan yang diekstrak *.app ke /Applications/ direktori.

Nota

Kami telah melihat masalah aneh jika aplikasi Xcode diganti namanya setelah dibuka setidaknya sekali, oleh karena itu kami sarankan hanya mengganti nama aplikasi tepat setelah mengunduh dan mengekstraknya.

Setelah versi Xcode yang diinginkan diinstal, pengembang dapat memilih di antara versi tersebut baik melalui Xcode (menu Xcode - Pengaturan - Lokasi - Alat Baris Perintah), atau dengan menggunakan alat > dari baris perintah:

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

Penting

File ~/Library/Preferences/Xamarin/Settings.plist juga dapat digunakan untuk memilih versi Xcode tertentu, dan file ini akan lebih diutamakan daripada pengaturan yang ditentukan dalam Xcode atau pada baris perintah menggunakan xcode-select. Untuk menghindari kebingungan, kami sarankan hanya menghapus file ini.

Instal versi lama dari sebuah tugas

Versi spesifik dari suatu beban kerja diinstal menggunakan paket beban kerja.

Versi set beban kerja yang tepat tidak dapat diprediksi sebelumnya, tetapi kami menyatakan versi set beban kerja untuk versi beban kerja tertentu dengan setiap rilis: https://github.com/dotnet/macios/releases.

Berikut adalah contoh untuk rilis kami dengan dukungan untuk Xcode 16.3:

$ dotnet workload install ios --version 9.0.203

FAQ

Apakah aman untuk meningkatkan Xcode saya?

Dimungkinkan untuk memeriksa apakah kami telah merilis dukungan untuk versi Xcode tertentu dengan melihat daftar rilis kami.

Jika kami telah merilis dukungan untuk versi Xcode tertentu, aman untuk meningkatkan ke versi Xcode tersebut (ini termasuk pengembang MAUI juga). Mungkin ada dokumen lain di tempat lain yang menyatakan bahwa beberapa versi Xcode yang lebih lama adalah versi yang didukung; dokumen-dokumen tersebut biasanya tertinggal dari rilis kami hingga tingkat tertentu.

Sebaliknya juga benar: jika kami belum merilis dukungan untuk versi Xcode tertentu, kemungkinan peningkatan Xcode akan menyebabkan masalah. Untuk pengembang yang menginginkan versi Xcode yang lebih baru, solusi terbaik dalam hal ini adalah menginstal beberapa versi Xcode.