27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main
yerine android-latest-release
kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.
Tam ekran intent sınırları
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Reklam spam'ini ve kimlik bilgisi avını önlemek amacıyla Android 14'ten itibaren, tam ekran bildirim göndermeyle ilgili varsayılan USE_FULL_SCREEN_INTENT
izin yalnızca arama ve alarm işlevleri sağlayan uygulamalara verilebilir.
Android 14'te yüklenen tüm uygulamalarda USE_FULL_SCREEN_INTENT
izni varsayılan olarak etkindir. Google Play Store, yükleme işleminden sonra arama veya alarm işlevi olmayan uygulamaların tam ekran intent (FSI) iznini iptal eder.
Android 13 veya önceki sürümlerin yüklü olduğu telefonlara yüklenen uygulamalarda USE_FULL_SCREEN_INTENT
izni varsayılan olarak etkin kalır.
Kullanıcı izni
Android 14 ile uygulamalar, tam ekran bildirim gönderip gönderemeyeceklerini kontrol etmek için NotificationManager#canUseFullScreenIntent()
değerini kullanabilir. Uygulamalar, tam ekran bildirim göndermek için kullanıcı izni almak üzere ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT
kullanarak Şekil 1'de gösterildiği gibi Tam ekran intent'leri yönet ayarını başlatır:
Şekil 1. Uygulamaların tam ekran intent'ler göndermesini etkinleştirmek için kullanıcı arayüzü.
Tam ekran intent'leri yönetme ayarı, Özel Uygulama Erişimi bölümündeki Ayarlar menüsünde bulunur. Bu kullanıcı arayüzü sayesinde kullanıcılar gerekirse bu izni iptal edebilir.
OEM koşulları
Android 14'te, uygulamalar için FSI izinleri varsayılan olarak etkindir. OEM'ler, hangi uygulamaların FSI izinlerine uygun olduğunu belirtmelidir. OEM'ler, üçüncü taraf uygulama mağazalarının PackageInstaller.SessionParams
parametresini, özellikle de PERMISSION_STATE_DEFAULT
, PERMISSION_STATE_DENIED
ve PERMISSION_STATE_GRANTED
parametrelerini kullanarak uygulamalarının FSI izinlerinin ilk izin durumlarını ayarlamasını sağlamalıdır.
Doğrulama
FSI sınırlarını doğrulamak için NotificationFullScreenIntentVerifierActivity.java
'daki CTS Doğrulayıcı testini ve NotificationManagerTest.java
'daki CTS testini kullanın.
Manuel testler
Uygulamanızda FSI sınırlarını manuel olarak test etmek için aşağıdaki adımları uygulayın:
- Uygulamanızın
AndroidManifest.xml
dosyasında USE_FULL_SCREEN_INTENT
değerini beyan edin.
- FSI'yi etkinleştirmek veya devre dışı bırakmak için ayarları yönetmek üzere
ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT
simgesini kullanın.
- Test telefonunuzda, tam ekran bildirimler için kullanıcı iznini Şekil 1'de gösterildiği gibi manuel olarak açın veya kapatın.
- FSI bildirimi gönderin.
- Aşağıdaki FSI izni ve görüntüleme modu kombinasyonları için tam ekran bildirimin görünümünü doğrulayın:
FSI izni
|
Kilitli ekran
|
Kilitli ekran
|
Ekran dışında
|
Her zaman açık ekran (AOD)
|
Kullanıcı tarafından izin verildi
|
Hap düğmelerine sahip kalıcı uyarı bildirimi (HUN)
|
FSI'yi başlatma
|
FSI'yi başlatma
|
FSI'yi başlatma
|
Kullanıcı tarafından reddedildi
|
60 saniye boyunca hap düğmeleri olan HUN
|
Hap düğmeli HUN, listede 60 saniye boyunca ilk sırada gösteriliyor
|
AOD açılır, 60 saniye boyunca hap düğmeleriyle HUN gösterir
|
60 saniye boyunca hap düğmeleri olan HUN
|
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Full-screen intent limits\n\nTo prevent ad spam and credential phishing, starting with Android 14,\nthe default [`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission to send full-screen notifications can be granted only to apps that\nprovide calling and alarm functionalities.\n\nFor all apps being installed on Android 14, the\n[`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission is enabled by default. Upon installation, the Google Play Store\nrevokes the full-screen intent (FSI) permission for apps that do not have\ncalling or alarm functionalities.\n\nFor apps installed on phones running versions\nAndroid 13 or lower, the\n[`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT)\npermission remains enabled by default.\n\nUser permission\n---------------\n\nWith Android 14, apps can use [`NotificationManager#canUseFullScreenIntent()`](https://developer.android.com/reference/android/app/NotificationManager#canUseFullScreenIntent())\nto check if they can send full-screen notifications. To get user permission to\nsend full-screen notifications, apps use [`ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/provider/Settings#ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT)\nto launch the **Manage full screen intents** setting as shown in Figure 1:\n\n**Figure 1.** UI for enabling apps to send full-screen intents.\n\nThe **Manage full screen intents** setting is in the **Settings** menu under\n**Special App Access**. With this UI, users can revoke this permission if needed.\n\nOEM requirements\n----------------\n\nIn Android 14, FSI permissions for apps are enabled by\ndefault. OEMs must specify which apps qualify for FSI permissions. OEMs must\nensure that third-party app stores set the initial grant states of FSI\npermissions for their apps using\n[`PackageInstaller.SessionParams`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams),\nspecifically with the [`PERMISSION_STATE_DEFAULT`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_DEFAULT), [`PERMISSION_STATE_DENIED`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_DENIED), and [`PERMISSION_STATE_GRANTED`](https://developer.android.com/reference/android/content/pm/PackageInstaller.SessionParams#PERMISSION_STATE_GRANTED)\nparameters.\n\nValidation\n----------\n\nUse the CTS Verifier test in [`NotificationFullScreenIntentVerifierActivity.java`](https://android.googlesource.com/platform/cts/+/refs/heads/android16-release/apps/CtsVerifier/src/com/android/cts/verifier/notifications/NotificationFullScreenIntentVerifierActivity.java),\nand the CTS test in [`NotificationManagerTest.java`](https://cs.android.com/android/platform/superproject/+/android-latest-release:cts/tests/app/src/android/app/cts/NotificationManagerTest.java;drc=ed156b1d4a7d91675dba1adb9191a92cf439dab0;l=148)\nto validate the FSI limits.\n\n### Manual tests\n\nFollow these steps to manually test FSI limits on your app:\n\n1. Declare [`USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/Manifest.permission#USE_FULL_SCREEN_INTENT) in your app's `AndroidManifest.xml` file.\n2. Use [`ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT`](https://developer.android.com/reference/android/provider/Settings#ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT) to manage settings to turn FSI on or off.\n3. On your test phone, manually toggle the user permission for full-screen notifications as shown in Figure 1.\n4. Send an FSI notification.\n5. Validate the appearance of the full-screen notification for the following combinations of FSI permission and display modes:\n\n|--------------------|----------------------------------------------------------|----------------------------------------------------------|---------------------------------------------------|-------------------------------|\n| **FSI permission** | **Unlocked screen** | **Locked screen** | **Off screen** | **Always-on display (AOD)** |\n| Granted by user | Persistent heads-up notification (HUN) with pill buttons | Launch FSI | Launch FSI | Launch FSI |\n| Denied by user | HUN with pill buttons for 60s | HUN with pill buttons shows up first in the list for 60s | AOD turns on, shows HUN with pill buttons for 60s | HUN with pill buttons for 60s |"]]