1/*
2 * Copyright (C) 2011 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package com.android.ex.chips;
18
19import android.Manifest;
20import android.content.Context;
21import android.content.pm.PackageManager;
22import android.os.Build;
23import android.os.Process;
24import android.support.annotation.Nullable;
25
26public class ChipsUtil {
27
28    /**
29     * Listener that gets notified when we check whether we have permission.
30     */
31    public interface PermissionsCheckListener {
32        void onPermissionCheck(String permission, boolean granted);
33    }
34
35    /**
36     * Permissions required by Chips library.
37     */
38    public static final String[] REQUIRED_PERMISSIONS =
39            new String[] { Manifest.permission.READ_CONTACTS };
40
41    /**
42     * Returns true when the caller can use Chips UI in its environment.
43     */
44    public static boolean supportsChipsUi() {
45        return Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH;
46    }
47
48    /**
49     * Whether we are running on M or later version.
50     *
51     * <p>This is interesting for us because new permission model is introduced in M and we need to
52     * check if we have {@link #REQUIRED_PERMISSIONS}.
53     */
54    public static boolean isRunningMOrLater() {
55        return Build.VERSION.SDK_INT >= Build.VERSION_CODES.M;
56    }
57
58    /**
59     * Returns {@link PackageManager#PERMISSION_GRANTED} if given permission is granted, or
60     * {@link PackageManager#PERMISSION_DENIED} if not.
61     */
62    public static int checkPermission(Context context, String permission) {
63        if (isRunningMOrLater()) {
64            // TODO: Use "context.checkSelfPermission(permission)" once it's safe to move to M sdk
65            return context.checkPermission(permission, Process.myPid(), Process.myUid());
66        } else {
67            // Assume that we have permission before M.
68            return PackageManager.PERMISSION_GRANTED;
69        }
70    }
71
72    /**
73     * Returns true if all permissions in {@link #REQUIRED_PERMISSIONS} are granted.
74     *
75     * <p>If {@link PermissionsCheckListener} is specified it will be called for every
76     * {@link #checkPermission} call.
77     */
78    public static boolean hasPermissions(Context context,
79            @Nullable PermissionsCheckListener permissionsCheckListener) {
80        for (String permission : REQUIRED_PERMISSIONS) {
81            final boolean granted =
82                    checkPermission(context, permission) == PackageManager.PERMISSION_GRANTED;
83            if (permissionsCheckListener != null) {
84                permissionsCheckListener.onPermissionCheck(permission, granted);
85            }
86            if (!granted) {
87                return false;
88            }
89        }
90        return true;
91    }
92}
93