Hızlı Başlangıç: Android'de .NET MAUI (Windows)

Kısa cevap: Visual Studio 2022 (17.6+) yükleyin, .NET 8 ve Android SDK (API 34+) ile "Mobile development with .NET" iş yükünü ekleyin, sanallaştırmayı etkinleştirin, Android Device Manager üzerinden bir öykünücü oluşturun ve .NET MAUI App şablonunu çalıştırın — uygulama derlenip öykünücüde veya cihazda çalışacaktır. Aşağıda adım adım ve gereksiz detaylar olmadan anlatılmıştır.

Gereksinimler ve hazırlık

• Windows 10/11 (19041+), 64-bit, BIOS'ta sanallaştırma etkin (Intel VT-x / AMD-V).
• RAM: en az 8 GB (16 GB önerilir). SSD tercih edilir.
• "Mobile development with .NET" iş yüküyle birlikte Visual Studio 2022 v17.6+.
• .NET 8 SDK ve Android SDK (Android 14 için API 34+).
• Donanım hızlandırma: Hyper-V veya Windows Hypervisor Platform (Intel/AMD için) ya da HAXM (kullanılıyorsa).

MAUI için Visual Studio ve bileşenlerin kurulması

1. Visual Studio Installer'ı açın → Seçili kurulumu Modify edin.
2. İş yükünü seçin: .NET Multi-platform App UI development (Mobile development with .NET).
3. Sağ panelde şunları işaretleyin:
   • .NET 8.0 SDK
   • Android SDK (API 34+)
   • Android SDK Build-Tools
   • Android Emulator
4. Modify/Update düğmesine tıklayın ve kurulumun tamamlanmasını bekleyin (ağ hızına bağlı olarak 10–30 dakika).
5. Visual Studio'yu yeniden başlatın. Tools → Options → Xamarin → Android Settings altında Android SDK yolunu kontrol edin (genellikle C:\Program Files (x86)\Android\android-sdk).

Kontrol edin: File → New → Project → .NET MAUI App — şablon görünmelidir.

Android öykünücüsünün yapılandırılması

1. Visual Studio'da: Tools → Android → Android Device Manager.
2. New Device → bir profil seçin (örneğin Pixel 6) API 34, ABI x86_64 ile.
3. Ayarları yapın: RAM 4096 MB, Internal Storage 6 GB, Hardware Acceleration etkin.
4. Kaydedin ve öykünücüyü başlatın — ilk yükleme zaman alabilir (imaj indirme işlemi).

Hızlı imaj seçim tablosu:

İlk projenin oluşturulması ve çalıştırılması

1. File → New → Project → .NET MAUI App. Örnek olarak MauiFirstApp adını verin.
2. MainPage.xaml dosyasını açın — şablonda zaten bir Label ve Button bulunur.
3. Debug yapılandırmasının yanındaki açılır listeden öykünücüyü seçin ve Run (F5) düğmesine basın.
4. Proje derlenecek, seçilen cihaza yüklenecek ve çalıştırılacaktır.

Düğme işleyicisi örneği (MainPage.xaml.cs):

int count = 0;
private void OnCounterClicked(object sender, EventArgs e)
{
    CounterBtn.Text = $"Clicked {++count}!";
}

Notlar:

• İlk derleme, AOT ve imaj kurulumu nedeniyle daha uzun sürer.
• Geliştirme hızını artırmak için XAML Hot Reload'u etkinleştirin: sağ araç çubuğu → Enable XAML Hot Reload.

Sık karşılaşılan hatalar ve çözümleri

• "Android SDK not found": Tools → Options → Xamarin → Android Settings altında yolu manuel olarak belirtin veya bileşeni Installer aracılığıyla yeniden yükleyin.
• Öykünücü donuyor/çöküyor: İmajı değiştirin (API 33), farklı bir ABI ile AVD'yi yeniden oluşturun veya fiziksel bir cihaz kullanın.
• Cihaza kurulum sırasında DEP6200 / UWP/sürücü sorunları: Cihazda Developer Mode'u etkinleştirin ve USB sürücülerini yükleyin (Windows Device Manager).
• Sanallaştırma sorunları: BIOS'ta VT-x/AMD-V'yi etkinleştirin, Windows Features altında Hyper-V veya WHP özelliğini açın.

SSS

• Android uygulamaları derlemek için macOS gerekli mi? Hayır — Android için Windows yeterlidir. iOS için macOS gerekir.
• Derleme süresi nasıl azaltılır? Artımlı derlemeleri etkinleştirin, x86_64 imajı kullanın ve SSD tercih edin.
• MAUI Hot Restart'ı destekliyor mu? Evet, hızlı kod değişiklikleri için Hot Reload/Hot Restart'ı etkinleştirin (yerel değişiklikler için sınırlamalar devam eder).

Bu plan, ortamı hazırlamanızı ve ilk .NET MAUI Android uygulamanızı 30–60 dakika içinde çalıştırmanızı sağlayacaktır. Daha sonra Blazor Hybrid, grafik API'leri ve APK/AAB yayınlama konularını inceleyebilirsiniz.