İngilizce dilinde oku

Aracılığıyla paylaş


Xamarin.Essentials:İzinler

permissions sınıfı, çalışma zamanı izinlerini denetleme ve isteme olanağı sağlar.

Kullanmaya başlayın

Bu API'yi kullanmaya başlamak için kitaplığın projelerinizde düzgün yüklendiğinden ve ayarlandığından emin olmak için Xamarin.Essentials kullanmaya başlama kılavuzunu okuyun.

Bu API, Android'de çalışma zamanı izinlerini kullanır. Lütfen tam olarak başlatıldığından Xamarin.Essentials ve uygulamanızda izin işlemenin ayarlandığından emin olun.

Android projesinde MainLauncher veya başlatılan Xamarin.Essentials herhangi bir Activity proje yönteminde OnCreate başlatılmalıdır:

C#
protected override void OnCreate(Bundle savedInstanceState) 
{
    //...
    base.OnCreate(savedInstanceState);
    Xamarin.Essentials.Platform.Init(this, savedInstanceState); // add this line to your code, it may also be called: bundle
    //...
}    

Android'de çalışma zamanı izinlerini işlemek için herhangi Xamarin.Essentials bir OnRequestPermissionsResultalmalıdır. Aşağıdaki kodu tüm Activity sınıflara ekleyin:

C#
public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Android.Content.PM.Permission[] grantResults)
{
    Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);

    base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
}

İzinleri Kullanma

Sınıfınızda için Xamarin.Essentials bir başvuru ekleyin:

C#
using Xamarin.Essentials;

İzinleri Denetleme

bir iznin geçerli durumunu denetlemek için, durumunu almak için belirli izinle birlikte yöntemini kullanın CheckStatusAsync .

C#
var status = await Permissions.CheckStatusAsync<Permissions.LocationWhenInUse>();

Gerekli izin bildirilmemişse bir PermissionException oluşturulur.

İstekte bulunmadan önce iznin durumunu denetlemek en iyisidir. Kullanıcıdan hiç sorulmazsa her işletim sistemi farklı bir varsayılan durum döndürür. iOS döndürürken Unknown, diğerleri döndürür Denied. Durum böyleyse Granted başka aramalar yapmanıza gerek yoktur. iOS'ta durum böyleyse Denied , kullanıcıdan ayarlardaki izni değiştirmesini istemeniz gerekir ve Android'de, kullanıcının geçmişte izni zaten reddedip reddetmediğini algılamak için arayabilirsiniz ShouldShowRationale .

İzin İsteme

Kullanıcılardan izin istemek için, isteğin RequestAsync belirli izniyle birlikte yöntemini kullanın. Kullanıcı daha önce izin verdiyse ve iptal etmediyse, bu yöntem hemen döner Granted ve bir iletişim kutusu görüntülemez.

C#
var status = await Permissions.RequestAsync<Permissions.LocationWhenInUse>();

Gerekli izin bildirilmemişse bir PermissionException oluşturulur.

Bazı platformlarda bir izin isteğinin yalnızca tek bir kez etkinleştirilebileceğini unutmayın. Bir iznin Denied durumunda olup olmadığını denetlemek ve kullanıcıdan bunu el ile açmasını istemek için geliştirici tarafından başka istemler işlenmelidir.

İzin Durumu

veya kullanırken CheckStatusAsync RequestAsync , sonraki adımları belirlemek için kullanılabilecek bir PermissionStatus döndürülür:

  • Bilinmiyor - İzin bilinmeyen bir durumda
  • Reddedildi - Kullanıcı izin isteğini reddetti
  • Devre dışı - Özellik cihazda devre dışı bırakıldı
  • Verildi - Kullanıcıya izin verildi veya otomatik olarak verildi
  • Kısıtlı - Kısıtlı durumda

İznin neden gerekli olduğunu açıklama

Uygulamanızın neden belirli bir izne ihtiyacı olduğunu açıklamak en iyi yöntemdir. iOS'ta kullanıcıya görüntülenecek bir dize belirtmeniz gerekir. Android'in bu özelliği yoktur ve ayrıca izin durumunu Devre Dışı olarak varsayılan olarak kullanır. Bu, kullanıcının izni reddedip reddetmediğini veya kullanıcıdan ilk kez isteyip istemediğini anlama becerisini sınırlar. ShouldShowRationale yöntemi, bir eğitim kullanıcı arabiriminin görüntülenip görüntülenmediğini belirlemek için kullanılabilir. Yöntemin döndürmesinin true nedeni, kullanıcının geçmişte izni reddetmesi veya devre dışı bırakmış olmasıdır. Bu yöntem çağrılırken diğer platformlar her zaman döndürülecektir false .

Kullanılabilir İzinler

Xamarin.Essentials mümkün olduğunca çok izni soyutlama girişiminde bulunur. Ancak, her işletim sisteminin farklı bir çalışma zamanı izinleri kümesi vardır. Ayrıca, bazı izinler için tek bir API sağlarken farklılıklar vardır. Şu anda kullanılabilir izinler için bir kılavuz aşağıdadır:

Simge Kılavuzu:

  • Tam Destek -Destekli
  • Desteklenmiyor - Desteklenmiyor/gerekli
İzin Android iOS UWP watchOS tvOS Tizen
CalendarRead Desteklenen Android Desteklenen iOS UWP desteklenmiyor desteklenen watchOS tvOS desteklenmiyor Tizen desteklenmiyor
Takvim Yaz Desteklenen Android Desteklenen iOS UWP desteklenmiyor desteklenen watchOS tvOS desteklenmiyor Tizen desteklenmiyor
Kamera Desteklenen Android Desteklenen iOS UWP desteklenmiyor watchOS desteklenmiyor tvOS desteklenmiyor Desteklenen Tizen
KişilerRead Desteklenen Android Desteklenen iOS UWP desteklenir watchOS desteklenmiyor tvOS desteklenmiyor Tizen desteklenmiyor
Kişiler Yazma Desteklenen Android Desteklenen iOS UWP desteklenir watchOS desteklenmiyor tvOS desteklenmiyor Tizen desteklenmiyor
El Feneri Desteklenen Android iOS desteklenmiyor UWP desteklenmiyor watchOS desteklenmiyor tvOS desteklenmiyor Desteklenen Tizen
LocationWhenInUse Desteklenen Android Desteklenen iOS UWP desteklenir desteklenen watchOS desteklenen tvOS Desteklenen Tizen
LocationAlways Desteklenen Android Desteklenen iOS UWP desteklenir desteklenen watchOS tvOS desteklenmiyor Desteklenen Tizen
Medya Android desteklenmiyor Desteklenen iOS UWP desteklenmiyor watchOS desteklenmiyor tvOS desteklenmiyor Tizen desteklenmiyor
Mikrofon Desteklenen Android Desteklenen iOS UWP desteklenir watchOS desteklenmiyor tvOS desteklenmiyor Desteklenen Tizen
Phone Desteklenen Android Desteklenen iOS UWP desteklenmiyor watchOS desteklenmiyor tvOS desteklenmiyor Tizen desteklenmiyor
Fotoğraflar Android desteklenmiyor Desteklenen iOS UWP desteklenmiyor watchOS desteklenmiyor desteklenen tvOS Tizen desteklenmiyor
Anımsatıcılar Android desteklenmiyor Desteklenen iOS UWP desteklenmiyor desteklenen watchOS tvOS desteklenmiyor Tizen desteklenmiyor
Algılayıcılar Desteklenen Android Desteklenen iOS UWP desteklenir desteklenen watchOS tvOS desteklenmiyor Tizen desteklenmiyor
SMS Desteklenen Android Desteklenen iOS UWP desteklenmiyor watchOS desteklenmiyor tvOS desteklenmiyor Tizen desteklenmiyor
Konuşma Desteklenen Android Desteklenen iOS UWP desteklenmiyor watchOS desteklenmiyor tvOS desteklenmiyor Tizen desteklenmiyor
StorageRead Desteklenen Android iOS desteklenmiyor UWP desteklenmiyor watchOS desteklenmiyor tvOS desteklenmiyor Tizen desteklenmiyor
StorageWrite Desteklenen Android iOS desteklenmiyor UWP desteklenmiyor watchOS desteklenmiyor tvOS desteklenmiyor Tizen desteklenmiyor

İzin olarak desteklenmiyor işaretlenirse, her zaman işaretlendiğinde veya istendiğinde döndürülecektir Granted .

Genel Kullanım

Aşağıdaki kod, bir iznin verilip verilmediğini belirlemek için genel kullanım desenini sunar ve verilmemişse istekte bulunur. Bu kod, sürüm 1.6.0 veya üzeri ile Xamarin.Essentials kullanılabilen özellikleri kullanır.

C#
public async Task<PermissionStatus> CheckAndRequestLocationPermission()
{
    var status = await Permissions.CheckStatusAsync<Permissions.LocationWhenInUse>();
    
    if (status == PermissionStatus.Granted)
        return status;        
    
    if (status == PermissionStatus.Denied && DeviceInfo.Platform == DevicePlatform.iOS)
    {
        // Prompt the user to turn on in settings
        // On iOS once a permission has been denied it may not be requested again from the application
        return status;
    }
    
    if (Permissions.ShouldShowRationale<Permissions.LocationWhenInUse>())
    {
        // Prompt the user with additional information as to why the permission is needed
    }   

    status = await Permissions.RequestAsync<Permissions.LocationWhenInUse>();

    return status;
}

Her izin türü, yöntemlerin doğrudan çağrılabileceği bir örneğine sahip olabilir.

C#
public async Task GetLocationAsync()
{
    var status = await CheckAndRequestPermissionAsync(new Permissions.LocationWhenInUse());
    if (status != PermissionStatus.Granted)
    {
        // Notify user permission was denied
        return;
    }

    var location = await Geolocation.GetLocationAsync();
}

public async Task<PermissionStatus> CheckAndRequestPermissionAsync<T>(T permission)
            where T : BasePermission
{
    var status = await permission.CheckStatusAsync();
    if (status != PermissionStatus.Granted)
    {
        status = await permission.RequestAsync();
    }

    return status;
}

İzinleri Genişletme

İzinler API'si, içinde olmayan Xamarin.Essentialsek doğrulama veya izinler gerektiren uygulamalar için esnek ve genişletilebilir olacak şekilde oluşturulmuştur. öğesinden BasePermission devralan yeni bir sınıf oluşturun ve gerekli soyut yöntemleri uygulayın.

C#
public class MyPermission : BasePermission
{
    // This method checks if current status of the permission
    public override Task<PermissionStatus> CheckStatusAsync()
    {
        throw new System.NotImplementedException();
    }

    // This method is optional and a PermissionException is often thrown if a permission is not declared
    public override void EnsureDeclared()
    {
        throw new System.NotImplementedException();
    }

    // Requests the user to accept or deny a permission
    public override Task<PermissionStatus> RequestAsync()
    {
        throw new System.NotImplementedException();
    }
}

Belirli bir platformda bir izin uygulanırken sınıfı BasePlatformPermission öğesinden devralınabilir. Bu, bildirimleri otomatik olarak denetlemek için ek platform yardımcı yöntemleri sağlar. Bu, gruplandırmalar için özel izinler oluştururken yardımcı olabilir. Örneğin, aşağıdaki özel izni kullanarak Android'de depolamaya hem Okuma hem de Yazma erişimi isteyebilirsiniz.

C#
public class ReadWriteStoragePermission : Xamarin.Essentials.Permissions.BasePlatformPermission
{
    public override (string androidPermission, bool isRuntime)[] RequiredPermissions => new List<(string androidPermission, bool isRuntime)>
    {
        (Android.Manifest.Permission.ReadExternalStorage, true),
        (Android.Manifest.Permission.WriteExternalStorage, true)
    }.ToArray();
}

Ardından Android projesinden yeni izninizi çağırabilirsiniz.

C#
await Permissions.RequestAsync<ReadWriteStoragePermission>();

Bu API'yi paylaşılan kodunuzdan çağırmak isterseniz bir arabirim oluşturabilir ve bir bağımlılık hizmeti kullanarak kaydolabilir ve uygulamayı alabilirsiniz.

C#
public interface IReadWritePermission
{        
    Task<PermissionStatus> CheckStatusAsync();
    Task<PermissionStatus> RequestAsync();
}

Ardından platform projenizde arabirimini uygulayın:

C#
public class ReadWriteStoragePermission : Xamarin.Essentials.Permissions.BasePlatformPermission, IReadWritePermission
{
    public override (string androidPermission, bool isRuntime)[] RequiredPermissions => new List<(string androidPermission, bool isRuntime)>
    {
        (Android.Manifest.Permission.ReadExternalStorage, true),
        (Android.Manifest.Permission.WriteExternalStorage, true)
    }.ToArray();
}

Ardından belirli bir uygulamayı kaydedebilirsiniz:

C#
DependencyService.Register<IReadWritePermission, ReadWriteStoragePermission>();

Ardından, paylaşılan projenizden çözümleyebilir ve kullanabilirsiniz:

C#
var readWritePermission = DependencyService.Get<IReadWritePermission>();
var status = await readWritePermission.CheckStatusAsync();
if (status != PermissionStatus.Granted)
{
    status = await readWritePermission.RequestAsync();
}

Platform Uygulama Özellikleri

İzinler, Android Bildirim dosyasında ayarlanmış eşleşen özniteliklere sahip olmalıdır. İzin durumu varsayılan olarak Reddedildi olarak değişir.

Xamarin.Android'de İzinler belgeleri hakkında daha fazla bilgi edinin.

API

Channel 9 ve YouTube'da daha fazla Xamarin videosu bulun.