Alarm kur

Alarmlar şu özelliklere sahiptir:

• Belirli zamanlarda ve/veya aralıklarla Intent'leri tetiklemenize olanak tanır.

• Diğer işlemleri gerçekleştirmek için işler planlamak veya WorkRequest'ler göndermek amacıyla yayın alıcılarıyla birlikte kullanabilirsiniz.

• Bu hizmetler, uygulamanızın dışında çalışır. Bu nedenle, uygulamanız çalışmadığında veya cihaz uykudayken bile etkinlikleri veya işlemleri tetiklemek için bu hizmetleri kullanabilirsiniz.

• Bu özellikler, uygulamanızın kaynak gereksinimlerini en aza indirmenize yardımcı olur. Zamanlayıcılara veya sürekli çalışan hizmetlere gerek kalmadan işlemleri planlayabilirsiniz.

Tam saat olmayan bir alarm ayarlama

Bir uygulama yanlış alarm ayarladığı zaman sistem, alarmı gelecekte bir noktada verir. Tam olarak doğru olmayan alarmlar, Dinlenme gibi pil tasarrufu kısıtlamalarına uyarken alarmın teslimat zamanlaması konusunda bazı garantiler sağlar.

Geliştiriciler, tam olmayan alarm yayınının zamanlamasını özelleştirmek için aşağıdaki API garantilerinden yararlanabilir.

Belirli bir zamandan sonra alarm gönderme

Uygulamanız set(), setInexactRepeating() veya setAndAllowWhileIdle() çağrısı yaparsa alarm, belirtilen tetikleyici zamanından önce hiçbir zaman çalmaz.

Android 12 (API düzeyi 31) ve sonraki sürümlerde, pil tasarrufu veya Dinlenme gibi pil tasarrufu kısıtlamaları geçerli olmadığı sürece sistem, alarmı sağlanan tetikleme zamanından itibaren bir saat içinde çağırır.

Belirli bir zaman aralığında alarm gönderme

Uygulamanız setWindow() çağrısı yaparsa alarm, sağlanan tetikleme zamanından önce hiçbir zaman çalmaz. Pil tasarrufu kısıtlamaları geçerli değilse alarm, belirtilen tetikleyici zamandan itibaren belirtilen zaman aralığında gönderilir.

Uygulamanız Android 12 veya sonraki sürümleri hedefliyorsa sistem, zaman aralığıyla ilişkilendirilmiş tam olmayan alarmın çağrılmasını en az 10 dakika geciktirebilir. Bu nedenle, 600000 altındaki windowLengthMillis parametre değerleri 600000 değerine kırpılır.

Yaklaşık olarak düzenli aralıklarla tekrarlanan bir alarm gönderme

Uygulamanız setInexactRepeating() çağrısı yaparsa sistem birden fazla alarmı tetikler:

1. İlk alarm, belirtilen tetikleme zamanından itibaren belirtilen zaman aralığında çalar.
2. Sonraki alarmlar genellikle belirtilen zaman aralığı geçtikten sonra çalar. Alarmın art arda iki kez çağrılması arasındaki süre değişiklik gösterebilir.

Tam alarm ayarlama

Sistem, gelecekte belirli bir anda tam alarm çağırır.

Çoğu uygulama, çeşitli yaygın kullanım alanlarını tamamlamak için tam olmayan alarmlar kullanarak görevler ve etkinlikler planlayabilir. Uygulamanızın temel işlevi, tam olarak zamanlanmış bir alarma (ör. çalar saat uygulaması veya takvim uygulaması) bağlıysa bunun yerine tam alarm kullanabilirsiniz.

Tam alarm gerektirmeyen kullanım alanları

Aşağıdaki listede, tam alarm gerektirmeyen yaygın iş akışları gösterilmektedir:

Uygulamanızın kullanım süresi boyunca zamanlama işlemlerini planlama

Handler sınıfı, uygulamanız çalışırken n saniyede bir işlem yapma gibi zamanlama işlemlerini gerçekleştirmek için birkaç iyi yöntem içerir: postAtTime() ve postDelayed(). Bu API'lerin gerçek zamanlı değil, sistem çalışma süresine bağlı olduğunu unutmayın.

Uygulamanızı güncelleme ve günlük yükleme gibi planlanmış arka plan işleri

WorkManager, zamana duyarlı periyodik çalışmaları planlama olanağı sunar. Çalışmanın ayrıntılı çalışma süresini tanımlamak için bir tekrarlama aralığı ve flexInterval (minimum 15 dakika) sağlayabilirsiniz.

Belirli bir süre sonra yapılması gereken, kullanıcı tarafından belirtilen işlem (sistem boş durumda olsa bile)

Yaklaşık alarm kullanın. Özellikle setAndAllowWhileIdle() numaralı telefonu arayın.

Belirli bir zamandan sonra gerçekleşmesi gereken, kullanıcı tarafından belirtilen işlem

Yaklaşık alarm kullanın. Özellikle set() numaralı telefonu arayın.

Belirli bir zaman aralığında gerçekleşebilecek, kullanıcı tarafından belirtilen işlem

Yaklaşık alarm kullanın. Özellikle setWindow() numaralı telefonu arayın. Uygulamanız Android 12 veya sonraki sürümleri hedefliyorsa izin verilen en kısa pencere uzunluğunun 10 dakika olduğunu unutmayın.

Tam alarm ayarlama yöntemleri

Uygulamanız, aşağıdaki yöntemlerden birini kullanarak tam alarm ayarlayabilir. Bu yöntemler, listenin alt kısmına yakın olan yöntemler daha zamana duyarlı görevler yerine getirecek ancak daha fazla sistem kaynağı gerektirecek şekilde sıralanır.

setExact()

Diğer pil tasarrufu önlemleri etkin olmadığı sürece gelecekte neredeyse tam olarak istediğiniz saatte alarm kurma

Uygulamanızın çalışması kullanıcı için zaman açısından kritik değilse tam alarm ayarlamak için bu yöntemi kullanın.

setExactAndAllowWhileIdle()

Pil tasarrufu önlemleri etkin olsa bile gelecekte neredeyse tam olarak istediğiniz saatte alarm çalabilirsiniz.

setAlarmClock()

Gelecekte belirli bir zamanda alarm çağırabilirsiniz. Bu alarmlar kullanıcılar tarafından çok net bir şekilde görülebildiğinden sistem, teslimat zamanlarını hiçbir zaman ayarlamaz. Sistem bu alarmları en kritik alarmlar olarak tanımlar ve alarmları iletmek için gerekirse düşük güç modlarını bırakır.

Sistem kaynağı tüketimi

Sistem, uygulamanızın ayarladığını tam olarak uyan alarmları tetiklediğinde cihaz, özellikle de güç tasarrufu modundaysa pil ömrü gibi çok fazla kaynak tüketir. Ayrıca sistem, kaynakları daha verimli kullanmak için bu istekleri kolayca gruplandıramaz.

Mümkün olduğunda yaklaşık alarm oluşturmanız önemle tavsiye edilir. Daha uzun süreli işler yapmak için alarmınızın BroadcastReceiver bölümünden WorkManager veya JobScheduler simgesini kullanarak planlayınBroadcastReceiver. Cihaz Uyku modundayken iş yapmak için setAndAllowWhileIdle() kullanarak tam olmayan bir alarm oluşturun ve alarmdan bir iş başlatın.

Uygun tam alarm iznini beyan edin

Uygulamanız Android 12 veya sonraki sürümleri hedefliyorsa "Alarmlar ve hatırlatıcılar" özel uygulama erişimini almanız gerekir. Bunu yapmak için aşağıdaki kod snippet'inde gösterildiği gibi uygulamanızın manifest dosyasında SCHEDULE_EXACT_ALARM iznini beyan edin:

<manifest ...>
    <uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM"/>
    <application ...>
        ...
    </application>
</manifest>

Uygulamanız Android 13 (API düzeyi 33) veya sonraki sürümleri hedefliyorsa SCHEDULE_EXACT_ALARM veya USE_EXACT_ALARM iznini beyan edebilirsiniz.

<manifest ...>
    <uses-permission android:name="android.permission.USE_EXACT_ALARM"/>
    <application ...>
        ...
    </application>
</manifest>

Hem SCHEDULE_EXACT_ALARM hem de USE_EXACT_ALARM izinleri aynı özellikleri belirtse de farklı şekilde verilir ve farklı kullanım alanlarını destekler. Uygulamanız tam alarmları kullanmalı ve yalnızca kullanıcılara yönelik bir işlevi tam olarak zamanlanmış işlemler gerektiriyorsa SCHEDULE_EXACT_ALARM veya USE_EXACT_ALARM iznini beyan etmelidir.

USE_EXACT_ALARM

• Otomatik olarak verilir
• Kullanıcı tarafından iptal edilemez.
• Yakında yayınlanacak bir Google Play politikasına tabidir.
• Sınırlı kullanım alanları

SCHEDULE_EXACT_ALARM

• Kullanıcı tarafından izin verildi
• Daha geniş bir kullanım alanı yelpazesi
• Uygulamalar, iznin iptal edilmediğini onaylamalıdır.

SCHEDULE_EXACT_ALARM izni, Android 13'ü (API düzeyi 33) ve sonraki sürümleri hedefleyen uygulamaların yeni yüklemelerine önceden verilmez. Kullanıcı, yedekleme ve geri yükleme işlemiyle uygulama verilerini Android 14 çalıştıran bir cihaza aktarırsa yeni cihazda SCHEDULE_EXACT_ALARM izni reddedilir. Ancak mevcut bir uygulamada bu izin zaten varsa cihaz Android 14'e yükseltildiğinde önceden verilir.

Not: Tam alarm, setExact API gibi bir OnAlarmListener nesnesi kullanılarak ayarlanırsa SCHEDULE_EXACT_ALARM izni gerekli değildir.

SCHEDULE_EXACT_ALARM iznini kullanma

USE_EXACT_ALARM'ün aksine SCHEDULE_EXACT_ALARM izninin kullanıcı tarafından verilmesi gerekir. SCHEDULE_EXACT_ALARM izni hem kullanıcı hem de sistem tarafından iptal edilebilir.

Uygulamanıza iznin verilip verilmediğini kontrol etmek için tam alarm ayarlamaya çalışmadan önce canScheduleExactAlarms() işlevini çağırın. Uygulamanız için SCHEDULE_EXACT_ALARM izni iptal edildiğinde uygulamanız durur ve gelecekteki tüm tam alarmlar iptal edilir. Bu, canScheduleExactAlarms() tarafından döndürülen değerin uygulamanızın yaşam döngüsünün tamamı için geçerli olduğu anlamına da gelir.

Uygulamanıza SCHEDULE_EXACT_ALARMS izni verildiğinde sistem, ACTION_SCHEDULE_EXACT_ALARM_PERMISSION_STATE_CHANGED yayınını gönderir. Uygulamanız, aşağıdakileri yapan bir yayın alıcısı uygulamalıdır:

1. Uygulamanızın özel uygulama erişimine sahip olduğunu onaylar. Bunun için canScheduleExactAlarms() numaralı telefonu arayın. Bu kontrol, kullanıcının uygulamanıza izin verip hemen ardından izni iptal etmesi durumunda uygulamanızı korur.
2. Uygulamanızın ihtiyaç duyduğu tam alarmları, mevcut durumuna göre yeniden planlar. Bu mantık, uygulamanızın ACTION_BOOT_COMPLETED yayını aldığında yaptığı işleme benzer olmalıdır.

Kullanıcılardan SCHEDULE_EXACT_ALARM iznini vermelerini isteme

Gerekirse kullanıcıları, Şekil 1'de gösterildiği gibi sistem ayarlarındaki Alarmlar ve hatırlatıcılar ekranına yönlendirebilirsiniz. Bunun için aşağıdaki adımları uygulayın:

1. Uygulamanızın kullanıcı arayüzünde, uygulamanızın neden tam alarmlar planlaması gerektiğini kullanıcıya açıklayın.
2. ACTION_REQUEST_SCHEDULE_EXACT_ALARM intent işlemini içeren bir intent çağırın.

Tekrarlanan alarm ayarlama

Yinelenen alarmlar, sistemin uygulamanızı tekrarlanan bir programda bilgilendirmesine olanak tanır.

Kötü tasarlanmış bir alarm, pilin tükenmesine neden olabilir ve sunuculara önemli ölçüde yük bindirebilir. Bu nedenle, Android 4.4 (API düzeyi 19) ve sonraki sürümlerde tekrarlanan tüm alarmlar yanlış alarmlardır.

Tekrarlanan alarmlar aşağıdaki özelliklere sahiptir:

• Alarm türü. Daha fazla bilgi için Alarm türü seçme başlıklı makaleyi inceleyin.

• Tetikleyici zaman. Belirttiğiniz tetikleyici zamanı geçmişteyse alarm hemen tetiklenir.

• Alarmın aralığı. Örneğin, günde bir kez, her saat veya her 5 dakikada bir.

• Alarm tetiklendiğinde tetiklenen bekleyen bir intent. Beklemedeki aynı intent'i kullanan ikinci bir alarm ayarladığınızda bu alarm, orijinal alarmın yerini alır.

Bir PendingIntent()'ü iptal etmek için FLAG_NO_CREATE değerini PendingIntent.getService()'e göndererek intent örneğini (varsa) alın, ardından bu intent'i AlarmManager.cancel()'e gönderin.

val alarmManager =
    context.getSystemService(Context.ALARM_SERVICE) as? AlarmManager
val pendingIntent =
    PendingIntent.getService(context, requestId, intent,
                                PendingIntent.FLAG_NO_CREATE)
if (pendingIntent != null && alarmManager != null) {
  alarmManager.cancel(pendingIntent)
}

AlarmManager alarmManager =
    (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
PendingIntent pendingIntent =
    PendingIntent.getService(context, requestId, intent,
                                PendingIntent.FLAG_NO_CREATE);
if (pendingIntent != null && alarmManager != null) {
  alarmManager.cancel(pendingIntent);
}

Alarm türü seçin

Tekrar eden alarm kullanırken dikkat etmeniz gereken ilk nokta, alarmın türü olmalıdır.

Alarmlar için iki genel saat türü vardır: "geçen gerçek zaman" ve "gerçek zamanlı saat" (RTC). Geçen gerçek zaman, referans olarak "sistemin başlatılmasından bu yana geçen süreyi" kullanır. Gerçek zamanlı saat ise UTC (duvar saati) saatini kullanır. Bu, geçen gerçek sürenin, saat dilimine veya yerel ayara bağlı olmadığından, sürenin geçmesine göre alarm ayarlamak için (ör. 30 saniyede bir tetiklenen bir alarm) uygun olduğu anlamına gelir. Gerçek zamanlı saat türü, mevcut yerel ayara bağlı alarmlar için daha uygundur.

Her iki türde de ekran kapalıysa cihazın CPU'sunun uyandırılmasını söyleyen bir"uyandırma" sürümü vardır. Bu, alarmın planlanan zamanda tetiklenmesini sağlar. Bu, uygulamanızın zamana bağlı olması durumunda kullanışlıdır. Örneğin, belirli bir işlemi gerçekleştirmek için sınırlı bir zaman aralığı varsa. Alarm türünüzün uyandırma sürümünü kullanmıyorsanız tekrarlanan tüm alarmlar, cihazınız bir sonraki sefer uyanık olduğunda tetiklenir.

Alarmınızın belirli bir aralıkta (örneğin, yarım saatte bir) tetiklenmesi yeterliyse geçen gerçek zaman türlerinden birini kullanın. Genel olarak bu daha iyi bir seçimdir.

Alarmınızın günün belirli bir saatinde tetiklenmesi gerekiyorsa saate dayalı gerçek zamanlı saat türlerinden birini seçin. Ancak bu yaklaşımın bazı dezavantajları olabileceğini unutmayın. Uygulama diğer yerel ayarlara iyi çevrilemeyebilir ve kullanıcı cihazın saat ayarını değiştirirse uygulamanızda beklenmedik davranışlara neden olabilir. Gerçek zamanlı saat alarmı türü kullanmak da yukarıda belirtildiği gibi ölçeklendirme açısından iyi değildir. Mümkünse "geçen gerçek zaman" alarmı kullanmanızı öneririz.

Türlerin listesi aşağıda verilmiştir:

• ELAPSED_REALTIME: Beklemede olan intent'i, cihazın başlatılmasından itibaren geçen süreye göre tetikler ancak cihazı uyandırmaz. Geçen süre, cihazın uykuda olduğu süreyi içerir.

• ELAPSED_REALTIME_WAKEUP: Cihazı uyandırır ve cihazın açılmasından itibaren belirtilen süre geçtikten sonra bekleyen intent'i tetikler.

• RTC: Beklemede olan intent'i belirtilen zamanda tetikler ancak cihazı uyandırmaz.

• RTC_WAKEUP: Beklemede olan intent'i belirtilen zamanda tetiklemek için cihazı uyandırır.

Geçen gerçek zamanlı alarm örnekleri

ELAPSED_REALTIME_WAKEUP kullanmaya yönelik bazı örnekler aşağıda verilmiştir.

Alarmın 30 dakika sonra ve sonraki her 30 dakikada bir çalacak şekilde cihazı uyandırın:

// Hopefully your alarm will have a lower frequency than this!
alarmMgr?.setInexactRepeating(
        AlarmManager.ELAPSED_REALTIME_WAKEUP,
        SystemClock.elapsedRealtime() + AlarmManager.INTERVAL_HALF_HOUR,
        AlarmManager.INTERVAL_HALF_HOUR,
        alarmIntent
)

// Hopefully your alarm will have a lower frequency than this!
alarmMgr.setInexactRepeating(AlarmManager.ELAPSED_REALTIME_WAKEUP,
        SystemClock.elapsedRealtime() + AlarmManager.INTERVAL_HALF_HOUR,
        AlarmManager.INTERVAL_HALF_HOUR, alarmIntent);

Bir dakika içinde tek seferlik (tekrarlanmayan) bir alarmın tetiklenmesi için cihazı uyandırın:

private var alarmMgr: AlarmManager? = null
private lateinit var alarmIntent: PendingIntent
...
alarmMgr = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager
alarmIntent = Intent(context, AlarmReceiver::class.java).let { intent ->
    PendingIntent.getBroadcast(context, 0, intent, 0)
}

alarmMgr?.set(
        AlarmManager.ELAPSED_REALTIME_WAKEUP,
        SystemClock.elapsedRealtime() + 60 * 1000,
        alarmIntent
)

private AlarmManager alarmMgr;
private PendingIntent alarmIntent;
...
alarmMgr = (AlarmManager)context.getSystemService(Context.ALARM_SERVICE);
Intent intent = new Intent(context, AlarmReceiver.class);
alarmIntent = PendingIntent.getBroadcast(context, 0, intent, 0);

alarmMgr.set(AlarmManager.ELAPSED_REALTIME_WAKEUP,
        SystemClock.elapsedRealtime() +
        60 * 1000, alarmIntent);

Gerçek zamanlı saat alarmı örnekleri

RTC_WAKEUP öğesinin kullanımına ilişkin bazı örnekler aşağıda verilmiştir.

Alarmı yaklaşık 14:00'te tetiklemek için cihazı uyandırın ve aynı saatte günde bir kez tekrarlayın:

// Set the alarm to start at approximately 2:00 p.m.
val calendar: Calendar = Calendar.getInstance().apply {
    timeInMillis = System.currentTimeMillis()
    set(Calendar.HOUR_OF_DAY, 14)
}

// With setInexactRepeating(), you have to use one of the AlarmManager interval
// constants--in this case, AlarmManager.INTERVAL_DAY.
alarmMgr?.setInexactRepeating(
        AlarmManager.RTC_WAKEUP,
        calendar.timeInMillis,
        AlarmManager.INTERVAL_DAY,
        alarmIntent
)

// Set the alarm to start at approximately 2:00 p.m.
Calendar calendar = Calendar.getInstance();
calendar.setTimeInMillis(System.currentTimeMillis());
calendar.set(Calendar.HOUR_OF_DAY, 14);

// With setInexactRepeating(), you have to use one of the AlarmManager interval
// constants--in this case, AlarmManager.INTERVAL_DAY.
alarmMgr.setInexactRepeating(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(),
        AlarmManager.INTERVAL_DAY, alarmIntent);

Alarmı tam olarak 08:30'ta ve sonrasında her 20 dakikada bir tetiklemek için cihazı uyandırın:

private var alarmMgr: AlarmManager? = null
private lateinit var alarmIntent: PendingIntent
...
alarmMgr = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager
alarmIntent = Intent(context, AlarmReceiver::class.java).let { intent ->
    PendingIntent.getBroadcast(context, 0, intent, 0)
}

// Set the alarm to start at 8:30 a.m.
val calendar: Calendar = Calendar.getInstance().apply {
    timeInMillis = System.currentTimeMillis()
    set(Calendar.HOUR_OF_DAY, 8)
    set(Calendar.MINUTE, 30)
}

// setRepeating() lets you specify a precise custom interval--in this case,
// 20 minutes.
alarmMgr?.setRepeating(
        AlarmManager.RTC_WAKEUP,
        calendar.timeInMillis,
        1000 * 60 * 20,
        alarmIntent
)

private AlarmManager alarmMgr;
private PendingIntent alarmIntent;
...
alarmMgr = (AlarmManager)context.getSystemService(Context.ALARM_SERVICE);
Intent intent = new Intent(context, AlarmReceiver.class);
alarmIntent = PendingIntent.getBroadcast(context, 0, intent, 0);

// Set the alarm to start at 8:30 a.m.
Calendar calendar = Calendar.getInstance();
calendar.setTimeInMillis(System.currentTimeMillis());
calendar.set(Calendar.HOUR_OF_DAY, 8);
calendar.set(Calendar.MINUTE, 30);

// setRepeating() lets you specify a precise custom interval--in this case,
// 20 minutes.
alarmMgr.setRepeating(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(),
        1000 * 60 * 20, alarmIntent);

Alarmınızın ne kadar hassas olması gerektiğine karar verin

Daha önce de açıklandığı gibi, alarm oluşturmanın ilk adımı genellikle alarm türünü seçmektir. Bir diğer ayrım da alarmınızın ne kadar hassas olması gerektiğidir. Çoğu uygulama için setInexactRepeating() doğru seçimdir. Bu yöntemi kullandığınızda Android, birden fazla tam olmayan tekrarlanan alarmı senkronize eder ve aynı anda tetikler. Bu sayede pil daha az harcar.

Mümkünse tam alarm kullanmaktan kaçının. Ancak katı zaman koşullarına sahip nadir uygulamalar için setRepeating() çağrısını yaparak tam alarm ayarlayabilirsiniz.

setInexactRepeating() ile setRepeating()'te yapabildiğiniz gibi özel bir aralık belirtemezsiniz. INTERVAL_FIFTEEN_MINUTES, INTERVAL_DAY vb. gibi aralık sabitlerinden birini kullanmanız gerekir. Tam liste için AlarmManager bölümünü inceleyin.

Bir alarmı iptal etme

Uygulamanıza bağlı olarak alarmı iptal etme özelliğini ekleyebilirsiniz. Bir alarmı iptal etmek için Alarm Yöneticisi'nde cancel() işlevini çağırın ve artık tetiklenmesini istemediğiniz PendingIntent değerini iletin. Örnek:

// If the alarm has been set, cancel it.
alarmMgr?.cancel(alarmIntent)

// If the alarm has been set, cancel it.
if (alarmMgr!= null) {
    alarmMgr.cancel(alarmIntent);
}

Cihaz yeniden başlatıldığında alarm başlatma

Bir cihaz kapandığında varsayılan olarak tüm alarmlar iptal edilir. Bunun olmasını önlemek için uygulamanızı, kullanıcı cihazı yeniden başlattığında tekrarlanan alarmı otomatik olarak yeniden başlatacak şekilde tasarlayabilirsiniz. Bu sayede AlarmManager, kullanıcının alarmı manuel olarak yeniden başlatması gerekmeden görevini yapmaya devam eder.

İlgili adımlar aşağıdadır:

1. Uygulamanızın manifest dosyasında RECEIVE_BOOT_COMPLETED izinini ayarlayın. Bu, uygulamanızın sistem açılışı tamamlandıktan sonra yayınlanan ACTION_BOOT_COMPLETED'i almasına olanak tanır (bu yalnızca uygulama kullanıcı tarafından en az bir kez başlatılmışsa çalışır):

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

2. Aşağıdaki adımları uygulayarak yayını alın:BroadcastReceiver

   Kotlin

   class SampleBootReceiver : BroadcastReceiver() {
   
       override fun onReceive(context: Context, intent: Intent) {
           if (intent.action == "android.intent.action.BOOT_COMPLETED") {
               // Set the alarm here.
           }
       }
   }
   

   Java

   public class SampleBootReceiver extends BroadcastReceiver {
   
       @Override
       public void onReceive(Context context, Intent intent) {
           if (intent.getAction().equals("android.intent.action.BOOT_COMPLETED")) {
               // Set the alarm here.
           }
       }
   }
   

3. Alıcının, ACTION_BOOT_COMPLETED işlemine göre filtreleyen bir intent filtresiyle uygulamanızın manifest dosyasına eklenmesini sağlayın:

   <receiver android:name=".SampleBootReceiver"
           android:enabled="false">
       <intent-filter>
           <action android:name="android.intent.action.BOOT_COMPLETED"></action>
       </intent-filter>
   </receiver>

   Manifestte önyükleme alıcısının android:enabled="false" olarak ayarlandığını unutmayın. Bu, uygulama açıkça etkinleştirmediği sürece alıcının çağrılmayacağı anlamına gelir. Bu, önyükleme alıcısının gereksiz yere çağrılmasını önler. Alıcının etkinleştirilmesini (ör. kullanıcı alarm ayarlarsa) aşağıdaki şekilde sağlayabilirsiniz:

   Kotlin

   val receiver = ComponentName(context, SampleBootReceiver::class.java)
   
   context.packageManager.setComponentEnabledSetting(
           receiver,
           PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
           PackageManager.DONT_KILL_APP
   )
   

   Java

   ComponentName receiver = new ComponentName(context, SampleBootReceiver.class);
   PackageManager pm = context.getPackageManager();
   
   pm.setComponentEnabledSetting(receiver,
           PackageManager.COMPONENT_ENABLED_STATE_ENABLED,
           PackageManager.DONT_KILL_APP);
   

   Alıcıyı bu şekilde etkinleştirdiğinizde, kullanıcı cihazı yeniden başlatsa bile alıcı etkin kalır. Başka bir deyişle, alıcıyı programatik olarak etkinleştirmek, yeniden başlatmalarda bile manifest ayarını geçersiz kılar. Alıcı, uygulamanız devre dışı bırakana kadar etkin kalır. Alıcılar (ör. kullanıcı bir alarmı iptal ederse) aşağıdaki şekilde devre dışı bırakılabilir:

   Kotlin

   val receiver = ComponentName(context, SampleBootReceiver::class.java)
   
   context.packageManager.setComponentEnabledSetting(
           receiver,
           PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
           PackageManager.DONT_KILL_APP
   )
   

   Java

   ComponentName receiver = new ComponentName(context, SampleBootReceiver.class);
   PackageManager pm = context.getPackageManager();
   
   pm.setComponentEnabledSetting(receiver,
           PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
           PackageManager.DONT_KILL_APP);
   

Cihaz Uyku modundayken alarmları tetikleme

Android 6.0 (API düzeyi 23) yüklü cihazlar, cihazın pil ömrünü uzatmaya yardımcı olan Dinlenme modunu destekler. Cihaz Dinlenme modundayken alarmlar çalmıyor. Planlanmış alarmlar, cihaz Dinlenme modundan çıkana kadar erteleniyor. Cihaz boştayken bile çalışmayı tamamlamanız gerekiyorsa birkaç seçeneğiniz vardır:

• Tam saat alarmı ayarlayın.

• Arka planda çalışma yapmak için tasarlanmış WorkManager API'yi kullanın. Sistemin, çalışmanın bir an önce tamamlanması için çalışmanızı hızlandırmasını belirtebilirsiniz. Daha fazla bilgi için WorkManager ile görevleri planlama başlıklı makaleyi inceleyin.

En iyi uygulamalar

Tekrarlanan alarmınızı tasarlarken yaptığınız her seçim, uygulamanızın sistem kaynaklarını kullanma (veya kötüye kullanma) şeklini etkileyebilir. Örneğin, bir sunucuyla senkronize olan popüler bir uygulamayı düşünün. Senkronizasyon işlemi saate bağlıysa ve uygulamanın her örneği 23:00'te senkronize ediliyorsa sunucudaki yük yüksek gecikmeye veya hatta "hizmet reddi" durumuna neden olabilir. Alarmları kullanırken aşağıdaki en iyi uygulamalardan yararlanın:

• Tekrarlanan bir alarm sonucunda tetiklenen tüm ağ isteklerine rastgelelik (jitter) ekleyin:

  • Alarm tetiklendiğinde yerel işlem yapabilirsiniz. "Yerel çalışma", bir sunucuya hitap etmeyen veya sunucudaki verileri gerektirmeyen her şey anlamına gelir.

  • Aynı zamanda, ağ isteklerini içeren alarmı rastgele bir zamanda tetiklenecek şekilde planlayın.

• Alarm sıklığınızı minimumda tutun.

• Cihazı gereksiz yere uyandırmayın (bu davranış, Alarm türü seçme bölümünde açıklandığı gibi alarm türüne göre belirlenir).

• Alarmınızın tetiklenme zamanını olması gerekenden daha hassas bir şekilde ayarlamayın.

  setRepeating() yerine setInexactRepeating() kullanın. setInexactRepeating() simgesini kullandığınızda Android, birden fazla uygulamadaki tekrarlanan alarmları senkronize eder ve aynı anda çalar. Bu sayede sistem, cihazı uyandırması gereken toplam süre azalır ve pil tüketimi azaltılır. Android 4.4 (API düzeyi 19) itibarıyla, tekrarlanan tüm alarmlar yanlış alarm olarak kabul edilir. setInexactRepeating(), setRepeating()'e kıyasla bir iyileştirme olsa da bir uygulamanın her örneği sunucuya yaklaşık olarak aynı anda ulaşırsa sunucunun aşırı yüke maruz kalabileceğini unutmayın. Bu nedenle, ağ istekleri için daha önce de belirtildiği gibi alarmlarınıza biraz rastgelelik ekleyin.

• Mümkünse alarmınızı saate göre ayarlamamaya çalışın.

  Tam tetikleme zamanına dayalı tekrarlanan alarmlar ölçeklendirmeye uygun değildir. Mümkünse ELAPSED_REALTIME kullanın. Farklı alarm türleri aşağıdaki bölümde daha ayrıntılı olarak açıklanmıştır.