2 * Copyright © 2016-2022 Soren Stoutner <soren@stoutner.com>.
4 * This file is part of Privacy Browser Android <https://www.stoutner.com/privacy-browser-android>.
6 * Privacy Browser Android is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * Privacy Browser Android is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with Privacy Browser Android. If not, see <http://www.gnu.org/licenses/>.
20 package com.stoutner.privacybrowser.fragments;
22 import android.annotation.SuppressLint;
23 import android.app.Activity;
24 import android.content.Context;
25 import android.content.Intent;
26 import android.content.SharedPreferences;
27 import android.content.res.Configuration;
28 import android.content.res.Resources;
29 import android.os.Build;
30 import android.os.Bundle;
31 import android.os.Handler;
32 import android.os.Looper;
33 import android.view.LayoutInflater;
34 import android.view.View;
35 import android.webkit.WebView;
36 import android.widget.ArrayAdapter;
38 import androidx.appcompat.app.AppCompatDelegate;
39 import androidx.preference.Preference;
40 import androidx.preference.PreferenceCategory;
41 import androidx.preference.PreferenceFragmentCompat;
43 import com.stoutner.privacybrowser.R;
44 import com.stoutner.privacybrowser.activities.MainWebViewActivity;
45 import com.stoutner.privacybrowser.helpers.ProxyHelper;
47 import java.util.Objects;
49 public class SettingsFragment extends PreferenceFragmentCompat {
50 // Declare the class variables.
51 private int currentThemeStatus;
52 private String defaultUserAgent;
53 private ArrayAdapter<CharSequence> userAgentNamesArray;
54 private String[] translatedUserAgentNamesArray;
55 private String[] userAgentDataArray;
56 private String[] appThemeEntriesStringArray;
57 private String[] appThemeEntryValuesStringArray;
58 private String[] webViewThemeEntriesStringArray;
59 private String[] webViewThemeEntryValuesStringArray;
60 private SharedPreferences.OnSharedPreferenceChangeListener sharedPreferenceChangeListener;
62 // Declare the class views.
63 private Preference javaScriptPreference;
64 private Preference cookiesPreference;
65 private Preference domStoragePreference;
66 private Preference formDataPreference; // The form data preference can be removed once the minimum API >= 26.
67 private Preference userAgentPreference;
68 private Preference customUserAgentPreference;
69 private Preference xRequestedWithHeaderPreference;
70 private Preference incognitoModePreference;
71 private Preference allowScreenshotsPreference;
72 private Preference easyListPreference;
73 private Preference easyPrivacyPreference;
74 private Preference fanboyAnnoyanceListPreference;
75 private Preference fanboySocialBlockingListPreference;
76 private Preference ultraListPreference;
77 private Preference ultraPrivacyPreference;
78 private Preference blockAllThirdPartyRequestsPreference;
79 private Preference trackingQueriesPreference;
80 private Preference ampRedirectsPreference;
81 private Preference searchPreference;
82 private Preference searchCustomURLPreference;
83 private Preference proxyPreference;
84 private Preference proxyCustomUrlPreference;
85 private Preference fullScreenBrowsingModePreference;
86 private Preference hideAppBarPreference;
87 private Preference clearEverythingPreference;
88 private Preference clearCookiesPreference;
89 private Preference clearDomStoragePreference;
90 private Preference clearFormDataPreference; // The clear form data preference can be removed once the minimum API >= 26.
91 private Preference clearLogcatPreference;
92 private Preference clearCachePreference;
93 private Preference homepagePreference;
94 private Preference fontSizePreference;
95 private Preference openIntentsInNewTabPreference;
96 private Preference swipeToRefreshPreference;
97 private Preference downloadWithExternalAppPreference;
98 private Preference scrollAppBarPreference;
99 private Preference bottomAppBarPreference;
100 private Preference displayAdditionalAppBarIconsPreference;
101 private Preference appThemePreference;
102 private Preference webViewThemePreference;
103 private Preference wideViewportPreference;
104 private Preference displayWebpageImagesPreference;
107 public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
108 // Load the preferences from the XML file.
109 setPreferencesFromResource(R.xml.preferences, rootKey);
111 // Get a handle for the activity.
112 Activity activity = getActivity();
114 // Remove the lint warning below that `getApplicationContext()` might produce a null pointer exception.
115 assert activity != null;
117 // Get a handle for the resources.
118 Resources resources = getResources();
120 // Get the current theme status.
121 currentThemeStatus = getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
123 // Get a handle for the shared preferences.
124 SharedPreferences sharedPreferences = getPreferenceScreen().getSharedPreferences();
126 // Remove the incorrect warning below that the shared preferences might be null.
127 assert sharedPreferences != null;
129 // Get handles for the preferences.
130 javaScriptPreference = findPreference("javascript");
131 cookiesPreference = findPreference(getString(R.string.cookies_key));
132 domStoragePreference = findPreference("dom_storage");
133 formDataPreference = findPreference("save_form_data"); // The form data preference can be removed once the minimum API >= 26.
134 userAgentPreference = findPreference("user_agent");
135 customUserAgentPreference = findPreference("custom_user_agent");
136 xRequestedWithHeaderPreference = findPreference(getString(R.string.x_requested_with_header_key));
137 incognitoModePreference = findPreference("incognito_mode");
138 allowScreenshotsPreference = findPreference(getString(R.string.allow_screenshots_key));
139 easyListPreference = findPreference("easylist");
140 easyPrivacyPreference = findPreference("easyprivacy");
141 fanboyAnnoyanceListPreference = findPreference("fanboys_annoyance_list");
142 fanboySocialBlockingListPreference = findPreference("fanboys_social_blocking_list");
143 ultraListPreference = findPreference("ultralist");
144 ultraPrivacyPreference = findPreference("ultraprivacy");
145 blockAllThirdPartyRequestsPreference = findPreference("block_all_third_party_requests");
146 trackingQueriesPreference = findPreference(getString(R.string.tracking_queries_key));
147 ampRedirectsPreference = findPreference(getString(R.string.amp_redirects_key));
148 searchPreference = findPreference("search");
149 searchCustomURLPreference = findPreference("search_custom_url");
150 proxyPreference = findPreference("proxy");
151 proxyCustomUrlPreference = findPreference(getString(R.string.proxy_custom_url_key));
152 fullScreenBrowsingModePreference = findPreference("full_screen_browsing_mode");
153 hideAppBarPreference = findPreference("hide_app_bar");
154 clearEverythingPreference = findPreference("clear_everything");
155 clearCookiesPreference = findPreference("clear_cookies");
156 clearDomStoragePreference = findPreference("clear_dom_storage");
157 clearFormDataPreference = findPreference("clear_form_data"); // The clear form data preference can be removed once the minimum API >= 26.
158 clearLogcatPreference = findPreference(getString(R.string.clear_logcat_key));
159 clearCachePreference = findPreference("clear_cache");
160 homepagePreference = findPreference("homepage");
161 fontSizePreference = findPreference("font_size");
162 openIntentsInNewTabPreference = findPreference("open_intents_in_new_tab");
163 swipeToRefreshPreference = findPreference("swipe_to_refresh");
164 downloadWithExternalAppPreference = findPreference(getString(R.string.download_with_external_app_key));
165 scrollAppBarPreference = findPreference(getString(R.string.scroll_app_bar_key));
166 bottomAppBarPreference = findPreference(getString(R.string.bottom_app_bar_key));
167 displayAdditionalAppBarIconsPreference = findPreference(getString(R.string.display_additional_app_bar_icons_key));
168 appThemePreference = findPreference("app_theme");
169 webViewThemePreference = findPreference("webview_theme");
170 wideViewportPreference = findPreference("wide_viewport");
171 displayWebpageImagesPreference = findPreference("display_webpage_images");
173 // Remove the lint warnings below that the preferences might be null.
174 assert javaScriptPreference != null;
175 assert cookiesPreference != null;
176 assert domStoragePreference != null;
177 assert formDataPreference != null;
178 assert userAgentPreference != null;
179 assert customUserAgentPreference != null;
180 assert xRequestedWithHeaderPreference != null;
181 assert incognitoModePreference != null;
182 assert allowScreenshotsPreference != null;
183 assert easyListPreference != null;
184 assert easyPrivacyPreference != null;
185 assert fanboyAnnoyanceListPreference != null;
186 assert fanboySocialBlockingListPreference != null;
187 assert ultraListPreference != null;
188 assert ultraPrivacyPreference != null;
189 assert blockAllThirdPartyRequestsPreference != null;
190 assert trackingQueriesPreference != null;
191 assert ampRedirectsPreference != null;
192 assert searchPreference != null;
193 assert searchCustomURLPreference != null;
194 assert proxyPreference != null;
195 assert proxyCustomUrlPreference != null;
196 assert fullScreenBrowsingModePreference != null;
197 assert hideAppBarPreference != null;
198 assert clearEverythingPreference != null;
199 assert clearCookiesPreference != null;
200 assert clearDomStoragePreference != null;
201 assert clearFormDataPreference != null;
202 assert clearLogcatPreference != null;
203 assert clearCachePreference != null;
204 assert homepagePreference != null;
205 assert fontSizePreference != null;
206 assert openIntentsInNewTabPreference != null;
207 assert swipeToRefreshPreference != null;
208 assert downloadWithExternalAppPreference != null;
209 assert scrollAppBarPreference != null;
210 assert bottomAppBarPreference != null;
211 assert displayAdditionalAppBarIconsPreference != null;
212 assert appThemePreference != null;
213 assert webViewThemePreference != null;
214 assert wideViewportPreference != null;
215 assert displayWebpageImagesPreference != null;
217 // Set the preference dependencies.
218 hideAppBarPreference.setDependency("full_screen_browsing_mode");
219 domStoragePreference.setDependency("javascript");
221 // Get strings from the preferences.
222 String userAgentName = sharedPreferences.getString("user_agent", getString(R.string.user_agent_default_value));
223 String searchString = sharedPreferences.getString("search", getString(R.string.search_default_value));
224 String proxyString = sharedPreferences.getString("proxy", getString(R.string.proxy_default_value));
226 // Get booleans that are used in multiple places from the preferences.
227 boolean javaScriptEnabled = sharedPreferences.getBoolean("javascript", false);
228 boolean fanboyAnnoyanceListEnabled = sharedPreferences.getBoolean("fanboys_annoyance_list", true);
229 boolean fanboySocialBlockingEnabled = sharedPreferences.getBoolean("fanboys_social_blocking_list", true);
230 boolean fullScreenBrowsingMode = sharedPreferences.getBoolean("full_screen_browsing_mode", false);
231 boolean clearEverything = sharedPreferences.getBoolean("clear_everything", true);
233 // Remove the form data preferences if the API is >= 26 as they no longer do anything.
234 if (Build.VERSION.SDK_INT >= 26) {
235 // Get handles for the categories.
236 PreferenceCategory privacyCategory = findPreference("privacy");
237 PreferenceCategory clearAndExitCategory = findPreference("clear_and_exit");
239 // Remove the incorrect lint warnings below that the preference categories might be null.
240 assert privacyCategory != null;
241 assert clearAndExitCategory != null;
243 // Remove the form data preferences.
244 privacyCategory.removePreference(formDataPreference);
245 clearAndExitCategory.removePreference(clearFormDataPreference);
248 // Only enable Fanboy's social blocking list preference if Fanboy's annoyance list is disabled.
249 fanboySocialBlockingListPreference.setEnabled(!fanboyAnnoyanceListEnabled);
252 // Inflate a WebView to get the default user agent.
253 LayoutInflater inflater = getActivity().getLayoutInflater();
255 // `@SuppressLint("InflateParams")` removes the warning about using `null` as the `ViewGroup`, which in this case makes sense because the `bare_webview` will not be displayed.
256 @SuppressLint("InflateParams") View bareWebViewLayout = inflater.inflate(R.layout.bare_webview, null, false);
258 // Get a handle for a bare WebView.
259 WebView bareWebView = bareWebViewLayout.findViewById(R.id.bare_webview);
261 // Get the default user agent.
262 defaultUserAgent = bareWebView.getSettings().getUserAgentString();
264 // Get the user agent arrays.
265 userAgentNamesArray = ArrayAdapter.createFromResource(requireContext(), R.array.user_agent_names, R.layout.spinner_item);
266 translatedUserAgentNamesArray = resources.getStringArray(R.array.translated_user_agent_names);
267 userAgentDataArray = resources.getStringArray(R.array.user_agent_data);
269 // Get the array position of the user agent name.
270 int userAgentArrayPosition = userAgentNamesArray.getPosition(userAgentName);
272 // Populate the user agent summary.
273 switch (userAgentArrayPosition) {
274 case MainWebViewActivity.UNRECOGNIZED_USER_AGENT: // The user agent name is not on the canonical list.
275 // This is probably because it was set in an older version of Privacy Browser before the switch to persistent user agent names. Use the current user agent entry name as the summary.
276 userAgentPreference.setSummary(userAgentName);
279 case MainWebViewActivity.SETTINGS_WEBVIEW_DEFAULT_USER_AGENT:
280 // Get the user agent text from the webview (which changes based on the version of Android and WebView installed).
281 userAgentPreference.setSummary(translatedUserAgentNamesArray[userAgentArrayPosition] + ":\n" + defaultUserAgent);
284 case MainWebViewActivity.SETTINGS_CUSTOM_USER_AGENT:
285 // Set the summary text.
286 userAgentPreference.setSummary(R.string.custom_user_agent);
290 // Get the user agent summary from the user agent data array.
291 userAgentPreference.setSummary(translatedUserAgentNamesArray[userAgentArrayPosition] + ":\n" + userAgentDataArray[userAgentArrayPosition]);
294 // Set the summary text for the custom user agent preference.
295 customUserAgentPreference.setSummary(sharedPreferences.getString("custom_user_agent", getString(R.string.custom_user_agent_default_value)));
297 // Only enable the custom user agent preference if the user agent is set to `Custom`.
298 customUserAgentPreference.setEnabled(Objects.equals(userAgentPreference.getSummary(), getString(R.string.custom_user_agent)));
300 // Set the search URL as the summary text for the search preference when the preference screen is loaded.
301 if (searchString.equals("Custom URL")) {
302 // Use R.string.custom_url, which will be translated, instead of the array value, which will not.
303 searchPreference.setSummary(R.string.custom_url);
305 // Set the array value as the summary text.
306 searchPreference.setSummary(searchString);
309 // Set the summary text for the search custom URL (the default is `""`).
310 searchCustomURLPreference.setSummary(sharedPreferences.getString("search_custom_url", getString(R.string.search_custom_url_default_value)));
312 // Only enable the search custom URL preference if the search is set to `Custom URL`.
313 searchCustomURLPreference.setEnabled(searchString.equals("Custom URL"));
316 // Set the summary text for the proxy preference when the preference screen is loaded.
317 switch (proxyString) {
318 case ProxyHelper.NONE:
319 proxyPreference.setSummary(getString(R.string.no_proxy_enabled));
322 case ProxyHelper.TOR:
323 proxyPreference.setSummary(getString(R.string.tor_enabled));
326 case ProxyHelper.I2P:
327 proxyPreference.setSummary(getString(R.string.i2p_enabled));
330 case ProxyHelper.CUSTOM:
331 proxyPreference.setSummary(getString(R.string.custom_proxy));
335 // Set the summary text for the custom proxy URL.
336 proxyCustomUrlPreference.setSummary(sharedPreferences.getString(getString(R.string.proxy_custom_url_key), getString(R.string.proxy_custom_url_default_value)));
338 // Only enable the custom proxy URL if a custom proxy is selected.
339 proxyCustomUrlPreference.setEnabled(proxyString.equals(ProxyHelper.CUSTOM));
342 // Set the status of the clear and exit preferences.
343 clearCookiesPreference.setEnabled(!clearEverything);
344 clearDomStoragePreference.setEnabled(!clearEverything);
345 clearFormDataPreference.setEnabled(!clearEverything); // The form data line can be removed once the minimum API is >= 26.
346 clearLogcatPreference.setEnabled(!clearEverything);
347 clearCachePreference.setEnabled(!clearEverything);
350 // Set the homepage URL as the summary text for the homepage preference.
351 homepagePreference.setSummary(sharedPreferences.getString("homepage", getString(R.string.homepage_default_value)));
354 // Set the font size as the summary text for the preference.
355 fontSizePreference.setSummary(sharedPreferences.getString("font_size", getString(R.string.font_size_default_value)) + "%");
358 // Get the app theme string arrays.
359 appThemeEntriesStringArray = resources.getStringArray(R.array.app_theme_entries);
360 appThemeEntryValuesStringArray = resources.getStringArray(R.array.app_theme_entry_values);
362 // Get the current app theme.
363 String currentAppTheme = sharedPreferences.getString("app_theme", getString(R.string.app_theme_default_value));
365 // Define an app theme entry number.
366 int appThemeEntryNumber;
368 // Get the app theme entry number that matches the current app theme. A switch statement cannot be used because the theme entry values string array is not a compile time constant.
369 if (currentAppTheme.equals(appThemeEntryValuesStringArray[1])) { // The light theme is selected.
370 // Store the app theme entry number.
371 appThemeEntryNumber = 1;
372 } else if (currentAppTheme.equals(appThemeEntryValuesStringArray[2])) { // The dark theme is selected.
373 // Store the app theme entry number.
374 appThemeEntryNumber = 2;
375 } else { // The system default theme is selected.
376 // Store the app theme entry number.
377 appThemeEntryNumber = 0;
380 // Set the current theme as the summary text for the preference.
381 appThemePreference.setSummary(appThemeEntriesStringArray[appThemeEntryNumber]);
384 // Get the WebView theme string arrays.
385 webViewThemeEntriesStringArray = resources.getStringArray(R.array.webview_theme_entries);
386 webViewThemeEntryValuesStringArray = resources.getStringArray(R.array.webview_theme_entry_values);
388 // Get the current WebView theme.
389 String currentWebViewTheme = sharedPreferences.getString("webview_theme", getString(R.string.webview_theme_default_value));
391 // Define a WebView theme entry number.
392 int webViewThemeEntryNumber;
394 // Get the WebView theme entry number that matches the current WebView theme. A switch statement cannot be used because the WebView theme entry values string array is not a compile time constant.
395 if (currentWebViewTheme.equals(webViewThemeEntryValuesStringArray[1])) { // The light theme is selected.
396 // Store the WebView theme entry number.
397 webViewThemeEntryNumber = 1;
398 } else if (currentWebViewTheme.equals(webViewThemeEntryValuesStringArray[2])) { // The dark theme is selected.
399 // Store the WebView theme entry number.
400 webViewThemeEntryNumber = 2;
401 } else { // The system default theme is selected.
402 // Store the WebView theme entry number.
403 webViewThemeEntryNumber = 0;
406 // Set the current theme as the summary text for the preference.
407 webViewThemePreference.setSummary(webViewThemeEntriesStringArray[webViewThemeEntryNumber]);
410 // Set the JavaScript icon.
411 if (javaScriptEnabled) {
412 javaScriptPreference.setIcon(R.drawable.javascript_enabled);
414 javaScriptPreference.setIcon(R.drawable.privacy_mode);
417 // Set the cookies icon.
418 if (sharedPreferences.getBoolean(getString(R.string.cookies_key), false)) {
419 cookiesPreference.setIcon(R.drawable.cookies_enabled);
421 cookiesPreference.setIcon(R.drawable.cookies_disabled);
424 // Set the DOM storage icon.
425 if (javaScriptEnabled) { // The preference is enabled.
426 if (sharedPreferences.getBoolean("dom_storage", false)) { // DOM storage is enabled.
427 domStoragePreference.setIcon(R.drawable.dom_storage_enabled);
428 } else { // DOM storage is disabled.
429 domStoragePreference.setIcon(R.drawable.dom_storage_disabled);
431 } else { // The preference is disabled. The icon should be ghosted.
432 domStoragePreference.setIcon(R.drawable.dom_storage_ghosted);
435 // Set the save form data icon if API < 26. Save form data has no effect on API >= 26.
436 if (Build.VERSION.SDK_INT < 26) {
437 if (sharedPreferences.getBoolean("save_form_data", false))
438 formDataPreference.setIcon(R.drawable.form_data_enabled);
440 formDataPreference.setIcon(R.drawable.form_data_disabled);
443 // Set the custom user agent icon.
444 if (customUserAgentPreference.isEnabled())
445 customUserAgentPreference.setIcon(R.drawable.custom_user_agent_enabled);
447 customUserAgentPreference.setIcon(R.drawable.custom_user_agent_ghosted);
449 // Set the X-Requested With header icon.
450 if (sharedPreferences.getBoolean(getString(R.string.x_requested_with_header_key), true))
451 xRequestedWithHeaderPreference.setIcon(R.drawable.x_requested_with_header_enabled);
453 xRequestedWithHeaderPreference.setIcon(R.drawable.x_requested_with_header_disabled);
455 // Set the incognito mode icon.
456 if (sharedPreferences.getBoolean("incognito_mode", false))
457 incognitoModePreference.setIcon(R.drawable.incognito_mode_enabled);
459 incognitoModePreference.setIcon(R.drawable.incognito_mode_disabled);
461 // Set the allow screenshots icon.
462 if (sharedPreferences.getBoolean(getString(R.string.allow_screenshots_key), false))
463 allowScreenshotsPreference.setIcon(R.drawable.allow_screenshots_enabled);
465 allowScreenshotsPreference.setIcon(R.drawable.allow_screenshots_disabled);
467 // Set the EasyList icon.
468 if (sharedPreferences.getBoolean("easylist", true))
469 easyListPreference.setIcon(R.drawable.block_ads_enabled);
471 easyListPreference.setIcon(R.drawable.block_ads_disabled);
473 // Set the EasyPrivacy icon.
474 if (sharedPreferences.getBoolean("easyprivacy", true))
475 easyPrivacyPreference.setIcon(R.drawable.block_tracking_enabled);
477 easyPrivacyPreference.setIcon(R.drawable.block_tracking_disabled);
479 // Set the Fanboy lists icons.
480 if (fanboyAnnoyanceListEnabled) {
481 // Set the Fanboy annoyance list icon.
482 fanboyAnnoyanceListPreference.setIcon(R.drawable.social_media_enabled);
484 // Set the Fanboy social blocking list icon.
485 fanboySocialBlockingListPreference.setIcon(R.drawable.social_media_ghosted);
487 // Set the Fanboy annoyance list icon.
488 fanboyAnnoyanceListPreference.setIcon(R.drawable.social_media_disabled);
490 // Set the Fanboy social blocking list icon.
491 if (fanboySocialBlockingEnabled) {
492 fanboySocialBlockingListPreference.setIcon(R.drawable.social_media_enabled);
494 fanboySocialBlockingListPreference.setIcon(R.drawable.social_media_disabled);
498 // Set the UltraList icon.
499 if (sharedPreferences.getBoolean("ultralist", true)){
500 ultraListPreference.setIcon(R.drawable.block_ads_enabled);
502 ultraListPreference.setIcon(R.drawable.block_ads_disabled);
505 // Set the UltraPrivacy icon.
506 if (sharedPreferences.getBoolean("ultraprivacy", true)) {
507 ultraPrivacyPreference.setIcon(R.drawable.block_tracking_enabled);
509 ultraPrivacyPreference.setIcon(R.drawable.block_tracking_disabled);
512 // Set the block all third-party requests icon.
513 if (sharedPreferences.getBoolean("block_all_third_party_requests", false)) {
514 blockAllThirdPartyRequestsPreference.setIcon(R.drawable.block_all_third_party_requests_enabled);
516 blockAllThirdPartyRequestsPreference.setIcon(R.drawable.block_all_third_party_requests_disabled);
519 // Set the Tracking Queries icon.
520 if (sharedPreferences.getBoolean(getString(R.string.tracking_queries_key), true)) {
521 trackingQueriesPreference.setIcon(R.drawable.modify_url_enabled);
523 trackingQueriesPreference.setIcon(R.drawable.modify_url_disabled);
526 // Set the AMP Redirects icon.
527 if (sharedPreferences.getBoolean(getString(R.string.amp_redirects_key), true)) {
528 ampRedirectsPreference.setIcon(R.drawable.modify_url_enabled);
530 ampRedirectsPreference.setIcon(R.drawable.modify_url_disabled);
533 // Set the search custom URL icon.
534 if (searchCustomURLPreference.isEnabled()) {
535 searchCustomURLPreference.setIcon(R.drawable.search_custom_enabled);
537 searchCustomURLPreference.setIcon(R.drawable.search_custom_ghosted);
540 // Set the Proxy icons according to the theme and status.
541 if (proxyString.equals(ProxyHelper.NONE)) { // Proxying is disabled.
542 // Set the main proxy icon to be disabled.
543 proxyPreference.setIcon(R.drawable.proxy_disabled);
545 // Set the custom proxy URL icon to be ghosted.
546 proxyCustomUrlPreference.setIcon(R.drawable.proxy_ghosted);
547 } else { // Proxying is enabled.
548 // Set the main proxy icon to be enabled.
549 proxyPreference.setIcon(R.drawable.proxy_enabled);
551 // Set the custom proxy URL icon according to its status.
552 if (proxyCustomUrlPreference.isEnabled()) {
553 proxyCustomUrlPreference.setIcon(R.drawable.proxy_enabled);
555 proxyCustomUrlPreference.setIcon(R.drawable.proxy_ghosted);
559 // Set the full screen browsing mode icons.
560 if (fullScreenBrowsingMode) { // Full screen browsing mode is enabled.
561 // Set the full screen browsing mode preference icon.
562 fullScreenBrowsingModePreference.setIcon(R.drawable.full_screen_enabled);
564 // Set the hide app bar icon.
565 if (sharedPreferences.getBoolean("hide_app_bar", true)) {
566 hideAppBarPreference.setIcon(R.drawable.app_bar_enabled);
568 hideAppBarPreference.setIcon(R.drawable.app_bar_disabled);
570 } else { // Full screen browsing mode is disabled.
572 fullScreenBrowsingModePreference.setIcon(R.drawable.full_screen_disabled);
573 hideAppBarPreference.setIcon(R.drawable.app_bar_ghosted);
576 // Set the clear everything preference icon.
577 if (clearEverything) {
578 clearEverythingPreference.setIcon(R.drawable.clear_everything_enabled);
580 clearEverythingPreference.setIcon(R.drawable.clear_everything_disabled);
583 // Set the clear cookies preference icon.
584 if (clearEverything || sharedPreferences.getBoolean("clear_cookies", true)) {
585 clearCookiesPreference.setIcon(R.drawable.clear_cookies_enabled);
587 clearCookiesPreference.setIcon(R.drawable.clear_cookies_disabled);
590 // Set the clear DOM storage preference icon.
591 if (clearEverything || sharedPreferences.getBoolean("clear_dom_storage", true)) {
592 clearDomStoragePreference.setIcon(R.drawable.clear_dom_storage_enabled);
594 clearDomStoragePreference.setIcon(R.drawable.clear_dom_storage_disabled);
597 // Set the clear form data preference icon if the API < 26. It has no effect on newer versions of Android.
598 if (Build.VERSION.SDK_INT < 26) {
599 if (clearEverything || sharedPreferences.getBoolean("clear_form_data", true)) {
600 clearFormDataPreference.setIcon(R.drawable.clear_form_data_enabled);
602 clearFormDataPreference.setIcon(R.drawable.clear_form_data_disabled);
606 // Set the clear logcat preference icon.
607 if (clearEverything || sharedPreferences.getBoolean(getString(R.string.clear_logcat_key), true)) {
608 clearLogcatPreference.setIcon(R.drawable.clear_logcat_enabled);
610 clearLogcatPreference.setIcon(R.drawable.clear_logcat_disabled);
613 // Set the clear cache preference icon.
614 if (clearEverything || sharedPreferences.getBoolean("clear_cache", true)) {
615 clearCachePreference.setIcon(R.drawable.clear_cache_enabled);
617 clearCachePreference.setIcon(R.drawable.clear_cache_disabled);
620 // Set the open intents in new tab preference icon.
621 if (sharedPreferences.getBoolean("open_intents_in_new_tab", true)) {
622 openIntentsInNewTabPreference.setIcon(R.drawable.tab_enabled);
624 openIntentsInNewTabPreference.setIcon(R.drawable.tab_disabled);
627 // Set the swipe to refresh preference icon.
628 if (sharedPreferences.getBoolean("swipe_to_refresh", true))
629 swipeToRefreshPreference.setIcon(R.drawable.refresh_enabled);
631 swipeToRefreshPreference.setIcon(R.drawable.refresh_disabled);
633 // Set the download with external app preference icon.
634 if (sharedPreferences.getBoolean(getString(R.string.download_with_external_app_key), false))
635 downloadWithExternalAppPreference.setIcon(R.drawable.download_with_external_app_enabled);
637 downloadWithExternalAppPreference.setIcon(R.drawable.download_with_external_app_disabled);
639 // Set the scroll app bar preference icon.
640 if (sharedPreferences.getBoolean(getString(R.string.scroll_app_bar_key), true))
641 scrollAppBarPreference.setIcon(R.drawable.app_bar_enabled);
643 scrollAppBarPreference.setIcon(R.drawable.app_bar_disabled);
645 // Set the bottom app bar preference icon.
646 if (sharedPreferences.getBoolean(getString(R.string.bottom_app_bar_key), false))
647 bottomAppBarPreference.setIcon(R.drawable.bottom_app_bar_enabled);
649 bottomAppBarPreference.setIcon(R.drawable.bottom_app_bar_disabled);
651 // Set the display additional app bar icons preference icon.
652 if (sharedPreferences.getBoolean(getString(R.string.display_additional_app_bar_icons_key), false))
653 displayAdditionalAppBarIconsPreference.setIcon(R.drawable.more_enabled);
655 displayAdditionalAppBarIconsPreference.setIcon(R.drawable.more_disabled);
657 // Set the WebView theme preference icon.
658 switch (webViewThemeEntryNumber) {
659 case 0: // The system default WebView theme is selected.
660 // Set the icon according to the app theme.
661 if (currentThemeStatus == Configuration.UI_MODE_NIGHT_NO) {
662 webViewThemePreference.setIcon(R.drawable.webview_light_theme);
664 webViewThemePreference.setIcon(R.drawable.webview_dark_theme);
668 case 1: // The light WebView theme is selected.
670 webViewThemePreference.setIcon(R.drawable.webview_light_theme);
673 case 2: // The dark WebView theme is selected.
675 webViewThemePreference.setIcon(R.drawable.webview_dark_theme);
679 // Set the wide viewport preference icon.
680 if (sharedPreferences.getBoolean("wide_viewport", true)) {
681 wideViewportPreference.setIcon(R.drawable.wide_viewport_enabled);
683 wideViewportPreference.setIcon(R.drawable.wide_viewport_disabled);
686 // Set the display webpage images preference icon.
687 if (sharedPreferences.getBoolean("display_webpage_images", true)) {
688 displayWebpageImagesPreference.setIcon(R.drawable.images_enabled);
690 displayWebpageImagesPreference.setIcon(R.drawable.images_disabled);
694 // The listener should be unregistered when the app is paused.
696 public void onPause() {
697 // Run the default commands.
700 // Get a handle for the shared preferences.
701 SharedPreferences sharedPreferences = getPreferenceScreen().getSharedPreferences();
703 // Remove the incorrect lint warning below that the shared preferences might be null.
704 assert sharedPreferences != null;
706 // Unregister the shared preference listener.
707 sharedPreferences.unregisterOnSharedPreferenceChangeListener(sharedPreferenceChangeListener);
710 // The listener should be re-registered when the app is resumed.
712 public void onResume() {
713 // Run the default commands.
716 // Get a new shared preference change listener.
717 sharedPreferenceChangeListener = getSharedPreferenceChangeListener(requireContext());
719 // Get a handle for the shared preferences.
720 SharedPreferences sharedPreferences = getPreferenceScreen().getSharedPreferences();
722 // Remove the incorrect lint warning below that the shared preferences might be null.
723 assert sharedPreferences != null;
725 // Re-register the shared preference listener.
726 sharedPreferences.registerOnSharedPreferenceChangeListener(sharedPreferenceChangeListener);
729 // The context must be passed to the shared preference change listener or else any calls to the system `getString()` will crash if the app has been restarted.
730 // This can be removed at some future point, perhaps after the switch to PreferenceScreenCompat. It isn't an issue in Privacy Cell.
731 private SharedPreferences.OnSharedPreferenceChangeListener getSharedPreferenceChangeListener(Context context) {
732 // Return the shared preference change listener.
733 return (SharedPreferences sharedPreferences, String key) -> {
736 // Update the icons and the DOM storage preference status.
737 if (sharedPreferences.getBoolean("javascript", false)) { // The JavaScript preference is enabled.
738 // Update the icon for the JavaScript preference.
739 javaScriptPreference.setIcon(R.drawable.javascript_enabled);
741 // Update the status of the DOM storage preference.
742 domStoragePreference.setEnabled(true);
744 // Update the icon for the DOM storage preference.
745 if (sharedPreferences.getBoolean("dom_storage", false)) {
746 domStoragePreference.setIcon(R.drawable.dom_storage_enabled);
748 domStoragePreference.setIcon(R.drawable.dom_storage_disabled);
750 } else { // The JavaScript preference is disabled.
751 // Update the icon for the JavaScript preference.
752 javaScriptPreference.setIcon(R.drawable.privacy_mode);
754 // Update the status of the DOM storage preference.
755 domStoragePreference.setEnabled(false);
757 // Set the icon for DOM storage preference to be ghosted.
758 domStoragePreference.setIcon(R.drawable.dom_storage_ghosted);
764 if (sharedPreferences.getBoolean(context.getString(R.string.cookies_key), false)) {
765 cookiesPreference.setIcon(R.drawable.cookies_enabled);
767 cookiesPreference.setIcon(R.drawable.cookies_disabled);
773 if (sharedPreferences.getBoolean("dom_storage", false)) {
774 domStoragePreference.setIcon(R.drawable.dom_storage_enabled);
776 domStoragePreference.setIcon(R.drawable.dom_storage_disabled);
780 // Save form data can be removed once the minimum API >= 26.
781 case "save_form_data":
783 if (sharedPreferences.getBoolean("save_form_data", false)) {
784 formDataPreference.setIcon(R.drawable.form_data_enabled);
786 formDataPreference.setIcon(R.drawable.form_data_disabled);
791 // Get the new user agent name.
792 String newUserAgentName = sharedPreferences.getString("user_agent", context.getString(R.string.user_agent_default_value));
794 // Get the array position for the new user agent name.
795 int newUserAgentArrayPosition = userAgentNamesArray.getPosition(newUserAgentName);
797 // Get the translated new user agent name.
798 String translatedNewUserAgentName = translatedUserAgentNamesArray[newUserAgentArrayPosition];
800 // Populate the user agent summary.
801 switch (newUserAgentArrayPosition) {
802 case MainWebViewActivity.SETTINGS_WEBVIEW_DEFAULT_USER_AGENT:
803 // Get the user agent text from the webview (which changes based on the version of Android and WebView installed).
804 userAgentPreference.setSummary(translatedNewUserAgentName + ":\n" + defaultUserAgent);
806 // Disable the custom user agent preference.
807 customUserAgentPreference.setEnabled(false);
809 // Set the custom user agent preference icon.
810 customUserAgentPreference.setIcon(R.drawable.custom_user_agent_ghosted);
813 case MainWebViewActivity.SETTINGS_CUSTOM_USER_AGENT:
814 // Set the summary text.
815 userAgentPreference.setSummary(R.string.custom_user_agent);
817 // Enable the custom user agent preference.
818 customUserAgentPreference.setEnabled(true);
820 // Set the custom user agent preference icon.
821 customUserAgentPreference.setIcon(R.drawable.custom_user_agent_enabled);
825 // Get the user agent summary from the user agent data array.
826 userAgentPreference.setSummary(translatedNewUserAgentName + ":\n" + userAgentDataArray[newUserAgentArrayPosition]);
828 // Disable the custom user agent preference.
829 customUserAgentPreference.setEnabled(false);
831 // Set the custom user agent preference icon.
832 customUserAgentPreference.setIcon(R.drawable.custom_user_agent_ghosted);
836 case "custom_user_agent":
837 // Set the new custom user agent as the summary text for the preference.
838 customUserAgentPreference.setSummary(sharedPreferences.getString("custom_user_agent", context.getString(R.string.custom_user_agent_default_value)));
841 case "x_requested_with_header":
843 if (sharedPreferences.getBoolean(context.getString(R.string.x_requested_with_header_key), true))
844 xRequestedWithHeaderPreference.setIcon(R.drawable.x_requested_with_header_enabled);
846 xRequestedWithHeaderPreference.setIcon(R.drawable.x_requested_with_header_disabled);
848 // Restart Privacy Browser.
849 restartPrivacyBrowser();
852 case "incognito_mode":
854 if (sharedPreferences.getBoolean("incognito_mode", false))
855 incognitoModePreference.setIcon(R.drawable.incognito_mode_enabled);
857 incognitoModePreference.setIcon(R.drawable.incognito_mode_disabled);
860 case "allow_screenshots":
862 if (sharedPreferences.getBoolean(context.getString(R.string.allow_screenshots_key), false))
863 allowScreenshotsPreference.setIcon(R.drawable.allow_screenshots_enabled);
865 allowScreenshotsPreference.setIcon(R.drawable.allow_screenshots_disabled);
867 // Restart Privacy Browser.
868 restartPrivacyBrowser();
873 if (sharedPreferences.getBoolean("easylist", true))
874 easyListPreference.setIcon(R.drawable.block_ads_enabled);
876 easyListPreference.setIcon(R.drawable.block_ads_disabled);
881 if (sharedPreferences.getBoolean("easyprivacy", true))
882 easyPrivacyPreference.setIcon(R.drawable.block_tracking_enabled);
884 easyPrivacyPreference.setIcon(R.drawable.block_tracking_disabled);
887 case "fanboys_annoyance_list":
888 boolean currentFanboyAnnoyanceList = sharedPreferences.getBoolean("fanboys_annoyance_list", true);
889 boolean currentFanboySocialBlockingList = sharedPreferences.getBoolean("fanboys_social_blocking_list", true);
891 // Update the Fanboy icons.
892 if (currentFanboyAnnoyanceList) { // Fanboy's annoyance list is enabled.
893 // Update the Fanboy's annoyance list icon.
894 fanboyAnnoyanceListPreference.setIcon(R.drawable.social_media_enabled);
896 // Update the Fanboy's social blocking list icon.
897 fanboySocialBlockingListPreference.setIcon(R.drawable.social_media_ghosted);
898 } else { // Fanboy's annoyance list is disabled.
899 // Update the Fanboy's annoyance list icon.
900 fanboyAnnoyanceListPreference.setIcon(R.drawable.social_media_disabled);
902 // Update the Fanboy's social blocking list icon.
903 if (currentFanboySocialBlockingList) {
904 fanboySocialBlockingListPreference.setIcon(R.drawable.social_media_enabled);
906 fanboySocialBlockingListPreference.setIcon(R.drawable.social_media_disabled);
910 // Only enable Fanboy's social blocking list preference if Fanboy's annoyance list preference is disabled.
911 fanboySocialBlockingListPreference.setEnabled(!currentFanboyAnnoyanceList);
914 case "fanboys_social_blocking_list":
916 if (sharedPreferences.getBoolean("fanboys_social_blocking_list", true)) {
917 fanboySocialBlockingListPreference.setIcon(R.drawable.social_media_enabled);
919 fanboySocialBlockingListPreference.setIcon(R.drawable.social_media_disabled);
925 if (sharedPreferences.getBoolean("ultralist", true)) {
926 ultraListPreference.setIcon(R.drawable.block_ads_enabled);
928 ultraListPreference.setIcon(R.drawable.block_ads_disabled);
934 if (sharedPreferences.getBoolean("ultraprivacy", true)) {
935 ultraPrivacyPreference.setIcon(R.drawable.block_tracking_enabled);
937 ultraPrivacyPreference.setIcon(R.drawable.block_tracking_disabled);
941 case "block_all_third_party_requests":
943 if (sharedPreferences.getBoolean("block_all_third_party_requests", false)) {
944 blockAllThirdPartyRequestsPreference.setIcon(R.drawable.block_all_third_party_requests_enabled);
946 blockAllThirdPartyRequestsPreference.setIcon(R.drawable.block_all_third_party_requests_disabled);
950 case "tracking_queries":
952 if (sharedPreferences.getBoolean(context.getString(R.string.tracking_queries_key), true)) {
953 trackingQueriesPreference.setIcon(R.drawable.modify_url_enabled);
955 trackingQueriesPreference.setIcon(R.drawable.modify_url_disabled);
959 case "amp_redirects":
961 if (sharedPreferences.getBoolean(context.getString(R.string.amp_redirects_key), true)) {
962 ampRedirectsPreference.setIcon(R.drawable.modify_url_enabled);
964 ampRedirectsPreference.setIcon(R.drawable.modify_url_disabled);
969 // Store the new search string.
970 String newSearchString = sharedPreferences.getString("search", context.getString(R.string.search_default_value));
972 // Update the search and search custom URL preferences.
973 if (newSearchString.equals("Custom URL")) { // `Custom URL` is selected.
974 // Set the summary text to `R.string.custom_url`, which is translated.
975 searchPreference.setSummary(R.string.custom_url);
977 // Enable the search custom URL preference.
978 searchCustomURLPreference.setEnabled(true);
980 // Set the search custom URL preference icon.
981 searchCustomURLPreference.setIcon(R.drawable.search_custom_enabled);
982 } else { // `Custom URL` is not selected.
983 // Set the summary text to `newSearchString`.
984 searchPreference.setSummary(newSearchString);
986 // Disable `searchCustomURLPreference`.
987 searchCustomURLPreference.setEnabled(false);
989 // Set the search custom URL preference icon.
990 searchCustomURLPreference.setIcon(R.drawable.search_custom_ghosted);
994 case "search_custom_url":
995 // Set the new search custom URL as the summary text for the preference.
996 searchCustomURLPreference.setSummary(sharedPreferences.getString("search_custom_url", context.getString(R.string.search_custom_url_default_value)));
1000 // Get current proxy string.
1001 String currentProxyString = sharedPreferences.getString("proxy", context.getString(R.string.proxy_default_value));
1003 // Update the summary text for the proxy preference.
1004 switch (currentProxyString) {
1005 case ProxyHelper.NONE:
1006 proxyPreference.setSummary(context.getString(R.string.no_proxy_enabled));
1009 case ProxyHelper.TOR:
1010 proxyPreference.setSummary(context.getString(R.string.tor_enabled));
1013 case ProxyHelper.I2P:
1014 proxyPreference.setSummary(context.getString(R.string.i2p_enabled));
1017 case ProxyHelper.CUSTOM:
1018 proxyPreference.setSummary(context.getString(R.string.custom_proxy));
1022 // Update the status of the custom URL preference.
1023 proxyCustomUrlPreference.setEnabled(currentProxyString.equals(ProxyHelper.CUSTOM));
1025 // Update the icons.
1026 if (currentProxyString.equals(ProxyHelper.NONE)) { // Proxying is disabled.
1027 // Set the main proxy icon to be disabled
1028 proxyPreference.setIcon(R.drawable.proxy_disabled);
1030 // Set the custom proxy URL icon to be ghosted.
1031 proxyCustomUrlPreference.setIcon(R.drawable.proxy_ghosted);
1032 } else { // Proxying is enabled.
1033 // Set the main proxy icon to be enabled.
1034 proxyPreference.setIcon(R.drawable.proxy_enabled);
1036 /// Set the custom proxy URL icon according to its status.
1037 if (proxyCustomUrlPreference.isEnabled()) {
1038 proxyCustomUrlPreference.setIcon(R.drawable.proxy_enabled);
1040 proxyCustomUrlPreference.setIcon(R.drawable.proxy_ghosted);
1045 case "proxy_custom_url":
1046 // Set the summary text for the proxy custom URL.
1047 proxyCustomUrlPreference.setSummary(sharedPreferences.getString(context.getString(R.string.proxy_custom_url_key), context.getString(R.string.proxy_custom_url_default_value)));
1050 case "full_screen_browsing_mode":
1051 if (sharedPreferences.getBoolean("full_screen_browsing_mode", false)) { // Full screen browsing is enabled.
1052 // Set the full screen browsing mode preference icon.
1053 fullScreenBrowsingModePreference.setIcon(R.drawable.full_screen_enabled);
1055 // Set the hide app bar preference icon.
1056 if (sharedPreferences.getBoolean("hide_app_bar", true)) {
1057 hideAppBarPreference.setIcon(R.drawable.app_bar_enabled);
1059 hideAppBarPreference.setIcon(R.drawable.app_bar_disabled);
1061 } else { // Full screen browsing is disabled.
1062 // Update the icons.
1063 fullScreenBrowsingModePreference.setIcon(R.drawable.full_screen_disabled);
1064 hideAppBarPreference.setIcon(R.drawable.app_bar_ghosted);
1068 case "hide_app_bar":
1070 if (sharedPreferences.getBoolean("hide_app_bar", true)) {
1071 hideAppBarPreference.setIcon(R.drawable.app_bar_enabled);
1072 } else { // Hide app bar is disabled.
1073 // Set the icon according to the theme.
1074 hideAppBarPreference.setIcon(R.drawable.app_bar_disabled);
1078 case "clear_everything":
1079 // Store the new clear everything status
1080 boolean newClearEverythingBoolean = sharedPreferences.getBoolean("clear_everything", true);
1082 // Update the status of the clear and exit preferences.
1083 clearCookiesPreference.setEnabled(!newClearEverythingBoolean);
1084 clearDomStoragePreference.setEnabled(!newClearEverythingBoolean);
1085 clearFormDataPreference.setEnabled(!newClearEverythingBoolean); // This line can be removed once the minimum API >= 26.
1086 clearLogcatPreference.setEnabled(!newClearEverythingBoolean);
1087 clearCachePreference.setEnabled(!newClearEverythingBoolean);
1089 // Update the clear everything preference icon.
1090 if (newClearEverythingBoolean) {
1091 clearEverythingPreference.setIcon(R.drawable.clear_everything_enabled);
1093 clearEverythingPreference.setIcon(R.drawable.clear_everything_disabled);
1096 // Update the clear cookies preference icon.
1097 if (newClearEverythingBoolean || sharedPreferences.getBoolean("clear_cookies", true)) {
1098 clearCookiesPreference.setIcon(R.drawable.clear_cookies_enabled);
1100 clearCookiesPreference.setIcon(R.drawable.clear_cookies_disabled);
1103 // Update the clear dom storage preference icon.
1104 if (newClearEverythingBoolean || sharedPreferences.getBoolean("clear_dom_storage", true)) {
1105 clearDomStoragePreference.setIcon(R.drawable.clear_dom_storage_enabled);
1107 clearDomStoragePreference.setIcon(R.drawable.clear_dom_storage_disabled);
1110 // Update the clear form data preference icon if the API < 26.
1111 if (Build.VERSION.SDK_INT < 26) {
1112 if (newClearEverythingBoolean || sharedPreferences.getBoolean("clear_form_data", true)) {
1113 clearFormDataPreference.setIcon(R.drawable.clear_form_data_enabled);
1115 clearFormDataPreference.setIcon(R.drawable.clear_form_data_disabled);
1119 // Update the clear logcat preference icon.
1120 if (newClearEverythingBoolean || sharedPreferences.getBoolean(context.getString(R.string.clear_logcat_key), true)) {
1121 clearLogcatPreference.setIcon(R.drawable.clear_logcat_enabled);
1123 clearLogcatPreference.setIcon(R.drawable.clear_cache_disabled);
1126 // Update the clear cache preference icon.
1127 if (newClearEverythingBoolean || sharedPreferences.getBoolean("clear_cache", true)) {
1128 clearCachePreference.setIcon(R.drawable.clear_cache_enabled);
1130 clearCachePreference.setIcon(R.drawable.clear_cache_disabled);
1134 case "clear_cookies":
1136 if (sharedPreferences.getBoolean("clear_cookies", true)) {
1137 clearCookiesPreference.setIcon(R.drawable.clear_cookies_enabled);
1139 clearCookiesPreference.setIcon(R.drawable.clear_cookies_disabled);
1143 case "clear_dom_storage":
1145 if (sharedPreferences.getBoolean("clear_dom_storage", true)) {
1146 clearDomStoragePreference.setIcon(R.drawable.clear_dom_storage_enabled);
1148 clearDomStoragePreference.setIcon(R.drawable.clear_dom_storage_disabled);
1152 // This section can be removed once the minimum API >= 26.
1153 case "clear_form_data":
1155 if (sharedPreferences.getBoolean("clear_form_data", true)) {
1156 clearFormDataPreference.setIcon(R.drawable.clear_form_data_enabled);
1158 clearFormDataPreference.setIcon(R.drawable.clear_form_data_disabled);
1162 case "clear_logcat":
1164 if (sharedPreferences.getBoolean(context.getString(R.string.clear_logcat_key), true)) {
1165 clearLogcatPreference.setIcon(R.drawable.clear_logcat_enabled);
1167 clearLogcatPreference.setIcon(R.drawable.clear_logcat_disabled);
1173 if (sharedPreferences.getBoolean("clear_cache", true)) {
1174 clearCachePreference.setIcon(R.drawable.clear_cache_enabled);
1176 clearCachePreference.setIcon(R.drawable.clear_cache_disabled);
1181 // Set the new homepage URL as the summary text for the Homepage preference.
1182 homepagePreference.setSummary(sharedPreferences.getString("homepage", context.getString(R.string.homepage_default_value)));
1186 // Update the font size summary text.
1187 fontSizePreference.setSummary(sharedPreferences.getString("font_size", context.getString(R.string.font_size_default_value)) + "%");
1190 case "open_intents_in_new_tab":
1192 if (sharedPreferences.getBoolean("open_intents_in_new_tab", true))
1193 openIntentsInNewTabPreference.setIcon(R.drawable.tab_enabled);
1195 openIntentsInNewTabPreference.setIcon(R.drawable.tab_disabled);
1198 case "swipe_to_refresh":
1200 if (sharedPreferences.getBoolean("swipe_to_refresh", true))
1201 swipeToRefreshPreference.setIcon(R.drawable.refresh_enabled);
1203 swipeToRefreshPreference.setIcon(R.drawable.refresh_disabled);
1206 case "download_with_external_app":
1208 if (sharedPreferences.getBoolean(context.getString(R.string.download_with_external_app_key), false))
1209 downloadWithExternalAppPreference.setIcon(R.drawable.download_with_external_app_enabled);
1211 downloadWithExternalAppPreference.setIcon(R.drawable.download_with_external_app_disabled);
1214 case "scroll_app_bar":
1216 if (sharedPreferences.getBoolean(context.getString(R.string.scroll_app_bar_key), true))
1217 scrollAppBarPreference.setIcon(R.drawable.app_bar_enabled);
1219 scrollAppBarPreference.setIcon(R.drawable.app_bar_disabled);
1223 case "bottom_app_bar":
1225 if (sharedPreferences.getBoolean(context.getString(R.string.bottom_app_bar_key), false))
1226 bottomAppBarPreference.setIcon(R.drawable.bottom_app_bar_enabled);
1228 bottomAppBarPreference.setIcon(R.drawable.bottom_app_bar_disabled);
1230 // Restart Privacy Browser.
1231 restartPrivacyBrowser();
1234 case "display_additional_app_bar_icons":
1236 if (sharedPreferences.getBoolean(context.getString(R.string.display_additional_app_bar_icons_key), false))
1237 displayAdditionalAppBarIconsPreference.setIcon(R.drawable.more_enabled);
1239 displayAdditionalAppBarIconsPreference.setIcon(R.drawable.more_disabled);
1243 // Get the new theme.
1244 String newAppTheme = sharedPreferences.getString("app_theme", context.getString(R.string.app_theme_default_value));
1246 // Update the system according to the new theme. A switch statement cannot be used because the theme entry values string array is not a compile-time constant.
1247 if (newAppTheme.equals(appThemeEntryValuesStringArray[1])) { // The light theme is selected.
1248 // Update the theme preference summary text.
1249 appThemePreference.setSummary(appThemeEntriesStringArray[1]);
1251 // Apply the new theme.
1252 AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO);
1253 } else if (newAppTheme.equals(appThemeEntryValuesStringArray[2])) { // The dark theme is selected.
1254 // Update the theme preference summary text.
1255 appThemePreference.setSummary(appThemeEntriesStringArray[2]);
1257 // Apply the new theme.
1258 AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES);
1259 } else { // The system default theme is selected.
1260 // Update the theme preference summary text.
1261 appThemePreference.setSummary(appThemeEntriesStringArray[0]);
1263 // Apply the new theme.
1264 if (Build.VERSION.SDK_INT >= 28) { // The system default theme is supported.
1265 // Follow the system default theme.
1266 AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM);
1267 } else {// The system default theme is not supported.
1268 // Follow the battery saver mode.
1269 AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_AUTO_BATTERY);
1273 // Update the current theme status.
1274 currentThemeStatus = getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
1277 case "webview_theme":
1278 // Get the new WebView theme.
1279 String newWebViewTheme = sharedPreferences.getString("webview_theme", context.getString(R.string.webview_theme_default_value));
1281 // Define a new WebView theme entry number.
1282 int newWebViewThemeEntryNumber;
1284 // Get the webView theme entry number that matches the new WebView theme. A switch statement cannot be used because the theme entry values string array is not a compile time constant.
1285 if (newWebViewTheme.equals(webViewThemeEntriesStringArray[1])) { // The light theme is selected.
1286 // Store the new WebView theme entry number.
1287 newWebViewThemeEntryNumber = 1;
1288 } else if (newWebViewTheme.equals(webViewThemeEntryValuesStringArray[2])) { // The dark theme is selected.
1289 // Store the WebView theme entry number.
1290 newWebViewThemeEntryNumber = 2;
1291 } else { // The system default theme is selected.
1292 // Store the WebView theme entry number.
1293 newWebViewThemeEntryNumber = 0;
1297 switch (newWebViewThemeEntryNumber) {
1298 case 0: // The system default WebView theme is selected.
1300 if (currentThemeStatus == Configuration.UI_MODE_NIGHT_NO) {
1301 webViewThemePreference.setIcon(R.drawable.webview_light_theme);
1303 webViewThemePreference.setIcon(R.drawable.webview_dark_theme);
1307 case 1: // The light theme is selected.
1309 webViewThemePreference.setIcon(R.drawable.webview_light_theme);
1312 case 2: // The dark theme is selected.
1314 webViewThemePreference.setIcon(R.drawable.webview_dark_theme);
1318 // Set the current theme as the summary text for the preference.
1319 webViewThemePreference.setSummary(webViewThemeEntriesStringArray[newWebViewThemeEntryNumber]);
1322 case "wide_viewport":
1324 if (sharedPreferences.getBoolean("wide_viewport", true)) {
1325 wideViewportPreference.setIcon(R.drawable.wide_viewport_enabled);
1327 wideViewportPreference.setIcon(R.drawable.wide_viewport_disabled);
1331 case "display_webpage_images":
1333 if (sharedPreferences.getBoolean("display_webpage_images", true)) {
1334 displayWebpageImagesPreference.setIcon(R.drawable.images_enabled);
1336 displayWebpageImagesPreference.setIcon(R.drawable.images_disabled);
1343 private void restartPrivacyBrowser() {
1344 // Create an intent to restart Privacy Browser.
1345 Intent restartIntent = requireActivity().getParentActivityIntent();
1347 // Assert that the intent is not null to remove the lint error below.
1348 assert restartIntent != null;
1350 // `Intent.FLAG_ACTIVITY_CLEAR_TASK` removes all activities from the stack. It requires `Intent.FLAG_ACTIVITY_NEW_TASK`.
1351 restartIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
1353 // Create a handler to restart the activity.
1354 Handler restartHandler = new Handler(Looper.getMainLooper());
1356 // Create a runnable to restart the activity.
1357 Runnable restartRunnable = () -> {
1358 // Restart the activity.
1359 startActivity(restartIntent);
1361 // Kill this instance of Privacy Browser. Otherwise, the app exhibits sporadic behavior after the restart.
1365 // Restart the activity after 400 milliseconds, so that the app has enough time to save the change to the preference.
1366 restartHandler.postDelayed(restartRunnable, 400);