WebView

iOS ve Mac Catalyst'te Uygulama Aktarım Güvenliğini Yapılandırma

Sürüm 9'dan bu yana iOS yalnızca uygulamanızın güvenli sunucularla iletişim kurmasına izin verir. Bir uygulamanın güvenli olmayan sunucularla iletişimi etkinleştirmeyi seçmesi gerekir.

Aşağıdaki Info.plist yapılandırması, belirli bir etki alanının Apple Aktarım Güvenliği (ATS) gereksinimlerini atlamak için nasıl etkinleştirileceği gösterir:

	<key>NSAppTransportSecurity</key>
	<dict>
		<key>NSExceptionDomains</key>
		<dict>
			<key>mydomain.com</key>
			<dict>
				<key>NSIncludesSubdomains</key>
				<true/>
				<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
				<true/>
				<key>NSTemporaryExceptionMinimumTLSVersion</key>
				<string>TLSv1.1</string>
			</dict>
		</dict>
	</dict>

Yalnızca belirli etki alanlarının ATS'yi atlamasına olanak tanımak ve güvenilir olmayan etki alanlarında ek güvenlikten yararlanırken güvenilen siteleri kullanmanıza olanak tanımak en iyi yöntemdir.

Aşağıdaki Info.plist yapılandırması, bir uygulama için ATS'yi devre dışı bırakma işlemini gösterir:

	<key>NSAppTransportSecurity</key>
	<dict>
		<key>NSAllowsArbitraryLoads</key>
		<true/>
	</dict>

Android'de izinleri işleme

Cihazın kamera veya mikrofon gibi kayıt donanımına erişim isteyen bir sayfaya göz atarken denetim tarafından WebView izin verilmelidir. Denetim, WebView izin isteklerine Android.Webkit.WebChromeClient tepki vermek için Android'de türünü kullanır. Ancak, WebChromeClient .NET MAUI tarafından sağlanan uygulama izin isteklerini yoksayar. İzin isteklerini devralan MauiWebChromeClient ve onaylayan yeni bir tür oluşturmanız gerekir.

Web sayfasından denetime yönelik WebView izin istekleri, .NET MAUI uygulamasından kullanıcıya yapılan izin isteklerinden farklıdır. .NET MAUI uygulama izinleri, tüm uygulama için kullanıcı tarafından istenir ve onaylar. Denetim WebView , uygulamaların donanıma erişme yeteneğine bağlıdır. Bu kavramı göstermek için cihazın kamerasına erişim isteyen bir web sayfası düşünün. Bu istek denetim tarafından WebView onaylanmış olsa bile .NET MAUI uygulamasının kameraya erişmek için kullanıcı tarafından onayı olmasa da web sayfası kameraya erişemez.

Aşağıdaki adımlar, kamerayı kullanmak için denetimden gelen izin isteklerinin WebView nasıl kesilip durdurulduğunu gösterir. Mikrofonu kullanmaya çalışıyorsanız, kamerayla ilgili izinler yerine mikrofonla ilgili izinleri kullanmanız dışında adımlar benzer olacaktır.

1. İlk olarak, Android bildirimine gerekli uygulama izinlerini ekleyin. Platformlar/Android/AndroidManifest.xml dosyasını açın ve düğüme manifest aşağıdakileri ekleyin:

   <uses-permission android:name="android.permission.CAMERA" />
   

2. Uygulamanızın belirli bir WebView noktasında, örneğin denetim içeren sayfa yüklendiğinde, uygulamanın kameraya erişmesine izin vermek için kullanıcıdan izin isteyin.

   private async Task RequestCameraPermission()
   {
       PermissionStatus status = await Permissions.CheckStatusAsync<Permissions.Camera>();
   
       if (status != PermissionStatus.Granted)
           await Permissions.RequestAsync<Permissions.Camera>();
   }
   

3. Aşağıdaki sınıfı Platforms/Android klasörüne ekleyerek kök ad alanını projenizin ad alanıyla eşleşecek şekilde değiştirin:

   using Android.Webkit;
   using Microsoft.Maui.Handlers;
   using Microsoft.Maui.Platform;
   
   namespace MauiAppWebViewHandlers.Platforms.Android;
   
   internal class MyWebChromeClient: MauiWebChromeClient
   {
       public MyWebChromeClient(IWebViewHandler handler) : base(handler)
       {
   
       }
   
       public override void OnPermissionRequest(PermissionRequest request)
       {
           // Process each request
           foreach (var resource in request.GetResources())
           {
               // Check if the web page is requesting permission to the camera
               if (resource.Equals(PermissionRequest.ResourceVideoCapture, StringComparison.OrdinalIgnoreCase))
               {
                   // Get the status of the .NET MAUI app's access to the camera
                   PermissionStatus status = Permissions.CheckStatusAsync<Permissions.Camera>().Result;
   
                   // Deny the web page's request if the app's access to the camera is not "Granted"
                   if (status != PermissionStatus.Granted)
                       request.Deny();
                   else
                       request.Grant(request.GetResources());
   
                   return;
               }
           }
   
           base.OnPermissionRequest(request);
       }
   }
   

   Önceki kod parçacığında MyWebChromeClient , sınıfı öğesinden MauiWebChromeClientdevralır ve web sayfası izin isteklerini kesmek için yöntemini geçersiz kılar OnPermissionRequest . Her izin öğesi, kamerayı temsil eden dize sabiti PermissionRequest.ResourceVideoCapture ile eşleşip eşleşmediğini görmek için denetlenir. Bir kamera izni eşleşirse kod, uygulamanın kamerayı kullanma izni olup olmadığını denetler. İzin varsa, web sayfasının isteği verilir.

4. Chrome istemcisini SetWebChromeClient MyWebChromeClientolarak ayarlamak için Android'in WebView denetimindeki yöntemini kullanın. Aşağıdaki iki öğe, chrome istemcisini nasıl ayarlayabileceğinizi gösterir:

   • adlı theWebViewControlbir .NET MAUI WebView denetimi verildiğinde chrome istemcisini doğrudan Android denetimi olan platform görünümünde ayarlayabilirsiniz:

     ((IWebViewHandler)theWebViewControl.Handler).PlatformView.SetWebChromeClient(new MyWebChromeClient((IWebViewHandler)theWebViewControl.Handler));
     

   • Ayrıca, tüm WebView denetimleri chrome istemcinizi kullanmaya zorlamak için işleyici özellik eşlemesini de kullanabilirsiniz. Daha fazla bilgi için bkz . İşleyiciler.

     Uygulama başlatıldığında aşağıdaki kod parçacığının CustomizeWebViewHandler yöntemi çağrılmalıdır, örneğin yönteminde MauiProgram.CreateMauiApp .

     private static void CustomizeWebViewHandler()
     {
     #if ANDROID26_0_OR_GREATER
         Microsoft.Maui.Handlers.WebViewHandler.Mapper.ModifyMapping(
             nameof(Android.Webkit.WebView.WebChromeClient),
             (handler, view, args) => handler.PlatformView.SetWebChromeClient(new MyWebChromeClient(handler)));
     #endif
     }
     

iOS ve Mac Catalyst üzerinde yerel WebView'ı yapılandırma

Yerel WebView denetim, sürümünden türetilen WKWebViewiOS ve Mac Catalyst üzerindedirMauiWKWebView. Oluşturucu aşırı yüklemelerinden MauiWKWebView biri, nesnenin nasıl yapılandırılacağı hakkında bilgi sağlayan bir WKWebViewConfiguration nesnenin belirtilmesine WKWebView olanak tanır. Tipik yapılandırmalar, kullanıcı aracısını ayarlamayı, web içeriğinizin kullanımına sunulacak tanımlama bilgilerini belirtmeyi ve web içeriğinize özel betikler eklemeyi içerir.

Uygulamanızda bir WKWebViewConfiguration nesne oluşturabilir ve ardından özelliklerini gerektiği gibi yapılandırabilirsiniz. Alternatif olarak statik yöntemini çağırarak MauiWKWebView.CreateConfiguration .NET MAUI'nin WKWebViewConfiguration nesnesini alabilir ve sonra değiştirebilirsiniz. Nesne WKWebViewConfiguration daha sonra oluşturucu aşırı yüklemesine MauiWKWebView bağımsız değişken olarak belirtilebilir.

İşleyicinin platform görünümü oluşturulduktan sonra iOS ve Mac Catalyst'te yerel WebView yapılandırma değiştirilebileceğinden, değiştirmek için özel bir işleyici fabrikası temsilcisi oluşturmanız gerekir:

#if IOS || MACCATALYST
using WebKit;
using CoreGraphics;
using Microsoft.Maui.Platform;
using Microsoft.Maui.Handlers;
#endif
...

#if IOS || MACCATALYST
    Microsoft.Maui.Handlers.WebViewHandler.PlatformViewFactory = (handler) =>
    {
        WKWebViewConfiguration config = MauiWKWebView.CreateConfiguration();
        config.ApplicationNameForUserAgent = "MyProduct/1.0.0";
        return new MauiWKWebView(CGRect.Empty, (WebViewHandler)handler, config);
    };
#endif

iOS ve Mac Catalyst'te medya kayıttan yürütme tercihlerini ayarlama

Otomatik yürütme ve resimdeki resim de dahil olmak üzere HTML5 videonun satır içi medya kayıttan yürütmesi, iOS ve Mac Catalyst üzerinde varsayılan olarak WebView etkindir. Bu varsayılanı değiştirmek veya diğer medya kayıttan yürütme tercihlerini ayarlamak için, işleyicinin platform görünümü oluşturulduktan sonra medya kayıttan yürütme tercihleri değiştirilebileceğinden özel bir işleyici fabrikası temsilcisi oluşturmanız gerekir. Aşağıdaki kodda bunun bir örneği gösterilmektedir:

#if IOS || MACCATALYST
using WebKit;
using CoreGraphics;
using Microsoft.Maui.Platform;
using Microsoft.Maui.Handlers;
#endif
...

#if IOS || MACCATALYST
    Microsoft.Maui.Handlers.WebViewHandler.PlatformViewFactory = (handler) =>
    {
        WKWebViewConfiguration config = MauiWKWebView.CreateConfiguration();

        // True to play HTML5 videos inliine, false to use the native full-screen controller.
        config.AllowsInlineMediaPlayback = false;

        // True to play videos over AirPlay, otherwise false.
        config.AllowsAirPlayForMediaPlayback = false;

        // True to let HTML5 videos play Picture in Picture.
        config.AllowsPictureInPictureMediaPlayback = false;

        // Media types that require a user gesture to begin playing.
        config.MediaTypesRequiringUserActionForPlayback = WKAudiovisualMediaTypes.All;

        return new MauiWKWebView(CGRect.Empty, (WebViewHandler)handler, config);
    };
#endif

iOS'ta yapılandırma WebView hakkında daha fazla bilgi için bkz . iOS ve Mac Catalyst'ta yerel WebView'ı yapılandırma.

Mac'te WebView Catalyst'i inceleme

Mac Catalyst'te safari WebView geliştirici araçlarını kullanarak içeriğini incelemek için aşağıdaki kodu uygulamanıza ekleyin:

#if MACCATALYST
        Microsoft.Maui.Handlers.WebViewHandler.Mapper.AppendToMapping("Inspect", (handler, view) =>
        {
            if (OperatingSystem.IsMacCatalystVersionAtLeast(16, 6))
                handler.PlatformView.Inspectable = true;
        });
#endif

Bu kod, içeriği Safari geliştirici araçları tarafından denetlenebilir hale getirmek WebView için WebViewHandler Mac Catalyst'in özellik eşleyicisini özelleştirir. İşleyiciler hakkında daha fazla bilgi için bkz . İşleyiciler.

Safari geliştirici araçlarını Mac Catalyst uygulamasıyla kullanmak için:

1. Mac bilgisayarınızda Safari'i açın.
2. Safari'de, menü çubuğunda Safari > Ayarları > Gelişmiş > Geliştirme menüsünü göster onay kutusunu seçin.
3. .NET MAUI Mac Catalyst uygulamanızı çalıştırın.
4. Safari'de, yer tutucunun gibi Macbook Procihaz adınız olduğu {Device name} {Cihaz adı} geliştir > menüsünü seçin. Ardından uygulama adınızın altındaki girdiyi seçerek çalışan uygulamanızı da vurgulayabilirsiniz. Bu, Web denetçisi penceresinin görünmesine neden olur.