ImmutablePendingIntent
Overview
ImmutablePendingIntent provides
- methods that create immutability-safe PendingIntent
- lint to make an error when using methods that create PendingIntent
- quick fix that fixes to not use methods that create PendingIntent
Why need ImmutablePendingIntent
Apps targeting Android 12 and higher must specify either FLAG_IMMUTABLE or FLAG_MUTABLE when constructing a PendingIntent. More info: https://developer.android.com/about/versions/12/behavior-changes-12#pending-intent-mutability
methods
PendingIntent creation methods are unsafe because it is not clear whether the flags parameter specify either FLAG_IMMUTABLE or FLAG_MUTABLE flag or not.
ImmutablePendingIntent provides ImmutablePendingIntent.get~ and MutablePendingIntent.get~ methods that its flags is clearly either FLAG_IMMUTABLE or FLAG_MUTABLE.
lint
UnspecifiedImmutableFlag lint detects that create PendingIntent not specifying either FLAG_IMMUTABLE or FLAG_MUTABLE flag. But, UnspecifiedImmutableFlag lint cannot detect the flags passed as method parameter.
ImmutablePendingIntent provides lint to make an error when using methods that create PendingIntent.
quick fix
Quick fix doesn't provides by default.
ImmutablePendingIntent provides a quick fix that fixes to use either ImmutablePendingIntent.get~ or MutablePendingIntent.get~ methods.
Can you remember that you must specify either FLAG_IMMUTABLE or FLAG_MUTABLE to PendingIntent?
You can do now. But, a year later? Can your team member do? If you use ImmutablePendingIntent, you don't need to remember.
When using PendingIntent, PendingIntent creating methods occurs error by lint. You can fix it by quick fix.
Can you remember why you specified FLAG_MUTABLE to PendingIntent?
You can do now. But, a year later? Can your team member do? If you use ImmutablePendingIntent, you don't need to remember.
When using MutablePendingIntent, you should explain why to use MutablePendingIntent by specifying UseMutablePendingIntent annotation.
Usage
Dependency
repositories {
maven { url "https://jitpack.io" }
}
dependencies {
implementation 'com.github.wada811.ImmutablePendingIntent:ImmutablePendingIntent:x.y.z'
}
Quick Fix
- Hover your
PendingIntent.get~method. - Select either from two quick fixes below.
- Replace with ImmutablePendingIntent.get~
- Replace with MutablePendingIntent.get~
How to select immutable or mutable
See Create immutable pending intents whenever possible | Intents and Intent Filters | Android Developers
When using MutablePendingIntent, you should specify UseMutablePendingIntent annotation
In most cases, your app should create immutable PendingIntent. However, certain use cases require mutable PendingIntent.
When using MutablePendingIntent without specifying UseMutablePendingIntent annotation, lint makes an error.
You should explain why to use MutablePendingIntent by specifying UseMutablePendingIntent annotation.
@UseMutablePendingIntent(reason = UseMutablePendingIntent.Reason.YouMustSelectReason)
fun getActivity(context: Context, requestCode: Int, intent: Intent, flags: Int): PendingIntent {
return MutablePendingIntent.getActivity(context, requestCode, intent, flags)
}
0 Apr 27, 2022
1 Mar 8, 2022
644 Dec 26, 2022
14 Jul 25, 2022
6 Jan 3, 2023
234 Nov 14, 2022
2 Aug 8, 2022
2 Oct 3, 2022
0 Jan 4, 2022
598 Dec 31, 2022
12 Nov 27, 2022
2 Nov 7, 2022
285 Jan 3, 2023
1 Nov 27, 2021