Anthony Restaino
9 years ago
9 changed files with 24 additions and 244 deletions
@ -1,176 +0,0 @@ |
|||||||
package acr.browser.lightning.permissions; |
|
||||||
|
|
||||||
import android.app.Activity; |
|
||||||
import android.app.Fragment; |
|
||||||
import android.content.pm.PackageInfo; |
|
||||||
import android.content.pm.PackageManager; |
|
||||||
import android.os.Build; |
|
||||||
import android.os.Handler; |
|
||||||
import android.os.Looper; |
|
||||||
import android.support.annotation.NonNull; |
|
||||||
import android.support.annotation.Nullable; |
|
||||||
import android.support.v4.app.ActivityCompat; |
|
||||||
import android.util.Log; |
|
||||||
|
|
||||||
import java.util.ArrayList; |
|
||||||
import java.util.HashSet; |
|
||||||
import java.util.List; |
|
||||||
import java.util.Set; |
|
||||||
|
|
||||||
/** |
|
||||||
* A class to help you manage your permissions simply. |
|
||||||
*/ |
|
||||||
public final class PermissionsManager { |
|
||||||
|
|
||||||
private static final String TAG = PermissionsManager.class.getSimpleName(); |
|
||||||
private static final String[] EMPTY_PERMISSIONS = new String[0]; |
|
||||||
private static final PermissionsManager INSTANCE = new PermissionsManager(); |
|
||||||
|
|
||||||
private final Set<String> mPendingRequests = new HashSet<>(1); |
|
||||||
private final List<PermissionsResultAction> mPendingActions = new ArrayList<>(1); |
|
||||||
|
|
||||||
public static PermissionsManager getInstance() { |
|
||||||
return INSTANCE; |
|
||||||
} |
|
||||||
|
|
||||||
private PermissionsManager() {} |
|
||||||
|
|
||||||
/** |
|
||||||
* This method adds the {@link PermissionsResultAction} to the current list |
|
||||||
* of pending actions that will be completed when the permissions are |
|
||||||
* received. The list of permissions passed to this method are registered |
|
||||||
* in the PermissionsResultAction object so that it will be notified of changes |
|
||||||
* made to these permissions. |
|
||||||
* |
|
||||||
* @param permissions the required permissions for the action to be executed |
|
||||||
* @param action the action to add to the current list of pending actions |
|
||||||
*/ |
|
||||||
private synchronized void addPendingAction(@NonNull String[] permissions, @Nullable PermissionsResultAction action) { |
|
||||||
if (action == null) { |
|
||||||
return; |
|
||||||
} |
|
||||||
action.registerPermissions(permissions); |
|
||||||
mPendingActions.add(action); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* This method will request all the permissions declared in your application manifest |
|
||||||
* for the specified {@link PermissionsResultAction}. The purpose of this method is to enable |
|
||||||
* all permissions to be requested at one shot. The PermissionsResultAction is used to notify |
|
||||||
* you of the user allowing or denying each permission. The Activity and PermissionsResultAction |
|
||||||
* parameters are both annotated Nullable, but this method will not work if the Activity |
|
||||||
* is null. It is only annotated Nullable as a courtesy to prevent crashes in the case |
|
||||||
* that you call this from a Fragment where {@link Fragment#getActivity()} could yield |
|
||||||
* null. Additionally, you will not receive any notification of permissions being granted |
|
||||||
* if you provide a null PermissionsResultAction. |
|
||||||
* |
|
||||||
* @param activity the Activity necessary to request and check permissions. |
|
||||||
* @param action the PermissionsResultAction used to notify you of permissions being accepted. |
|
||||||
*/ |
|
||||||
public synchronized void requestAllManifestPermissionsIfNecessary(final @Nullable Activity activity, |
|
||||||
final @Nullable PermissionsResultAction action) { |
|
||||||
if (activity == null) { |
|
||||||
return; |
|
||||||
} |
|
||||||
Handler handler = new Handler(Looper.getMainLooper()); |
|
||||||
handler.post(new Runnable() { |
|
||||||
@Override |
|
||||||
public void run() { |
|
||||||
PackageInfo packageInfo = null; |
|
||||||
try { |
|
||||||
Log.d(TAG, activity.getPackageName()); |
|
||||||
packageInfo = activity.getPackageManager().getPackageInfo(activity.getPackageName(), PackageManager.GET_PERMISSIONS); |
|
||||||
} catch (PackageManager.NameNotFoundException e) { |
|
||||||
Log.e(TAG, "A problem occurred when retrieving permissions", e); |
|
||||||
} |
|
||||||
if (packageInfo != null) { |
|
||||||
String[] permissions = packageInfo.requestedPermissions; |
|
||||||
if (permissions != null) { |
|
||||||
for (String perm : permissions) { |
|
||||||
Log.d(TAG, "Requesting permission if necessary: " + perm); |
|
||||||
} |
|
||||||
} else { |
|
||||||
permissions = EMPTY_PERMISSIONS; |
|
||||||
} |
|
||||||
requestPermissionsIfNecessaryForResult(activity, permissions, action); |
|
||||||
} |
|
||||||
} |
|
||||||
}); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* This method should be used to execute a {@link PermissionsResultAction} for the array |
|
||||||
* of permissions passed to this method. This method will request the permissions if |
|
||||||
* they need to be requested (i.e. we don't have permission yet) and will add the |
|
||||||
* PermissionsResultAction to the queue to be notified of permissions being granted or |
|
||||||
* denied. In the case of pre-Android Marshmallow, permissions will be granted immediately. |
|
||||||
* The Activity variable is nullable, but if it is null, the method will fail to execute. |
|
||||||
* This is only nullable as a courtesy for Fragments where getActivity() may yeild null |
|
||||||
* if the Fragment is not currently added to its parent Activity. |
|
||||||
* |
|
||||||
* @param activity the activity necessary to request the permissions |
|
||||||
* @param permissions the list of permissions to request for the {@link PermissionsResultAction} |
|
||||||
* @param action the PermissionsResultAction to notify when the permissions are granted or denied |
|
||||||
*/ |
|
||||||
public synchronized void requestPermissionsIfNecessaryForResult(@Nullable Activity activity, |
|
||||||
@NonNull String[] permissions, |
|
||||||
@Nullable PermissionsResultAction action) { |
|
||||||
if (activity == null) { |
|
||||||
return; |
|
||||||
} |
|
||||||
addPendingAction(permissions, action); |
|
||||||
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) { |
|
||||||
for (String perm : permissions) { |
|
||||||
if (action != null) { |
|
||||||
if (ActivityCompat.checkSelfPermission(activity, perm) != PackageManager.PERMISSION_GRANTED) { |
|
||||||
action.onResult(perm, PackageManager.PERMISSION_DENIED); |
|
||||||
} else { |
|
||||||
action.onResult(perm, PackageManager.PERMISSION_GRANTED); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
} else { |
|
||||||
List<String> permList = new ArrayList<>(1); |
|
||||||
for (String perm : permissions) { |
|
||||||
if (ActivityCompat.checkSelfPermission(activity, perm) != PackageManager.PERMISSION_GRANTED) { |
|
||||||
if (!mPendingRequests.contains(perm)) { |
|
||||||
permList.add(perm); |
|
||||||
} |
|
||||||
} else { |
|
||||||
if (action != null) { |
|
||||||
action.onResult(perm, PackageManager.PERMISSION_GRANTED); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
if (!permList.isEmpty()) { |
|
||||||
String[] permsToRequest = permList.toArray(new String[permList.size()]); |
|
||||||
mPendingRequests.addAll(permList); |
|
||||||
ActivityCompat.requestPermissions(activity, permsToRequest, 1); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* This method notifies the PermissionsManager that the permissions have change. It should |
|
||||||
* be called from the Activity callback onRequestPermissionsResult() with the variables |
|
||||||
* passed to that method. It will notify all the pending PermissionsResultAction objects currently |
|
||||||
* in the queue, and will remove the permissions request from the list of pending requests. |
|
||||||
* |
|
||||||
* @param permissions the permissions that have changed |
|
||||||
* @param results the values for each permission |
|
||||||
*/ |
|
||||||
public synchronized void notifyPermissionsChange(@NonNull String[] permissions, @NonNull int[] results) { |
|
||||||
int size = permissions.length; |
|
||||||
if (results.length < size) { |
|
||||||
size = results.length; |
|
||||||
} |
|
||||||
for (int n = 0; n < size; n++) { |
|
||||||
for (PermissionsResultAction result : mPendingActions) { |
|
||||||
result.onResult(permissions[n], results[n]); |
|
||||||
mPendingRequests.remove(permissions[n]); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
|
|
||||||
} |
|
||||||
@ -1,57 +0,0 @@ |
|||||||
package acr.browser.lightning.permissions; |
|
||||||
|
|
||||||
import android.content.pm.PackageManager; |
|
||||||
import android.support.annotation.NonNull; |
|
||||||
|
|
||||||
import java.util.Collections; |
|
||||||
import java.util.HashSet; |
|
||||||
import java.util.Set; |
|
||||||
|
|
||||||
/** |
|
||||||
* This abstract class should be used to create an if/else action that the PermissionsManager |
|
||||||
* can execute when the permissions you request are granted or denied. Simple use involves |
|
||||||
* creating an anonymous instance of it and passing that instance to the |
|
||||||
* requestPermissionsIfNecessaryForResult method. The result will be sent back to you as |
|
||||||
* either onGranted (all permissions have been granted), or onDenied (a required permission |
|
||||||
* has been denied). Ideally you put your functionality in the onGranted method and notify |
|
||||||
* the user what won't work in the onDenied method. |
|
||||||
*/ |
|
||||||
public abstract class PermissionsResultAction { |
|
||||||
|
|
||||||
private final Set<String> mPermissions = new HashSet<>(1); |
|
||||||
|
|
||||||
public abstract void onGranted(); |
|
||||||
|
|
||||||
public abstract void onDenied(String permission); |
|
||||||
|
|
||||||
/** |
|
||||||
* This method is called when a particular permission has changed. |
|
||||||
* This method will be called for all permissions, so this method determines |
|
||||||
* if the permission affects the state or not and whether it can proceed with |
|
||||||
* calling onGranted or if onDenied should be called. |
|
||||||
* |
|
||||||
* @param permission the permission that changed |
|
||||||
* @param result the result for that permission |
|
||||||
*/ |
|
||||||
public synchronized final void onResult(String permission, int result) { |
|
||||||
if (result == PackageManager.PERMISSION_GRANTED) { |
|
||||||
mPermissions.remove(permission); |
|
||||||
if (mPermissions.isEmpty()) { |
|
||||||
onGranted(); |
|
||||||
} |
|
||||||
} else { |
|
||||||
onDenied(permission); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* This method registers the PermissionsResultAction object for the specified permissions |
|
||||||
* so that it will know which permissions to look for changes to. The PermissionsResultAction |
|
||||||
* will then know to look out for changes to these permissions. |
|
||||||
* |
|
||||||
* @param perms the permissions to listen for |
|
||||||
*/ |
|
||||||
public synchronized final void registerPermissions(@NonNull String[] perms) { |
|
||||||
Collections.addAll(mPermissions, perms); |
|
||||||
} |
|
||||||
} |
|
||||||
Loading…
Reference in new issue