macOS üzerinde yerel, platformlar arası .NET MAUI uygulamaları geliştirmeye başlamak için yükleme adımlarını izleyerek Mac için Visual Studio 2022 17.6'yı yükleyin.
Önkoşullar
iOS veya macOS için .NET MAUI uygulamaları oluşturmak, imzalamak ve dağıtmak için şunlar da gerekir:
Yükleme
.NET MAUI uygulamaları oluşturmak için en son Mac için Visual Studio gerekir:
Mac için Visual Studio 2022'yi yükleyin veya mevcut yüklemenizi değiştirin ve aşağıdaki iş yüklerinin yüklendiğinden emin olun:
- .NET
- .NET MAUI
- Android
- iOS
Önemli
Mac için Visual Studio 2022'nin yeni yüklemeleri için .NET MAUI iş yükünün seçilmesi, şu anda .NET MAUI geliştirmesi için gerekli olan Android ve iOS iş yüklerini otomatik olarak seçer.
.NET 8'i tek başına yükleyici aracılığıyla yükleyin.
.NET 8'in yüklenmesi tamamlandıktan sonra bir terminalde çalıştırın dotnet workload install maui
.
Önemli
.NET 8 ile Mac için Visual Studio kullanmak için Visual Studio Tercihleri Diğer Önizleme Özellikleri > Yüklüyse .NET 8 SDK'sını kullanın (yeniden başlatma gerektirir) onay kutusunu etkinleştirin.>>>
Şirket ortamında yüklerken ağ sorunu yaşıyorsanız güvenlik duvarı veya ara sunucu arkasında yükleme yönergelerini gözden geçirin.
Güvenlik duvarı veya ara sunucunun arkasına yükleme
Mac için Visual Studio 2022'yi bir güvenlik duvarının arkasına yüklemek için, yazılımınız için gerekli araçların ve güncelleştirmelerin indirilmesine izin vermek için belirli uç noktaların erişilebilir olması gerekir. Ağınızı gerekli uç noktalara erişime izin verecek şekilde yapılandırma hakkında daha fazla bilgi için bkz. Güvenlik duvarının veya ara sunucunun arkasındaki Mac için Visual Studio yükleme ve kullanma.
Not
Visual Studio Code'da .NET MAUI desteği hala önizleme aşamasındadır. Deneyin ve geri bildiriminizi paylaşın!
Visual Studio Code'u ve .NET MAUI uzantısını yükleme
Visual Studio Code’u yükleyin.
Uzantılar sekmesinde ".NET MAUI" araması yapın ve .NET MAUI uzantısını yükleyin. .NET MAUI uzantısı, .NET MAUI uzantısının çalışması için gereken C# Geliştirme Seti ve C# uzantılarını otomatik olarak yükler.
Not
.NET MAUI uzantısı için C# Dev Kit ve ön sürüm C# uzantıları gerekir. .NET MAUI uzantısının işlevselliğini kullanmak için C# Dev Kit'de oturum açmanız gerekir. C# Dev Kit ve uzantı ailesi hakkında daha fazla bilgi için bu blog gönderisine bakın.
.NET ve .NET MAUI iş yüklerini yükleme
.NET 8'i yükleyin.
Windows'ta, .NET ve .NET MAUI iş yükü yüklemelerini yönetmek için Visual Studio yükleyicisinin kullanılması önerilir. Visual Studio yükleyicisini kullanma yönergelerini burada bulabilirsiniz.
.NET MAUI iş yükünü yükleyin.
Windows ve macOS'ta terminalde aşağıdaki komutu çalıştırın:
dotnet workload install maui
Linux'ta terminalde aşağıdaki komutu çalıştırın:
dotnet workload install maui-android
Visual Studio Code'da bir .NET MAUI uygulamasında hata ayıklamak için geliştirme makinenizin işletim sistemi için geçerli bir hedef platforma sahip olmanız gerekir:
İşletim Sisteminiz |
Desteklenen Hedef Platformlar |
Windows |
Windows, Android |
macOS |
Android, iOS, macOS |
Linux |
Android |
iOS ve macOS
Visual Studio Code'da bir iOS veya macOS hedefinde hata ayıklamak için:
- Kullandığınız .NET MAUI sürümünün gerektirdiği Xcode sürümünü yükleyin. Daha fazla bilgi için bkz . Sürüm sürümleri. En son kararlı Xcode sürümü Mac App Store'dan indirilebilir.
- Xcode komut satırı araçlarını almak için bir terminalde komutunu çalıştırın
xcode-select --install
.
Android
Visual Studio Code'da bir Android hedefinde hata ayıklamak için:
- Microsoft OpenJDK 17'yi yükleyin.
- Aşağıdaki yaklaşımlardan biriyle Android SDK'sını yükleyin:
- (Önerilen) Yeni bir .NET MAUI projesi (
dotnet new maui
) oluşturun ve InstallAndroidDependencies hedefini kullanın.
- Visual Studio aracılığıyla yükleyin (yalnızca Windows).
- Android Studio aracılığıyla yükleyin.
- Linux'ta tercih ettiğiniz paket yöneticisi aracılığıyla yükleyin.
Sorun giderme
Visual Studio Code için .NET MAUI uzantısını ayarlarken sorunlarla karşılaşabilirsiniz. Aşağıdaki sorun giderme adımlarını takip ettikten sonra sorun yaşamaya devam ediyorsanız lütfen bir sorun bildirin.
Proje oluşturma
Yeni bir proje oluşturmaya çalışırsanız ve dosya gezgini sonsuz döngüde belirmeye devam ederse boş bir klasör seçmiyor olabilirsiniz. Gizli dosya veya klasör olup olmadığını denetleyin, yeni bir klasör oluşturun veya komutunu kullanarak dotnet new maui
komut satırından .NET MAUI uygulamanızı oluşturun.
InstallAndroidDependencies hedefini kullanma
.NET 8, Android ortamınızı sizin için ayarlamanıza yardımcı olan bir derleme hedefini barındırmıştır. Makinenizi yapılandırmak ve Android ortamınızı ayarlamak için terminalde aşağıdaki komutu çalıştırın:
dotnet build -t:InstallAndroidDependencies -f:net8.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
Yukarıdaki komutta:
AndroidSdkDirectory="<AndroidSdkPath>"
: Android bağımlılıklarını belirtilen mutlak yola yükler veya güncelleştirir.
- Windows: Önerilen AndroidSdkPath şöyledir
%LOCALAPPDATA%/Android/Sdk
: .
- MacOS: Önerilen AndroidSdkPath şeklindedir
$HOME/Library/Android/sdk
.
JavaSdkDirectory="<JavaSdkPath>"
: Belirtilen mutlak yola Java yükler.
AcceptAndroidSDKLicenses=True
: geliştirme için gerekli Android lisanslarını kabul eder.
Android SDK veya Java SDK'sının bulunamadığını belirten bir hata var
- Komut paletini (Ctrl/Cmd + Shift + P) açın ve komutu arayın
.NET MAUI: Configure Android
. Hem "Android SDK yolunu ayarla" hem de "Android JDK yolunu ayarla" seçeneğini belirleyin ve bunların her birinin yüklemelerine işaret ettiğini doğrulayın.
- Android SDK klasöründe ,
cmdline-tools
ve platform-tools
gibi build-tools
alt klasörler olmalıdır.
- Java OpenJDK klasöründe ,
lib
ve gibi bin
alt klasörler olmalıdır.
- Windows'da, Visual Studio aracılığıyla yüklerseniz Java SDK'sı ve
C:\Program Files\Microsoft\
Android SDK'sı içinde C:\Program Files (x86)\Android\android-sdk
olur.
- Ortam değişkenini
JAVA_HOME
geçerli bir Java OpenJDK yolu olarak ayarlayın.
- Ortam değişkenini
ANDROID_HOME
Android SDK yolunuz olarak ayarlayın.
- Yüklü Android bağımlılıklarının en düşük sürümlerini denetleyin:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- Platform; android-34*
- .NET 8: platform araçları = 34.0.5
Android lisanslarının kabul edildiğine dair bir hata var
Yükseltilmiş bir komut isteminde veya terminalde, Android SDK'nızın cmdline-tools/latest/bin/
klasörüne gidin ve cli sdkmanager --licenses
istemlerini izleyin.
Android bağımlılıklarım Çözüm Gezgini yüklenmiyor, ancak uygulamam sorunsuz bir şekilde derleniyor
Windows'a %APPDATA%
yüklerseniz bu bilinen bir sorundur ve gelecekteki bir sürümde düzeltilecektir.
iOS/Xcode Kurulumu
- Xcode bulunamadığını belirten bir hata alırsanız bir terminalde çalıştırın
xcode-select --install
ve Xcode yüklemenize işaret edenleri xcode-select -p
denetleyin.
- Sorun yaşamaya devam ediyorsanız doğru yüklendiğinden emin olmak için Xcode'un kendisini açın. Xcode açıldıktan sonra Xcode > Ayarlar > Konumları'na gidin ve Komut Satırı Araçları alanının doğru Xcode'a işaret edip etmediğini denetleyin.
- Bazen iOS/macOS uygulamanızın dağıtılması için iki kez oluşturmanız gereken bilinen bir sorun vardır. Bu, gelecek yayınlardan birinde düzeltilecektir.
Hata ayıklama sorunları
- Hata ayıklama birden çok nedenden dolayı başlatılamıyor olabilir. Çıkış penceresinde net bir hata yoksa, önce Visual Studio Code'da ".NET MAUI" çalıştırma yapılandırmasını kullanıp kullanmadığınızdan bir kez daha kontrol edin.
- Hatanın kodunuzla mı yoksa .NET MAUI uzantısıyla mı olduğunu görmek için terminalden bir komut satırı derlemesi deneyebilirsiniz. Örneğin, Android derlemenizin Visual Studio Code dışında başarılı olup olmadığını görmek için komutunu çalıştırabilirsiniz
dotnet build -f:net8.0-android
. Bu derleme başarılı olursa lütfen Sorun Bildirin
Bilinen Sınırlamalar
Bu uzantı hala erken önizleme aşamasındadır, bu nedenle bilinen bir dizi sınırlama vardır. Bu yeni deneyimi oluşturmaya devam ettiğimizde görmek istediğiniz diğer özelliklerle ilgili geri bildirimlerinizi bize gönderin.
- XAML düzenleme özellikleri çok basittir; temel söz dizimi vurgulama ve otomatik tamamlama özelliklerini alırsınız. Gelecek bir sürümde XAML deneyimini nasıl geliştirebileceğimizi araştırıyoruz.
- Şu anda IntelliSense için hedef çerçeveyi değiştiremezsiniz (yalnızca .csproj dosyanızda listelenen ilk hedef çerçeve için söz dizimi vurgulama gösterir). Bu özellik devam ediyor.
- XAML ve .NET Çalışırken Yeniden Yükleme şu anda desteklenmiyor.
- Bu uzantı henüz en son iOS ve Xcode betaları ile tam olarak test edilmemiştir.
Bu yeni deneyimi oluşturmaya devam ettiğimizde görmek istediğiniz diğer özelliklerle ilgili geri bildiriminizi bize bildirin!
Geri Bildirim Sağlama
Yeni bir sorun veya öneri göndermeden önce lütfen C# Geliştirme Seti SSS bölümünü okuyun ve mevcut Bilinen Sorunları denetleyin. Yardım > Raporu Sorunu iletişim kutusu aracılığıyla Visual Studio Code'un içinden önerileri ve sorunları dosyalayabilirsiniz. Açılan listeden "Bir uzantı" ve ardından .NET MAUI uzantısını seçtiğinizden emin olun.