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

Bu öğretici, .NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) kabuk uygulamasının nasıl oluşturulacağını gösteren serinin 2. bölümüdür. Bu serinin 1. Bölümünde bir uygulamayı kaydettiniz ve dış kiracınızda kullanıcı akışlarını yapılandırdık. Bu öğreticide bir .NET MAUI kabuk uygulaması oluşturma, MSAL SDK'sını başlatmak için özel bir Microsoft Kimlik Doğrulama Kitaplığı (MSAL) istemci yardımcısı ekleme, gerekli kitaplıkları yükleme ve görüntü kaynağı ekleme işlemleri gösterilmektedir.

Bu öğreticide şunları yapacaksınız:

• .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

• Öğretici: Dış kiracıda .NET MAUI uygulamasını kaydetme ve yapılandırma
• .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 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 Uygulama ş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ı maui oturumu açmak için 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ğrulamak ve bu api'lere erişmek için bir dış kiracıdan 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 uygulaması 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 işleyicileri, MSAL.NET günlüğe kaydetmenin 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 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ı sarmalama amacıyla tek bir uygulama içerir.
• WindowsHelper.cs - Bu dosya, pencere tutamacını almak için yöntemler 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 ve Yeni Klasör Ekle'yi>seçin. Klasöre MSALClient adını verin.
2. MSALClient klasörüne sağ tıklayın, Varolan ÖğeYi Ekle...'yi>seçin.
3. Daha önce indirdiğiniz MSALClient dosyalarını içeren klasöre gidin.
4. 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 ikili dosyalarını içerir (MSAL.NET).
• 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 kullanmak için şu adımları izleyin:

1. Çözüm için NuGet Paketlerini Yönet Paket Yöneticisi> Araçlar>NuGet'i 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ü indirmiş olursunuz.

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

• Simge: Microsoft Entra Id - 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, Resimler klasörünü gösteren Kaynaklar klasörünü genişletin.
2. Resimler'e sağ tıklayın ve Var Olan ÖğeYi Ekle>... öğesini 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 görüntüyü seçin.
6. Ekle'yi seçin.

Sonraki adım

3. Bölüm: Dış kiracı kullanarak .NET MAUI kabuk uygulamasında kullanıcılarla oturum açma