1 /*
2  * Copyright (C) 2013 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 
17 package com.example.android.apprestrictions;
18 
19 import android.app.Activity;
20 import android.content.Context;
21 import android.content.SharedPreferences;
22 import android.os.Bundle;
23 import android.os.UserManager;
24 import android.preference.PreferenceManager;
25 import android.view.View;
26 import android.widget.CheckBox;
27 import android.widget.TextView;
28 
29 /**
30  * This is the main user interface of the App Restrictions sample app.  It demonstrates the use
31  * of the App Restriction feature, which is available on Android 4.3 and above tablet devices
32  * with the multiuser feature.
33  *
34  * When launched under the primary User account, you can toggle between standard app restriction
35  * types and custom.  When launched under a restricted profile, this activity displays app
36  * restriction settings, if available.
37  *
38  * Follow these steps to exercise the feature:
39  * 1. If this is the primary user, go to Settings > Users.
40  * 2. Create a restricted profile, if one doesn't exist already.
41  * 3. Open the profile settings, locate the sample app, and tap the app restriction settings
42  *    icon. Configure app restrictions for the app.
43  * 4. In the lock screen, switch to the user's restricted profile, launch this sample app,
44  *    and see the configured app restrictions displayed.
45  */
46 public class MainActivity extends Activity {
47     private Bundle mRestrictionsBundle;
48 
49     // Checkbox to indicate whether custom or standard app restriction types are selected.
50     private CheckBox mCustomConfig;
51 
52     public static final String CUSTOM_CONFIG_KEY = "custom_config";
53 
54     private TextView mMultiEntryValue;
55     private TextView mChoiceEntryValue;
56     private TextView mBooleanEntryValue;
57 
58     @Override
onCreate(Bundle savedInstanceState)59     protected void onCreate(Bundle savedInstanceState) {
60         super.onCreate(savedInstanceState);
61 
62         // Sets up  user interface elements.
63         setContentView(R.layout.main);
64 
65         mCustomConfig = (CheckBox) findViewById(R.id.custom_app_limits);
66         final boolean customChecked =
67                 PreferenceManager.getDefaultSharedPreferences(this).getBoolean(
68                         CUSTOM_CONFIG_KEY, false);
69         if (customChecked) mCustomConfig.setChecked(true);
70 
71         mMultiEntryValue = (TextView) findViewById(R.id.multi_entry_id);
72         mChoiceEntryValue = (TextView) findViewById(R.id.choice_entry_id);
73         mBooleanEntryValue = (TextView) findViewById(R.id.boolean_entry_id);
74     }
75 
76     @Override
onResume()77     protected void onResume() {
78         super.onResume();
79 
80         // If app restrictions are set for this package, when launched from a restricted profile,
81         // the settings are available in the returned Bundle as key/value pairs.
82         mRestrictionsBundle =
83                 ((UserManager) getSystemService(Context.USER_SERVICE))
84                         .getApplicationRestrictions(getPackageName());
85         if (mRestrictionsBundle == null) {
86             mRestrictionsBundle = new Bundle();
87         }
88 
89         // Reads and displays values from a boolean type restriction entry, if available.
90         // An app can utilize these settings to restrict its content under a restricted profile.
91         final String booleanRestrictionValue =
92                 mRestrictionsBundle.containsKey(GetRestrictionsReceiver.KEY_BOOLEAN) ?
93                         mRestrictionsBundle.getBoolean(GetRestrictionsReceiver.KEY_BOOLEAN) + "":
94                         getString(R.string.na);
95         mBooleanEntryValue.setText(booleanRestrictionValue);
96 
97         // Reads and displays values from a single choice restriction entry, if available.
98         final String singleChoiceRestrictionValue =
99                 mRestrictionsBundle.containsKey(GetRestrictionsReceiver.KEY_CHOICE) ?
100                         mRestrictionsBundle.getString(GetRestrictionsReceiver.KEY_CHOICE) :
101                         getString(R.string.na);
102         mChoiceEntryValue.setText(singleChoiceRestrictionValue);
103 
104         // Reads and displays values from a multi-select restriction entry, if available.
105         final String[] multiSelectValues =
106                 mRestrictionsBundle.getStringArray(GetRestrictionsReceiver.KEY_MULTI_SELECT);
107         if (multiSelectValues == null || multiSelectValues.length == 0) {
108             mMultiEntryValue.setText(getString(R.string.na));
109         } else {
110             String tempValue = "";
111             for (String value : multiSelectValues) {
112                 tempValue = tempValue + value + " ";
113             }
114             mMultiEntryValue.setText(tempValue);
115         }
116     }
117 
118     /**
119      * Saves custom app restriction to the shared preference.
120      *
121      * This flag is used by {@code GetRestrictionsReceiver} to determine if a custom app
122      * restriction activity should be used.
123      */
onCustomClicked(View view)124     public void onCustomClicked(View view) {
125         final SharedPreferences.Editor editor =
126                 PreferenceManager.getDefaultSharedPreferences(this).edit();
127         editor.putBoolean(CUSTOM_CONFIG_KEY, mCustomConfig.isChecked()).apply();
128     }
129 }
130