Öğretici: .NET MAUI kabuk uygulaması oluşturma

Bu öğreticide bir .NET Çok platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) kabuk uygulamasının nasıl oluşturulacağı gösterilmektedir. Ayrıca MSAL SDK'yı başlatmak, gerekli kitaplıkları yüklemek ve bir görüntü kaynağı eklemek için özel bir Microsoft Kimlik Doğrulama Kitaplığı (MSAL) istemci yardımcısı ekleyeceksiniz.

Bu öğreticide şunların nasıl yapıldığını öğreneceksiniz:

• Bir .NET MAUI kabuk uygulaması oluşturun.
• MSAL yardımcı sınıflarını kullanarak MSAL SDK desteği ekleyin.
• Gerekli paketleri yükleyin.
• Görüntü kaynağı ekleyin.

Önkoşullar

• .NET 7.0 SDK
• MAUI iş yükünün yüklü olduğu Visual Studio 2022:
  • Windows yönergeleri
  • macOS için yönergeler

.NET MAUI kabuk uygulaması oluşturma

1. Visual Studio 2022'nin başlangıç penceresinde Yeni proje oluştur'u seçin.
2. Yeni proje oluştur penceresinde, Tüm proje türleri açılan listesinde MAUI'yi seçin, .NET MAUI Uygulaması şablonunu seçin ve İleri'yi seçin.
3. Yeni projenizi yapılandırın penceresinde Proje adıSignInMaui olarak ayarlanmalıdır. Çözüm adınıoturum açma maui olarak güncelleştirin ve İleri'yi seçin.
4. Ek bilgiler penceresinde .NET 7.0'ı ve ardından Oluştur'u seçin.

Projenin oluşturulmasını ve bağımlılıklarının geri yüklenmesini bekleyin.

MSAL yardımcı sınıflarını kullanarak MSAL SDK desteği ekleme

MSAL istemcisi, geliştiricilerin güvenli web API'lerinin kimliğini doğrulaması ve erişmesi için müşterilerin kiracısının Microsoft Entra kimliğinden güvenlik belirteçleri almasını sağlar. Bu bölümde, MSALClient'ı oluşturan dosyaları indirirsiniz.

Aşağıdaki dosyaları bilgisayarınızdaki bir klasöre indirin:

• AzureAdConfig.cs - Bu dosya, uygulama yapılandırma dosyanızdan Microsoft Entra uygulama benzersiz tanımlayıcılarını alır ve ayarlar.
• DownStreamApiConfig.cs - Bu dosya Microsoft Graph çağrısının kapsamlarını alır ve ayarlar.
• DownstreamApiHelper.cs - Bu dosya, aşağı akış API'sini çağırırken oluşan özel durumları işler.
• Exception.cs - Bu dosya özel durum oluşturma ve işleme ile ilgili birkaç uzantı yöntemi sunar.
• IdentityLogger.cs - Bu dosya tanıtıcıları, MSAL.NET günlüğün nasıl kullanılacağını gösterir.
• MSALClientHelper.cs - Bu dosya MSAL SDK'sını başlatma yöntemlerini içerir.
• PlatformConfig.cs - Bu dosya belirli bir platformu işlemek için yöntemler içerir. Örneğin, Windows.
• PublicClientSingleton.cs - Bu dosya, platformlar için statik başlatma modelini desteklemek üzere MSALClient ve ilişkili sınıfları sarmalayan tekil bir uygulama içerir.
• WindowsHelper.cs - Bu dosya pencere tutamacını alma yöntemlerini içerir.

Önemli

MSALClient dosyalarını indirmeyi atlamayın, bu öğreticiyi tamamlamaları gerekir.

Visual Studio ile MSALClient dosyalarını taşıma

1. Çözüm Gezgini bölmesinde SignInMaui projesine sağ tıklayın veYeni Klasör Ekle'yi> seçin. Klasörü MSALClient olarak adlandırın.
2. MSALClient klasörüne sağ tıklayın,Varolan ÖğeYi Ekle...'yi> seçin.
3. Daha önce indirdiğiniz indirilen MSALClient dosyalarını içeren klasöre gidin.
4. İndirdiğiniz tüm MSALClient dosyalarını ve ardından Ekle'yi seçin

Gerekli paketleri yükleme

Aşağıdaki paketleri yüklemeniz gerekir:

• Microsoft.Identity.Client - Bu paket.NET için Microsoft Kimlik Doğrulama Kitaplığı'nın (MSAL.NET) ikili dosyalarını içerir.
• Microsoft.Extensions.Configuration.Json - Bu paket, Microsoft.Extensions.Configuration için JSON yapılandırma sağlayıcısı uygulamasını içerir.
• Microsoft.Extensions.Configuration.Binder - Bu paket, Microsoft.Extensions.Configuration için yapılandırma sağlayıcılarında bir nesneyi verilere bağlama işlevi içerir.
• Microsoft.Extensions.Configuration.Abstractions - Bu paket anahtar-değer çifti tabanlı yapılandırmanın özetlerini içerir.
• Microsoft.Identity.Client.Extensions.Msal - Bu paket .NET için Microsoft Kimlik Doğrulama Kitaplığı (MSAL.NET) uzantılarını içerir.

NuGet Paket Yöneticisi

Visual Studio'da Microsoft.Identity.Client paketini yüklemek üzere NuGet Paket Yöneticisi'ni kullanmak için şu adımları izleyin:

1. Araçlar>NuGet Paket Yöneticisi>Çözüm için NuGet Paketlerini Yönet... öğesini seçin.
2. Gözat sekmesinde Microsoft.Identity.Client'ı arayın.
3. Listeden Microsoft.Identity.Client'ı seçin.
4. Proje listesi bölmesinde SignInMaui'yi seçin.
5. Yükle'yi seçin.
6. Yüklemeyi doğrulamanız istenirse Tamam'ı seçin.

Kalan gerekli paketleri yüklemek için işlemi yineleyin.

Görüntü kaynağı ekleme

Bu bölümde, kullanıcıların bu resimle etkileşim kurma biçimini geliştirmek için uygulamanızda kullandığınız bir görüntüyü indirirsiniz.

Aşağıdaki görüntüyü indirin:

• Simge: Microsoft Entra Kimliği - Bu resim ana sayfada simge olarak kullanılır.

Visual Studio ile görüntüyü taşıma

1. Visual Studio'nun Çözüm Gezgini bölmesinde, Görüntüler klasörünü gösteren Kaynaklar klasörünü genişletin.
2. Resimler'e sağ tıklayın veVar Olan Öğeyi Ekle...'yi> seçin.
3. İndirilen görüntüleri içeren klasöre gidin.
4. Filtreyi dosya türü filtresi olarak Görüntü Dosyaları olarak değiştirin.
5. İndirdiğiniz resmi seçin.
6. Add (Ekle) seçeneğini belirleyin.

Sonraki adımlar

Öğretici: .NET MAUI kabuk uygulamasında kullanıcıların oturumunu açma