From 2d2314a038d235d0b5a7aeca7d3c79d1183f6029 Mon Sep 17 00:00:00 2001 From: George Date: Wed, 1 Feb 2023 22:51:04 +0800 Subject: [PATCH] Add more details in the javadocs for getTagIntentAppPreferenceForUser Bug: 266675647 Bug: 244272155 Test: build pass Change-Id: Id5e177e8aa4b818bb15521907a7dfa915a9b12a6 --- core/java/android/nfc/NfcAdapter.java | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/core/java/android/nfc/NfcAdapter.java b/core/java/android/nfc/NfcAdapter.java index a980158a2e5e7..7378ac7638deb 100644 --- a/core/java/android/nfc/NfcAdapter.java +++ b/core/java/android/nfc/NfcAdapter.java @@ -2510,8 +2510,18 @@ public final class NfcAdapter { * *

This returns a mapping of package names for this user id to whether we dispatch Tag * intents to the package. {@link #ACTION_NDEF_DISCOVERED}, {@link #ACTION_TECH_DISCOVERED} or - * {@link #ACTION_TAG_DISCOVERED} will not be dispatched to an Activity if its package is - * disallowed. + * {@link #ACTION_TAG_DISCOVERED} will not be dispatched to an Activity if its package is + * mapped to {@code false}. + *

There are three different possible cases: + *

A package not being in the preference list. + * It does not contain any Tag intent filters or the user never triggers a Tag detection that + * matches the intent filter of the package. + *

A package being mapped to {@code true}. + * When a package has been launched by a tag detection for the first time, the package name is + * put to the map and by default mapped to {@code true}. The package will receive Tag intents as + * usual. + *

A package being mapped to {@code false}. + * The user chooses to disable this package and it will not receive any Tag intents anymore. * * @param userId the user to whom this preference list will belong to * @return a map of the UserId which indicates the mapping from package name to