]> gitweb.stoutner.com Git - PrivacyBrowserAndroid.git/blob - app/src/main/java/com/stoutner/privacybrowser/activities/MainWebViewActivity.java
Release 3.0.
[PrivacyBrowserAndroid.git] / app / src / main / java / com / stoutner / privacybrowser / activities / MainWebViewActivity.java
1 /*
2  * Copyright © 2015-2019 Soren Stoutner <soren@stoutner.com>.
3  *
4  * Download cookie code contributed 2017 Hendrik Knackstedt.  Copyright assigned to Soren Stoutner <soren@stoutner.com>.
5  *
6  * This file is part of Privacy Browser <https://www.stoutner.com/privacy-browser>.
7  *
8  * Privacy Browser is free software: you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation, either version 3 of the License, or
11  * (at your option) any later version.
12  *
13  * Privacy Browser is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with Privacy Browser.  If not, see <http://www.gnu.org/licenses/>.
20  */
21
22 package com.stoutner.privacybrowser.activities;
23
24 import android.Manifest;
25 import android.annotation.SuppressLint;
26 import android.app.Activity;
27 import android.app.DownloadManager;
28 import android.app.SearchManager;
29 import android.content.ActivityNotFoundException;
30 import android.content.BroadcastReceiver;
31 import android.content.ClipData;
32 import android.content.ClipboardManager;
33 import android.content.Context;
34 import android.content.Intent;
35 import android.content.IntentFilter;
36 import android.content.SharedPreferences;
37 import android.content.pm.PackageManager;
38 import android.content.res.Configuration;
39 import android.database.Cursor;
40 import android.graphics.Bitmap;
41 import android.graphics.BitmapFactory;
42 import android.graphics.Typeface;
43 import android.graphics.drawable.BitmapDrawable;
44 import android.graphics.drawable.Drawable;
45 import android.net.Uri;
46 import android.net.http.SslCertificate;
47 import android.net.http.SslError;
48 import android.os.Build;
49 import android.os.Bundle;
50 import android.os.Environment;
51 import android.os.Handler;
52 import android.preference.PreferenceManager;
53 import android.print.PrintDocumentAdapter;
54 import android.print.PrintManager;
55 import android.text.Editable;
56 import android.text.Spanned;
57 import android.text.TextWatcher;
58 import android.text.style.ForegroundColorSpan;
59 import android.util.Patterns;
60 import android.view.ContextMenu;
61 import android.view.GestureDetector;
62 import android.view.KeyEvent;
63 import android.view.Menu;
64 import android.view.MenuItem;
65 import android.view.MotionEvent;
66 import android.view.View;
67 import android.view.ViewGroup;
68 import android.view.WindowManager;
69 import android.view.inputmethod.InputMethodManager;
70 import android.webkit.CookieManager;
71 import android.webkit.HttpAuthHandler;
72 import android.webkit.SslErrorHandler;
73 import android.webkit.ValueCallback;
74 import android.webkit.WebChromeClient;
75 import android.webkit.WebResourceResponse;
76 import android.webkit.WebSettings;
77 import android.webkit.WebStorage;
78 import android.webkit.WebView;
79 import android.webkit.WebViewClient;
80 import android.webkit.WebViewDatabase;
81 import android.widget.ArrayAdapter;
82 import android.widget.CursorAdapter;
83 import android.widget.EditText;
84 import android.widget.FrameLayout;
85 import android.widget.ImageView;
86 import android.widget.LinearLayout;
87 import android.widget.ListView;
88 import android.widget.ProgressBar;
89 import android.widget.RadioButton;
90 import android.widget.RelativeLayout;
91 import android.widget.TextView;
92
93 import androidx.annotation.NonNull;
94 import androidx.appcompat.app.ActionBar;
95 import androidx.appcompat.app.ActionBarDrawerToggle;
96 import androidx.appcompat.app.AppCompatActivity;
97 import androidx.appcompat.widget.Toolbar;
98 import androidx.coordinatorlayout.widget.CoordinatorLayout;
99 import androidx.core.app.ActivityCompat;
100 import androidx.core.content.ContextCompat;
101 import androidx.core.view.GravityCompat;
102 import androidx.drawerlayout.widget.DrawerLayout;
103 import androidx.fragment.app.DialogFragment;
104 import androidx.fragment.app.FragmentManager;
105 import androidx.swiperefreshlayout.widget.SwipeRefreshLayout;
106 import androidx.viewpager.widget.ViewPager;
107
108 import com.google.android.material.appbar.AppBarLayout;
109 import com.google.android.material.floatingactionbutton.FloatingActionButton;
110 import com.google.android.material.navigation.NavigationView;
111 import com.google.android.material.snackbar.Snackbar;
112 import com.google.android.material.tabs.TabLayout;
113
114 import com.stoutner.privacybrowser.BuildConfig;
115 import com.stoutner.privacybrowser.R;
116 import com.stoutner.privacybrowser.adapters.WebViewPagerAdapter;
117 import com.stoutner.privacybrowser.asynctasks.GetHostIpAddresses;
118 import com.stoutner.privacybrowser.dialogs.AdConsentDialog;
119 import com.stoutner.privacybrowser.dialogs.CreateBookmarkDialog;
120 import com.stoutner.privacybrowser.dialogs.CreateBookmarkFolderDialog;
121 import com.stoutner.privacybrowser.dialogs.CreateHomeScreenShortcutDialog;
122 import com.stoutner.privacybrowser.dialogs.DownloadFileDialog;
123 import com.stoutner.privacybrowser.dialogs.DownloadImageDialog;
124 import com.stoutner.privacybrowser.dialogs.DownloadLocationPermissionDialog;
125 import com.stoutner.privacybrowser.dialogs.EditBookmarkDialog;
126 import com.stoutner.privacybrowser.dialogs.EditBookmarkFolderDialog;
127 import com.stoutner.privacybrowser.dialogs.HttpAuthenticationDialog;
128 import com.stoutner.privacybrowser.dialogs.SslCertificateErrorDialog;
129 import com.stoutner.privacybrowser.dialogs.UrlHistoryDialog;
130 import com.stoutner.privacybrowser.dialogs.ViewSslCertificateDialog;
131 import com.stoutner.privacybrowser.fragments.WebViewTabFragment;
132 import com.stoutner.privacybrowser.helpers.AdHelper;
133 import com.stoutner.privacybrowser.helpers.BlockListHelper;
134 import com.stoutner.privacybrowser.helpers.BookmarksDatabaseHelper;
135 import com.stoutner.privacybrowser.helpers.CheckPinnedMismatchHelper;
136 import com.stoutner.privacybrowser.helpers.DomainsDatabaseHelper;
137 import com.stoutner.privacybrowser.helpers.OrbotProxyHelper;
138 import com.stoutner.privacybrowser.views.NestedScrollWebView;
139
140 import java.io.ByteArrayInputStream;
141 import java.io.ByteArrayOutputStream;
142 import java.io.File;
143 import java.io.IOException;
144 import java.io.UnsupportedEncodingException;
145 import java.net.MalformedURLException;
146 import java.net.URL;
147 import java.net.URLDecoder;
148 import java.net.URLEncoder;
149 import java.util.ArrayList;
150 import java.util.Date;
151 import java.util.HashMap;
152 import java.util.HashSet;
153 import java.util.List;
154 import java.util.Map;
155 import java.util.Set;
156
157 // AppCompatActivity from android.support.v7.app.AppCompatActivity must be used to have access to the SupportActionBar until the minimum API is >= 21.
158 public class MainWebViewActivity extends AppCompatActivity implements CreateBookmarkDialog.CreateBookmarkListener, CreateBookmarkFolderDialog.CreateBookmarkFolderListener,
159         DownloadFileDialog.DownloadFileListener, DownloadImageDialog.DownloadImageListener, DownloadLocationPermissionDialog.DownloadLocationPermissionDialogListener, EditBookmarkDialog.EditBookmarkListener,
160         EditBookmarkFolderDialog.EditBookmarkFolderListener, NavigationView.OnNavigationItemSelectedListener, WebViewTabFragment.NewTabListener {
161
162     // `orbotStatus` is public static so it can be accessed from `OrbotProxyHelper`.  It is also used in `onCreate()`, `onResume()`, and `applyProxyThroughOrbot()`.
163     public static String orbotStatus;
164
165     // The WebView pager adapter is accessed from `HttpAuthenticationDialog`, `PinnedMismatchDialog`, and `SslCertificateErrorDialog`.  It is also used in `onCreate()`, `onResume()`, and `addTab()`.
166     public static WebViewPagerAdapter webViewPagerAdapter;
167
168     // The load URL on restart variables are public static so they can be accessed from `BookmarksActivity`.  They are used in `onRestart()`.
169     public static boolean loadUrlOnRestart;
170     public static String urlToLoadOnRestart;
171
172     // `restartFromBookmarksActivity` is public static so it can be accessed from `BookmarksActivity`.  It is also used in `onRestart()`.
173     public static boolean restartFromBookmarksActivity;
174
175     // `currentBookmarksFolder` is public static so it can be accessed from `BookmarksActivity`.  It is also used in `onCreate()`, `onBackPressed()`, `onCreateBookmark()`, `onCreateBookmarkFolder()`,
176     // `onSaveEditBookmark()`, `onSaveEditBookmarkFolder()`, and `loadBookmarksFolder()`.
177     public static String currentBookmarksFolder;
178
179     // The user agent constants are public static so they can be accessed from `SettingsFragment`, `DomainsActivity`, and `DomainSettingsFragment`.
180     public final static int UNRECOGNIZED_USER_AGENT = -1;
181     public final static int SETTINGS_WEBVIEW_DEFAULT_USER_AGENT = 1;
182     public final static int SETTINGS_CUSTOM_USER_AGENT = 12;
183     public final static int DOMAINS_SYSTEM_DEFAULT_USER_AGENT = 0;
184     public final static int DOMAINS_WEBVIEW_DEFAULT_USER_AGENT = 2;
185     public final static int DOMAINS_CUSTOM_USER_AGENT = 13;
186
187
188
189     // The current WebView is used in `onCreate()`, `onPrepareOptionsMenu()`, `onOptionsItemSelected()`, `onNavigationItemSelected()`, `onRestart()`, `onCreateContextMenu()`, `findPreviousOnPage()`,
190     // `findNextOnPage()`, `closeFindOnPage()`, `loadUrlFromTextBox()`, `onSslMismatchBack()`, `applyProxyThroughOrbot()`, and `applyDomainSettings()`.
191     private NestedScrollWebView currentWebView;
192
193     // `customHeader` is used in `onCreate()`, `onOptionsItemSelected()`, `onCreateContextMenu()`, and `loadUrl()`.
194     private final Map<String, String> customHeaders = new HashMap<>();
195
196     // The search URL is set in `applyProxyThroughOrbot()` and used in `onCreate()`, `onNewIntent()`, `loadURLFromTextBox()`, and `initializeWebView()`.
197     private String searchURL;
198
199     // The options menu is set in `onCreateOptionsMenu()` and used in `onOptionsItemSelected()`, `updatePrivacyIcons()`, and `initializeWebView()`.
200     private Menu optionsMenu;
201
202     // The blocklists are populated in `onCreate()` and accessed from `initializeWebView()`.
203     private ArrayList<List<String[]>> easyList;
204     private ArrayList<List<String[]>> easyPrivacy;
205     private ArrayList<List<String[]>> fanboysAnnoyanceList;
206     private ArrayList<List<String[]>> fanboysSocialList;
207     private ArrayList<List<String[]>> ultraPrivacy;
208
209     // `webViewDefaultUserAgent` is used in `onCreate()` and `onPrepareOptionsMenu()`.
210     private String webViewDefaultUserAgent;
211
212     // `proxyThroughOrbot` is used in `onRestart()`, `onOptionsItemSelected()`, `applyAppSettings()`, and `applyProxyThroughOrbot()`.
213     private boolean proxyThroughOrbot;
214
215     // The incognito mode is set in `applyAppSettings()` and used in `initializeWebView()`.
216     private boolean incognitoModeEnabled;
217
218     // The full screen browsing mode tracker is set it `applyAppSettings()` and used in `initializeWebView()`.
219     private boolean fullScreenBrowsingModeEnabled;
220
221     // `inFullScreenBrowsingMode` is used in `onCreate()`, `onConfigurationChanged()`, and `applyAppSettings()`.
222     private boolean inFullScreenBrowsingMode;
223
224     // The app bar trackers are set in `applyAppSettings()` and used in `initializeWebView()`.
225     private boolean hideAppBar;
226     private boolean scrollAppBar;
227
228     // The loading new intent tracker is set in `onNewIntent()` and used in `setCurrentWebView()`.
229     private boolean loadingNewIntent;
230
231     // `reapplyDomainSettingsOnRestart` is used in `onCreate()`, `onOptionsItemSelected()`, `onNavigationItemSelected()`, `onRestart()`, and `onAddDomain()`, .
232     private boolean reapplyDomainSettingsOnRestart;
233
234     // `reapplyAppSettingsOnRestart` is used in `onNavigationItemSelected()` and `onRestart()`.
235     private boolean reapplyAppSettingsOnRestart;
236
237     // `displayingFullScreenVideo` is used in `onCreate()` and `onResume()`.
238     private boolean displayingFullScreenVideo;
239
240     // `orbotStatusBroadcastReceiver` is used in `onCreate()` and `onDestroy()`.
241     private BroadcastReceiver orbotStatusBroadcastReceiver;
242
243     // `waitingForOrbot` is used in `onCreate()`, `onResume()`, and `applyProxyThroughOrbot()`.
244     private boolean waitingForOrbot;
245
246     // The action bar drawer toggle is initialized in `onCreate()` and used in `onResume()`.
247     private ActionBarDrawerToggle actionBarDrawerToggle;
248
249     // The color spans are used in `onCreate()` and `highlightUrlText()`.
250     private ForegroundColorSpan redColorSpan;
251     private ForegroundColorSpan initialGrayColorSpan;
252     private ForegroundColorSpan finalGrayColorSpan;
253
254     // The drawer header padding variables are used in `onCreate()` and `onConfigurationChanged()`.
255     private int drawerHeaderPaddingLeftAndRight;
256     private int drawerHeaderPaddingTop;
257     private int drawerHeaderPaddingBottom;
258
259     // `bookmarksDatabaseHelper` is used in `onCreate()`, `onDestroy`, `onOptionsItemSelected()`, `onCreateBookmark()`, `onCreateBookmarkFolder()`, `onSaveEditBookmark()`, `onSaveEditBookmarkFolder()`,
260     // and `loadBookmarksFolder()`.
261     private BookmarksDatabaseHelper bookmarksDatabaseHelper;
262
263     // `bookmarksCursor` is used in `onDestroy()`, `onOptionsItemSelected()`, `onCreateBookmark()`, `onCreateBookmarkFolder()`, `onSaveEditBookmark()`, `onSaveEditBookmarkFolder()`, and `loadBookmarksFolder()`.
264     private Cursor bookmarksCursor;
265
266     // `bookmarksCursorAdapter` is used in `onCreateBookmark()`, `onCreateBookmarkFolder()` `onSaveEditBookmark()`, `onSaveEditBookmarkFolder()`, and `loadBookmarksFolder()`.
267     private CursorAdapter bookmarksCursorAdapter;
268
269     // `oldFolderNameString` is used in `onCreate()` and `onSaveEditBookmarkFolder()`.
270     private String oldFolderNameString;
271
272     // `fileChooserCallback` is used in `onCreate()` and `onActivityResult()`.
273     private ValueCallback<Uri[]> fileChooserCallback;
274
275     // The default progress view offsets are set in `onCreate()` and used in `initializeWebView()`.
276     private int defaultProgressViewStartOffset;
277     private int defaultProgressViewEndOffset;
278
279     // The swipe refresh layout top padding is used when exiting full screen browsing mode.  It is used in an inner class in `initializeWebView()`.
280     private int swipeRefreshLayoutPaddingTop;
281
282     // The download strings are used in `onCreate()`, `onRequestPermissionResult()` and `initializeWebView()`.
283     private String downloadUrl;
284     private String downloadContentDisposition;
285     private long downloadContentLength;
286
287     // `downloadImageUrl` is used in `onCreateContextMenu()` and `onRequestPermissionResult()`.
288     private String downloadImageUrl;
289
290     // The request codes are used in `onCreate()`, `onCreateContextMenu()`, `onCloseDownloadLocationPermissionDialog()`, `onRequestPermissionResult()`, and `initializeWebView()`.
291     private final int DOWNLOAD_FILE_REQUEST_CODE = 1;
292     private final int DOWNLOAD_IMAGE_REQUEST_CODE = 2;
293
294     @Override
295     // Remove the warning about needing to override `performClick()` when using an `OnTouchListener` with `WebView`.
296     @SuppressLint("ClickableViewAccessibility")
297     protected void onCreate(Bundle savedInstanceState) {
298         // Get a handle for the shared preferences.
299         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
300
301         // Get the theme and screenshot preferences.
302         boolean darkTheme = sharedPreferences.getBoolean("dark_theme", false);
303         boolean allowScreenshots = sharedPreferences.getBoolean("allow_screenshots", false);
304
305         // Disable screenshots if not allowed.
306         if (!allowScreenshots) {
307             getWindow().addFlags(WindowManager.LayoutParams.FLAG_SECURE);
308         }
309
310         // Set the activity theme.
311         if (darkTheme) {
312             setTheme(R.style.PrivacyBrowserDark);
313         } else {
314             setTheme(R.style.PrivacyBrowserLight);
315         }
316
317         // Run the default commands.
318         super.onCreate(savedInstanceState);
319
320         // Set the content view.
321         setContentView(R.layout.main_framelayout);
322
323         // Get a handle for the input method.
324         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
325
326         // Remove the lint warning below that the input method manager might be null.
327         assert inputMethodManager != null;
328
329         // Get a handle for the toolbar.
330         Toolbar toolbar = findViewById(R.id.toolbar);
331
332         // Set the action bar.  `SupportActionBar` must be used until the minimum API is >= 21.
333         setSupportActionBar(toolbar);
334
335         // Get a handle for the action bar.
336         ActionBar actionBar = getSupportActionBar();
337
338         // This is needed to get rid of the Android Studio warning that the action bar might be null.
339         assert actionBar != null;
340
341         // Add the custom layout, which shows the URL text bar.
342         actionBar.setCustomView(R.layout.url_app_bar);
343         actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM);
344
345         // Initialize the foreground color spans for highlighting the URLs.  We have to use the deprecated `getColor()` until API >= 23.
346         redColorSpan = new ForegroundColorSpan(getResources().getColor(R.color.red_a700));
347         initialGrayColorSpan = new ForegroundColorSpan(getResources().getColor(R.color.gray_500));
348         finalGrayColorSpan = new ForegroundColorSpan(getResources().getColor(R.color.gray_500));
349
350         // Get handles for the URL views.
351         EditText urlEditText = findViewById(R.id.url_edittext);
352
353         // Remove the formatting from `urlTextBar` when the user is editing the text.
354         urlEditText.setOnFocusChangeListener((View v, boolean hasFocus) -> {
355             if (hasFocus) {  // The user is editing the URL text box.
356                 // Remove the highlighting.
357                 urlEditText.getText().removeSpan(redColorSpan);
358                 urlEditText.getText().removeSpan(initialGrayColorSpan);
359                 urlEditText.getText().removeSpan(finalGrayColorSpan);
360             } else {  // The user has stopped editing the URL text box.
361                 // Move to the beginning of the string.
362                 urlEditText.setSelection(0);
363
364                 // Reapply the highlighting.
365                 highlightUrlText();
366             }
367         });
368
369         // Set the go button on the keyboard to load the URL in `urlTextBox`.
370         urlEditText.setOnKeyListener((View v, int keyCode, KeyEvent event) -> {
371             // If the event is a key-down event on the `enter` button, load the URL.
372             if ((event.getAction() == KeyEvent.ACTION_DOWN) && (keyCode == KeyEvent.KEYCODE_ENTER)) {
373                 // Load the URL into the mainWebView and consume the event.
374                 loadUrlFromTextBox();
375
376                 // If the enter key was pressed, consume the event.
377                 return true;
378             } else {
379                 // If any other key was pressed, do not consume the event.
380                 return false;
381             }
382         });
383
384         // Initialize the Orbot status and the waiting for Orbot trackers.
385         orbotStatus = "unknown";
386         waitingForOrbot = false;
387
388         // Create an Orbot status `BroadcastReceiver`.
389         orbotStatusBroadcastReceiver = new BroadcastReceiver() {
390             @Override
391             public void onReceive(Context context, Intent intent) {
392                 // Store the content of the status message in `orbotStatus`.
393                 orbotStatus = intent.getStringExtra("org.torproject.android.intent.extra.STATUS");
394
395                 // If Privacy Browser is waiting on Orbot, load the website now that Orbot is connected.
396                 if (orbotStatus.equals("ON") && waitingForOrbot) {
397                     // Reset the waiting for Orbot status.
398                     waitingForOrbot = false;
399
400                     // Get the intent that started the app.
401                     Intent launchingIntent = getIntent();
402
403                     // Get the information from the intent.
404                     String launchingIntentAction = launchingIntent.getAction();
405                     Uri launchingIntentUriData = launchingIntent.getData();
406
407                     // If the intent action is a web search, perform the search.
408                     if ((launchingIntentAction != null) && launchingIntentAction.equals(Intent.ACTION_WEB_SEARCH)) {
409                         // Create an encoded URL string.
410                         String encodedUrlString;
411
412                         // Sanitize the search input and convert it to a search.
413                         try {
414                             encodedUrlString = URLEncoder.encode(launchingIntent.getStringExtra(SearchManager.QUERY), "UTF-8");
415                         } catch (UnsupportedEncodingException exception) {
416                             encodedUrlString = "";
417                         }
418
419                         // Load the completed search URL.
420                         loadUrl(searchURL + encodedUrlString);
421                     } else if (launchingIntentUriData != null){  // Check to see if the intent contains a new URL.
422                         // Load the URL from the intent.
423                         loadUrl(launchingIntentUriData.toString());
424                     } else {  // The is no URL in the intent.
425                         // Select the homepage based on the proxy through Orbot status.
426                         if (proxyThroughOrbot) {
427                             // Load the Tor homepage.
428                             loadUrl(sharedPreferences.getString("tor_homepage", getString(R.string.tor_homepage_default_value)));
429                         } else {
430                             // Load the normal homepage.
431                             loadUrl(sharedPreferences.getString("homepage", getString(R.string.homepage_default_value)));
432                         }
433                     }
434                 }
435             }
436         };
437
438         // Register `orbotStatusBroadcastReceiver` on `this` context.
439         this.registerReceiver(orbotStatusBroadcastReceiver, new IntentFilter("org.torproject.android.intent.action.STATUS"));
440
441         // Instantiate the blocklist helper.
442         BlockListHelper blockListHelper = new BlockListHelper();
443
444         // Parse the block lists.
445         easyList = blockListHelper.parseBlockList(getAssets(), "blocklists/easylist.txt");
446         easyPrivacy = blockListHelper.parseBlockList(getAssets(), "blocklists/easyprivacy.txt");
447         fanboysAnnoyanceList = blockListHelper.parseBlockList(getAssets(), "blocklists/fanboy-annoyance.txt");
448         fanboysSocialList = blockListHelper.parseBlockList(getAssets(), "blocklists/fanboy-social.txt");
449         ultraPrivacy = blockListHelper.parseBlockList(getAssets(), "blocklists/ultraprivacy.txt");
450
451         // Get handles for views that need to be modified.
452         DrawerLayout drawerLayout = findViewById(R.id.drawerlayout);
453         NavigationView navigationView = findViewById(R.id.navigationview);
454         TabLayout tabLayout = findViewById(R.id.tablayout);
455         SwipeRefreshLayout swipeRefreshLayout = findViewById(R.id.swiperefreshlayout);
456         ViewPager webViewPager = findViewById(R.id.webviewpager);
457         ListView bookmarksListView = findViewById(R.id.bookmarks_drawer_listview);
458         FloatingActionButton launchBookmarksActivityFab = findViewById(R.id.launch_bookmarks_activity_fab);
459         FloatingActionButton createBookmarkFolderFab = findViewById(R.id.create_bookmark_folder_fab);
460         FloatingActionButton createBookmarkFab = findViewById(R.id.create_bookmark_fab);
461         EditText findOnPageEditText = findViewById(R.id.find_on_page_edittext);
462
463         // Listen for touches on the navigation menu.
464         navigationView.setNavigationItemSelectedListener(this);
465
466         // Get handles for the navigation menu and the back and forward menu items.  The menu is zero-based.
467         Menu navigationMenu = navigationView.getMenu();
468         MenuItem navigationCloseTabMenuItem = navigationMenu.getItem(0);
469         MenuItem navigationBackMenuItem = navigationMenu.getItem(3);
470         MenuItem navigationForwardMenuItem = navigationMenu.getItem(4);
471         MenuItem navigationHistoryMenuItem = navigationMenu.getItem(5);
472         MenuItem navigationRequestsMenuItem = navigationMenu.getItem(6);
473
474         // Initialize the web view pager adapter.
475         webViewPagerAdapter = new WebViewPagerAdapter(getSupportFragmentManager());
476
477         // Set the pager adapter on the web view pager.
478         webViewPager.setAdapter(webViewPagerAdapter);
479
480         // Store up to 100 tabs in memory.
481         webViewPager.setOffscreenPageLimit(100);
482
483         // Update the web view pager every time a tab is modified.
484         webViewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
485             @Override
486             public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
487                 // Do nothing.
488             }
489
490             @Override
491             public void onPageSelected(int position) {
492                 // Close the find on page bar if it is open.
493                 closeFindOnPage(null);
494
495                 // Set the current WebView.
496                 setCurrentWebView(position);
497
498                 // Select the corresponding tab if it does not match the currently selected page.  This will happen if the page was scrolled via swiping in the view pager or by creating a new tab.
499                 if (tabLayout.getSelectedTabPosition() != position) {
500                     // Create a handler to select the tab.
501                     Handler selectTabHandler = new Handler();
502
503                     // Create a runnable select the new tab.
504                     Runnable selectTabRunnable = () -> {
505                         // Get a handle for the tab.
506                         TabLayout.Tab tab = tabLayout.getTabAt(position);
507
508                         // Assert that the tab is not null.
509                         assert tab != null;
510
511                         // Select the tab.
512                         tab.select();
513                     };
514
515                     // Select the tab layout after 100 milliseconds, which leaves enough time for a new tab to be created.
516                     selectTabHandler.postDelayed(selectTabRunnable, 100);
517                 }
518             }
519
520             @Override
521             public void onPageScrollStateChanged(int state) {
522                 // Do nothing.
523             }
524         });
525
526         // Display the View SSL Certificate dialog when the currently selected tab is reselected.
527         tabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {
528             @Override
529             public void onTabSelected(TabLayout.Tab tab) {
530                 // Select the same page in the view pager.
531                 webViewPager.setCurrentItem(tab.getPosition());
532             }
533
534             @Override
535             public void onTabUnselected(TabLayout.Tab tab) {
536                 // Do nothing.
537             }
538
539             @Override
540             public void onTabReselected(TabLayout.Tab tab) {
541                 // Instantiate the View SSL Certificate dialog.
542                 DialogFragment viewSslCertificateDialogFragment = ViewSslCertificateDialog.displayDialog(currentWebView.getWebViewFragmentId());
543
544                 // Display the View SSL Certificate dialog.
545                 viewSslCertificateDialogFragment.show(getSupportFragmentManager(), getString(R.string.view_ssl_certificate));
546             }
547         });
548
549         // Add the first tab.
550         addTab(null);
551
552         // Set the bookmarks drawer resources according to the theme.  This can't be done in the layout due to compatibility issues with the `DrawerLayout` support widget.
553         // The deprecated `getResources().getDrawable()` must be used until the minimum API >= 21 and and `getResources().getColor()` must be used until the minimum API >= 23.
554         if (darkTheme) {
555             launchBookmarksActivityFab.setImageDrawable(getResources().getDrawable(R.drawable.bookmarks_dark));
556             createBookmarkFolderFab.setImageDrawable(getResources().getDrawable(R.drawable.create_folder_dark));
557             createBookmarkFab.setImageDrawable(getResources().getDrawable(R.drawable.create_bookmark_dark));
558             bookmarksListView.setBackgroundColor(getResources().getColor(R.color.gray_850));
559         } else {
560             launchBookmarksActivityFab.setImageDrawable(getResources().getDrawable(R.drawable.bookmarks_light));
561             createBookmarkFolderFab.setImageDrawable(getResources().getDrawable(R.drawable.create_folder_light));
562             createBookmarkFab.setImageDrawable(getResources().getDrawable(R.drawable.create_bookmark_light));
563             bookmarksListView.setBackgroundColor(getResources().getColor(R.color.white));
564         }
565
566         // Set the launch bookmarks activity FAB to launch the bookmarks activity.
567         launchBookmarksActivityFab.setOnClickListener(v -> {
568             // Get a copy of the favorite icon bitmap.
569             Bitmap favoriteIconBitmap = currentWebView.getFavoriteOrDefaultIcon();
570
571             // Create a favorite icon byte array output stream.
572             ByteArrayOutputStream favoriteIconByteArrayOutputStream = new ByteArrayOutputStream();
573
574             // Convert the favorite icon bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
575             favoriteIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, favoriteIconByteArrayOutputStream);
576
577             // Convert the favorite icon byte array stream to a byte array.
578             byte[] favoriteIconByteArray = favoriteIconByteArrayOutputStream.toByteArray();
579
580             // Create an intent to launch the bookmarks activity.
581             Intent bookmarksIntent = new Intent(getApplicationContext(), BookmarksActivity.class);
582
583             // Add the extra information to the intent.
584             bookmarksIntent.putExtra("current_url", currentWebView.getUrl());
585             bookmarksIntent.putExtra("current_title", currentWebView.getTitle());
586             bookmarksIntent.putExtra("current_folder", currentBookmarksFolder);
587             bookmarksIntent.putExtra("favorite_icon_byte_array", favoriteIconByteArray);
588
589             // Make it so.
590             startActivity(bookmarksIntent);
591         });
592
593         // Set the create new bookmark folder FAB to display an alert dialog.
594         createBookmarkFolderFab.setOnClickListener(v -> {
595             // Create a create bookmark folder dialog.
596             DialogFragment createBookmarkFolderDialog = CreateBookmarkFolderDialog.createBookmarkFolder(currentWebView.getFavoriteOrDefaultIcon());
597
598             // Show the create bookmark folder dialog.
599             createBookmarkFolderDialog.show(getSupportFragmentManager(), getString(R.string.create_folder));
600         });
601
602         // Set the create new bookmark FAB to display an alert dialog.
603         createBookmarkFab.setOnClickListener(view -> {
604             // Instantiate the create bookmark dialog.
605             DialogFragment createBookmarkDialog = CreateBookmarkDialog.createBookmark(currentWebView.getUrl(), currentWebView.getTitle(), currentWebView.getFavoriteOrDefaultIcon());
606
607             // Display the create bookmark dialog.
608             createBookmarkDialog.show(getSupportFragmentManager(), getString(R.string.create_bookmark));
609         });
610
611         // Search for the string on the page whenever a character changes in the `findOnPageEditText`.
612         findOnPageEditText.addTextChangedListener(new TextWatcher() {
613             @Override
614             public void beforeTextChanged(CharSequence s, int start, int count, int after) {
615                 // Do nothing.
616             }
617
618             @Override
619             public void onTextChanged(CharSequence s, int start, int before, int count) {
620                 // Do nothing.
621             }
622
623             @Override
624             public void afterTextChanged(Editable s) {
625                 // Search for the text in the WebView if it is not null.  Sometimes on resume after a period of non-use the WebView will be null.
626                 if (currentWebView != null) {
627                     currentWebView.findAllAsync(findOnPageEditText.getText().toString());
628                 }
629             }
630         });
631
632         // Set the `check mark` button for the `findOnPageEditText` keyboard to close the soft keyboard.
633         findOnPageEditText.setOnKeyListener((v, keyCode, event) -> {
634             if ((event.getAction() == KeyEvent.ACTION_DOWN) && (keyCode == KeyEvent.KEYCODE_ENTER)) {  // The `enter` key was pressed.
635                 // Hide the soft keyboard.
636                 inputMethodManager.hideSoftInputFromWindow(currentWebView.getWindowToken(), 0);
637
638                 // Consume the event.
639                 return true;
640             } else {  // A different key was pressed.
641                 // Do not consume the event.
642                 return false;
643             }
644         });
645
646         // Implement swipe to refresh.
647         swipeRefreshLayout.setOnRefreshListener(() -> currentWebView.reload());
648
649         // Store the default progress view offsets for use later in `initializeWebView()`.
650         defaultProgressViewStartOffset = swipeRefreshLayout.getProgressViewStartOffset();
651         defaultProgressViewEndOffset = swipeRefreshLayout.getProgressViewEndOffset();
652
653         // Set the swipe to refresh color according to the theme.
654         if (darkTheme) {
655             swipeRefreshLayout.setColorSchemeResources(R.color.blue_800);
656             swipeRefreshLayout.setProgressBackgroundColorSchemeResource(R.color.gray_850);
657         } else {
658             swipeRefreshLayout.setColorSchemeResources(R.color.blue_500);
659         }
660
661         // `DrawerTitle` identifies the `DrawerLayouts` in accessibility mode.
662         drawerLayout.setDrawerTitle(GravityCompat.START, getString(R.string.navigation_drawer));
663         drawerLayout.setDrawerTitle(GravityCompat.END, getString(R.string.bookmarks));
664
665         // Initialize the bookmarks database helper.  The `0` specifies a database version, but that is ignored and set instead using a constant in `BookmarksDatabaseHelper`.
666         bookmarksDatabaseHelper = new BookmarksDatabaseHelper(this, null, null, 0);
667
668         // Initialize `currentBookmarksFolder`.  `""` is the home folder in the database.
669         currentBookmarksFolder = "";
670
671         // Load the home folder, which is `""` in the database.
672         loadBookmarksFolder();
673
674         bookmarksListView.setOnItemClickListener((parent, view, position, id) -> {
675             // Convert the id from long to int to match the format of the bookmarks database.
676             int databaseID = (int) id;
677
678             // Get the bookmark cursor for this ID and move it to the first row.
679             Cursor bookmarkCursor = bookmarksDatabaseHelper.getBookmark(databaseID);
680             bookmarkCursor.moveToFirst();
681
682             // Act upon the bookmark according to the type.
683             if (bookmarkCursor.getInt(bookmarkCursor.getColumnIndex(BookmarksDatabaseHelper.IS_FOLDER)) == 1) {  // The selected bookmark is a folder.
684                 // Store the new folder name in `currentBookmarksFolder`.
685                 currentBookmarksFolder = bookmarkCursor.getString(bookmarkCursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME));
686
687                 // Load the new folder.
688                 loadBookmarksFolder();
689             } else {  // The selected bookmark is not a folder.
690                 // Load the bookmark URL.
691                 loadUrl(bookmarkCursor.getString(bookmarkCursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_URL)));
692
693                 // Close the bookmarks drawer.
694                 drawerLayout.closeDrawer(GravityCompat.END);
695             }
696
697             // Close the `Cursor`.
698             bookmarkCursor.close();
699         });
700
701         bookmarksListView.setOnItemLongClickListener((parent, view, position, id) -> {
702             // Convert the database ID from `long` to `int`.
703             int databaseId = (int) id;
704
705             // Find out if the selected bookmark is a folder.
706             boolean isFolder = bookmarksDatabaseHelper.isFolder(databaseId);
707
708             if (isFolder) {
709                 // Save the current folder name, which is used in `onSaveEditBookmarkFolder()`.
710                 oldFolderNameString = bookmarksCursor.getString(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME));
711
712                 // Show the edit bookmark folder `AlertDialog` and name the instance `@string/edit_folder`.
713                 DialogFragment editBookmarkFolderDialog = EditBookmarkFolderDialog.folderDatabaseId(databaseId, currentWebView.getFavoriteOrDefaultIcon());
714                 editBookmarkFolderDialog.show(getSupportFragmentManager(), getString(R.string.edit_folder));
715             } else {
716                 // Show the edit bookmark `AlertDialog` and name the instance `@string/edit_bookmark`.
717                 DialogFragment editBookmarkDialog = EditBookmarkDialog.bookmarkDatabaseId(databaseId, currentWebView.getFavoriteOrDefaultIcon());
718                 editBookmarkDialog.show(getSupportFragmentManager(), getString(R.string.edit_bookmark));
719             }
720
721             // Consume the event.
722             return true;
723         });
724
725         // Get the status bar pixel size.
726         int statusBarResourceId = getResources().getIdentifier("status_bar_height", "dimen", "android");
727         int statusBarPixelSize = getResources().getDimensionPixelSize(statusBarResourceId);
728
729         // Get the resource density.
730         float screenDensity = getResources().getDisplayMetrics().density;
731
732         // Calculate the drawer header padding.  This is used to move the text in the drawer headers below any cutouts.
733         drawerHeaderPaddingLeftAndRight = (int) (15 * screenDensity);
734         drawerHeaderPaddingTop = statusBarPixelSize + (int) (4 * screenDensity);
735         drawerHeaderPaddingBottom = (int) (8 * screenDensity);
736
737         // The drawer listener is used to update the navigation menu.`
738         drawerLayout.addDrawerListener(new DrawerLayout.DrawerListener() {
739             @Override
740             public void onDrawerSlide(@NonNull View drawerView, float slideOffset) {
741             }
742
743             @Override
744             public void onDrawerOpened(@NonNull View drawerView) {
745             }
746
747             @Override
748             public void onDrawerClosed(@NonNull View drawerView) {
749             }
750
751             @Override
752             public void onDrawerStateChanged(int newState) {
753                 if ((newState == DrawerLayout.STATE_SETTLING) || (newState == DrawerLayout.STATE_DRAGGING)) {  // A drawer is opening or closing.
754                     // Get handles for the drawer headers.
755                     TextView navigationHeaderTextView = findViewById(R.id.navigationText);
756                     TextView bookmarksHeaderTextView = findViewById(R.id.bookmarks_title_textview);
757
758                     // Apply the navigation header paddings if the view is not null (sometimes it is null if another activity has already started).  This moves the text in the header below any cutouts.
759                     if (navigationHeaderTextView != null) {
760                         navigationHeaderTextView.setPadding(drawerHeaderPaddingLeftAndRight, drawerHeaderPaddingTop, drawerHeaderPaddingLeftAndRight, drawerHeaderPaddingBottom);
761                     }
762
763                     // Apply the bookmarks header paddings if the view is not null (sometimes it is null if another activity has already started).  This moves the text in the header below any cutouts.
764                     if (bookmarksHeaderTextView != null) {
765                         bookmarksHeaderTextView.setPadding(drawerHeaderPaddingLeftAndRight, drawerHeaderPaddingTop, drawerHeaderPaddingLeftAndRight, drawerHeaderPaddingBottom);
766                     }
767
768                     // Update the navigation menu items.
769                     navigationCloseTabMenuItem.setEnabled(tabLayout.getTabCount() > 1);
770                     navigationBackMenuItem.setEnabled(currentWebView.canGoBack());
771                     navigationForwardMenuItem.setEnabled(currentWebView.canGoForward());
772                     navigationHistoryMenuItem.setEnabled((currentWebView.canGoBack() || currentWebView.canGoForward()));
773                     navigationRequestsMenuItem.setTitle(getString(R.string.requests) + " - " + currentWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
774
775                     // Hide the keyboard (if displayed).
776                     inputMethodManager.hideSoftInputFromWindow(currentWebView.getWindowToken(), 0);
777
778                     // Clear the focus from from the URL text box and the WebView.  This removes any text selection markers and context menus, which otherwise draw above the open drawers.
779                     urlEditText.clearFocus();
780                     currentWebView.clearFocus();
781                 }
782             }
783         });
784
785         // Create the hamburger icon at the start of the AppBar.
786         actionBarDrawerToggle = new ActionBarDrawerToggle(this, drawerLayout, toolbar, R.string.open_navigation_drawer, R.string.close_navigation_drawer);
787
788         // Replace the header that `WebView` creates for `X-Requested-With` with a null value.  The default value is the application ID (com.stoutner.privacybrowser.standard).
789         customHeaders.put("X-Requested-With", "");
790
791         // Initialize the default preference values the first time the program is run.  `false` keeps this command from resetting any current preferences back to default.
792         PreferenceManager.setDefaultValues(this, R.xml.preferences, false);
793
794         // Inflate a bare WebView to get the default user agent.  It is not used to render content on the screen.
795         @SuppressLint("InflateParams") View webViewLayout = getLayoutInflater().inflate(R.layout.bare_webview, null, false);
796
797         // Get a handle for the WebView.
798         WebView bareWebView = webViewLayout.findViewById(R.id.bare_webview);
799
800         // Store the default user agent.
801         webViewDefaultUserAgent = bareWebView.getSettings().getUserAgentString();
802
803         // Destroy the bare WebView.
804         bareWebView.destroy();
805     }
806
807     @Override
808     protected void onNewIntent(Intent intent) {
809         // Get the information from the intent.
810         String intentAction = intent.getAction();
811         Uri intentUriData = intent.getData();
812
813         // Only process the URI if it contains data.  If the user pressed the desktop icon after the app was already running the URI will be null.
814         if (intentUriData != null) {
815             // Sets the new intent as the activity intent, which replaces the one that originally started the app.
816             setIntent(intent);
817
818             // Get the shared preferences.
819             SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
820
821             // Add a new tab if specified in the preferences.
822             if (sharedPreferences.getBoolean("open_intents_in_new_tab", true)) {
823                 // Set the loading new intent flag.
824                 loadingNewIntent = true;
825
826                 // Add a new tab.
827                 addTab(null);
828             }
829
830             // Create a URL string.
831             String url;
832
833             // If the intent action is a web search, perform the search.
834             if ((intentAction != null) && intentAction.equals(Intent.ACTION_WEB_SEARCH)) {
835                 // Create an encoded URL string.
836                 String encodedUrlString;
837
838                 // Sanitize the search input and convert it to a search.
839                 try {
840                     encodedUrlString = URLEncoder.encode(intent.getStringExtra(SearchManager.QUERY), "UTF-8");
841                 } catch (UnsupportedEncodingException exception) {
842                     encodedUrlString = "";
843                 }
844
845                 // Add the base search URL.
846                 url = searchURL + encodedUrlString;
847             } else {  // The intent should contain a URL.
848                 // Set the intent data as the URL.
849                 url = intentUriData.toString();
850             }
851
852             // Load the URL.
853             loadUrl(url);
854
855             // Get a handle for the drawer layout.
856             DrawerLayout drawerLayout = findViewById(R.id.drawerlayout);
857
858             // Close the navigation drawer if it is open.
859             if (drawerLayout.isDrawerVisible(GravityCompat.START)) {
860                 drawerLayout.closeDrawer(GravityCompat.START);
861             }
862
863             // Close the bookmarks drawer if it is open.
864             if (drawerLayout.isDrawerVisible(GravityCompat.END)) {
865                 drawerLayout.closeDrawer(GravityCompat.END);
866             }
867
868             // Clear the keyboard if displayed and remove the focus on the urlTextBar if it has it.
869             currentWebView.requestFocus();
870         }
871     }
872
873     @Override
874     public void onRestart() {
875         // Run the default commands.
876         super.onRestart();
877
878         // Make sure Orbot is running if Privacy Browser is proxying through Orbot.
879         if (proxyThroughOrbot) {
880             // Request Orbot to start.  If Orbot is already running no hard will be caused by this request.
881             Intent orbotIntent = new Intent("org.torproject.android.intent.action.START");
882
883             // Send the intent to the Orbot package.
884             orbotIntent.setPackage("org.torproject.android");
885
886             // Make it so.
887             sendBroadcast(orbotIntent);
888         }
889
890         // Apply the app settings if returning from the Settings activity.
891         if (reapplyAppSettingsOnRestart) {
892             // Reset the reapply app settings on restart tracker.
893             reapplyAppSettingsOnRestart = false;
894
895             // Apply the app settings.
896             applyAppSettings();
897         }
898
899         // Apply the domain settings if returning from the settings or domains activity.
900         if (reapplyDomainSettingsOnRestart) {
901             // Reset the reapply domain settings on restart tracker.
902             reapplyDomainSettingsOnRestart = false;
903
904             // Reapply the domain settings for each tab.
905             for (int i = 0; i < webViewPagerAdapter.getCount(); i++) {
906                 // Get the WebView tab fragment.
907                 WebViewTabFragment webViewTabFragment = webViewPagerAdapter.getPageFragment(i);
908
909                 // Get the fragment view.
910                 View fragmentView = webViewTabFragment.getView();
911
912                 // Only reload the WebViews if they exist.
913                 if (fragmentView != null) {
914                     // Get the nested scroll WebView from the tab fragment.
915                     NestedScrollWebView nestedScrollWebView = fragmentView.findViewById(R.id.nestedscroll_webview);
916
917                     // Reset the current domain name so the domain settings will be reapplied.
918                     nestedScrollWebView.resetCurrentDomainName();
919
920                     // Reapply the domain settings if the URL is not null, which can happen if an empty tab is active when returning from settings.
921                     if (nestedScrollWebView.getUrl() != null) {
922                         applyDomainSettings(nestedScrollWebView, nestedScrollWebView.getUrl(), false, true);
923                     }
924                 }
925             }
926         }
927
928         // Load the URL on restart (used when loading a bookmark).
929         if (loadUrlOnRestart) {
930             // Load the specified URL.
931             loadUrl(urlToLoadOnRestart);
932
933             // Reset the load on restart tracker.
934             loadUrlOnRestart = false;
935         }
936
937         // Update the bookmarks drawer if returning from the Bookmarks activity.
938         if (restartFromBookmarksActivity) {
939             // Get a handle for the drawer layout.
940             DrawerLayout drawerLayout = findViewById(R.id.drawerlayout);
941
942             // Close the bookmarks drawer.
943             drawerLayout.closeDrawer(GravityCompat.END);
944
945             // Reload the bookmarks drawer.
946             loadBookmarksFolder();
947
948             // Reset `restartFromBookmarksActivity`.
949             restartFromBookmarksActivity = false;
950         }
951
952         // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.  This can be important if the screen was rotated.
953         updatePrivacyIcons(true);
954     }
955
956     // `onResume()` runs after `onStart()`, which runs after `onCreate()` and `onRestart()`.
957     @Override
958     public void onResume() {
959         // Run the default commands.
960         super.onResume();
961
962         for (int i = 0; i < webViewPagerAdapter.getCount(); i++) {
963             // Get the WebView tab fragment.
964             WebViewTabFragment webViewTabFragment = webViewPagerAdapter.getPageFragment(i);
965
966             // Get the fragment view.
967             View fragmentView = webViewTabFragment.getView();
968
969             // Only resume the WebViews if they exist (they won't when the app is first created).
970             if (fragmentView != null) {
971                 // Get the nested scroll WebView from the tab fragment.
972                 NestedScrollWebView nestedScrollWebView = fragmentView.findViewById(R.id.nestedscroll_webview);
973
974                 // Resume the nested scroll WebView JavaScript timers.
975                 nestedScrollWebView.resumeTimers();
976
977                 // Resume the nested scroll WebView.
978                 nestedScrollWebView.onResume();
979             }
980         }
981
982         // Display a message to the user if waiting for Orbot.
983         if (waitingForOrbot && !orbotStatus.equals("ON")) {
984             // Disable the wide view port so that the waiting for Orbot text is displayed correctly.
985             currentWebView.getSettings().setUseWideViewPort(false);
986
987             // Load a waiting page.  `null` specifies no encoding, which defaults to ASCII.
988             currentWebView.loadData("<html><body><br/><center><h1>" + getString(R.string.waiting_for_orbot) + "</h1></center></body></html>", "text/html", null);
989         }
990
991         if (displayingFullScreenVideo || inFullScreenBrowsingMode) {
992             // Get a handle for the root frame layouts.
993             FrameLayout rootFrameLayout = findViewById(R.id.root_framelayout);
994
995             // Remove the translucent status flag.  This is necessary so the root frame layout can fill the entire screen.
996             getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
997
998             /* Hide the system bars.
999              * SYSTEM_UI_FLAG_FULLSCREEN hides the status bar at the top of the screen.
1000              * SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN makes the root frame layout fill the area that is normally reserved for the status bar.
1001              * SYSTEM_UI_FLAG_HIDE_NAVIGATION hides the navigation bar on the bottom or right of the screen.
1002              * SYSTEM_UI_FLAG_IMMERSIVE_STICKY makes the status and navigation bars translucent and automatically re-hides them after they are shown.
1003              */
1004             rootFrameLayout.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
1005                     View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
1006         } else if (BuildConfig.FLAVOR.contentEquals("free")) {  // Resume the adView for the free flavor.
1007             // Resume the ad.
1008             AdHelper.resumeAd(findViewById(R.id.adview));
1009         }
1010     }
1011
1012     @Override
1013     public void onPause() {
1014         // Run the default commands.
1015         super.onPause();
1016
1017         for (int i = 0; i < webViewPagerAdapter.getCount(); i++) {
1018             // Get the WebView tab fragment.
1019             WebViewTabFragment webViewTabFragment = webViewPagerAdapter.getPageFragment(i);
1020
1021             // Get the fragment view.
1022             View fragmentView = webViewTabFragment.getView();
1023
1024             // Only pause the WebViews if they exist (they won't when the app is first created).
1025             if (fragmentView != null) {
1026                 // Get the nested scroll WebView from the tab fragment.
1027                 NestedScrollWebView nestedScrollWebView = fragmentView.findViewById(R.id.nestedscroll_webview);
1028
1029                 // Pause the nested scroll WebView.
1030                 nestedScrollWebView.onPause();
1031
1032                 // Pause the nested scroll WebView JavaScript timers.
1033                 nestedScrollWebView.pauseTimers();
1034             }
1035         }
1036
1037         // Pause the ad or it will continue to consume resources in the background on the free flavor.
1038         if (BuildConfig.FLAVOR.contentEquals("free")) {
1039             // Pause the ad.
1040             AdHelper.pauseAd(findViewById(R.id.adview));
1041         }
1042     }
1043
1044     @Override
1045     public void onDestroy() {
1046         // Unregister the Orbot status broadcast receiver.
1047         this.unregisterReceiver(orbotStatusBroadcastReceiver);
1048
1049         // Close the bookmarks cursor and database.
1050         bookmarksCursor.close();
1051         bookmarksDatabaseHelper.close();
1052
1053         // Run the default commands.
1054         super.onDestroy();
1055     }
1056
1057     @Override
1058     public boolean onCreateOptionsMenu(Menu menu) {
1059         // Inflate the menu.  This adds items to the action bar if it is present.
1060         getMenuInflater().inflate(R.menu.webview_options_menu, menu);
1061
1062         // Store a handle for the options menu so it can be used by `onOptionsItemSelected()` and `updatePrivacyIcons()`.
1063         optionsMenu = menu;
1064
1065         // Set the initial status of the privacy icons.  `false` does not call `invalidateOptionsMenu` as the last step.
1066         updatePrivacyIcons(false);
1067
1068         // Get handles for the menu items.
1069         MenuItem toggleFirstPartyCookiesMenuItem = menu.findItem(R.id.toggle_first_party_cookies);
1070         MenuItem toggleThirdPartyCookiesMenuItem = menu.findItem(R.id.toggle_third_party_cookies);
1071         MenuItem toggleDomStorageMenuItem = menu.findItem(R.id.toggle_dom_storage);
1072         MenuItem toggleSaveFormDataMenuItem = menu.findItem(R.id.toggle_save_form_data);  // Form data can be removed once the minimum API >= 26.
1073         MenuItem clearFormDataMenuItem = menu.findItem(R.id.clear_form_data);  // Form data can be removed once the minimum API >= 26.
1074         MenuItem refreshMenuItem = menu.findItem(R.id.refresh);
1075         MenuItem adConsentMenuItem = menu.findItem(R.id.ad_consent);
1076
1077         // Only display third-party cookies if API >= 21
1078         toggleThirdPartyCookiesMenuItem.setVisible(Build.VERSION.SDK_INT >= 21);
1079
1080         // Only display the form data menu items if the API < 26.
1081         toggleSaveFormDataMenuItem.setVisible(Build.VERSION.SDK_INT < 26);
1082         clearFormDataMenuItem.setVisible(Build.VERSION.SDK_INT < 26);
1083
1084         // Disable the clear form data menu item if the API >= 26 so that the status of the main Clear Data is calculated correctly.
1085         clearFormDataMenuItem.setEnabled(Build.VERSION.SDK_INT < 26);
1086
1087         // Only show Ad Consent if this is the free flavor.
1088         adConsentMenuItem.setVisible(BuildConfig.FLAVOR.contentEquals("free"));
1089
1090         // Get the shared preferences.
1091         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
1092
1093         // Get the dark theme and app bar preferences..
1094         boolean displayAdditionalAppBarIcons = sharedPreferences.getBoolean("display_additional_app_bar_icons", false);
1095         boolean darkTheme = sharedPreferences.getBoolean("dark_theme", false);
1096
1097         // Set the status of the additional app bar icons.  Setting the refresh menu item to `SHOW_AS_ACTION_ALWAYS` makes it appear even on small devices like phones.
1098         if (displayAdditionalAppBarIcons) {
1099             toggleFirstPartyCookiesMenuItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
1100             toggleDomStorageMenuItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
1101             refreshMenuItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_ALWAYS);
1102         } else { //Do not display the additional icons.
1103             toggleFirstPartyCookiesMenuItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
1104             toggleDomStorageMenuItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
1105             refreshMenuItem.setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
1106         }
1107
1108         // Replace Refresh with Stop if a URL is already loading.
1109         if (currentWebView != null && currentWebView.getProgress() != 100) {
1110             // Set the title.
1111             refreshMenuItem.setTitle(R.string.stop);
1112
1113             // If the icon is displayed in the AppBar, set it according to the theme.
1114             if (displayAdditionalAppBarIcons) {
1115                 if (darkTheme) {
1116                     refreshMenuItem.setIcon(R.drawable.close_dark);
1117                 } else {
1118                     refreshMenuItem.setIcon(R.drawable.close_light);
1119                 }
1120             }
1121         }
1122
1123         return true;
1124     }
1125
1126     @Override
1127     public boolean onPrepareOptionsMenu(Menu menu) {
1128         // Get handles for the menu items.
1129         MenuItem addOrEditDomain = menu.findItem(R.id.add_or_edit_domain);
1130         MenuItem firstPartyCookiesMenuItem = menu.findItem(R.id.toggle_first_party_cookies);
1131         MenuItem thirdPartyCookiesMenuItem = menu.findItem(R.id.toggle_third_party_cookies);
1132         MenuItem domStorageMenuItem = menu.findItem(R.id.toggle_dom_storage);
1133         MenuItem saveFormDataMenuItem = menu.findItem(R.id.toggle_save_form_data);  // Form data can be removed once the minimum API >= 26.
1134         MenuItem clearDataMenuItem = menu.findItem(R.id.clear_data);
1135         MenuItem clearCookiesMenuItem = menu.findItem(R.id.clear_cookies);
1136         MenuItem clearDOMStorageMenuItem = menu.findItem(R.id.clear_dom_storage);
1137         MenuItem clearFormDataMenuItem = menu.findItem(R.id.clear_form_data);  // Form data can be removed once the minimum API >= 26.
1138         MenuItem blocklistsMenuItem = menu.findItem(R.id.blocklists);
1139         MenuItem easyListMenuItem = menu.findItem(R.id.easylist);
1140         MenuItem easyPrivacyMenuItem = menu.findItem(R.id.easyprivacy);
1141         MenuItem fanboysAnnoyanceListMenuItem = menu.findItem(R.id.fanboys_annoyance_list);
1142         MenuItem fanboysSocialBlockingListMenuItem = menu.findItem(R.id.fanboys_social_blocking_list);
1143         MenuItem ultraPrivacyMenuItem = menu.findItem(R.id.ultraprivacy);
1144         MenuItem blockAllThirdPartyRequestsMenuItem = menu.findItem(R.id.block_all_third_party_requests);
1145         MenuItem fontSizeMenuItem = menu.findItem(R.id.font_size);
1146         MenuItem swipeToRefreshMenuItem = menu.findItem(R.id.swipe_to_refresh);
1147         MenuItem displayImagesMenuItem = menu.findItem(R.id.display_images);
1148         MenuItem nightModeMenuItem = menu.findItem(R.id.night_mode);
1149         MenuItem proxyThroughOrbotMenuItem = menu.findItem(R.id.proxy_through_orbot);
1150
1151         // Get a handle for the cookie manager.
1152         CookieManager cookieManager = CookieManager.getInstance();
1153
1154         // Initialize the current user agent string and the font size.
1155         String currentUserAgent = getString(R.string.user_agent_privacy_browser);
1156         int fontSize = 100;
1157
1158         // Set items that require the current web view to be populated.  It will be null when the program is first opened, as `onPrepareOptionsMenu()` is called before the first WebView is initialized.
1159         if (currentWebView != null) {
1160             // Set the add or edit domain text.
1161             if (currentWebView.getDomainSettingsApplied()) {
1162                 addOrEditDomain.setTitle(R.string.edit_domain_settings);
1163             } else {
1164                 addOrEditDomain.setTitle(R.string.add_domain_settings);
1165             }
1166
1167             // Get the current user agent from the WebView.
1168             currentUserAgent = currentWebView.getSettings().getUserAgentString();
1169
1170             // Get the current font size from the
1171             fontSize = currentWebView.getSettings().getTextZoom();
1172
1173             // Set the status of the menu item checkboxes.
1174             domStorageMenuItem.setChecked(currentWebView.getSettings().getDomStorageEnabled());
1175             saveFormDataMenuItem.setChecked(currentWebView.getSettings().getSaveFormData());  // Form data can be removed once the minimum API >= 26.
1176             easyListMenuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.EASY_LIST));
1177             easyPrivacyMenuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.EASY_PRIVACY));
1178             fanboysAnnoyanceListMenuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST));
1179             fanboysSocialBlockingListMenuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST));
1180             ultraPrivacyMenuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.ULTRA_PRIVACY));
1181             blockAllThirdPartyRequestsMenuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.THIRD_PARTY_REQUESTS));
1182             swipeToRefreshMenuItem.setChecked(currentWebView.getSwipeToRefresh());
1183             displayImagesMenuItem.setChecked(currentWebView.getSettings().getLoadsImagesAutomatically());
1184             nightModeMenuItem.setChecked(currentWebView.getNightMode());
1185
1186             // Initialize the display names for the blocklists with the number of blocked requests.
1187             blocklistsMenuItem.setTitle(getString(R.string.blocklists) + " - " + currentWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
1188             easyListMenuItem.setTitle(currentWebView.getRequestsCount(NestedScrollWebView.EASY_LIST) + " - " + getString(R.string.easylist));
1189             easyPrivacyMenuItem.setTitle(currentWebView.getRequestsCount(NestedScrollWebView.EASY_PRIVACY) + " - " + getString(R.string.easyprivacy));
1190             fanboysAnnoyanceListMenuItem.setTitle(currentWebView.getRequestsCount(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST) + " - " + getString(R.string.fanboys_annoyance_list));
1191             fanboysSocialBlockingListMenuItem.setTitle(currentWebView.getRequestsCount(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST) + " - " + getString(R.string.fanboys_social_blocking_list));
1192             ultraPrivacyMenuItem.setTitle(currentWebView.getRequestsCount(NestedScrollWebView.ULTRA_PRIVACY) + " - " + getString(R.string.ultraprivacy));
1193             blockAllThirdPartyRequestsMenuItem.setTitle(currentWebView.getRequestsCount(NestedScrollWebView.THIRD_PARTY_REQUESTS) + " - " + getString(R.string.block_all_third_party_requests));
1194
1195             // Only modify third-party cookies if the API >= 21.
1196             if (Build.VERSION.SDK_INT >= 21) {
1197                 // Set the status of the third-party cookies checkbox.
1198                 thirdPartyCookiesMenuItem.setChecked(cookieManager.acceptThirdPartyCookies(currentWebView));
1199
1200                 // Enable third-party cookies if first-party cookies are enabled.
1201                 thirdPartyCookiesMenuItem.setEnabled(cookieManager.acceptCookie());
1202             }
1203
1204             // Enable DOM Storage if JavaScript is enabled.
1205             domStorageMenuItem.setEnabled(currentWebView.getSettings().getJavaScriptEnabled());
1206         }
1207
1208         // Set the status of the menu item checkboxes.
1209         firstPartyCookiesMenuItem.setChecked(cookieManager.acceptCookie());
1210         proxyThroughOrbotMenuItem.setChecked(proxyThroughOrbot);
1211
1212         // Enable Clear Cookies if there are any.
1213         clearCookiesMenuItem.setEnabled(cookieManager.hasCookies());
1214
1215         // Get the application's private data directory, which will be something like `/data/user/0/com.stoutner.privacybrowser.standard`, which links to `/data/data/com.stoutner.privacybrowser.standard`.
1216         String privateDataDirectoryString = getApplicationInfo().dataDir;
1217
1218         // Get a count of the number of files in the Local Storage directory.
1219         File localStorageDirectory = new File (privateDataDirectoryString + "/app_webview/Local Storage/");
1220         int localStorageDirectoryNumberOfFiles = 0;
1221         if (localStorageDirectory.exists()) {
1222             localStorageDirectoryNumberOfFiles = localStorageDirectory.list().length;
1223         }
1224
1225         // Get a count of the number of files in the IndexedDB directory.
1226         File indexedDBDirectory = new File (privateDataDirectoryString + "/app_webview/IndexedDB");
1227         int indexedDBDirectoryNumberOfFiles = 0;
1228         if (indexedDBDirectory.exists()) {
1229             indexedDBDirectoryNumberOfFiles = indexedDBDirectory.list().length;
1230         }
1231
1232         // Enable Clear DOM Storage if there is any.
1233         clearDOMStorageMenuItem.setEnabled(localStorageDirectoryNumberOfFiles > 0 || indexedDBDirectoryNumberOfFiles > 0);
1234
1235         // Enable Clear Form Data is there is any.  This can be removed once the minimum API >= 26.
1236         if (Build.VERSION.SDK_INT < 26) {
1237             // Get the WebView database.
1238             WebViewDatabase webViewDatabase = WebViewDatabase.getInstance(this);
1239
1240             // Enable the clear form data menu item if there is anything to clear.
1241             clearFormDataMenuItem.setEnabled(webViewDatabase.hasFormData());
1242         }
1243
1244         // Enable Clear Data if any of the submenu items are enabled.
1245         clearDataMenuItem.setEnabled(clearCookiesMenuItem.isEnabled() || clearDOMStorageMenuItem.isEnabled() || clearFormDataMenuItem.isEnabled());
1246
1247         // Disable Fanboy's Social Blocking List menu item if Fanboy's Annoyance List is checked.
1248         fanboysSocialBlockingListMenuItem.setEnabled(!fanboysAnnoyanceListMenuItem.isChecked());
1249
1250         // Select the current user agent menu item.  A switch statement cannot be used because the user agents are not compile time constants.
1251         if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[0])) {  // Privacy Browser.
1252             menu.findItem(R.id.user_agent_privacy_browser).setChecked(true);
1253         } else if (currentUserAgent.equals(webViewDefaultUserAgent)) {  // WebView Default.
1254             menu.findItem(R.id.user_agent_webview_default).setChecked(true);
1255         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[2])) {  // Firefox on Android.
1256             menu.findItem(R.id.user_agent_firefox_on_android).setChecked(true);
1257         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[3])) {  // Chrome on Android.
1258             menu.findItem(R.id.user_agent_chrome_on_android).setChecked(true);
1259         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[4])) {  // Safari on iOS.
1260             menu.findItem(R.id.user_agent_safari_on_ios).setChecked(true);
1261         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[5])) {  // Firefox on Linux.
1262             menu.findItem(R.id.user_agent_firefox_on_linux).setChecked(true);
1263         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[6])) {  // Chromium on Linux.
1264             menu.findItem(R.id.user_agent_chromium_on_linux).setChecked(true);
1265         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[7])) {  // Firefox on Windows.
1266             menu.findItem(R.id.user_agent_firefox_on_windows).setChecked(true);
1267         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[8])) {  // Chrome on Windows.
1268             menu.findItem(R.id.user_agent_chrome_on_windows).setChecked(true);
1269         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[9])) {  // Edge on Windows.
1270             menu.findItem(R.id.user_agent_edge_on_windows).setChecked(true);
1271         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[10])) {  // Internet Explorer on Windows.
1272             menu.findItem(R.id.user_agent_internet_explorer_on_windows).setChecked(true);
1273         } else if (currentUserAgent.equals(getResources().getStringArray(R.array.user_agent_data)[11])) {  // Safari on macOS.
1274             menu.findItem(R.id.user_agent_safari_on_macos).setChecked(true);
1275         } else {  // Custom user agent.
1276             menu.findItem(R.id.user_agent_custom).setChecked(true);
1277         }
1278
1279         // Instantiate the font size title and the selected font size menu item.
1280         String fontSizeTitle;
1281         MenuItem selectedFontSizeMenuItem;
1282
1283         // Prepare the font size title and current size menu item.
1284         switch (fontSize) {
1285             case 25:
1286                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.twenty_five_percent);
1287                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_twenty_five_percent);
1288                 break;
1289
1290             case 50:
1291                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.fifty_percent);
1292                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_fifty_percent);
1293                 break;
1294
1295             case 75:
1296                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.seventy_five_percent);
1297                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_seventy_five_percent);
1298                 break;
1299
1300             case 100:
1301                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.one_hundred_percent);
1302                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_one_hundred_percent);
1303                 break;
1304
1305             case 125:
1306                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.one_hundred_twenty_five_percent);
1307                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_one_hundred_twenty_five_percent);
1308                 break;
1309
1310             case 150:
1311                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.one_hundred_fifty_percent);
1312                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_one_hundred_fifty_percent);
1313                 break;
1314
1315             case 175:
1316                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.one_hundred_seventy_five_percent);
1317                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_one_hundred_seventy_five_percent);
1318                 break;
1319
1320             case 200:
1321                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.two_hundred_percent);
1322                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_two_hundred_percent);
1323                 break;
1324
1325             default:
1326                 fontSizeTitle = getString(R.string.font_size) + " - " + getString(R.string.one_hundred_percent);
1327                 selectedFontSizeMenuItem = menu.findItem(R.id.font_size_one_hundred_percent);
1328                 break;
1329         }
1330
1331         // Set the font size title and select the current size menu item.
1332         fontSizeMenuItem.setTitle(fontSizeTitle);
1333         selectedFontSizeMenuItem.setChecked(true);
1334
1335         // Run all the other default commands.
1336         super.onPrepareOptionsMenu(menu);
1337
1338         // Display the menu.
1339         return true;
1340     }
1341
1342     @Override
1343     // Remove Android Studio's warning about the dangers of using SetJavaScriptEnabled.
1344     @SuppressLint("SetJavaScriptEnabled")
1345     public boolean onOptionsItemSelected(MenuItem menuItem) {
1346         // Reenter full screen browsing mode if it was interrupted by the options menu.  <https://redmine.stoutner.com/issues/389>
1347         if (inFullScreenBrowsingMode) {
1348             // Remove the translucent status flag.  This is necessary so the root frame layout can fill the entire screen.
1349             getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
1350
1351             FrameLayout rootFrameLayout = findViewById(R.id.root_framelayout);
1352
1353             /* Hide the system bars.
1354              * SYSTEM_UI_FLAG_FULLSCREEN hides the status bar at the top of the screen.
1355              * SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN makes the root frame layout fill the area that is normally reserved for the status bar.
1356              * SYSTEM_UI_FLAG_HIDE_NAVIGATION hides the navigation bar on the bottom or right of the screen.
1357              * SYSTEM_UI_FLAG_IMMERSIVE_STICKY makes the status and navigation bars translucent and automatically re-hides them after they are shown.
1358              */
1359             rootFrameLayout.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
1360                     View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
1361         }
1362
1363         // Get the selected menu item ID.
1364         int menuItemId = menuItem.getItemId();
1365
1366         // Get a handle for the shared preferences.
1367         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
1368
1369         // Get a handle for the cookie manager.
1370         CookieManager cookieManager = CookieManager.getInstance();
1371
1372         // Run the commands that correlate to the selected menu item.
1373         switch (menuItemId) {
1374             case R.id.toggle_javascript:
1375                 // Toggle the JavaScript status.
1376                 currentWebView.getSettings().setJavaScriptEnabled(!currentWebView.getSettings().getJavaScriptEnabled());
1377
1378                 // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.
1379                 updatePrivacyIcons(true);
1380
1381                 // Display a `Snackbar`.
1382                 if (currentWebView.getSettings().getJavaScriptEnabled()) {  // JavaScrip is enabled.
1383                     Snackbar.make(findViewById(R.id.webviewpager), R.string.javascript_enabled, Snackbar.LENGTH_SHORT).show();
1384                 } else if (cookieManager.acceptCookie()) {  // JavaScript is disabled, but first-party cookies are enabled.
1385                     Snackbar.make(findViewById(R.id.webviewpager), R.string.javascript_disabled, Snackbar.LENGTH_SHORT).show();
1386                 } else {  // Privacy mode.
1387                     Snackbar.make(findViewById(R.id.webviewpager), R.string.privacy_mode, Snackbar.LENGTH_SHORT).show();
1388                 }
1389
1390                 // Reload the current WebView.
1391                 currentWebView.reload();
1392                 return true;
1393
1394             case R.id.add_or_edit_domain:
1395                 if (currentWebView.getDomainSettingsApplied()) {  // Edit the current domain settings.
1396                     // Reapply the domain settings on returning to `MainWebViewActivity`.
1397                     reapplyDomainSettingsOnRestart = true;
1398
1399                     // Create an intent to launch the domains activity.
1400                     Intent domainsIntent = new Intent(this, DomainsActivity.class);
1401
1402                     // Add the extra information to the intent.
1403                     domainsIntent.putExtra("load_domain", currentWebView.getDomainSettingsDatabaseId());
1404                     domainsIntent.putExtra("close_on_back", true);
1405                     domainsIntent.putExtra("current_url", currentWebView.getUrl());
1406
1407                     // Get the current certificate.
1408                     SslCertificate sslCertificate = currentWebView.getCertificate();
1409
1410                     // Check to see if the SSL certificate is populated.
1411                     if (sslCertificate != null) {
1412                         // Extract the certificate to strings.
1413                         String issuedToCName = sslCertificate.getIssuedTo().getCName();
1414                         String issuedToOName = sslCertificate.getIssuedTo().getOName();
1415                         String issuedToUName = sslCertificate.getIssuedTo().getUName();
1416                         String issuedByCName = sslCertificate.getIssuedBy().getCName();
1417                         String issuedByOName = sslCertificate.getIssuedBy().getOName();
1418                         String issuedByUName = sslCertificate.getIssuedBy().getUName();
1419                         long startDateLong = sslCertificate.getValidNotBeforeDate().getTime();
1420                         long endDateLong = sslCertificate.getValidNotAfterDate().getTime();
1421
1422                         // Add the certificate to the intent.
1423                         domainsIntent.putExtra("ssl_issued_to_cname", issuedToCName);
1424                         domainsIntent.putExtra("ssl_issued_to_oname", issuedToOName);
1425                         domainsIntent.putExtra("ssl_issued_to_uname", issuedToUName);
1426                         domainsIntent.putExtra("ssl_issued_by_cname", issuedByCName);
1427                         domainsIntent.putExtra("ssl_issued_by_oname", issuedByOName);
1428                         domainsIntent.putExtra("ssl_issued_by_uname", issuedByUName);
1429                         domainsIntent.putExtra("ssl_start_date", startDateLong);
1430                         domainsIntent.putExtra("ssl_end_date", endDateLong);
1431                     }
1432
1433                     // Check to see if the current IP addresses have been received.
1434                     if (currentWebView.hasCurrentIpAddresses()) {
1435                         // Add the current IP addresses to the intent.
1436                         domainsIntent.putExtra("current_ip_addresses", currentWebView.getCurrentIpAddresses());
1437                     }
1438
1439                     // Make it so.
1440                     startActivity(domainsIntent);
1441                 } else {  // Add a new domain.
1442                     // Apply the new domain settings on returning to `MainWebViewActivity`.
1443                     reapplyDomainSettingsOnRestart = true;
1444
1445                     // Get the current domain
1446                     Uri currentUri = Uri.parse(currentWebView.getUrl());
1447                     String currentDomain = currentUri.getHost();
1448
1449                     // Initialize the database handler.  The `0` specifies the database version, but that is ignored and set instead using a constant in `DomainsDatabaseHelper`.
1450                     DomainsDatabaseHelper domainsDatabaseHelper = new DomainsDatabaseHelper(this, null, null, 0);
1451
1452                     // Create the domain and store the database ID.
1453                     int newDomainDatabaseId = domainsDatabaseHelper.addDomain(currentDomain);
1454
1455                     // Create an intent to launch the domains activity.
1456                     Intent domainsIntent = new Intent(this, DomainsActivity.class);
1457
1458                     // Add the extra information to the intent.
1459                     domainsIntent.putExtra("load_domain", newDomainDatabaseId);
1460                     domainsIntent.putExtra("close_on_back", true);
1461                     domainsIntent.putExtra("current_url", currentWebView.getUrl());
1462
1463                     // Get the current certificate.
1464                     SslCertificate sslCertificate = currentWebView.getCertificate();
1465
1466                     // Check to see if the SSL certificate is populated.
1467                     if (sslCertificate != null) {
1468                         // Extract the certificate to strings.
1469                         String issuedToCName = sslCertificate.getIssuedTo().getCName();
1470                         String issuedToOName = sslCertificate.getIssuedTo().getOName();
1471                         String issuedToUName = sslCertificate.getIssuedTo().getUName();
1472                         String issuedByCName = sslCertificate.getIssuedBy().getCName();
1473                         String issuedByOName = sslCertificate.getIssuedBy().getOName();
1474                         String issuedByUName = sslCertificate.getIssuedBy().getUName();
1475                         long startDateLong = sslCertificate.getValidNotBeforeDate().getTime();
1476                         long endDateLong = sslCertificate.getValidNotAfterDate().getTime();
1477
1478                         // Add the certificate to the intent.
1479                         domainsIntent.putExtra("ssl_issued_to_cname", issuedToCName);
1480                         domainsIntent.putExtra("ssl_issued_to_oname", issuedToOName);
1481                         domainsIntent.putExtra("ssl_issued_to_uname", issuedToUName);
1482                         domainsIntent.putExtra("ssl_issued_by_cname", issuedByCName);
1483                         domainsIntent.putExtra("ssl_issued_by_oname", issuedByOName);
1484                         domainsIntent.putExtra("ssl_issued_by_uname", issuedByUName);
1485                         domainsIntent.putExtra("ssl_start_date", startDateLong);
1486                         domainsIntent.putExtra("ssl_end_date", endDateLong);
1487                     }
1488
1489                     // Check to see if the current IP addresses have been received.
1490                     if (currentWebView.hasCurrentIpAddresses()) {
1491                         // Add the current IP addresses to the intent.
1492                         domainsIntent.putExtra("current_ip_addresses", currentWebView.getCurrentIpAddresses());
1493                     }
1494
1495                     // Make it so.
1496                     startActivity(domainsIntent);
1497                 }
1498                 return true;
1499
1500             case R.id.toggle_first_party_cookies:
1501                 // Switch the first-party cookie status.
1502                 cookieManager.setAcceptCookie(!cookieManager.acceptCookie());
1503
1504                 // Store the first-party cookie status.
1505                 currentWebView.setAcceptFirstPartyCookies(cookieManager.acceptCookie());
1506
1507                 // Update the menu checkbox.
1508                 menuItem.setChecked(cookieManager.acceptCookie());
1509
1510                 // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.
1511                 updatePrivacyIcons(true);
1512
1513                 // Display a snackbar.
1514                 if (cookieManager.acceptCookie()) {  // First-party cookies are enabled.
1515                     Snackbar.make(findViewById(R.id.webviewpager), R.string.first_party_cookies_enabled, Snackbar.LENGTH_SHORT).show();
1516                 } else if (currentWebView.getSettings().getJavaScriptEnabled()) {  // JavaScript is still enabled.
1517                     Snackbar.make(findViewById(R.id.webviewpager), R.string.first_party_cookies_disabled, Snackbar.LENGTH_SHORT).show();
1518                 } else {  // Privacy mode.
1519                     Snackbar.make(findViewById(R.id.webviewpager), R.string.privacy_mode, Snackbar.LENGTH_SHORT).show();
1520                 }
1521
1522                 // Reload the current WebView.
1523                 currentWebView.reload();
1524                 return true;
1525
1526             case R.id.toggle_third_party_cookies:
1527                 if (Build.VERSION.SDK_INT >= 21) {
1528                     // Switch the status of thirdPartyCookiesEnabled.
1529                     cookieManager.setAcceptThirdPartyCookies(currentWebView, !cookieManager.acceptThirdPartyCookies(currentWebView));
1530
1531                     // Update the menu checkbox.
1532                     menuItem.setChecked(cookieManager.acceptThirdPartyCookies(currentWebView));
1533
1534                     // Display a snackbar.
1535                     if (cookieManager.acceptThirdPartyCookies(currentWebView)) {
1536                         Snackbar.make(findViewById(R.id.webviewpager), R.string.third_party_cookies_enabled, Snackbar.LENGTH_SHORT).show();
1537                     } else {
1538                         Snackbar.make(findViewById(R.id.webviewpager), R.string.third_party_cookies_disabled, Snackbar.LENGTH_SHORT).show();
1539                     }
1540
1541                     // Reload the current WebView.
1542                     currentWebView.reload();
1543                 } // Else do nothing because SDK < 21.
1544                 return true;
1545
1546             case R.id.toggle_dom_storage:
1547                 // Toggle the status of domStorageEnabled.
1548                 currentWebView.getSettings().setDomStorageEnabled(!currentWebView.getSettings().getDomStorageEnabled());
1549
1550                 // Update the menu checkbox.
1551                 menuItem.setChecked(currentWebView.getSettings().getDomStorageEnabled());
1552
1553                 // Update the privacy icon.  `true` refreshes the app bar icons.
1554                 updatePrivacyIcons(true);
1555
1556                 // Display a snackbar.
1557                 if (currentWebView.getSettings().getDomStorageEnabled()) {
1558                     Snackbar.make(findViewById(R.id.webviewpager), R.string.dom_storage_enabled, Snackbar.LENGTH_SHORT).show();
1559                 } else {
1560                     Snackbar.make(findViewById(R.id.webviewpager), R.string.dom_storage_disabled, Snackbar.LENGTH_SHORT).show();
1561                 }
1562
1563                 // Reload the current WebView.
1564                 currentWebView.reload();
1565                 return true;
1566
1567             // Form data can be removed once the minimum API >= 26.
1568             case R.id.toggle_save_form_data:
1569                 // Switch the status of saveFormDataEnabled.
1570                 currentWebView.getSettings().setSaveFormData(!currentWebView.getSettings().getSaveFormData());
1571
1572                 // Update the menu checkbox.
1573                 menuItem.setChecked(currentWebView.getSettings().getSaveFormData());
1574
1575                 // Display a snackbar.
1576                 if (currentWebView.getSettings().getSaveFormData()) {
1577                     Snackbar.make(findViewById(R.id.webviewpager), R.string.form_data_enabled, Snackbar.LENGTH_SHORT).show();
1578                 } else {
1579                     Snackbar.make(findViewById(R.id.webviewpager), R.string.form_data_disabled, Snackbar.LENGTH_SHORT).show();
1580                 }
1581
1582                 // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.
1583                 updatePrivacyIcons(true);
1584
1585                 // Reload the current WebView.
1586                 currentWebView.reload();
1587                 return true;
1588
1589             case R.id.clear_cookies:
1590                 Snackbar.make(findViewById(R.id.webviewpager), R.string.cookies_deleted, Snackbar.LENGTH_LONG)
1591                         .setAction(R.string.undo, v -> {
1592                             // Do nothing because everything will be handled by `onDismissed()` below.
1593                         })
1594                         .addCallback(new Snackbar.Callback() {
1595                             @SuppressLint("SwitchIntDef")  // Ignore the lint warning about not handling the other possible events as they are covered by `default:`.
1596                             @Override
1597                             public void onDismissed(Snackbar snackbar, int event) {
1598                                 if (event != Snackbar.Callback.DISMISS_EVENT_ACTION) {  // The snackbar was dismissed without the undo button being pushed.
1599                                     // Delete the cookies, which command varies by SDK.
1600                                     if (Build.VERSION.SDK_INT < 21) {
1601                                         cookieManager.removeAllCookie();
1602                                     } else {
1603                                         cookieManager.removeAllCookies(null);
1604                                     }
1605                                 }
1606                             }
1607                         })
1608                         .show();
1609                 return true;
1610
1611             case R.id.clear_dom_storage:
1612                 Snackbar.make(findViewById(R.id.webviewpager), R.string.dom_storage_deleted, Snackbar.LENGTH_LONG)
1613                         .setAction(R.string.undo, v -> {
1614                             // Do nothing because everything will be handled by `onDismissed()` below.
1615                         })
1616                         .addCallback(new Snackbar.Callback() {
1617                             @SuppressLint("SwitchIntDef")  // Ignore the lint warning about not handling the other possible events as they are covered by `default:`.
1618                             @Override
1619                             public void onDismissed(Snackbar snackbar, int event) {
1620                                 if (event != Snackbar.Callback.DISMISS_EVENT_ACTION) {  // The snackbar was dismissed without the undo button being pushed.
1621                                     // Delete the DOM Storage.
1622                                     WebStorage webStorage = WebStorage.getInstance();
1623                                     webStorage.deleteAllData();
1624
1625                                     // Initialize a handler to manually delete the DOM storage files and directories.
1626                                     Handler deleteDomStorageHandler = new Handler();
1627
1628                                     // Setup a runnable to manually delete the DOM storage files and directories.
1629                                     Runnable deleteDomStorageRunnable = () -> {
1630                                         try {
1631                                             // Get a handle for the runtime.
1632                                             Runtime runtime = Runtime.getRuntime();
1633
1634                                             // Get the application's private data directory, which will be something like `/data/user/0/com.stoutner.privacybrowser.standard`,
1635                                             // which links to `/data/data/com.stoutner.privacybrowser.standard`.
1636                                             String privateDataDirectoryString = getApplicationInfo().dataDir;
1637
1638                                             // A string array must be used because the directory contains a space and `Runtime.exec` will otherwise not escape the string correctly.
1639                                             Process deleteLocalStorageProcess = runtime.exec(new String[]{"rm", "-rf", privateDataDirectoryString + "/app_webview/Local Storage/"});
1640
1641                                             // Multiple commands must be used because `Runtime.exec()` does not like `*`.
1642                                             Process deleteIndexProcess = runtime.exec("rm -rf " + privateDataDirectoryString + "/app_webview/IndexedDB");
1643                                             Process deleteQuotaManagerProcess = runtime.exec("rm -f " + privateDataDirectoryString + "/app_webview/QuotaManager");
1644                                             Process deleteQuotaManagerJournalProcess = runtime.exec("rm -f " + privateDataDirectoryString + "/app_webview/QuotaManager-journal");
1645                                             Process deleteDatabasesProcess = runtime.exec("rm -rf " + privateDataDirectoryString + "/app_webview/databases");
1646
1647                                             // Wait for the processes to finish.
1648                                             deleteLocalStorageProcess.waitFor();
1649                                             deleteIndexProcess.waitFor();
1650                                             deleteQuotaManagerProcess.waitFor();
1651                                             deleteQuotaManagerJournalProcess.waitFor();
1652                                             deleteDatabasesProcess.waitFor();
1653                                         } catch (Exception exception) {
1654                                             // Do nothing if an error is thrown.
1655                                         }
1656                                     };
1657
1658                                     // Manually delete the DOM storage files after 200 milliseconds.
1659                                     deleteDomStorageHandler.postDelayed(deleteDomStorageRunnable, 200);
1660                                 }
1661                             }
1662                         })
1663                         .show();
1664                 return true;
1665
1666             // Form data can be remove once the minimum API >= 26.
1667             case R.id.clear_form_data:
1668                 Snackbar.make(findViewById(R.id.webviewpager), R.string.form_data_deleted, Snackbar.LENGTH_LONG)
1669                         .setAction(R.string.undo, v -> {
1670                             // Do nothing because everything will be handled by `onDismissed()` below.
1671                         })
1672                         .addCallback(new Snackbar.Callback() {
1673                             @SuppressLint("SwitchIntDef")  // Ignore the lint warning about not handling the other possible events as they are covered by `default:`.
1674                             @Override
1675                             public void onDismissed(Snackbar snackbar, int event) {
1676                                 if (event != Snackbar.Callback.DISMISS_EVENT_ACTION) {  // The snackbar was dismissed without the undo button being pushed.
1677                                     // Delete the form data.
1678                                     WebViewDatabase mainWebViewDatabase = WebViewDatabase.getInstance(getApplicationContext());
1679                                     mainWebViewDatabase.clearFormData();
1680                                 }
1681                             }
1682                         })
1683                         .show();
1684                 return true;
1685
1686             case R.id.easylist:
1687                 // Toggle the EasyList status.
1688                 currentWebView.enableBlocklist(NestedScrollWebView.EASY_LIST, !currentWebView.isBlocklistEnabled(NestedScrollWebView.EASY_LIST));
1689
1690                 // Update the menu checkbox.
1691                 menuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.EASY_LIST));
1692
1693                 // Reload the current WebView.
1694                 currentWebView.reload();
1695                 return true;
1696
1697             case R.id.easyprivacy:
1698                 // Toggle the EasyPrivacy status.
1699                 currentWebView.enableBlocklist(NestedScrollWebView.EASY_PRIVACY, !currentWebView.isBlocklistEnabled(NestedScrollWebView.EASY_PRIVACY));
1700
1701                 // Update the menu checkbox.
1702                 menuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.EASY_PRIVACY));
1703
1704                 // Reload the current WebView.
1705                 currentWebView.reload();
1706                 return true;
1707
1708             case R.id.fanboys_annoyance_list:
1709                 // Toggle Fanboy's Annoyance List status.
1710                 currentWebView.enableBlocklist(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST, !currentWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST));
1711
1712                 // Update the menu checkbox.
1713                 menuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST));
1714
1715                 // Update the staus of Fanboy's Social Blocking List.
1716                 MenuItem fanboysSocialBlockingListMenuItem = optionsMenu.findItem(R.id.fanboys_social_blocking_list);
1717                 fanboysSocialBlockingListMenuItem.setEnabled(!currentWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST));
1718
1719                 // Reload the current WebView.
1720                 currentWebView.reload();
1721                 return true;
1722
1723             case R.id.fanboys_social_blocking_list:
1724                 // Toggle Fanboy's Social Blocking List status.
1725                 currentWebView.enableBlocklist(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST, !currentWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST));
1726
1727                 // Update the menu checkbox.
1728                 menuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST));
1729
1730                 // Reload the current WebView.
1731                 currentWebView.reload();
1732                 return true;
1733
1734             case R.id.ultraprivacy:
1735                 // Toggle the UltraPrivacy status.
1736                 currentWebView.enableBlocklist(NestedScrollWebView.ULTRA_PRIVACY, !currentWebView.isBlocklistEnabled(NestedScrollWebView.ULTRA_PRIVACY));
1737
1738                 // Update the menu checkbox.
1739                 menuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.ULTRA_PRIVACY));
1740
1741                 // Reload the current WebView.
1742                 currentWebView.reload();
1743                 return true;
1744
1745             case R.id.block_all_third_party_requests:
1746                 //Toggle the third-party requests blocker status.
1747                 currentWebView.enableBlocklist(NestedScrollWebView.THIRD_PARTY_REQUESTS, !currentWebView.isBlocklistEnabled(NestedScrollWebView.THIRD_PARTY_REQUESTS));
1748
1749                 // Update the menu checkbox.
1750                 menuItem.setChecked(currentWebView.isBlocklistEnabled(NestedScrollWebView.THIRD_PARTY_REQUESTS));
1751
1752                 // Reload the current WebView.
1753                 currentWebView.reload();
1754                 return true;
1755
1756             case R.id.user_agent_privacy_browser:
1757                 // Update the user agent.
1758                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[0]);
1759
1760                 // Reload the current WebView.
1761                 currentWebView.reload();
1762                 return true;
1763
1764             case R.id.user_agent_webview_default:
1765                 // Update the user agent.
1766                 currentWebView.getSettings().setUserAgentString("");
1767
1768                 // Reload the current WebView.
1769                 currentWebView.reload();
1770                 return true;
1771
1772             case R.id.user_agent_firefox_on_android:
1773                 // Update the user agent.
1774                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[2]);
1775
1776                 // Reload the current WebView.
1777                 currentWebView.reload();
1778                 return true;
1779
1780             case R.id.user_agent_chrome_on_android:
1781                 // Update the user agent.
1782                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[3]);
1783
1784                 // Reload the current WebView.
1785                 currentWebView.reload();
1786                 return true;
1787
1788             case R.id.user_agent_safari_on_ios:
1789                 // Update the user agent.
1790                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[4]);
1791
1792                 // Reload the current WebView.
1793                 currentWebView.reload();
1794                 return true;
1795
1796             case R.id.user_agent_firefox_on_linux:
1797                 // Update the user agent.
1798                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[5]);
1799
1800                 // Reload the current WebView.
1801                 currentWebView.reload();
1802                 return true;
1803
1804             case R.id.user_agent_chromium_on_linux:
1805                 // Update the user agent.
1806                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[6]);
1807
1808                 // Reload the current WebView.
1809                 currentWebView.reload();
1810                 return true;
1811
1812             case R.id.user_agent_firefox_on_windows:
1813                 // Update the user agent.
1814                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[7]);
1815
1816                 // Reload the current WebView.
1817                 currentWebView.reload();
1818                 return true;
1819
1820             case R.id.user_agent_chrome_on_windows:
1821                 // Update the user agent.
1822                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[8]);
1823
1824                 // Reload the current WebView.
1825                 currentWebView.reload();
1826                 return true;
1827
1828             case R.id.user_agent_edge_on_windows:
1829                 // Update the user agent.
1830                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[9]);
1831
1832                 // Reload the current WebView.
1833                 currentWebView.reload();
1834                 return true;
1835
1836             case R.id.user_agent_internet_explorer_on_windows:
1837                 // Update the user agent.
1838                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[10]);
1839
1840                 // Reload the current WebView.
1841                 currentWebView.reload();
1842                 return true;
1843
1844             case R.id.user_agent_safari_on_macos:
1845                 // Update the user agent.
1846                 currentWebView.getSettings().setUserAgentString(getResources().getStringArray(R.array.user_agent_data)[11]);
1847
1848                 // Reload the current WebView.
1849                 currentWebView.reload();
1850                 return true;
1851
1852             case R.id.user_agent_custom:
1853                 // Update the user agent.
1854                 currentWebView.getSettings().setUserAgentString(sharedPreferences.getString("custom_user_agent", getString(R.string.custom_user_agent_default_value)));
1855
1856                 // Reload the current WebView.
1857                 currentWebView.reload();
1858                 return true;
1859
1860             case R.id.font_size_twenty_five_percent:
1861                 currentWebView.getSettings().setTextZoom(25);
1862                 return true;
1863
1864             case R.id.font_size_fifty_percent:
1865                 currentWebView.getSettings().setTextZoom(50);
1866                 return true;
1867
1868             case R.id.font_size_seventy_five_percent:
1869                 currentWebView.getSettings().setTextZoom(75);
1870                 return true;
1871
1872             case R.id.font_size_one_hundred_percent:
1873                 currentWebView.getSettings().setTextZoom(100);
1874                 return true;
1875
1876             case R.id.font_size_one_hundred_twenty_five_percent:
1877                 currentWebView.getSettings().setTextZoom(125);
1878                 return true;
1879
1880             case R.id.font_size_one_hundred_fifty_percent:
1881                 currentWebView.getSettings().setTextZoom(150);
1882                 return true;
1883
1884             case R.id.font_size_one_hundred_seventy_five_percent:
1885                 currentWebView.getSettings().setTextZoom(175);
1886                 return true;
1887
1888             case R.id.font_size_two_hundred_percent:
1889                 currentWebView.getSettings().setTextZoom(200);
1890                 return true;
1891
1892             case R.id.swipe_to_refresh:
1893                 // Toggle the stored status of swipe to refresh.
1894                 currentWebView.setSwipeToRefresh(!currentWebView.getSwipeToRefresh());
1895
1896                 // Get a handle for the swipe refresh layout.
1897                 SwipeRefreshLayout swipeRefreshLayout = findViewById(R.id.swiperefreshlayout);
1898
1899                 // Update the swipe refresh layout.
1900                 if (currentWebView.getSwipeToRefresh()) {  // Swipe to refresh is enabled.
1901                     if (Build.VERSION.SDK_INT >= 23) {  // For API >= 23, the status of the scroll refresh listener is continuously updated by the on scroll change listener.
1902                         // Only enable the swipe refresh layout if the WebView is scrolled to the top.
1903                         swipeRefreshLayout.setEnabled(currentWebView.getY() == 0);
1904                     } else {  // For API < 23, the swipe refresh layout is always enabled.
1905                         // Enable the swipe refresh layout.
1906                         swipeRefreshLayout.setEnabled(true);
1907                     }
1908                 } else {  // Swipe to refresh is disabled.
1909                     // Disable the swipe refresh layout.
1910                     swipeRefreshLayout.setEnabled(false);
1911                 }
1912                 return true;
1913
1914             case R.id.display_images:
1915                 if (currentWebView.getSettings().getLoadsImagesAutomatically()) {  // Images are currently loaded automatically.
1916                     // Disable loading of images.
1917                     currentWebView.getSettings().setLoadsImagesAutomatically(false);
1918
1919                     // Reload the website to remove existing images.
1920                     currentWebView.reload();
1921                 } else {  // Images are not currently loaded automatically.
1922                     // Enable loading of images.  Missing images will be loaded without the need for a reload.
1923                     currentWebView.getSettings().setLoadsImagesAutomatically(true);
1924                 }
1925                 return true;
1926
1927             case R.id.night_mode:
1928                 // Toggle night mode.
1929                 currentWebView.setNightMode(!currentWebView.getNightMode());
1930
1931                 // Enable or disable JavaScript according to night mode, the global preference, and any domain settings.
1932                 if (currentWebView.getNightMode()) {  // Night mode is enabled, which requires JavaScript.
1933                     // Enable JavaScript.
1934                     currentWebView.getSettings().setJavaScriptEnabled(true);
1935                 } else if (currentWebView.getDomainSettingsApplied()) {  // Night mode is disabled and domain settings are applied.  Set JavaScript according to the domain settings.
1936                     // Apply the JavaScript preference that was stored the last time domain settings were loaded.
1937                     currentWebView.getSettings().setJavaScriptEnabled(currentWebView.getDomainSettingsJavaScriptEnabled());
1938                 } else {  // Night mode is disabled and domain settings are not applied.  Set JavaScript according to the global preference.
1939                     // Apply the JavaScript preference.
1940                     currentWebView.getSettings().setJavaScriptEnabled(sharedPreferences.getBoolean("javascript", false));
1941                 }
1942
1943                 // Update the privacy icons.
1944                 updatePrivacyIcons(false);
1945
1946                 // Reload the website.
1947                 currentWebView.reload();
1948                 return true;
1949
1950             case R.id.find_on_page:
1951                 // Get a handle for the views.
1952                 Toolbar toolbar = findViewById(R.id.toolbar);
1953                 LinearLayout findOnPageLinearLayout = findViewById(R.id.find_on_page_linearlayout);
1954                 EditText findOnPageEditText = findViewById(R.id.find_on_page_edittext);
1955
1956                 // Set the minimum height of the find on page linear layout to match the toolbar.
1957                 findOnPageLinearLayout.setMinimumHeight(toolbar.getHeight());
1958
1959                 // Hide the toolbar.
1960                 toolbar.setVisibility(View.GONE);
1961
1962                 // Show the find on page linear layout.
1963                 findOnPageLinearLayout.setVisibility(View.VISIBLE);
1964
1965                 // Display the keyboard.  The app must wait 200 ms before running the command to work around a bug in Android.
1966                 // http://stackoverflow.com/questions/5520085/android-show-softkeyboard-with-showsoftinput-is-not-working
1967                 findOnPageEditText.postDelayed(() -> {
1968                     // Set the focus on `findOnPageEditText`.
1969                     findOnPageEditText.requestFocus();
1970
1971                     // Get a handle for the input method manager.
1972                     InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
1973
1974                     // Remove the lint warning below that the input method manager might be null.
1975                     assert inputMethodManager != null;
1976
1977                     // Display the keyboard.  `0` sets no input flags.
1978                     inputMethodManager.showSoftInput(findOnPageEditText, 0);
1979                 }, 200);
1980                 return true;
1981
1982             case R.id.view_source:
1983                 // Create an intent to launch the view source activity.
1984                 Intent viewSourceIntent = new Intent(this, ViewSourceActivity.class);
1985
1986                 // Add the variables to the intent.
1987                 viewSourceIntent.putExtra("user_agent", currentWebView.getSettings().getUserAgentString());
1988                 viewSourceIntent.putExtra("current_url", currentWebView.getUrl());
1989
1990                 // Make it so.
1991                 startActivity(viewSourceIntent);
1992                 return true;
1993
1994             case R.id.share_url:
1995                 // Setup the share string.
1996                 String shareString = currentWebView.getTitle() + " – " + currentWebView.getUrl();
1997
1998                 // Create the share intent.
1999                 Intent shareIntent = new Intent(Intent.ACTION_SEND);
2000                 shareIntent.putExtra(Intent.EXTRA_TEXT, shareString);
2001                 shareIntent.setType("text/plain");
2002
2003                 // Make it so.
2004                 startActivity(Intent.createChooser(shareIntent, getString(R.string.share_url)));
2005                 return true;
2006
2007             case R.id.print:
2008                 // Get a print manager instance.
2009                 PrintManager printManager = (PrintManager) getSystemService(Context.PRINT_SERVICE);
2010
2011                 // Remove the lint error below that print manager might be null.
2012                 assert printManager != null;
2013
2014                 // Create a print document adapter from the current WebView.
2015                 PrintDocumentAdapter printDocumentAdapter = currentWebView.createPrintDocumentAdapter();
2016
2017                 // Print the document.
2018                 printManager.print(getString(R.string.privacy_browser_web_page), printDocumentAdapter, null);
2019                 return true;
2020
2021             case R.id.open_with_app:
2022                 openWithApp(currentWebView.getUrl());
2023                 return true;
2024
2025             case R.id.open_with_browser:
2026                 openWithBrowser(currentWebView.getUrl());
2027                 return true;
2028
2029             case R.id.add_to_homescreen:
2030                 // Instantiate the create home screen shortcut dialog.
2031                 DialogFragment createHomeScreenShortcutDialogFragment = CreateHomeScreenShortcutDialog.createDialog(currentWebView.getTitle(), currentWebView.getUrl(),
2032                         currentWebView.getFavoriteOrDefaultIcon());
2033
2034                 // Show the create home screen shortcut dialog.
2035                 createHomeScreenShortcutDialogFragment.show(getSupportFragmentManager(), getString(R.string.create_shortcut));
2036                 return true;
2037
2038             case R.id.proxy_through_orbot:
2039                 // Toggle the proxy through Orbot variable.
2040                 proxyThroughOrbot = !proxyThroughOrbot;
2041
2042                 // Apply the proxy through Orbot settings.
2043                 applyProxyThroughOrbot(true);
2044                 return true;
2045
2046             case R.id.refresh:
2047                 if (menuItem.getTitle().equals(getString(R.string.refresh))) {  // The refresh button was pushed.
2048                     // Reload the current WebView.
2049                     currentWebView.reload();
2050                 } else {  // The stop button was pushed.
2051                     // Stop the loading of the WebView.
2052                     currentWebView.stopLoading();
2053                 }
2054                 return true;
2055
2056             case R.id.ad_consent:
2057                 // Display the ad consent dialog.
2058                 DialogFragment adConsentDialogFragment = new AdConsentDialog();
2059                 adConsentDialogFragment.show(getSupportFragmentManager(), getString(R.string.ad_consent));
2060                 return true;
2061
2062             default:
2063                 // Don't consume the event.
2064                 return super.onOptionsItemSelected(menuItem);
2065         }
2066     }
2067
2068     // removeAllCookies is deprecated, but it is required for API < 21.
2069     @Override
2070     public boolean onNavigationItemSelected(@NonNull MenuItem menuItem) {
2071         // Get the menu item ID.
2072         int menuItemId = menuItem.getItemId();
2073
2074         // Get a handle for the shared preferences.
2075         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
2076
2077         // Run the commands that correspond to the selected menu item.
2078         switch (menuItemId) {
2079             case R.id.close_tab:
2080                 // Get a handle for the tab layout and the view pager.
2081                 TabLayout tabLayout = findViewById(R.id.tablayout);
2082                 ViewPager webViewPager = findViewById(R.id.webviewpager);
2083
2084                 // Get the current tab number.
2085                 int currentTabNumber = tabLayout.getSelectedTabPosition();
2086
2087                 // Delete the current tab.
2088                 tabLayout.removeTabAt(currentTabNumber);
2089
2090                 // Delete the current page.  If the selected page number did not change during the delete, it will return true, meaning that the current WebView must be reset.
2091                 if (webViewPagerAdapter.deletePage(currentTabNumber, webViewPager)) {
2092                     setCurrentWebView(currentTabNumber);
2093                 }
2094                 break;
2095
2096             case R.id.clear_and_exit:
2097                 // Close the bookmarks cursor and database.
2098                 bookmarksCursor.close();
2099                 bookmarksDatabaseHelper.close();
2100
2101                 // Get the status of the clear everything preference.
2102                 boolean clearEverything = sharedPreferences.getBoolean("clear_everything", true);
2103
2104                 // Get a handle for the runtime.
2105                 Runtime runtime = Runtime.getRuntime();
2106
2107                 // Get the application's private data directory, which will be something like `/data/user/0/com.stoutner.privacybrowser.standard`,
2108                 // which links to `/data/data/com.stoutner.privacybrowser.standard`.
2109                 String privateDataDirectoryString = getApplicationInfo().dataDir;
2110
2111                 // Clear cookies.
2112                 if (clearEverything || sharedPreferences.getBoolean("clear_cookies", true)) {
2113                     // The command to remove cookies changed slightly in API 21.
2114                     if (Build.VERSION.SDK_INT >= 21) {
2115                         CookieManager.getInstance().removeAllCookies(null);
2116                     } else {
2117                         CookieManager.getInstance().removeAllCookie();
2118                     }
2119
2120                     // Manually delete the cookies database, as `CookieManager` sometimes will not flush its changes to disk before `System.exit(0)` is run.
2121                     try {
2122                         // Two commands must be used because `Runtime.exec()` does not like `*`.
2123                         Process deleteCookiesProcess = runtime.exec("rm -f " + privateDataDirectoryString + "/app_webview/Cookies");
2124                         Process deleteCookiesJournalProcess = runtime.exec("rm -f " + privateDataDirectoryString + "/app_webview/Cookies-journal");
2125
2126                         // Wait until the processes have finished.
2127                         deleteCookiesProcess.waitFor();
2128                         deleteCookiesJournalProcess.waitFor();
2129                     } catch (Exception exception) {
2130                         // Do nothing if an error is thrown.
2131                     }
2132                 }
2133
2134                 // Clear DOM storage.
2135                 if (clearEverything || sharedPreferences.getBoolean("clear_dom_storage", true)) {
2136                     // Ask `WebStorage` to clear the DOM storage.
2137                     WebStorage webStorage = WebStorage.getInstance();
2138                     webStorage.deleteAllData();
2139
2140                     // Manually delete the DOM storage files and directories, as `WebStorage` sometimes will not flush its changes to disk before `System.exit(0)` is run.
2141                     try {
2142                         // A `String[]` must be used because the directory contains a space and `Runtime.exec` will otherwise not escape the string correctly.
2143                         Process deleteLocalStorageProcess = runtime.exec(new String[] {"rm", "-rf", privateDataDirectoryString + "/app_webview/Local Storage/"});
2144
2145                         // Multiple commands must be used because `Runtime.exec()` does not like `*`.
2146                         Process deleteIndexProcess = runtime.exec("rm -rf " + privateDataDirectoryString + "/app_webview/IndexedDB");
2147                         Process deleteQuotaManagerProcess = runtime.exec("rm -f " + privateDataDirectoryString + "/app_webview/QuotaManager");
2148                         Process deleteQuotaManagerJournalProcess = runtime.exec("rm -f " + privateDataDirectoryString + "/app_webview/QuotaManager-journal");
2149                         Process deleteDatabaseProcess = runtime.exec("rm -rf " + privateDataDirectoryString + "/app_webview/databases");
2150
2151                         // Wait until the processes have finished.
2152                         deleteLocalStorageProcess.waitFor();
2153                         deleteIndexProcess.waitFor();
2154                         deleteQuotaManagerProcess.waitFor();
2155                         deleteQuotaManagerJournalProcess.waitFor();
2156                         deleteDatabaseProcess.waitFor();
2157                     } catch (Exception exception) {
2158                         // Do nothing if an error is thrown.
2159                     }
2160                 }
2161
2162                 // Clear form data if the API < 26.
2163                 if ((Build.VERSION.SDK_INT < 26) && (clearEverything || sharedPreferences.getBoolean("clear_form_data", true))) {
2164                     WebViewDatabase webViewDatabase = WebViewDatabase.getInstance(this);
2165                     webViewDatabase.clearFormData();
2166
2167                     // Manually delete the form data database, as `WebViewDatabase` sometimes will not flush its changes to disk before `System.exit(0)` is run.
2168                     try {
2169                         // A string array must be used because the database contains a space and `Runtime.exec` will not otherwise escape the string correctly.
2170                         Process deleteWebDataProcess = runtime.exec(new String[] {"rm", "-f", privateDataDirectoryString + "/app_webview/Web Data"});
2171                         Process deleteWebDataJournalProcess = runtime.exec(new String[] {"rm", "-f", privateDataDirectoryString + "/app_webview/Web Data-journal"});
2172
2173                         // Wait until the processes have finished.
2174                         deleteWebDataProcess.waitFor();
2175                         deleteWebDataJournalProcess.waitFor();
2176                     } catch (Exception exception) {
2177                         // Do nothing if an error is thrown.
2178                     }
2179                 }
2180
2181                 // Clear the cache.
2182                 if (clearEverything || sharedPreferences.getBoolean("clear_cache", true)) {
2183                     // Clear the cache from each WebView.
2184                     for (int i = 0; i < webViewPagerAdapter.getCount(); i++) {
2185                         // Get the WebView tab fragment.
2186                         WebViewTabFragment webViewTabFragment = webViewPagerAdapter.getPageFragment(i);
2187
2188                         // Get the fragment view.
2189                         View fragmentView = webViewTabFragment.getView();
2190
2191                         // Only clear the cache if the WebView exists.
2192                         if (fragmentView != null) {
2193                             // Get the nested scroll WebView from the tab fragment.
2194                             NestedScrollWebView nestedScrollWebView = fragmentView.findViewById(R.id.nestedscroll_webview);
2195
2196                             // Clear the cache for this WebView.
2197                             nestedScrollWebView.clearCache(true);
2198                         }
2199                     }
2200
2201                     // Manually delete the cache directories.
2202                     try {
2203                         // Delete the main cache directory.
2204                         Process deleteCacheProcess = runtime.exec("rm -rf " + privateDataDirectoryString + "/cache");
2205
2206                         // Delete the secondary `Service Worker` cache directory.
2207                         // A string array must be used because the directory contains a space and `Runtime.exec` will otherwise not escape the string correctly.
2208                         Process deleteServiceWorkerProcess = runtime.exec(new String[] {"rm", "-rf", privateDataDirectoryString + "/app_webview/Service Worker/"});
2209
2210                         // Wait until the processes have finished.
2211                         deleteCacheProcess.waitFor();
2212                         deleteServiceWorkerProcess.waitFor();
2213                     } catch (Exception exception) {
2214                         // Do nothing if an error is thrown.
2215                     }
2216                 }
2217
2218                 // Wipe out each WebView.
2219                 for (int i = 0; i < webViewPagerAdapter.getCount(); i++) {
2220                     // Get the WebView tab fragment.
2221                     WebViewTabFragment webViewTabFragment = webViewPagerAdapter.getPageFragment(i);
2222
2223                     // Get the fragment view.
2224                     View fragmentView = webViewTabFragment.getView();
2225
2226                     // Only wipe out the WebView if it exists.
2227                     if (fragmentView != null) {
2228                         // Get the nested scroll WebView from the tab fragment.
2229                         NestedScrollWebView nestedScrollWebView = fragmentView.findViewById(R.id.nestedscroll_webview);
2230
2231                         // Clear SSL certificate preferences for this WebView.
2232                         nestedScrollWebView.clearSslPreferences();
2233
2234                         // Clear the back/forward history for this WebView.
2235                         nestedScrollWebView.clearHistory();
2236
2237                         // Destroy the internal state of `mainWebView`.
2238                         nestedScrollWebView.destroy();
2239                     }
2240                 }
2241
2242                 // Clear the custom headers.
2243                 customHeaders.clear();
2244
2245                 // Manually delete the `app_webview` folder, which contains the cookies, DOM storage, form data, and `Service Worker` cache.
2246                 // See `https://code.google.com/p/android/issues/detail?id=233826&thanks=233826&ts=1486670530`.
2247                 if (clearEverything) {
2248                     try {
2249                         // Delete the folder.
2250                         Process deleteAppWebviewProcess = runtime.exec("rm -rf " + privateDataDirectoryString + "/app_webview");
2251
2252                         // Wait until the process has finished.
2253                         deleteAppWebviewProcess.waitFor();
2254                     } catch (Exception exception) {
2255                         // Do nothing if an error is thrown.
2256                     }
2257                 }
2258
2259                 // Close Privacy Browser.  `finishAndRemoveTask` also removes Privacy Browser from the recent app list.
2260                 if (Build.VERSION.SDK_INT >= 21) {
2261                     finishAndRemoveTask();
2262                 } else {
2263                     finish();
2264                 }
2265
2266                 // Remove the terminated program from RAM.  The status code is `0`.
2267                 System.exit(0);
2268                 break;
2269
2270             case R.id.home:
2271                 // Select the homepage based on the proxy through Orbot status.
2272                 if (proxyThroughOrbot) {
2273                     // Load the Tor homepage.
2274                     loadUrl(sharedPreferences.getString("tor_homepage", getString(R.string.tor_homepage_default_value)));
2275                 } else {
2276                     // Load the normal homepage.
2277                     loadUrl(sharedPreferences.getString("homepage", getString(R.string.homepage_default_value)));
2278                 }
2279                 break;
2280
2281             case R.id.back:
2282                 if (currentWebView.canGoBack()) {
2283                     // Reset the current domain name so that navigation works if third-party requests are blocked.
2284                     currentWebView.resetCurrentDomainName();
2285
2286                     // Set navigating history so that the domain settings are applied when the new URL is loaded.
2287                     currentWebView.setNavigatingHistory(true);
2288
2289                     // Load the previous website in the history.
2290                     currentWebView.goBack();
2291                 }
2292                 break;
2293
2294             case R.id.forward:
2295                 if (currentWebView.canGoForward()) {
2296                     // Reset the current domain name so that navigation works if third-party requests are blocked.
2297                     currentWebView.resetCurrentDomainName();
2298
2299                     // Set navigating history so that the domain settings are applied when the new URL is loaded.
2300                     currentWebView.setNavigatingHistory(true);
2301
2302                     // Load the next website in the history.
2303                     currentWebView.goForward();
2304                 }
2305                 break;
2306
2307             case R.id.history:
2308                 // Instantiate the URL history dialog.
2309                 DialogFragment urlHistoryDialogFragment = UrlHistoryDialog.loadBackForwardList(currentWebView.getWebViewFragmentId());
2310
2311                 // Show the URL history dialog.
2312                 urlHistoryDialogFragment.show(getSupportFragmentManager(), getString(R.string.history));
2313                 break;
2314
2315             case R.id.requests:
2316                 // Populate the resource requests.
2317                 RequestsActivity.resourceRequests = currentWebView.getResourceRequests();
2318
2319                 // Create an intent to launch the Requests activity.
2320                 Intent requestsIntent = new Intent(this, RequestsActivity.class);
2321
2322                 // Add the block third-party requests status to the intent.
2323                 requestsIntent.putExtra("block_all_third_party_requests", currentWebView.isBlocklistEnabled(NestedScrollWebView.THIRD_PARTY_REQUESTS));
2324
2325                 // Make it so.
2326                 startActivity(requestsIntent);
2327                 break;
2328
2329             case R.id.downloads:
2330                 // Launch the system Download Manager.
2331                 Intent downloadManagerIntent = new Intent(DownloadManager.ACTION_VIEW_DOWNLOADS);
2332
2333                 // Launch as a new task so that Download Manager and Privacy Browser show as separate windows in the recent tasks list.
2334                 downloadManagerIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
2335
2336                 startActivity(downloadManagerIntent);
2337                 break;
2338
2339             case R.id.domains:
2340                 // Set the flag to reapply the domain settings on restart when returning from Domain Settings.
2341                 reapplyDomainSettingsOnRestart = true;
2342
2343                 // Launch the domains activity.
2344                 Intent domainsIntent = new Intent(this, DomainsActivity.class);
2345
2346                 // Add the extra information to the intent.
2347                 domainsIntent.putExtra("current_url", currentWebView.getUrl());
2348
2349                 // Get the current certificate.
2350                 SslCertificate sslCertificate = currentWebView.getCertificate();
2351
2352                 // Check to see if the SSL certificate is populated.
2353                 if (sslCertificate != null) {
2354                     // Extract the certificate to strings.
2355                     String issuedToCName = sslCertificate.getIssuedTo().getCName();
2356                     String issuedToOName = sslCertificate.getIssuedTo().getOName();
2357                     String issuedToUName = sslCertificate.getIssuedTo().getUName();
2358                     String issuedByCName = sslCertificate.getIssuedBy().getCName();
2359                     String issuedByOName = sslCertificate.getIssuedBy().getOName();
2360                     String issuedByUName = sslCertificate.getIssuedBy().getUName();
2361                     long startDateLong = sslCertificate.getValidNotBeforeDate().getTime();
2362                     long endDateLong = sslCertificate.getValidNotAfterDate().getTime();
2363
2364                     // Add the certificate to the intent.
2365                     domainsIntent.putExtra("ssl_issued_to_cname", issuedToCName);
2366                     domainsIntent.putExtra("ssl_issued_to_oname", issuedToOName);
2367                     domainsIntent.putExtra("ssl_issued_to_uname", issuedToUName);
2368                     domainsIntent.putExtra("ssl_issued_by_cname", issuedByCName);
2369                     domainsIntent.putExtra("ssl_issued_by_oname", issuedByOName);
2370                     domainsIntent.putExtra("ssl_issued_by_uname", issuedByUName);
2371                     domainsIntent.putExtra("ssl_start_date", startDateLong);
2372                     domainsIntent.putExtra("ssl_end_date", endDateLong);
2373                 }
2374
2375                 // Check to see if the current IP addresses have been received.
2376                 if (currentWebView.hasCurrentIpAddresses()) {
2377                     // Add the current IP addresses to the intent.
2378                     domainsIntent.putExtra("current_ip_addresses", currentWebView.getCurrentIpAddresses());
2379                 }
2380
2381                 // Make it so.
2382                 startActivity(domainsIntent);
2383                 break;
2384
2385             case R.id.settings:
2386                 // Set the flag to reapply app settings on restart when returning from Settings.
2387                 reapplyAppSettingsOnRestart = true;
2388
2389                 // Set the flag to reapply the domain settings on restart when returning from Settings.
2390                 reapplyDomainSettingsOnRestart = true;
2391
2392                 // Launch the settings activity.
2393                 Intent settingsIntent = new Intent(this, SettingsActivity.class);
2394                 startActivity(settingsIntent);
2395                 break;
2396
2397             case R.id.import_export:
2398                 // Launch the import/export activity.
2399                 Intent importExportIntent = new Intent (this, ImportExportActivity.class);
2400                 startActivity(importExportIntent);
2401                 break;
2402
2403             case R.id.logcat:
2404                 // Launch the logcat activity.
2405                 Intent logcatIntent = new Intent(this, LogcatActivity.class);
2406                 startActivity(logcatIntent);
2407                 break;
2408
2409             case R.id.guide:
2410                 // Launch `GuideActivity`.
2411                 Intent guideIntent = new Intent(this, GuideActivity.class);
2412                 startActivity(guideIntent);
2413                 break;
2414
2415             case R.id.about:
2416                 // Create an intent to launch the about activity.
2417                 Intent aboutIntent = new Intent(this, AboutActivity.class);
2418
2419                 // Create a string array for the blocklist versions.
2420                 String[] blocklistVersions = new String[] {easyList.get(0).get(0)[0], easyPrivacy.get(0).get(0)[0], fanboysAnnoyanceList.get(0).get(0)[0], fanboysSocialList.get(0).get(0)[0],
2421                         ultraPrivacy.get(0).get(0)[0]};
2422
2423                 // Add the blocklist versions to the intent.
2424                 aboutIntent.putExtra("blocklist_versions", blocklistVersions);
2425
2426                 // Make it so.
2427                 startActivity(aboutIntent);
2428                 break;
2429         }
2430
2431         // Get a handle for the drawer layout.
2432         DrawerLayout drawerLayout = findViewById(R.id.drawerlayout);
2433
2434         // Close the navigation drawer.
2435         drawerLayout.closeDrawer(GravityCompat.START);
2436         return true;
2437     }
2438
2439     @Override
2440     public void onPostCreate(Bundle savedInstanceState) {
2441         // Run the default commands.
2442         super.onPostCreate(savedInstanceState);
2443
2444         // Sync the state of the DrawerToggle after the default `onRestoreInstanceState()` has finished.  This creates the navigation drawer icon.
2445         actionBarDrawerToggle.syncState();
2446     }
2447
2448     @Override
2449     public void onConfigurationChanged(Configuration newConfig) {
2450         // Run the default commands.
2451         super.onConfigurationChanged(newConfig);
2452
2453         // Get the status bar pixel size.
2454         int statusBarResourceId = getResources().getIdentifier("status_bar_height", "dimen", "android");
2455         int statusBarPixelSize = getResources().getDimensionPixelSize(statusBarResourceId);
2456
2457         // Get the resource density.
2458         float screenDensity = getResources().getDisplayMetrics().density;
2459
2460         // Recalculate the drawer header padding.
2461         drawerHeaderPaddingLeftAndRight = (int) (15 * screenDensity);
2462         drawerHeaderPaddingTop = statusBarPixelSize + (int) (4 * screenDensity);
2463         drawerHeaderPaddingBottom = (int) (8 * screenDensity);
2464
2465         // Reload the ad for the free flavor if not in full screen mode.
2466         if (BuildConfig.FLAVOR.contentEquals("free") && !inFullScreenBrowsingMode) {
2467             // Reload the ad.  The AdView is destroyed and recreated, which changes the ID, every time it is reloaded to handle possible rotations.
2468             AdHelper.loadAd(findViewById(R.id.adview), getApplicationContext(), getString(R.string.ad_unit_id));
2469         }
2470
2471         // `invalidateOptionsMenu` should recalculate the number of action buttons from the menu to display on the app bar, but it doesn't because of the this bug:
2472         // https://code.google.com/p/android/issues/detail?id=20493#c8
2473         // ActivityCompat.invalidateOptionsMenu(this);
2474     }
2475
2476     @Override
2477     public void onCreateContextMenu(ContextMenu menu, View view, ContextMenu.ContextMenuInfo menuInfo) {
2478         // Store the hit test result.
2479         final WebView.HitTestResult hitTestResult = currentWebView.getHitTestResult();
2480
2481         // Create the URL strings.
2482         final String imageUrl;
2483         final String linkUrl;
2484
2485         // Get handles for the system managers.
2486         final ClipboardManager clipboardManager = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);
2487         FragmentManager fragmentManager = getSupportFragmentManager();
2488         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
2489
2490         // Remove the lint errors below that the clipboard manager might be null.
2491         assert clipboardManager != null;
2492
2493         // Process the link according to the type.
2494         switch (hitTestResult.getType()) {
2495             // `SRC_ANCHOR_TYPE` is a link.
2496             case WebView.HitTestResult.SRC_ANCHOR_TYPE:
2497                 // Get the target URL.
2498                 linkUrl = hitTestResult.getExtra();
2499
2500                 // Set the target URL as the title of the `ContextMenu`.
2501                 menu.setHeaderTitle(linkUrl);
2502
2503                 // Add a Load URL entry.
2504                 menu.add(R.string.open_in_new_tab).setOnMenuItemClickListener((MenuItem item) -> {
2505                     // Add a new tab.
2506                     addTab(null);
2507
2508                     // Load the URL.
2509                     loadUrl(linkUrl);
2510                     return false;
2511                 });
2512
2513                 // Add an Open with App entry.
2514                 menu.add(R.string.open_with_app).setOnMenuItemClickListener((MenuItem item) -> {
2515                     openWithApp(linkUrl);
2516                     return false;
2517                 });
2518
2519                 // Add an Open with Browser entry.
2520                 menu.add(R.string.open_with_browser).setOnMenuItemClickListener((MenuItem item) -> {
2521                     openWithBrowser(linkUrl);
2522                     return false;
2523                 });
2524
2525                 // Add a Copy URL entry.
2526                 menu.add(R.string.copy_url).setOnMenuItemClickListener((MenuItem item) -> {
2527                     // Save the link URL in a `ClipData`.
2528                     ClipData srcAnchorTypeClipData = ClipData.newPlainText(getString(R.string.url), linkUrl);
2529
2530                     // Set the `ClipData` as the clipboard's primary clip.
2531                     clipboardManager.setPrimaryClip(srcAnchorTypeClipData);
2532                     return false;
2533                 });
2534
2535                 // Add a Download URL entry.
2536                 menu.add(R.string.download_url).setOnMenuItemClickListener((MenuItem item) -> {
2537                     // Check if the download should be processed by an external app.
2538                     if (sharedPreferences.getBoolean("download_with_external_app", false)) {  // Download with an external app.
2539                         openUrlWithExternalApp(linkUrl);
2540                     } else {  // Download with Android's download manager.
2541                         // Check to see if the storage permission has already been granted.
2542                         if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_DENIED) {  // The storage permission needs to be requested.
2543                             // Store the variables for future use by `onRequestPermissionsResult()`.
2544                             downloadUrl = linkUrl;
2545                             downloadContentDisposition = "none";
2546                             downloadContentLength = -1;
2547
2548                             // Show a dialog if the user has previously denied the permission.
2549                             if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)) {  // Show a dialog explaining the request first.
2550                                 // Instantiate the download location permission alert dialog and set the download type to DOWNLOAD_FILE.
2551                                 DialogFragment downloadLocationPermissionDialogFragment = DownloadLocationPermissionDialog.downloadType(DownloadLocationPermissionDialog.DOWNLOAD_FILE);
2552
2553                                 // Show the download location permission alert dialog.  The permission will be requested when the the dialog is closed.
2554                                 downloadLocationPermissionDialogFragment.show(fragmentManager, getString(R.string.download_location));
2555                             } else {  // Show the permission request directly.
2556                                 // Request the permission.  The download dialog will be launched by `onRequestPermissionResult()`.
2557                                 ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, DOWNLOAD_FILE_REQUEST_CODE);
2558                             }
2559                         } else {  // The storage permission has already been granted.
2560                             // Get a handle for the download file alert dialog.
2561                             DialogFragment downloadFileDialogFragment = DownloadFileDialog.fromUrl(linkUrl, "none", -1);
2562
2563                             // Show the download file alert dialog.
2564                             downloadFileDialogFragment.show(fragmentManager, getString(R.string.download));
2565                         }
2566                     }
2567                     return false;
2568                 });
2569
2570                 // Add a Cancel entry, which by default closes the context menu.
2571                 menu.add(R.string.cancel);
2572                 break;
2573
2574             case WebView.HitTestResult.EMAIL_TYPE:
2575                 // Get the target URL.
2576                 linkUrl = hitTestResult.getExtra();
2577
2578                 // Set the target URL as the title of the `ContextMenu`.
2579                 menu.setHeaderTitle(linkUrl);
2580
2581                 // Add a Write Email entry.
2582                 menu.add(R.string.write_email).setOnMenuItemClickListener(item -> {
2583                     // Use `ACTION_SENDTO` instead of `ACTION_SEND` so that only email programs are launched.
2584                     Intent emailIntent = new Intent(Intent.ACTION_SENDTO);
2585
2586                     // Parse the url and set it as the data for the `Intent`.
2587                     emailIntent.setData(Uri.parse("mailto:" + linkUrl));
2588
2589                     // `FLAG_ACTIVITY_NEW_TASK` opens the email program in a new task instead as part of Privacy Browser.
2590                     emailIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
2591
2592                     // Make it so.
2593                     startActivity(emailIntent);
2594                     return false;
2595                 });
2596
2597                 // Add a Copy Email Address entry.
2598                 menu.add(R.string.copy_email_address).setOnMenuItemClickListener(item -> {
2599                     // Save the email address in a `ClipData`.
2600                     ClipData srcEmailTypeClipData = ClipData.newPlainText(getString(R.string.email_address), linkUrl);
2601
2602                     // Set the `ClipData` as the clipboard's primary clip.
2603                     clipboardManager.setPrimaryClip(srcEmailTypeClipData);
2604                     return false;
2605                 });
2606
2607                 // Add a `Cancel` entry, which by default closes the `ContextMenu`.
2608                 menu.add(R.string.cancel);
2609                 break;
2610
2611             // `IMAGE_TYPE` is an image.
2612             case WebView.HitTestResult.IMAGE_TYPE:
2613                 // Get the image URL.
2614                 imageUrl = hitTestResult.getExtra();
2615
2616                 // Set the image URL as the title of the `ContextMenu`.
2617                 menu.setHeaderTitle(imageUrl);
2618
2619                 // Add a View Image entry.
2620                 menu.add(R.string.view_image).setOnMenuItemClickListener(item -> {
2621                     loadUrl(imageUrl);
2622                     return false;
2623                 });
2624
2625                 // Add a Download Image entry.
2626                 menu.add(R.string.download_image).setOnMenuItemClickListener((MenuItem item) -> {
2627                     // Check if the download should be processed by an external app.
2628                     if (sharedPreferences.getBoolean("download_with_external_app", false)) {  // Download with an external app.
2629                         openUrlWithExternalApp(imageUrl);
2630                     } else {  // Download with Android's download manager.
2631                         // Check to see if the storage permission has already been granted.
2632                         if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_DENIED) {  // The storage permission needs to be requested.
2633                             // Store the image URL for use by `onRequestPermissionResult()`.
2634                             downloadImageUrl = imageUrl;
2635
2636                             // Show a dialog if the user has previously denied the permission.
2637                             if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)) {  // Show a dialog explaining the request first.
2638                                 // Instantiate the download location permission alert dialog and set the download type to DOWNLOAD_IMAGE.
2639                                 DialogFragment downloadLocationPermissionDialogFragment = DownloadLocationPermissionDialog.downloadType(DownloadLocationPermissionDialog.DOWNLOAD_IMAGE);
2640
2641                                 // Show the download location permission alert dialog.  The permission will be requested when the dialog is closed.
2642                                 downloadLocationPermissionDialogFragment.show(fragmentManager, getString(R.string.download_location));
2643                             } else {  // Show the permission request directly.
2644                                 // Request the permission.  The download dialog will be launched by `onRequestPermissionResult().
2645                                 ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, DOWNLOAD_IMAGE_REQUEST_CODE);
2646                             }
2647                         } else {  // The storage permission has already been granted.
2648                             // Get a handle for the download image alert dialog.
2649                             DialogFragment downloadImageDialogFragment = DownloadImageDialog.imageUrl(imageUrl);
2650
2651                             // Show the download image alert dialog.
2652                             downloadImageDialogFragment.show(fragmentManager, getString(R.string.download));
2653                         }
2654                     }
2655                     return false;
2656                 });
2657
2658                 // Add a Copy URL entry.
2659                 menu.add(R.string.copy_url).setOnMenuItemClickListener(item -> {
2660                     // Save the image URL in a `ClipData`.
2661                     ClipData srcImageTypeClipData = ClipData.newPlainText(getString(R.string.url), imageUrl);
2662
2663                     // Set the `ClipData` as the clipboard's primary clip.
2664                     clipboardManager.setPrimaryClip(srcImageTypeClipData);
2665                     return false;
2666                 });
2667
2668                 // Add an Open with App entry.
2669                 menu.add(R.string.open_with_app).setOnMenuItemClickListener((MenuItem item) -> {
2670                     openWithApp(imageUrl);
2671                     return false;
2672                 });
2673
2674                 // Add an Open with Browser entry.
2675                 menu.add(R.string.open_with_browser).setOnMenuItemClickListener((MenuItem item) -> {
2676                     openWithBrowser(imageUrl);
2677                     return false;
2678                 });
2679
2680                 // Add a `Cancel` entry, which by default closes the `ContextMenu`.
2681                 menu.add(R.string.cancel);
2682                 break;
2683
2684
2685             // `SRC_IMAGE_ANCHOR_TYPE` is an image that is also a link.
2686             case WebView.HitTestResult.SRC_IMAGE_ANCHOR_TYPE:
2687                 // Get the image URL.
2688                 imageUrl = hitTestResult.getExtra();
2689
2690                 // Set the image URL as the title of the `ContextMenu`.
2691                 menu.setHeaderTitle(imageUrl);
2692
2693                 // Add a `View Image` entry.
2694                 menu.add(R.string.view_image).setOnMenuItemClickListener(item -> {
2695                     loadUrl(imageUrl);
2696                     return false;
2697                 });
2698
2699                 // Add a `Download Image` entry.
2700                 menu.add(R.string.download_image).setOnMenuItemClickListener((MenuItem item) -> {
2701                     // Check if the download should be processed by an external app.
2702                     if (sharedPreferences.getBoolean("download_with_external_app", false)) {  // Download with an external app.
2703                         openUrlWithExternalApp(imageUrl);
2704                     } else {  // Download with Android's download manager.
2705                         // Check to see if the storage permission has already been granted.
2706                         if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_DENIED) {  // The storage permission needs to be requested.
2707                             // Store the image URL for use by `onRequestPermissionResult()`.
2708                             downloadImageUrl = imageUrl;
2709
2710                             // Show a dialog if the user has previously denied the permission.
2711                             if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)) {  // Show a dialog explaining the request first.
2712                                 // Instantiate the download location permission alert dialog and set the download type to DOWNLOAD_IMAGE.
2713                                 DialogFragment downloadLocationPermissionDialogFragment = DownloadLocationPermissionDialog.downloadType(DownloadLocationPermissionDialog.DOWNLOAD_IMAGE);
2714
2715                                 // Show the download location permission alert dialog.  The permission will be requested when the dialog is closed.
2716                                 downloadLocationPermissionDialogFragment.show(fragmentManager, getString(R.string.download_location));
2717                             } else {  // Show the permission request directly.
2718                                 // Request the permission.  The download dialog will be launched by `onRequestPermissionResult().
2719                                 ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, DOWNLOAD_IMAGE_REQUEST_CODE);
2720                             }
2721                         } else {  // The storage permission has already been granted.
2722                             // Get a handle for the download image alert dialog.
2723                             DialogFragment downloadImageDialogFragment = DownloadImageDialog.imageUrl(imageUrl);
2724
2725                             // Show the download image alert dialog.
2726                             downloadImageDialogFragment.show(fragmentManager, getString(R.string.download));
2727                         }
2728                     }
2729                     return false;
2730                 });
2731
2732                 // Add a `Copy URL` entry.
2733                 menu.add(R.string.copy_url).setOnMenuItemClickListener(item -> {
2734                     // Save the image URL in a `ClipData`.
2735                     ClipData srcImageAnchorTypeClipData = ClipData.newPlainText(getString(R.string.url), imageUrl);
2736
2737                     // Set the `ClipData` as the clipboard's primary clip.
2738                     clipboardManager.setPrimaryClip(srcImageAnchorTypeClipData);
2739                     return false;
2740                 });
2741
2742                 // Add an Open with App entry.
2743                 menu.add(R.string.open_with_app).setOnMenuItemClickListener((MenuItem item) -> {
2744                     openWithApp(imageUrl);
2745                     return false;
2746                 });
2747
2748                 // Add an Open with Browser entry.
2749                 menu.add(R.string.open_with_browser).setOnMenuItemClickListener((MenuItem item) -> {
2750                     openWithBrowser(imageUrl);
2751                     return false;
2752                 });
2753
2754                 // Add a `Cancel` entry, which by default closes the `ContextMenu`.
2755                 menu.add(R.string.cancel);
2756                 break;
2757         }
2758     }
2759
2760     @Override
2761     public void onCreateBookmark(DialogFragment dialogFragment, Bitmap favoriteIconBitmap) {
2762         // Get a handle for the bookmarks list view.
2763         ListView bookmarksListView = findViewById(R.id.bookmarks_drawer_listview);
2764
2765         // Get the views from the dialog fragment.
2766         EditText createBookmarkNameEditText = dialogFragment.getDialog().findViewById(R.id.create_bookmark_name_edittext);
2767         EditText createBookmarkUrlEditText = dialogFragment.getDialog().findViewById(R.id.create_bookmark_url_edittext);
2768
2769         // Extract the strings from the edit texts.
2770         String bookmarkNameString = createBookmarkNameEditText.getText().toString();
2771         String bookmarkUrlString = createBookmarkUrlEditText.getText().toString();
2772
2773         // Create a favorite icon byte array output stream.
2774         ByteArrayOutputStream favoriteIconByteArrayOutputStream = new ByteArrayOutputStream();
2775
2776         // Convert the favorite icon bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
2777         favoriteIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, favoriteIconByteArrayOutputStream);
2778
2779         // Convert the favorite icon byte array stream to a byte array.
2780         byte[] favoriteIconByteArray = favoriteIconByteArrayOutputStream.toByteArray();
2781
2782         // Display the new bookmark below the current items in the (0 indexed) list.
2783         int newBookmarkDisplayOrder = bookmarksListView.getCount();
2784
2785         // Create the bookmark.
2786         bookmarksDatabaseHelper.createBookmark(bookmarkNameString, bookmarkUrlString, currentBookmarksFolder, newBookmarkDisplayOrder, favoriteIconByteArray);
2787
2788         // Update the bookmarks cursor with the current contents of this folder.
2789         bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrder(currentBookmarksFolder);
2790
2791         // Update the list view.
2792         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
2793
2794         // Scroll to the new bookmark.
2795         bookmarksListView.setSelection(newBookmarkDisplayOrder);
2796     }
2797
2798     @Override
2799     public void onCreateBookmarkFolder(DialogFragment dialogFragment, Bitmap favoriteIconBitmap) {
2800         // Get a handle for the bookmarks list view.
2801         ListView bookmarksListView = findViewById(R.id.bookmarks_drawer_listview);
2802
2803         // Get handles for the views in the dialog fragment.
2804         EditText createFolderNameEditText = dialogFragment.getDialog().findViewById(R.id.create_folder_name_edittext);
2805         RadioButton defaultFolderIconRadioButton = dialogFragment.getDialog().findViewById(R.id.create_folder_default_icon_radiobutton);
2806         ImageView folderIconImageView = dialogFragment.getDialog().findViewById(R.id.create_folder_default_icon);
2807
2808         // Get new folder name string.
2809         String folderNameString = createFolderNameEditText.getText().toString();
2810
2811         // Create a folder icon bitmap.
2812         Bitmap folderIconBitmap;
2813
2814         // Set the folder icon bitmap according to the dialog.
2815         if (defaultFolderIconRadioButton.isChecked()) {  // Use the default folder icon.
2816             // Get the default folder icon drawable.
2817             Drawable folderIconDrawable = folderIconImageView.getDrawable();
2818
2819             // Convert the folder icon drawable to a bitmap drawable.
2820             BitmapDrawable folderIconBitmapDrawable = (BitmapDrawable) folderIconDrawable;
2821
2822             // Convert the folder icon bitmap drawable to a bitmap.
2823             folderIconBitmap = folderIconBitmapDrawable.getBitmap();
2824         } else {  // Use the WebView favorite icon.
2825             // Copy the favorite icon bitmap to the folder icon bitmap.
2826             folderIconBitmap = favoriteIconBitmap;
2827         }
2828
2829         // Create a folder icon byte array output stream.
2830         ByteArrayOutputStream folderIconByteArrayOutputStream = new ByteArrayOutputStream();
2831
2832         // Convert the folder icon bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
2833         folderIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, folderIconByteArrayOutputStream);
2834
2835         // Convert the folder icon byte array stream to a byte array.
2836         byte[] folderIconByteArray = folderIconByteArrayOutputStream.toByteArray();
2837
2838         // Move all the bookmarks down one in the display order.
2839         for (int i = 0; i < bookmarksListView.getCount(); i++) {
2840             int databaseId = (int) bookmarksListView.getItemIdAtPosition(i);
2841             bookmarksDatabaseHelper.updateDisplayOrder(databaseId, i + 1);
2842         }
2843
2844         // Create the folder, which will be placed at the top of the `ListView`.
2845         bookmarksDatabaseHelper.createFolder(folderNameString, currentBookmarksFolder, folderIconByteArray);
2846
2847         // Update the bookmarks cursor with the current contents of this folder.
2848         bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrder(currentBookmarksFolder);
2849
2850         // Update the `ListView`.
2851         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
2852
2853         // Scroll to the new folder.
2854         bookmarksListView.setSelection(0);
2855     }
2856
2857     @Override
2858     public void onSaveBookmark(DialogFragment dialogFragment, int selectedBookmarkDatabaseId, Bitmap favoriteIconBitmap) {
2859         // Get handles for the views from `dialogFragment`.
2860         EditText editBookmarkNameEditText = dialogFragment.getDialog().findViewById(R.id.edit_bookmark_name_edittext);
2861         EditText editBookmarkUrlEditText = dialogFragment.getDialog().findViewById(R.id.edit_bookmark_url_edittext);
2862         RadioButton currentBookmarkIconRadioButton = dialogFragment.getDialog().findViewById(R.id.edit_bookmark_current_icon_radiobutton);
2863
2864         // Store the bookmark strings.
2865         String bookmarkNameString = editBookmarkNameEditText.getText().toString();
2866         String bookmarkUrlString = editBookmarkUrlEditText.getText().toString();
2867
2868         // Update the bookmark.
2869         if (currentBookmarkIconRadioButton.isChecked()) {  // Update the bookmark without changing the favorite icon.
2870             bookmarksDatabaseHelper.updateBookmark(selectedBookmarkDatabaseId, bookmarkNameString, bookmarkUrlString);
2871         } else {  // Update the bookmark using the `WebView` favorite icon.
2872             // Create a favorite icon byte array output stream.
2873             ByteArrayOutputStream newFavoriteIconByteArrayOutputStream = new ByteArrayOutputStream();
2874
2875             // Convert the favorite icon bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
2876             favoriteIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, newFavoriteIconByteArrayOutputStream);
2877
2878             // Convert the favorite icon byte array stream to a byte array.
2879             byte[] newFavoriteIconByteArray = newFavoriteIconByteArrayOutputStream.toByteArray();
2880
2881             //  Update the bookmark and the favorite icon.
2882             bookmarksDatabaseHelper.updateBookmark(selectedBookmarkDatabaseId, bookmarkNameString, bookmarkUrlString, newFavoriteIconByteArray);
2883         }
2884
2885         // Update the bookmarks cursor with the current contents of this folder.
2886         bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrder(currentBookmarksFolder);
2887
2888         // Update the list view.
2889         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
2890     }
2891
2892     @Override
2893     public void onSaveBookmarkFolder(DialogFragment dialogFragment, int selectedFolderDatabaseId, Bitmap favoriteIconBitmap) {
2894         // Get handles for the views from `dialogFragment`.
2895         EditText editFolderNameEditText = dialogFragment.getDialog().findViewById(R.id.edit_folder_name_edittext);
2896         RadioButton currentFolderIconRadioButton = dialogFragment.getDialog().findViewById(R.id.edit_folder_current_icon_radiobutton);
2897         RadioButton defaultFolderIconRadioButton = dialogFragment.getDialog().findViewById(R.id.edit_folder_default_icon_radiobutton);
2898         ImageView defaultFolderIconImageView = dialogFragment.getDialog().findViewById(R.id.edit_folder_default_icon_imageview);
2899
2900         // Get the new folder name.
2901         String newFolderNameString = editFolderNameEditText.getText().toString();
2902
2903         // Check if the favorite icon has changed.
2904         if (currentFolderIconRadioButton.isChecked()) {  // Only the name has changed.
2905             // Update the name in the database.
2906             bookmarksDatabaseHelper.updateFolder(selectedFolderDatabaseId, oldFolderNameString, newFolderNameString);
2907         } else if (!currentFolderIconRadioButton.isChecked() && newFolderNameString.equals(oldFolderNameString)) {  // Only the icon has changed.
2908             // Create the new folder icon Bitmap.
2909             Bitmap folderIconBitmap;
2910
2911             // Populate the new folder icon bitmap.
2912             if (defaultFolderIconRadioButton.isChecked()) {
2913                 // Get the default folder icon drawable.
2914                 Drawable folderIconDrawable = defaultFolderIconImageView.getDrawable();
2915
2916                 // Convert the folder icon drawable to a bitmap drawable.
2917                 BitmapDrawable folderIconBitmapDrawable = (BitmapDrawable) folderIconDrawable;
2918
2919                 // Convert the folder icon bitmap drawable to a bitmap.
2920                 folderIconBitmap = folderIconBitmapDrawable.getBitmap();
2921             } else {  // Use the `WebView` favorite icon.
2922                 // Copy the favorite icon bitmap to the folder icon bitmap.
2923                 folderIconBitmap = favoriteIconBitmap;
2924             }
2925
2926             // Create a folder icon byte array output stream.
2927             ByteArrayOutputStream newFolderIconByteArrayOutputStream = new ByteArrayOutputStream();
2928
2929             // Convert the folder icon bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
2930             folderIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, newFolderIconByteArrayOutputStream);
2931
2932             // Convert the folder icon byte array stream to a byte array.
2933             byte[] newFolderIconByteArray = newFolderIconByteArrayOutputStream.toByteArray();
2934
2935             // Update the folder icon in the database.
2936             bookmarksDatabaseHelper.updateFolder(selectedFolderDatabaseId, newFolderIconByteArray);
2937         } else {  // The folder icon and the name have changed.
2938             // Get the new folder icon `Bitmap`.
2939             Bitmap folderIconBitmap;
2940             if (defaultFolderIconRadioButton.isChecked()) {
2941                 // Get the default folder icon drawable.
2942                 Drawable folderIconDrawable = defaultFolderIconImageView.getDrawable();
2943
2944                 // Convert the folder icon drawable to a bitmap drawable.
2945                 BitmapDrawable folderIconBitmapDrawable = (BitmapDrawable) folderIconDrawable;
2946
2947                 // Convert the folder icon bitmap drawable to a bitmap.
2948                 folderIconBitmap = folderIconBitmapDrawable.getBitmap();
2949             } else {  // Use the `WebView` favorite icon.
2950                 // Copy the favorite icon bitmap to the folder icon bitmap.
2951                 folderIconBitmap = favoriteIconBitmap;
2952             }
2953
2954             // Create a folder icon byte array output stream.
2955             ByteArrayOutputStream newFolderIconByteArrayOutputStream = new ByteArrayOutputStream();
2956
2957             // Convert the folder icon bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
2958             folderIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, newFolderIconByteArrayOutputStream);
2959
2960             // Convert the folder icon byte array stream to a byte array.
2961             byte[] newFolderIconByteArray = newFolderIconByteArrayOutputStream.toByteArray();
2962
2963             // Update the folder name and icon in the database.
2964             bookmarksDatabaseHelper.updateFolder(selectedFolderDatabaseId, oldFolderNameString, newFolderNameString, newFolderIconByteArray);
2965         }
2966
2967         // Update the bookmarks cursor with the current contents of this folder.
2968         bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrder(currentBookmarksFolder);
2969
2970         // Update the `ListView`.
2971         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
2972     }
2973
2974     @Override
2975     public void onCloseDownloadLocationPermissionDialog(int downloadType) {
2976         switch (downloadType) {
2977             case DownloadLocationPermissionDialog.DOWNLOAD_FILE:
2978                 // Request the WRITE_EXTERNAL_STORAGE permission with a file request code.
2979                 ActivityCompat.requestPermissions(this, new String[] {Manifest.permission.WRITE_EXTERNAL_STORAGE}, DOWNLOAD_FILE_REQUEST_CODE);
2980                 break;
2981
2982             case DownloadLocationPermissionDialog.DOWNLOAD_IMAGE:
2983                 // Request the WRITE_EXTERNAL_STORAGE permission with an image request code.
2984                 ActivityCompat.requestPermissions(this, new String[] {Manifest.permission.WRITE_EXTERNAL_STORAGE}, DOWNLOAD_IMAGE_REQUEST_CODE);
2985                 break;
2986         }
2987     }
2988
2989     @Override
2990     public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
2991         // Get a handle for the fragment manager.
2992         FragmentManager fragmentManager = getSupportFragmentManager();
2993
2994         switch (requestCode) {
2995             case DOWNLOAD_FILE_REQUEST_CODE:
2996                 // Show the download file alert dialog.  When the dialog closes, the correct command will be used based on the permission status.
2997                 DialogFragment downloadFileDialogFragment = DownloadFileDialog.fromUrl(downloadUrl, downloadContentDisposition, downloadContentLength);
2998
2999                 // On API 23, displaying the fragment must be delayed or the app will crash.
3000                 if (Build.VERSION.SDK_INT == 23) {
3001                     new Handler().postDelayed(() -> downloadFileDialogFragment.show(fragmentManager, getString(R.string.download)), 500);
3002                 } else {
3003                     downloadFileDialogFragment.show(fragmentManager, getString(R.string.download));
3004                 }
3005
3006                 // Reset the download variables.
3007                 downloadUrl = "";
3008                 downloadContentDisposition = "";
3009                 downloadContentLength = 0;
3010                 break;
3011
3012             case DOWNLOAD_IMAGE_REQUEST_CODE:
3013                 // Show the download image alert dialog.  When the dialog closes, the correct command will be used based on the permission status.
3014                 DialogFragment downloadImageDialogFragment = DownloadImageDialog.imageUrl(downloadImageUrl);
3015
3016                 // On API 23, displaying the fragment must be delayed or the app will crash.
3017                 if (Build.VERSION.SDK_INT == 23) {
3018                     new Handler().postDelayed(() -> downloadImageDialogFragment.show(fragmentManager, getString(R.string.download)), 500);
3019                 } else {
3020                     downloadImageDialogFragment.show(fragmentManager, getString(R.string.download));
3021                 }
3022
3023                 // Reset the image URL variable.
3024                 downloadImageUrl = "";
3025                 break;
3026         }
3027     }
3028
3029     @Override
3030     public void onDownloadImage(DialogFragment dialogFragment, String imageUrl) {
3031         // Download the image if it has an HTTP or HTTPS URI.
3032         if (imageUrl.startsWith("http")) {
3033             // Get a handle for the system `DOWNLOAD_SERVICE`.
3034             DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
3035
3036             // Parse `imageUrl`.
3037             DownloadManager.Request downloadRequest = new DownloadManager.Request(Uri.parse(imageUrl));
3038
3039             // Get a handle for the cookie manager.
3040             CookieManager cookieManager = CookieManager.getInstance();
3041
3042             // Pass cookies to download manager if cookies are enabled.  This is required to download images from websites that require a login.
3043             // Code contributed 2017 Hendrik Knackstedt.  Copyright assigned to Soren Stoutner <soren@stoutner.com>.
3044             if (cookieManager.acceptCookie()) {
3045                 // Get the cookies for `imageUrl`.
3046                 String cookies = cookieManager.getCookie(imageUrl);
3047
3048                 // Add the cookies to `downloadRequest`.  In the HTTP request header, cookies are named `Cookie`.
3049                 downloadRequest.addRequestHeader("Cookie", cookies);
3050             }
3051
3052             // Get the file name from the dialog fragment.
3053             EditText downloadImageNameEditText = dialogFragment.getDialog().findViewById(R.id.download_image_name);
3054             String imageName = downloadImageNameEditText.getText().toString();
3055
3056             // Specify the download location.
3057             if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED) {  // External write permission granted.
3058                 // Download to the public download directory.
3059                 downloadRequest.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, imageName);
3060             } else {  // External write permission denied.
3061                 // Download to the app's external download directory.
3062                 downloadRequest.setDestinationInExternalFilesDir(this, Environment.DIRECTORY_DOWNLOADS, imageName);
3063             }
3064
3065             // Allow `MediaScanner` to index the download if it is a media file.
3066             downloadRequest.allowScanningByMediaScanner();
3067
3068             // Add the URL as the description for the download.
3069             downloadRequest.setDescription(imageUrl);
3070
3071             // Show the download notification after the download is completed.
3072             downloadRequest.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
3073
3074             // Remove the lint warning below that `downloadManager` might be `null`.
3075             assert downloadManager != null;
3076
3077             // Initiate the download.
3078             downloadManager.enqueue(downloadRequest);
3079         } else {  // The image is not an HTTP or HTTPS URI.
3080             Snackbar.make(currentWebView, R.string.cannot_download_image, Snackbar.LENGTH_INDEFINITE).show();
3081         }
3082     }
3083
3084     @Override
3085     public void onDownloadFile(DialogFragment dialogFragment, String downloadUrl) {
3086         // Download the file if it has an HTTP or HTTPS URI.
3087         if (downloadUrl.startsWith("http")) {
3088             // Get a handle for the system `DOWNLOAD_SERVICE`.
3089             DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
3090
3091             // Parse `downloadUrl`.
3092             DownloadManager.Request downloadRequest = new DownloadManager.Request(Uri.parse(downloadUrl));
3093
3094             // Get a handle for the cookie manager.
3095             CookieManager cookieManager = CookieManager.getInstance();
3096
3097             // Pass cookies to download manager if cookies are enabled.  This is required to download files from websites that require a login.
3098             // Code contributed 2017 Hendrik Knackstedt.  Copyright assigned to Soren Stoutner <soren@stoutner.com>.
3099             if (cookieManager.acceptCookie()) {
3100                 // Get the cookies for `downloadUrl`.
3101                 String cookies = cookieManager.getCookie(downloadUrl);
3102
3103                 // Add the cookies to `downloadRequest`.  In the HTTP request header, cookies are named `Cookie`.
3104                 downloadRequest.addRequestHeader("Cookie", cookies);
3105             }
3106
3107             // Get the file name from the dialog fragment.
3108             EditText downloadFileNameEditText = dialogFragment.getDialog().findViewById(R.id.download_file_name);
3109             String fileName = downloadFileNameEditText.getText().toString();
3110
3111             // Specify the download location.
3112             if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED) {  // External write permission granted.
3113                 // Download to the public download directory.
3114                 downloadRequest.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);
3115             } else {  // External write permission denied.
3116                 // Download to the app's external download directory.
3117                 downloadRequest.setDestinationInExternalFilesDir(this, Environment.DIRECTORY_DOWNLOADS, fileName);
3118             }
3119
3120             // Allow `MediaScanner` to index the download if it is a media file.
3121             downloadRequest.allowScanningByMediaScanner();
3122
3123             // Add the URL as the description for the download.
3124             downloadRequest.setDescription(downloadUrl);
3125
3126             // Show the download notification after the download is completed.
3127             downloadRequest.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
3128
3129             // Remove the lint warning below that `downloadManager` might be `null`.
3130             assert downloadManager != null;
3131
3132             // Initiate the download.
3133             downloadManager.enqueue(downloadRequest);
3134         } else {  // The download is not an HTTP or HTTPS URI.
3135             Snackbar.make(currentWebView, R.string.cannot_download_file, Snackbar.LENGTH_INDEFINITE).show();
3136         }
3137     }
3138
3139     // Override `onBackPressed` to handle the navigation drawer and and the WebView.
3140     @Override
3141     public void onBackPressed() {
3142         // Get a handle for the drawer layout.
3143         DrawerLayout drawerLayout = findViewById(R.id.drawerlayout);
3144
3145         if (drawerLayout.isDrawerVisible(GravityCompat.START)) {  // The navigation drawer is open.
3146             // Close the navigation drawer.
3147             drawerLayout.closeDrawer(GravityCompat.START);
3148         } else if (drawerLayout.isDrawerVisible(GravityCompat.END)){  // The bookmarks drawer is open.
3149             if (currentBookmarksFolder.isEmpty()) {  // The home folder is displayed.
3150                 // close the bookmarks drawer.
3151                 drawerLayout.closeDrawer(GravityCompat.END);
3152             } else {  // A subfolder is displayed.
3153                 // Place the former parent folder in `currentFolder`.
3154                 currentBookmarksFolder = bookmarksDatabaseHelper.getParentFolderName(currentBookmarksFolder);
3155
3156                 // Load the new folder.
3157                 loadBookmarksFolder();
3158             }
3159         } else if (currentWebView.canGoBack()) {  // There is at least one item in the current WebView history.
3160             // Reset the current domain name so that navigation works if third-party requests are blocked.
3161             currentWebView.resetCurrentDomainName();
3162
3163             // Set navigating history so that the domain settings are applied when the new URL is loaded.
3164             currentWebView.setNavigatingHistory(true);
3165
3166             // Go back.
3167             currentWebView.goBack();
3168         } else {  // There is nothing else to do.
3169             // Load a blank website.
3170             loadUrl("");
3171         }
3172     }
3173
3174     // Process the results of an upload file chooser.  Currently there is only one `startActivityForResult` in this activity, so the request code, used to differentiate them, is ignored.
3175     @Override
3176     public void onActivityResult(int requestCode, int resultCode, Intent data) {
3177         // File uploads only work on API >= 21.
3178         if (Build.VERSION.SDK_INT >= 21) {
3179             // Pass the file to the WebView.
3180             fileChooserCallback.onReceiveValue(WebChromeClient.FileChooserParams.parseResult(resultCode, data));
3181         }
3182     }
3183
3184     private void loadUrlFromTextBox() {
3185         // Get a handle for the URL edit text.
3186         EditText urlEditText = findViewById(R.id.url_edittext);
3187
3188         // Get the text from urlTextBox and convert it to a string.  trim() removes white spaces from the beginning and end of the string.
3189         String unformattedUrlString = urlEditText.getText().toString().trim();
3190
3191         // Initialize the formatted URL string.
3192         String url = "";
3193
3194         // Check to see if `unformattedUrlString` is a valid URL.  Otherwise, convert it into a search.
3195         if (unformattedUrlString.startsWith("content://")) {  // This is a Content URL.
3196             // Load the entire content URL.
3197             url = unformattedUrlString;
3198         } else if (Patterns.WEB_URL.matcher(unformattedUrlString).matches() || unformattedUrlString.startsWith("http://") || unformattedUrlString.startsWith("https://") ||
3199                 unformattedUrlString.startsWith("file://")) {  // This is a standard URL.
3200             // Add `https://` at the beginning if there is no protocol.  Otherwise the app will segfault.
3201             if (!unformattedUrlString.startsWith("http") && !unformattedUrlString.startsWith("file://") && !unformattedUrlString.startsWith("content://")) {
3202                 unformattedUrlString = "https://" + unformattedUrlString;
3203             }
3204
3205             // Initialize `unformattedUrl`.
3206             URL unformattedUrl = null;
3207
3208             // Convert `unformattedUrlString` to a `URL`, then to a `URI`, and then back to a `String`, which sanitizes the input and adds in any missing components.
3209             try {
3210                 unformattedUrl = new URL(unformattedUrlString);
3211             } catch (MalformedURLException e) {
3212                 e.printStackTrace();
3213             }
3214
3215             // The ternary operator (? :) makes sure that a null pointer exception is not thrown, which would happen if `.get` was called on a `null` value.
3216             String scheme = unformattedUrl != null ? unformattedUrl.getProtocol() : null;
3217             String authority = unformattedUrl != null ? unformattedUrl.getAuthority() : null;
3218             String path = unformattedUrl != null ? unformattedUrl.getPath() : null;
3219             String query = unformattedUrl != null ? unformattedUrl.getQuery() : null;
3220             String fragment = unformattedUrl != null ? unformattedUrl.getRef() : null;
3221
3222             // Build the URI.
3223             Uri.Builder uri = new Uri.Builder();
3224             uri.scheme(scheme).authority(authority).path(path).query(query).fragment(fragment);
3225
3226             // Decode the URI as a UTF-8 string in.
3227             try {
3228                 url = URLDecoder.decode(uri.build().toString(), "UTF-8");
3229             } catch (UnsupportedEncodingException exception) {
3230                 // Do nothing.  The formatted URL string will remain blank.
3231             }
3232         } else if (!unformattedUrlString.isEmpty()){  // This is not a URL, but rather a search string.
3233             // Create an encoded URL String.
3234             String encodedUrlString;
3235
3236             // Sanitize the search input.
3237             try {
3238                 encodedUrlString = URLEncoder.encode(unformattedUrlString, "UTF-8");
3239             } catch (UnsupportedEncodingException exception) {
3240                 encodedUrlString = "";
3241             }
3242
3243             // Add the base search URL.
3244             url = searchURL + encodedUrlString;
3245         }
3246
3247         // Clear the focus from the URL edit text.  Otherwise, proximate typing in the box will retain the colorized formatting instead of being reset during refocus.
3248         urlEditText.clearFocus();
3249
3250         // Make it so.
3251         loadUrl(url);
3252     }
3253
3254     private void loadUrl(String url) {
3255         // Apply the domain settings.
3256         applyDomainSettings(currentWebView, url, true, false);
3257
3258         // Load the URL.
3259         currentWebView.loadUrl(url, customHeaders);
3260     }
3261
3262     public void findPreviousOnPage(View view) {
3263         // Go to the previous highlighted phrase on the page.  `false` goes backwards instead of forwards.
3264         currentWebView.findNext(false);
3265     }
3266
3267     public void findNextOnPage(View view) {
3268         // Go to the next highlighted phrase on the page. `true` goes forwards instead of backwards.
3269         currentWebView.findNext(true);
3270     }
3271
3272     public void closeFindOnPage(View view) {
3273         // Get a handle for the views.
3274         Toolbar toolbar = findViewById(R.id.toolbar);
3275         LinearLayout findOnPageLinearLayout = findViewById(R.id.find_on_page_linearlayout);
3276         EditText findOnPageEditText = findViewById(R.id.find_on_page_edittext);
3277
3278         // Delete the contents of `find_on_page_edittext`.
3279         findOnPageEditText.setText(null);
3280
3281         // Clear the highlighted phrases if the WebView is not null.
3282         if (currentWebView != null) {
3283             currentWebView.clearMatches();
3284         }
3285
3286         // Hide the find on page linear layout.
3287         findOnPageLinearLayout.setVisibility(View.GONE);
3288
3289         // Show the toolbar.
3290         toolbar.setVisibility(View.VISIBLE);
3291
3292         // Get a handle for the input method manager.
3293         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
3294
3295         // Remove the lint warning below that the input method manager might be null.
3296         assert inputMethodManager != null;
3297
3298         // Hide the keyboard.
3299         inputMethodManager.hideSoftInputFromWindow(currentWebView.getWindowToken(), 0);
3300     }
3301
3302     private void applyAppSettings() {
3303         // Get a handle for the shared preferences.
3304         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
3305
3306         // Store the values from the shared preferences in variables.
3307         incognitoModeEnabled = sharedPreferences.getBoolean("incognito_mode", false);
3308         boolean doNotTrackEnabled = sharedPreferences.getBoolean("do_not_track", false);
3309         proxyThroughOrbot = sharedPreferences.getBoolean("proxy_through_orbot", false);
3310         fullScreenBrowsingModeEnabled = sharedPreferences.getBoolean("full_screen_browsing_mode", false);
3311         hideAppBar = sharedPreferences.getBoolean("hide_app_bar", true);
3312         scrollAppBar = sharedPreferences.getBoolean("scroll_app_bar", true);
3313
3314         // Get handles for the views that need to be modified.
3315         FrameLayout rootFrameLayout = findViewById(R.id.root_framelayout);
3316         AppBarLayout appBarLayout = findViewById(R.id.appbar_layout);
3317         ActionBar actionBar = getSupportActionBar();
3318         LinearLayout tabsLinearLayout = findViewById(R.id.tabs_linearlayout);
3319         SwipeRefreshLayout swipeRefreshLayout = findViewById(R.id.swiperefreshlayout);
3320
3321         // Remove the incorrect lint warning below that the action bar might be null.
3322         assert actionBar != null;
3323
3324         // Apply the proxy through Orbot settings.
3325         applyProxyThroughOrbot(false);
3326
3327         // Set Do Not Track status.
3328         if (doNotTrackEnabled) {
3329             customHeaders.put("DNT", "1");
3330         } else {
3331             customHeaders.remove("DNT");
3332         }
3333
3334         // Get the current layout parameters.  Using coordinator layout parameters allows the `setBehavior()` command.
3335         CoordinatorLayout.LayoutParams layoutParams = (CoordinatorLayout.LayoutParams) swipeRefreshLayout.getLayoutParams();
3336
3337         // Add the scrolling behavior to the layout parameters.
3338         if (scrollAppBar) {
3339             // Enable scrolling of the app bar.
3340             layoutParams.setBehavior(new AppBarLayout.ScrollingViewBehavior());
3341         } else {
3342             // Disable scrolling of the app bar.
3343             layoutParams.setBehavior(null);
3344
3345             // Expand the app bar if it is currently collapsed.
3346             appBarLayout.setExpanded(true);
3347         }
3348
3349         // Apply the modified layout parameters to the swipe refresh layout.
3350         swipeRefreshLayout.setLayoutParams(layoutParams);
3351
3352         // Set the app bar scrolling for each WebView.
3353         for (int i = 0; i < webViewPagerAdapter.getCount(); i++) {
3354             // Get the WebView tab fragment.
3355             WebViewTabFragment webViewTabFragment = webViewPagerAdapter.getPageFragment(i);
3356
3357             // Get the fragment view.
3358             View fragmentView = webViewTabFragment.getView();
3359
3360             // Only modify the WebViews if they exist.
3361             if (fragmentView != null) {
3362                 // Get the nested scroll WebView from the tab fragment.
3363                 NestedScrollWebView nestedScrollWebView = fragmentView.findViewById(R.id.nestedscroll_webview);
3364
3365                 // Set the app bar scrolling.
3366                 nestedScrollWebView.setNestedScrollingEnabled(scrollAppBar);
3367             }
3368         }
3369
3370         // Update the full screen browsing mode settings.
3371         if (fullScreenBrowsingModeEnabled && inFullScreenBrowsingMode) {  // Privacy Browser is currently in full screen browsing mode.
3372             // Update the visibility of the app bar, which might have changed in the settings.
3373             if (hideAppBar) {
3374                 // Hide the tab linear layout.
3375                 tabsLinearLayout.setVisibility(View.GONE);
3376
3377                 // Hide the action bar.
3378                 actionBar.hide();
3379             } else {
3380                 // Show the tab linear layout.
3381                 tabsLinearLayout.setVisibility(View.VISIBLE);
3382
3383                 // Show the action bar.
3384                 actionBar.show();
3385             }
3386
3387             // Hide the banner ad in the free flavor.
3388             if (BuildConfig.FLAVOR.contentEquals("free")) {
3389                 AdHelper.hideAd(findViewById(R.id.adview));
3390             }
3391
3392             // Remove the translucent status flag.  This is necessary so the root frame layout can fill the entire screen.
3393             getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
3394
3395             /* Hide the system bars.
3396              * SYSTEM_UI_FLAG_FULLSCREEN hides the status bar at the top of the screen.
3397              * SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN makes the root frame layout fill the area that is normally reserved for the status bar.
3398              * SYSTEM_UI_FLAG_HIDE_NAVIGATION hides the navigation bar on the bottom or right of the screen.
3399              * SYSTEM_UI_FLAG_IMMERSIVE_STICKY makes the status and navigation bars translucent and automatically re-hides them after they are shown.
3400              */
3401             rootFrameLayout.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
3402                     View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
3403         } else {  // Privacy Browser is not in full screen browsing mode.
3404             // Reset the full screen tracker, which could be true if Privacy Browser was in full screen mode before entering settings and full screen browsing was disabled.
3405             inFullScreenBrowsingMode = false;
3406
3407             // Show the tab linear layout.
3408             tabsLinearLayout.setVisibility(View.VISIBLE);
3409
3410             // Show the action bar.
3411             actionBar.show();
3412
3413             // Show the banner ad in the free flavor.
3414             if (BuildConfig.FLAVOR.contentEquals("free")) {
3415                 // Initialize the ads.  If this isn't the first run, `loadAd()` will be automatically called instead.
3416                 AdHelper.initializeAds(findViewById(R.id.adview), getApplicationContext(), getSupportFragmentManager(), getString(R.string.google_app_id), getString(R.string.ad_unit_id));
3417             }
3418
3419             // Remove the `SYSTEM_UI` flags from the root frame layout.
3420             rootFrameLayout.setSystemUiVisibility(0);
3421
3422             // Add the translucent status flag.
3423             getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
3424         }
3425     }
3426
3427
3428     // `reloadWebsite` is used if returning from the Domains activity.  Otherwise JavaScript might not function correctly if it is newly enabled.
3429     @SuppressLint("SetJavaScriptEnabled")
3430     private boolean applyDomainSettings(NestedScrollWebView nestedScrollWebView, String url, boolean resetTab, boolean reloadWebsite) {
3431         // Store a copy of the current user agent to track changes for the return boolean.
3432         String initialUserAgent = nestedScrollWebView.getSettings().getUserAgentString();
3433
3434         // Parse the URL into a URI.
3435         Uri uri = Uri.parse(url);
3436
3437         // Extract the domain from `uri`.
3438         String newHostName = uri.getHost();
3439
3440         // Strings don't like to be null.
3441         if (newHostName == null) {
3442             newHostName = "";
3443         }
3444
3445         // Only apply the domain settings if a new domain is being loaded.  This allows the user to set temporary settings for JavaScript, cookies, DOM storage, etc.
3446         if (!nestedScrollWebView.getCurrentDomainName().equals(newHostName)) {
3447             // Set the new host name as the current domain name.
3448             nestedScrollWebView.setCurrentDomainName(newHostName);
3449
3450             // Reset the ignoring of pinned domain information.
3451             nestedScrollWebView.setIgnorePinnedDomainInformation(false);
3452
3453             // Clear any pinned SSL certificate or IP addresses.
3454             nestedScrollWebView.clearPinnedSslCertificate();
3455             nestedScrollWebView.clearPinnedIpAddresses();
3456
3457             // Reset the favorite icon if specified.
3458             if (resetTab) {
3459                 // Initialize the favorite icon.
3460                 nestedScrollWebView.initializeFavoriteIcon();
3461
3462                 // Get the current page position.
3463                 int currentPagePosition = webViewPagerAdapter.getPositionForId(nestedScrollWebView.getWebViewFragmentId());
3464
3465                 // Get a handle for the tab layout.
3466                 TabLayout tabLayout = findViewById(R.id.tablayout);
3467
3468                 // Get the corresponding tab.
3469                 TabLayout.Tab tab = tabLayout.getTabAt(currentPagePosition);
3470
3471                 // Update the tab if it isn't null, which sometimes happens when restarting from the background.
3472                 if (tab != null) {
3473                     // Get the tab custom view.
3474                     View tabCustomView = tab.getCustomView();
3475
3476                     // Remove the warning below that the tab custom view might be null.
3477                     assert tabCustomView != null;
3478
3479                     // Get the tab views.
3480                     ImageView tabFavoriteIconImageView = tabCustomView.findViewById(R.id.favorite_icon_imageview);
3481                     TextView tabTitleTextView = tabCustomView.findViewById(R.id.title_textview);
3482
3483                     // Set the default favorite icon as the favorite icon for this tab.
3484                     tabFavoriteIconImageView.setImageBitmap(Bitmap.createScaledBitmap(nestedScrollWebView.getFavoriteOrDefaultIcon(), 64, 64, true));
3485
3486                     // Set the loading title text.
3487                     tabTitleTextView.setText(R.string.loading);
3488                 }
3489             }
3490
3491             // Initialize the database handler.  The `0` specifies the database version, but that is ignored and set instead using a constant in `DomainsDatabaseHelper`.
3492             DomainsDatabaseHelper domainsDatabaseHelper = new DomainsDatabaseHelper(this, null, null, 0);
3493
3494             // Get a full cursor from `domainsDatabaseHelper`.
3495             Cursor domainNameCursor = domainsDatabaseHelper.getDomainNameCursorOrderedByDomain();
3496
3497             // Initialize `domainSettingsSet`.
3498             Set<String> domainSettingsSet = new HashSet<>();
3499
3500             // Get the domain name column index.
3501             int domainNameColumnIndex = domainNameCursor.getColumnIndex(DomainsDatabaseHelper.DOMAIN_NAME);
3502
3503             // Populate `domainSettingsSet`.
3504             for (int i = 0; i < domainNameCursor.getCount(); i++) {
3505                 // Move `domainsCursor` to the current row.
3506                 domainNameCursor.moveToPosition(i);
3507
3508                 // Store the domain name in `domainSettingsSet`.
3509                 domainSettingsSet.add(domainNameCursor.getString(domainNameColumnIndex));
3510             }
3511
3512             // Close `domainNameCursor.
3513             domainNameCursor.close();
3514
3515             // Initialize the domain name in database variable.
3516             String domainNameInDatabase = null;
3517
3518             // Check the hostname against the domain settings set.
3519             if (domainSettingsSet.contains(newHostName)) {  // The hostname is contained in the domain settings set.
3520                 // Record the domain name in the database.
3521                 domainNameInDatabase = newHostName;
3522
3523                 // Set the domain settings applied tracker to true.
3524                 nestedScrollWebView.setDomainSettingsApplied(true);
3525             } else {  // The hostname is not contained in the domain settings set.
3526                 // Set the domain settings applied tracker to false.
3527                 nestedScrollWebView.setDomainSettingsApplied(false);
3528             }
3529
3530             // Check all the subdomains of the host name against wildcard domains in the domain cursor.
3531             while (!nestedScrollWebView.getDomainSettingsApplied() && newHostName.contains(".")) {  // Stop checking if domain settings are already applied or there are no more `.` in the host name.
3532                 if (domainSettingsSet.contains("*." + newHostName)) {  // Check the host name prepended by `*.`.
3533                     // Set the domain settings applied tracker to true.
3534                     nestedScrollWebView.setDomainSettingsApplied(true);
3535
3536                     // Store the applied domain names as it appears in the database.
3537                     domainNameInDatabase = "*." + newHostName;
3538                 }
3539
3540                 // Strip out the lowest subdomain of of the host name.
3541                 newHostName = newHostName.substring(newHostName.indexOf(".") + 1);
3542             }
3543
3544
3545             // Get a handle for the shared preferences.
3546             SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
3547
3548             // Store the general preference information.
3549             String defaultFontSizeString = sharedPreferences.getString("font_size", getString(R.string.font_size_default_value));
3550             String defaultUserAgentName = sharedPreferences.getString("user_agent", getString(R.string.user_agent_default_value));
3551             boolean defaultSwipeToRefresh = sharedPreferences.getBoolean("swipe_to_refresh", true);
3552             boolean displayWebpageImages = sharedPreferences.getBoolean("display_webpage_images", true);
3553             boolean darkTheme = sharedPreferences.getBoolean("dark_theme", false);
3554
3555             // Get a handle for the cookie manager.
3556             CookieManager cookieManager = CookieManager.getInstance();
3557
3558             // Get handles for the views.
3559             RelativeLayout urlRelativeLayout = findViewById(R.id.url_relativelayout);
3560             SwipeRefreshLayout swipeRefreshLayout = findViewById(R.id.swiperefreshlayout);
3561
3562             // Initialize the user agent array adapter and string array.
3563             ArrayAdapter<CharSequence> userAgentNamesArray = ArrayAdapter.createFromResource(this, R.array.user_agent_names, R.layout.spinner_item);
3564             String[] userAgentDataArray = getResources().getStringArray(R.array.user_agent_data);
3565
3566             if (nestedScrollWebView.getDomainSettingsApplied()) {  // The url has custom domain settings.
3567                 // Get a cursor for the current host and move it to the first position.
3568                 Cursor currentDomainSettingsCursor = domainsDatabaseHelper.getCursorForDomainName(domainNameInDatabase);
3569                 currentDomainSettingsCursor.moveToFirst();
3570
3571                 // Get the settings from the cursor.
3572                 nestedScrollWebView.setDomainSettingsDatabaseId(currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper._ID)));
3573                 nestedScrollWebView.setDomainSettingsJavaScriptEnabled(currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_JAVASCRIPT)) == 1);
3574                 nestedScrollWebView.setAcceptFirstPartyCookies(currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_FIRST_PARTY_COOKIES)) == 1);
3575                 boolean domainThirdPartyCookiesEnabled = (currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_THIRD_PARTY_COOKIES)) == 1);
3576                 nestedScrollWebView.getSettings().setDomStorageEnabled(currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_DOM_STORAGE)) == 1);
3577                 // Form data can be removed once the minimum API >= 26.
3578                 boolean saveFormData = (currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_FORM_DATA)) == 1);
3579                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.EASY_LIST,
3580                         currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_EASYLIST)) == 1);
3581                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.EASY_PRIVACY,
3582                         currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_EASYPRIVACY)) == 1);
3583                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST,
3584                         currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_FANBOYS_ANNOYANCE_LIST)) == 1);
3585                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST,
3586                         currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_FANBOYS_SOCIAL_BLOCKING_LIST)) == 1);
3587                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.ULTRA_PRIVACY,
3588                         currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.ENABLE_ULTRAPRIVACY)) == 1);
3589                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.THIRD_PARTY_REQUESTS,
3590                         currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.BLOCK_ALL_THIRD_PARTY_REQUESTS)) == 1);
3591                 String userAgentName = currentDomainSettingsCursor.getString(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.USER_AGENT));
3592                 int fontSize = currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.FONT_SIZE));
3593                 int swipeToRefreshInt = currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SWIPE_TO_REFRESH));
3594                 int nightModeInt = currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.NIGHT_MODE));
3595                 int displayWebpageImagesInt = currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.DISPLAY_IMAGES));
3596                 boolean pinnedSslCertificate = (currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.PINNED_SSL_CERTIFICATE)) == 1);
3597                 String pinnedSslIssuedToCName = currentDomainSettingsCursor.getString(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_ISSUED_TO_COMMON_NAME));
3598                 String pinnedSslIssuedToOName = currentDomainSettingsCursor.getString(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_ISSUED_TO_ORGANIZATION));
3599                 String pinnedSslIssuedToUName = currentDomainSettingsCursor.getString(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_ISSUED_TO_ORGANIZATIONAL_UNIT));
3600                 String pinnedSslIssuedByCName = currentDomainSettingsCursor.getString(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_ISSUED_BY_COMMON_NAME));
3601                 String pinnedSslIssuedByOName = currentDomainSettingsCursor.getString(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_ISSUED_BY_ORGANIZATION));
3602                 String pinnedSslIssuedByUName = currentDomainSettingsCursor.getString(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_ISSUED_BY_ORGANIZATIONAL_UNIT));
3603                 boolean pinnedIpAddresses = (currentDomainSettingsCursor.getInt(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.PINNED_IP_ADDRESSES)) == 1);
3604                 String pinnedHostIpAddresses = currentDomainSettingsCursor.getString(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.IP_ADDRESSES));
3605
3606                 // Create the pinned SSL date variables.
3607                 Date pinnedSslStartDate;
3608                 Date pinnedSslEndDate;
3609
3610                 // Set the pinned SSL certificate start date to `null` if the saved date `long` is 0 because creating a new Date results in an error if the input is 0.
3611                 if (currentDomainSettingsCursor.getLong(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_START_DATE)) == 0) {
3612                     pinnedSslStartDate = null;
3613                 } else {
3614                     pinnedSslStartDate = new Date(currentDomainSettingsCursor.getLong(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_START_DATE)));
3615                 }
3616
3617                 // Set the pinned SSL certificate end date to `null` if the saved date `long` is 0 because creating a new Date results in an error if the input is 0.
3618                 if (currentDomainSettingsCursor.getLong(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_END_DATE)) == 0) {
3619                     pinnedSslEndDate = null;
3620                 } else {
3621                     pinnedSslEndDate = new Date(currentDomainSettingsCursor.getLong(currentDomainSettingsCursor.getColumnIndex(DomainsDatabaseHelper.SSL_END_DATE)));
3622                 }
3623
3624                 // If there is a pinned SSL certificate, store it in the WebView.
3625                 if (pinnedSslCertificate) {
3626                     nestedScrollWebView.setPinnedSslCertificate(pinnedSslIssuedToCName, pinnedSslIssuedToOName, pinnedSslIssuedToUName, pinnedSslIssuedByCName, pinnedSslIssuedByOName, pinnedSslIssuedByUName,
3627                             pinnedSslStartDate, pinnedSslEndDate);
3628                 }
3629
3630                 // If there is a pinned IP address, store it in the WebView.
3631                 if (pinnedIpAddresses) {
3632                     nestedScrollWebView.setPinnedIpAddresses(pinnedHostIpAddresses);
3633                 }
3634
3635                 // Set night mode according to the night mode int.
3636                 switch (nightModeInt) {
3637                     case DomainsDatabaseHelper.NIGHT_MODE_SYSTEM_DEFAULT:
3638                         // Set night mode according to the current default.
3639                         nestedScrollWebView.setNightMode(sharedPreferences.getBoolean("night_mode", false));
3640                         break;
3641
3642                     case DomainsDatabaseHelper.NIGHT_MODE_ENABLED:
3643                         // Enable night mode.
3644                         nestedScrollWebView.setNightMode(true);
3645                         break;
3646
3647                     case DomainsDatabaseHelper.NIGHT_MODE_DISABLED:
3648                         // Disable night mode.
3649                         nestedScrollWebView.setNightMode(false);
3650                         break;
3651                 }
3652
3653                 // Enable JavaScript if night mode is enabled.
3654                 if (nestedScrollWebView.getNightMode()) {
3655                     // Enable JavaScript.
3656                     nestedScrollWebView.getSettings().setJavaScriptEnabled(true);
3657                 } else {
3658                     // Set JavaScript according to the domain settings.
3659                     nestedScrollWebView.getSettings().setJavaScriptEnabled(nestedScrollWebView.getDomainSettingsJavaScriptEnabled());
3660                 }
3661
3662                 // Close the current host domain settings cursor.
3663                 currentDomainSettingsCursor.close();
3664
3665                 // Apply the domain settings.
3666                 cookieManager.setAcceptCookie(nestedScrollWebView.getAcceptFirstPartyCookies());
3667
3668                 // Set third-party cookies status if API >= 21.
3669                 if (Build.VERSION.SDK_INT >= 21) {
3670                     cookieManager.setAcceptThirdPartyCookies(nestedScrollWebView, domainThirdPartyCookiesEnabled);
3671                 }
3672
3673                 // Apply the form data setting if the API < 26.
3674                 if (Build.VERSION.SDK_INT < 26) {
3675                     nestedScrollWebView.getSettings().setSaveFormData(saveFormData);
3676                 }
3677
3678                 // Apply the font size.
3679                 if (fontSize == 0) {  // Apply the default font size.
3680                     nestedScrollWebView.getSettings().setTextZoom(Integer.valueOf(defaultFontSizeString));
3681                 } else {  // Apply the specified font size.
3682                     nestedScrollWebView.getSettings().setTextZoom(fontSize);
3683                 }
3684
3685                 // Only set the user agent if the webpage is not currently loading.  Otherwise, changing the user agent on redirects can cause the original website to reload.
3686                 // <https://redmine.stoutner.com/issues/160>
3687                 if (nestedScrollWebView.getProgress() == 100) {  // A URL is not loading.
3688                     // Set the user agent.
3689                     if (userAgentName.equals(getString(R.string.system_default_user_agent))) {  // Use the system default user agent.
3690                         // Get the array position of the default user agent name.
3691                         int defaultUserAgentArrayPosition = userAgentNamesArray.getPosition(defaultUserAgentName);
3692
3693                         // Set the user agent according to the system default.
3694                         switch (defaultUserAgentArrayPosition) {
3695                             case UNRECOGNIZED_USER_AGENT:  // The default user agent name is not on the canonical list.
3696                                 // This is probably because it was set in an older version of Privacy Browser before the switch to persistent user agent names.
3697                                 nestedScrollWebView.getSettings().setUserAgentString(defaultUserAgentName);
3698                                 break;
3699
3700                             case SETTINGS_WEBVIEW_DEFAULT_USER_AGENT:
3701                                 // Set the user agent to `""`, which uses the default value.
3702                                 nestedScrollWebView.getSettings().setUserAgentString("");
3703                                 break;
3704
3705                             case SETTINGS_CUSTOM_USER_AGENT:
3706                                 // Set the default custom user agent.
3707                                 nestedScrollWebView.getSettings().setUserAgentString(sharedPreferences.getString("custom_user_agent", getString(R.string.custom_user_agent_default_value)));
3708                                 break;
3709
3710                             default:
3711                                 // Get the user agent string from the user agent data array
3712                                 nestedScrollWebView.getSettings().setUserAgentString(userAgentDataArray[defaultUserAgentArrayPosition]);
3713                         }
3714                     } else {  // Set the user agent according to the stored name.
3715                         // Get the array position of the user agent name.
3716                         int userAgentArrayPosition = userAgentNamesArray.getPosition(userAgentName);
3717
3718                         switch (userAgentArrayPosition) {
3719                             case UNRECOGNIZED_USER_AGENT:  // The user agent name contains a custom user agent.
3720                                 nestedScrollWebView.getSettings().setUserAgentString(userAgentName);
3721                                 break;
3722
3723                             case SETTINGS_WEBVIEW_DEFAULT_USER_AGENT:
3724                                 // Set the user agent to `""`, which uses the default value.
3725                                 nestedScrollWebView.getSettings().setUserAgentString("");
3726                                 break;
3727
3728                             default:
3729                                 // Get the user agent string from the user agent data array.
3730                                 nestedScrollWebView.getSettings().setUserAgentString(userAgentDataArray[userAgentArrayPosition]);
3731                         }
3732                     }
3733                 }
3734
3735                 // Set swipe to refresh.
3736                 switch (swipeToRefreshInt) {
3737                     case DomainsDatabaseHelper.SWIPE_TO_REFRESH_SYSTEM_DEFAULT:
3738                         // Store the swipe to refresh status in the nested scroll WebView.
3739                         nestedScrollWebView.setSwipeToRefresh(defaultSwipeToRefresh);
3740
3741                         // Apply swipe to refresh according to the default.  This can be removed once the minimum API >= 23 because it is continuously set by an on scroll change listener.
3742                         swipeRefreshLayout.setEnabled(defaultSwipeToRefresh);
3743                         break;
3744
3745                     case DomainsDatabaseHelper.SWIPE_TO_REFRESH_ENABLED:
3746                         // Store the swipe to refresh status in the nested scroll WebView.
3747                         nestedScrollWebView.setSwipeToRefresh(true);
3748
3749                         // Enable swipe to refresh.  This can be removed once the minimum API >= 23 because it is continuously set by an on scroll change listener.
3750                         swipeRefreshLayout.setEnabled(true);
3751                         break;
3752
3753                     case DomainsDatabaseHelper.SWIPE_TO_REFRESH_DISABLED:
3754                         // Store the swipe to refresh status in the nested scroll WebView.
3755                         nestedScrollWebView.setSwipeToRefresh(false);
3756
3757                         // Disable swipe to refresh.  This can be removed once the minimum API >= 23 because it is continuously set by an on scroll change listener.
3758                         swipeRefreshLayout.setEnabled(false);
3759                 }
3760
3761                 // Set the loading of webpage images.
3762                 switch (displayWebpageImagesInt) {
3763                     case DomainsDatabaseHelper.DISPLAY_WEBPAGE_IMAGES_SYSTEM_DEFAULT:
3764                         nestedScrollWebView.getSettings().setLoadsImagesAutomatically(displayWebpageImages);
3765                         break;
3766
3767                     case DomainsDatabaseHelper.DISPLAY_WEBPAGE_IMAGES_ENABLED:
3768                         nestedScrollWebView.getSettings().setLoadsImagesAutomatically(true);
3769                         break;
3770
3771                     case DomainsDatabaseHelper.DISPLAY_WEBPAGE_IMAGES_DISABLED:
3772                         nestedScrollWebView.getSettings().setLoadsImagesAutomatically(false);
3773                         break;
3774                 }
3775
3776                 // Set a green background on the URL relative layout to indicate that custom domain settings are being used. The deprecated `.getDrawable()` must be used until the minimum API >= 21.
3777                 if (darkTheme) {
3778                     urlRelativeLayout.setBackground(getResources().getDrawable(R.drawable.url_bar_background_dark_blue));
3779                 } else {
3780                     urlRelativeLayout.setBackground(getResources().getDrawable(R.drawable.url_bar_background_light_green));
3781                 }
3782             } else {  // The new URL does not have custom domain settings.  Load the defaults.
3783                 // Store the values from the shared preferences.
3784                 boolean defaultJavaScriptEnabled = sharedPreferences.getBoolean("javascript", false);
3785                 nestedScrollWebView.setAcceptFirstPartyCookies(sharedPreferences.getBoolean("first_party_cookies", false));
3786                 boolean defaultThirdPartyCookiesEnabled = sharedPreferences.getBoolean("third_party_cookies", false);
3787                 nestedScrollWebView.getSettings().setDomStorageEnabled(sharedPreferences.getBoolean("dom_storage", false));
3788                 boolean saveFormData = sharedPreferences.getBoolean("save_form_data", false);  // Form data can be removed once the minimum API >= 26.
3789                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.EASY_LIST, sharedPreferences.getBoolean("easylist", true));
3790                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.EASY_PRIVACY, sharedPreferences.getBoolean("easyprivacy", true));
3791                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST, sharedPreferences.getBoolean("fanboys_annoyance_list", true));
3792                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST, sharedPreferences.getBoolean("fanboys_social_blocking_list", true));
3793                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.ULTRA_PRIVACY, sharedPreferences.getBoolean("ultraprivacy", true));
3794                 nestedScrollWebView.enableBlocklist(NestedScrollWebView.THIRD_PARTY_REQUESTS, sharedPreferences.getBoolean("block_all_third_party_requests", false));
3795                 nestedScrollWebView.setNightMode(sharedPreferences.getBoolean("night_mode", false));
3796
3797                 // Enable JavaScript if night mode is enabled.
3798                 if (nestedScrollWebView.getNightMode()) {
3799                     // Enable JavaScript.
3800                     nestedScrollWebView.getSettings().setJavaScriptEnabled(true);
3801                 } else {
3802                     // Set JavaScript according to the domain settings.
3803                     nestedScrollWebView.getSettings().setJavaScriptEnabled(defaultJavaScriptEnabled);
3804                 }
3805
3806                 // Apply the default settings.
3807                 cookieManager.setAcceptCookie(nestedScrollWebView.getAcceptFirstPartyCookies());
3808                 nestedScrollWebView.getSettings().setTextZoom(Integer.valueOf(defaultFontSizeString));
3809
3810                 // Apply the form data setting if the API < 26.
3811                 if (Build.VERSION.SDK_INT < 26) {
3812                     nestedScrollWebView.getSettings().setSaveFormData(saveFormData);
3813                 }
3814
3815                 // Store the swipe to refresh status in the nested scroll WebView.
3816                 nestedScrollWebView.setSwipeToRefresh(defaultSwipeToRefresh);
3817
3818                 // Apply swipe to refresh according to the default.
3819                 swipeRefreshLayout.setEnabled(defaultSwipeToRefresh);
3820
3821                 // Reset the pinned variables.
3822                 nestedScrollWebView.setDomainSettingsDatabaseId(-1);
3823
3824                 // Set third-party cookies status if API >= 21.
3825                 if (Build.VERSION.SDK_INT >= 21) {
3826                     cookieManager.setAcceptThirdPartyCookies(nestedScrollWebView, defaultThirdPartyCookiesEnabled);
3827                 }
3828
3829                 // Only set the user agent if the webpage is not currently loading.  Otherwise, changing the user agent on redirects can cause the original website to reload.
3830                 // <https://redmine.stoutner.com/issues/160>
3831                 if (nestedScrollWebView.getProgress() == 100) {  // A URL is not loading.
3832                     // Get the array position of the user agent name.
3833                     int userAgentArrayPosition = userAgentNamesArray.getPosition(defaultUserAgentName);
3834
3835                     // Set the user agent.
3836                     switch (userAgentArrayPosition) {
3837                         case UNRECOGNIZED_USER_AGENT:  // The default user agent name is not on the canonical list.
3838                             // This is probably because it was set in an older version of Privacy Browser before the switch to persistent user agent names.
3839                             nestedScrollWebView.getSettings().setUserAgentString(defaultUserAgentName);
3840                             break;
3841
3842                         case SETTINGS_WEBVIEW_DEFAULT_USER_AGENT:
3843                             // Set the user agent to `""`, which uses the default value.
3844                             nestedScrollWebView.getSettings().setUserAgentString("");
3845                             break;
3846
3847                         case SETTINGS_CUSTOM_USER_AGENT:
3848                             // Set the default custom user agent.
3849                             nestedScrollWebView.getSettings().setUserAgentString(sharedPreferences.getString("custom_user_agent", getString(R.string.custom_user_agent_default_value)));
3850                             break;
3851
3852                         default:
3853                             // Get the user agent string from the user agent data array
3854                             nestedScrollWebView.getSettings().setUserAgentString(userAgentDataArray[userAgentArrayPosition]);
3855                     }
3856                 }
3857
3858                 // Set the loading of webpage images.
3859                 nestedScrollWebView.getSettings().setLoadsImagesAutomatically(displayWebpageImages);
3860
3861                 // Set a transparent background on URL edit text.  The deprecated `getResources().getDrawable()` must be used until the minimum API >= 21.
3862                 urlRelativeLayout.setBackground(getResources().getDrawable(R.color.transparent));
3863             }
3864
3865             // Close the domains database helper.
3866             domainsDatabaseHelper.close();
3867
3868             // Update the privacy icons.
3869             updatePrivacyIcons(true);
3870         }
3871
3872         // Reload the website if returning from the Domains activity.
3873         if (reloadWebsite) {
3874             nestedScrollWebView.reload();
3875         }
3876
3877         // Return the user agent changed status.
3878         return !nestedScrollWebView.getSettings().getUserAgentString().equals(initialUserAgent);
3879     }
3880
3881     private void applyProxyThroughOrbot(boolean reloadWebsite) {
3882         // Get a handle for the shared preferences.
3883         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
3884
3885         // Get the search and theme preferences.
3886         String torSearchString = sharedPreferences.getString("tor_search", getString(R.string.tor_search_default_value));
3887         String torSearchCustomUrlString = sharedPreferences.getString("tor_search_custom_url", getString(R.string.tor_search_custom_url_default_value));
3888         String searchString = sharedPreferences.getString("search", getString(R.string.search_default_value));
3889         String searchCustomUrlString = sharedPreferences.getString("search_custom_url", getString(R.string.search_custom_url_default_value));
3890         boolean darkTheme = sharedPreferences.getBoolean("dark_theme", false);
3891
3892         // Get a handle for the app bar layout.
3893         AppBarLayout appBarLayout = findViewById(R.id.appbar_layout);
3894
3895         // Set the homepage, search, and proxy options.
3896         if (proxyThroughOrbot) {  // Set the Tor options.
3897             // Set the search URL.
3898             if (torSearchString.equals("Custom URL")) {  // Get the custom URL string.
3899                 searchURL = torSearchCustomUrlString;
3900             } else {  // Use the string from the pre-built list.
3901                 searchURL = torSearchString;
3902             }
3903
3904             // Set the proxy.  `this` refers to the current activity where an `AlertDialog` might be displayed.
3905             OrbotProxyHelper.setProxy(getApplicationContext(), this, "localhost", "8118");
3906
3907             // Set the app bar background to indicate proxying through Orbot is enabled.
3908             if (darkTheme) {
3909                 appBarLayout.setBackgroundResource(R.color.dark_blue_30);
3910             } else {
3911                 appBarLayout.setBackgroundResource(R.color.blue_50);
3912             }
3913
3914             // Check to see if Orbot is ready.
3915             if (!orbotStatus.equals("ON")) {  // Orbot is not ready.
3916                 // Set `waitingForOrbot`.
3917                 waitingForOrbot = true;
3918
3919                 // Disable the wide view port so that the waiting for Orbot text is displayed correctly.
3920                 currentWebView.getSettings().setUseWideViewPort(false);
3921
3922                 // Load a waiting page.  `null` specifies no encoding, which defaults to ASCII.
3923                 currentWebView.loadData("<html><body><br/><center><h1>" + getString(R.string.waiting_for_orbot) + "</h1></center></body></html>", "text/html", null);
3924             } else if (reloadWebsite) {  // Orbot is ready and the website should be reloaded.
3925                 // Reload the website.
3926                 currentWebView.reload();
3927             }
3928         } else {  // Set the non-Tor options.
3929             // Set the search URL.
3930             if (searchString.equals("Custom URL")) {  // Get the custom URL string.
3931                 searchURL = searchCustomUrlString;
3932             } else {  // Use the string from the pre-built list.
3933                 searchURL = searchString;
3934             }
3935
3936             // Reset the proxy to default.  The host is `""` and the port is `"0"`.
3937             OrbotProxyHelper.setProxy(getApplicationContext(), this, "", "0");
3938
3939             // Set the default app bar layout background.
3940             if (darkTheme) {
3941                 appBarLayout.setBackgroundResource(R.color.gray_900);
3942             } else {
3943                 appBarLayout.setBackgroundResource(R.color.gray_100);
3944             }
3945
3946             // Reset `waitingForOrbot.
3947             waitingForOrbot = false;
3948
3949             // Reload the WebViews if requested.
3950             if (reloadWebsite) {
3951                 // Reload the WebViews.
3952                 for (int i = 0; i < webViewPagerAdapter.getCount(); i++) {
3953                     // Get the WebView tab fragment.
3954                     WebViewTabFragment webViewTabFragment = webViewPagerAdapter.getPageFragment(i);
3955
3956                     // Get the fragment view.
3957                     View fragmentView = webViewTabFragment.getView();
3958
3959                     // Only reload the WebViews if they exist.
3960                     if (fragmentView != null) {
3961                         // Get the nested scroll WebView from the tab fragment.
3962                         NestedScrollWebView nestedScrollWebView = fragmentView.findViewById(R.id.nestedscroll_webview);
3963
3964                         // Reload the WebView.
3965                         nestedScrollWebView.reload();
3966                     }
3967                 }
3968             }
3969         }
3970     }
3971
3972     private void updatePrivacyIcons(boolean runInvalidateOptionsMenu) {
3973         // Only update the privacy icons if the options menu and the current WebView have already been populated.
3974         if ((optionsMenu != null) && (currentWebView != null)) {
3975             // Get a handle for the shared preferences.
3976             SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
3977
3978             // Get the theme and screenshot preferences.
3979             boolean darkTheme = sharedPreferences.getBoolean("dark_theme", false);
3980
3981             // Get handles for the menu items.
3982             MenuItem privacyMenuItem = optionsMenu.findItem(R.id.toggle_javascript);
3983             MenuItem firstPartyCookiesMenuItem = optionsMenu.findItem(R.id.toggle_first_party_cookies);
3984             MenuItem domStorageMenuItem = optionsMenu.findItem(R.id.toggle_dom_storage);
3985             MenuItem refreshMenuItem = optionsMenu.findItem(R.id.refresh);
3986
3987             // Update the privacy icon.
3988             if (currentWebView.getSettings().getJavaScriptEnabled()) {  // JavaScript is enabled.
3989                 privacyMenuItem.setIcon(R.drawable.javascript_enabled);
3990             } else if (currentWebView.getAcceptFirstPartyCookies()) {  // JavaScript is disabled but cookies are enabled.
3991                 privacyMenuItem.setIcon(R.drawable.warning);
3992             } else {  // All the dangerous features are disabled.
3993                 privacyMenuItem.setIcon(R.drawable.privacy_mode);
3994             }
3995
3996             // Update the first-party cookies icon.
3997             if (currentWebView.getAcceptFirstPartyCookies()) {  // First-party cookies are enabled.
3998                 firstPartyCookiesMenuItem.setIcon(R.drawable.cookies_enabled);
3999             } else {  // First-party cookies are disabled.
4000                 if (darkTheme) {
4001                     firstPartyCookiesMenuItem.setIcon(R.drawable.cookies_disabled_dark);
4002                 } else {
4003                     firstPartyCookiesMenuItem.setIcon(R.drawable.cookies_disabled_light);
4004                 }
4005             }
4006
4007             // Update the DOM storage icon.
4008             if (currentWebView.getSettings().getJavaScriptEnabled() && currentWebView.getSettings().getDomStorageEnabled()) {  // Both JavaScript and DOM storage are enabled.
4009                 domStorageMenuItem.setIcon(R.drawable.dom_storage_enabled);
4010             } else if (currentWebView.getSettings().getJavaScriptEnabled()) {  // JavaScript is enabled but DOM storage is disabled.
4011                 if (darkTheme) {
4012                     domStorageMenuItem.setIcon(R.drawable.dom_storage_disabled_dark);
4013                 } else {
4014                     domStorageMenuItem.setIcon(R.drawable.dom_storage_disabled_light);
4015                 }
4016             } else {  // JavaScript is disabled, so DOM storage is ghosted.
4017                 if (darkTheme) {
4018                     domStorageMenuItem.setIcon(R.drawable.dom_storage_ghosted_dark);
4019                 } else {
4020                     domStorageMenuItem.setIcon(R.drawable.dom_storage_ghosted_light);
4021                 }
4022             }
4023
4024             // Update the refresh icon.
4025             if (darkTheme) {
4026                 refreshMenuItem.setIcon(R.drawable.refresh_enabled_dark);
4027             } else {
4028                 refreshMenuItem.setIcon(R.drawable.refresh_enabled_light);
4029             }
4030
4031             // `invalidateOptionsMenu` calls `onPrepareOptionsMenu()` and redraws the icons in the `AppBar`.
4032             if (runInvalidateOptionsMenu) {
4033                 invalidateOptionsMenu();
4034             }
4035         }
4036     }
4037
4038     private void openUrlWithExternalApp(String url) {
4039         // Create a download intent.  Not specifying the action type will display the maximum number of options.
4040         Intent downloadIntent = new Intent();
4041
4042         // Set the URI and the MIME type.  Specifying `text/html` displays a good number of options.
4043         downloadIntent.setDataAndType(Uri.parse(url), "text/html");
4044
4045         // Flag the intent to open in a new task.
4046         downloadIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
4047
4048         // Show the chooser.
4049         startActivity(Intent.createChooser(downloadIntent, getString(R.string.open_with)));
4050     }
4051
4052     private void highlightUrlText() {
4053         // Get a handle for the URL edit text.
4054         EditText urlEditText = findViewById(R.id.url_edittext);
4055
4056         // Only highlight the URL text if the box is not currently selected.
4057         if (!urlEditText.hasFocus()) {
4058             // Get the URL string.
4059             String urlString = urlEditText.getText().toString();
4060
4061             // Highlight the URL according to the protocol.
4062             if (urlString.startsWith("file://")) {  // This is a file URL.
4063                 // De-emphasize only the protocol.
4064                 urlEditText.getText().setSpan(initialGrayColorSpan, 0, 7, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
4065             } else if (urlString.startsWith("content://")) {
4066                 // De-emphasize only the protocol.
4067                 urlEditText.getText().setSpan(initialGrayColorSpan, 0, 10, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
4068             } else {  // This is a web URL.
4069                 // Get the index of the `/` immediately after the domain name.
4070                 int endOfDomainName = urlString.indexOf("/", (urlString.indexOf("//") + 2));
4071
4072                 // Create a base URL string.
4073                 String baseUrl;
4074
4075                 // Get the base URL.
4076                 if (endOfDomainName > 0) {  // There is at least one character after the base URL.
4077                     // Get the base URL.
4078                     baseUrl = urlString.substring(0, endOfDomainName);
4079                 } else {  // There are no characters after the base URL.
4080                     // Set the base URL to be the entire URL string.
4081                     baseUrl = urlString;
4082                 }
4083
4084                 // Get the index of the last `.` in the domain.
4085                 int lastDotIndex = baseUrl.lastIndexOf(".");
4086
4087                 // Get the index of the penultimate `.` in the domain.
4088                 int penultimateDotIndex = baseUrl.lastIndexOf(".", lastDotIndex - 1);
4089
4090                 // Markup the beginning of the URL.
4091                 if (urlString.startsWith("http://")) {  // Highlight the protocol of connections that are not encrypted.
4092                     urlEditText.getText().setSpan(redColorSpan, 0, 7, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
4093
4094                     // De-emphasize subdomains.
4095                     if (penultimateDotIndex > 0) {  // There is more than one subdomain in the domain name.
4096                         urlEditText.getText().setSpan(initialGrayColorSpan, 7, penultimateDotIndex + 1, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
4097                     }
4098                 } else if (urlString.startsWith("https://")) {  // De-emphasize the protocol of connections that are encrypted.
4099                     if (penultimateDotIndex > 0) {  // There is more than one subdomain in the domain name.
4100                         // De-emphasize the protocol and the additional subdomains.
4101                         urlEditText.getText().setSpan(initialGrayColorSpan, 0, penultimateDotIndex + 1, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
4102                     } else {  // There is only one subdomain in the domain name.
4103                         // De-emphasize only the protocol.
4104                         urlEditText.getText().setSpan(initialGrayColorSpan, 0, 8, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
4105                     }
4106                 }
4107
4108                 // De-emphasize the text after the domain name.
4109                 if (endOfDomainName > 0) {
4110                     urlEditText.getText().setSpan(finalGrayColorSpan, endOfDomainName, urlString.length(), Spanned.SPAN_INCLUSIVE_INCLUSIVE);
4111                 }
4112             }
4113         }
4114     }
4115
4116     private void loadBookmarksFolder() {
4117         // Update the bookmarks cursor with the contents of the bookmarks database for the current folder.
4118         bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrder(currentBookmarksFolder);
4119
4120         // Populate the bookmarks cursor adapter.  `this` specifies the `Context`.  `false` disables `autoRequery`.
4121         bookmarksCursorAdapter = new CursorAdapter(this, bookmarksCursor, false) {
4122             @Override
4123             public View newView(Context context, Cursor cursor, ViewGroup parent) {
4124                 // Inflate the individual item layout.  `false` does not attach it to the root.
4125                 return getLayoutInflater().inflate(R.layout.bookmarks_drawer_item_linearlayout, parent, false);
4126             }
4127
4128             @Override
4129             public void bindView(View view, Context context, Cursor cursor) {
4130                 // Get handles for the views.
4131                 ImageView bookmarkFavoriteIcon = view.findViewById(R.id.bookmark_favorite_icon);
4132                 TextView bookmarkNameTextView = view.findViewById(R.id.bookmark_name);
4133
4134                 // Get the favorite icon byte array from the cursor.
4135                 byte[] favoriteIconByteArray = cursor.getBlob(cursor.getColumnIndex(BookmarksDatabaseHelper.FAVORITE_ICON));
4136
4137                 // Convert the byte array to a `Bitmap` beginning at the first byte and ending at the last.
4138                 Bitmap favoriteIconBitmap = BitmapFactory.decodeByteArray(favoriteIconByteArray, 0, favoriteIconByteArray.length);
4139
4140                 // Display the bitmap in `bookmarkFavoriteIcon`.
4141                 bookmarkFavoriteIcon.setImageBitmap(favoriteIconBitmap);
4142
4143                 // Get the bookmark name from the cursor and display it in `bookmarkNameTextView`.
4144                 String bookmarkNameString = cursor.getString(cursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME));
4145                 bookmarkNameTextView.setText(bookmarkNameString);
4146
4147                 // Make the font bold for folders.
4148                 if (cursor.getInt(cursor.getColumnIndex(BookmarksDatabaseHelper.IS_FOLDER)) == 1) {
4149                     bookmarkNameTextView.setTypeface(Typeface.DEFAULT_BOLD);
4150                 } else {  // Reset the font to default for normal bookmarks.
4151                     bookmarkNameTextView.setTypeface(Typeface.DEFAULT);
4152                 }
4153             }
4154         };
4155
4156         // Get a handle for the bookmarks list view.
4157         ListView bookmarksListView = findViewById(R.id.bookmarks_drawer_listview);
4158
4159         // Populate the list view with the adapter.
4160         bookmarksListView.setAdapter(bookmarksCursorAdapter);
4161
4162         // Get a handle for the bookmarks title text view.
4163         TextView bookmarksTitleTextView = findViewById(R.id.bookmarks_title_textview);
4164
4165         // Set the bookmarks drawer title.
4166         if (currentBookmarksFolder.isEmpty()) {
4167             bookmarksTitleTextView.setText(R.string.bookmarks);
4168         } else {
4169             bookmarksTitleTextView.setText(currentBookmarksFolder);
4170         }
4171     }
4172
4173     private void openWithApp(String url) {
4174         // Create the open with intent with `ACTION_VIEW`.
4175         Intent openWithAppIntent = new Intent(Intent.ACTION_VIEW);
4176
4177         // Set the URI but not the MIME type.  This should open all available apps.
4178         openWithAppIntent.setData(Uri.parse(url));
4179
4180         // Flag the intent to open in a new task.
4181         openWithAppIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
4182
4183         // Show the chooser.
4184         startActivity(openWithAppIntent);
4185     }
4186
4187     private void openWithBrowser(String url) {
4188         // Create the open with intent with `ACTION_VIEW`.
4189         Intent openWithBrowserIntent = new Intent(Intent.ACTION_VIEW);
4190
4191         // Set the URI and the MIME type.  `"text/html"` should load browser options.
4192         openWithBrowserIntent.setDataAndType(Uri.parse(url), "text/html");
4193
4194         // Flag the intent to open in a new task.
4195         openWithBrowserIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
4196
4197         // Show the chooser.
4198         startActivity(openWithBrowserIntent);
4199     }
4200
4201     public void addTab(View view) {
4202         // Get a handle for the tab layout and the view pager.
4203         TabLayout tabLayout = findViewById(R.id.tablayout);
4204         ViewPager webViewPager = findViewById(R.id.webviewpager);
4205
4206         // Get the new page number.  The page numbers are 0 indexed, so the new page number will match the current count.
4207         int newTabNumber = tabLayout.getTabCount();
4208
4209         // Add a new tab.
4210         tabLayout.addTab(tabLayout.newTab());
4211
4212         // Get the new tab.
4213         TabLayout.Tab newTab = tabLayout.getTabAt(newTabNumber);
4214
4215         // Remove the lint warning below that the current tab might be null.
4216         assert newTab != null;
4217
4218         // Set a custom view on the new tab.
4219         newTab.setCustomView(R.layout.tab_custom_view);
4220
4221         // Add the new WebView page.
4222         webViewPagerAdapter.addPage(newTabNumber, webViewPager);
4223     }
4224
4225     private void setCurrentWebView(int pageNumber) {
4226         // Get a handle for the shared preferences.
4227         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
4228
4229         // Get the theme preference.
4230         boolean darkTheme = sharedPreferences.getBoolean("dark_theme", false);
4231
4232         // Get handles for the URL views.
4233         RelativeLayout urlRelativeLayout = findViewById(R.id.url_relativelayout);
4234         EditText urlEditText = findViewById(R.id.url_edittext);
4235         SwipeRefreshLayout swipeRefreshLayout = findViewById(R.id.swiperefreshlayout);
4236
4237         //Stop the swipe to refresh indicator if it is running
4238         swipeRefreshLayout.setRefreshing(false);
4239
4240         // Get the WebView tab fragment.
4241         WebViewTabFragment webViewTabFragment = webViewPagerAdapter.getPageFragment(pageNumber);
4242
4243         // Get the fragment view.
4244         View fragmentView = webViewTabFragment.getView();
4245
4246         // Set the current WebView if the fragment view is not null.
4247         if (fragmentView != null) {
4248             // Store the current WebView.
4249             currentWebView = fragmentView.findViewById(R.id.nestedscroll_webview);
4250
4251             // Update the status of swipe to refresh.
4252             if (currentWebView.getSwipeToRefresh()) {  // Swipe to refresh is enabled.
4253                 if (Build.VERSION.SDK_INT >= 23) {  // For API >= 23, swipe refresh layout is continuously updated with an on scroll change listener and only enabled if the WebView is scrolled to the top.
4254                     // Enable the swipe refresh layout if the WebView is scrolled all the way to the top.
4255                     swipeRefreshLayout.setEnabled(currentWebView.getY() == 0);
4256                 } else {
4257                     // Enable the swipe refresh layout.
4258                     swipeRefreshLayout.setEnabled(true);
4259                 }
4260             } else {  // Swipe to refresh is disabled.
4261                 // Disable the swipe refresh layout.
4262                 swipeRefreshLayout.setEnabled(false);
4263             }
4264
4265             // Get a handle for the cookie manager.
4266             CookieManager cookieManager = CookieManager.getInstance();
4267
4268             // Set the first-party cookie status.
4269             cookieManager.setAcceptCookie(currentWebView.getAcceptFirstPartyCookies());
4270
4271             // Update the privacy icons.  `true` redraws the icons in the app bar.
4272             updatePrivacyIcons(true);
4273
4274             // Get a handle for the input method manager.
4275             InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
4276
4277             // Remove the lint warning below that the input method manager might be null.
4278             assert inputMethodManager != null;
4279
4280             // Get the current URL.
4281             String url = currentWebView.getUrl();
4282
4283             // Update the URL edit text if not loading a new intent.  Otherwise, this will be handled by `onPageStarted()` (if called) and `onPageFinished()`.
4284             if (!loadingNewIntent) {  // A new intent is not being loaded.
4285                 if ((url == null) || url.equals("about:blank")) {  // The WebView is blank.
4286                     // Display the hint in the URL edit text.
4287                     urlEditText.setText("");
4288
4289                     // Request focus for the URL text box.
4290                     urlEditText.requestFocus();
4291
4292                     // Display the keyboard.
4293                     inputMethodManager.showSoftInput(urlEditText, 0);
4294                 } else {  // The WebView has a loaded URL.
4295                     // Clear the focus from the URL text box.
4296                     urlEditText.clearFocus();
4297
4298                     // Hide the soft keyboard.
4299                     inputMethodManager.hideSoftInputFromWindow(currentWebView.getWindowToken(), 0);
4300
4301                     // Display the current URL in the URL text box.
4302                     urlEditText.setText(url);
4303
4304                     // Highlight the URL text.
4305                     highlightUrlText();
4306                 }
4307             } else {  // A new intent is being loaded.
4308                 // Reset the loading new intent tracker.
4309                 loadingNewIntent = false;
4310             }
4311
4312             // Set the background to indicate the domain settings status.
4313             if (currentWebView.getDomainSettingsApplied()) {
4314                 // Set a green background on the URL relative layout to indicate that custom domain settings are being used. The deprecated `.getDrawable()` must be used until the minimum API >= 21.
4315                 if (darkTheme) {
4316                     urlRelativeLayout.setBackground(getResources().getDrawable(R.drawable.url_bar_background_dark_blue));
4317                 } else {
4318                     urlRelativeLayout.setBackground(getResources().getDrawable(R.drawable.url_bar_background_light_green));
4319                 }
4320             } else {
4321                 urlRelativeLayout.setBackground(getResources().getDrawable(R.color.transparent));
4322             }
4323         }
4324     }
4325
4326     @Override
4327     public void initializeWebView(NestedScrollWebView nestedScrollWebView, int pageNumber, ProgressBar progressBar) {
4328         // Get handles for the activity views.
4329         FrameLayout rootFrameLayout = findViewById(R.id.root_framelayout);
4330         DrawerLayout drawerLayout = findViewById(R.id.drawerlayout);
4331         RelativeLayout mainContentRelativeLayout = findViewById(R.id.main_content_relativelayout);
4332         ActionBar actionBar = getSupportActionBar();
4333         LinearLayout tabsLinearLayout = findViewById(R.id.tabs_linearlayout);
4334         EditText urlEditText = findViewById(R.id.url_edittext);
4335         TabLayout tabLayout = findViewById(R.id.tablayout);
4336         SwipeRefreshLayout swipeRefreshLayout = findViewById(R.id.swiperefreshlayout);
4337
4338         // Remove the incorrect lint warning below that the action bar might be null.
4339         assert actionBar != null;
4340
4341         // Get a handle for the activity
4342         Activity activity = this;
4343
4344         // Get a handle for the input method manager.
4345         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
4346
4347         // Instantiate the blocklist helper.
4348         BlockListHelper blockListHelper = new BlockListHelper();
4349
4350         // Remove the lint warning below that the input method manager might be null.
4351         assert inputMethodManager != null;
4352
4353         // Get a handle for the shared preferences.
4354         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
4355
4356         // Get the relevant preferences.
4357         boolean downloadWithExternalApp = sharedPreferences.getBoolean("download_with_external_app", false);
4358
4359         // Initialize the favorite icon.
4360         nestedScrollWebView.initializeFavoriteIcon();
4361
4362         // Set the app bar scrolling.
4363         nestedScrollWebView.setNestedScrollingEnabled(sharedPreferences.getBoolean("scroll_app_bar", true));
4364
4365         // Allow pinch to zoom.
4366         nestedScrollWebView.getSettings().setBuiltInZoomControls(true);
4367
4368         // Hide zoom controls.
4369         nestedScrollWebView.getSettings().setDisplayZoomControls(false);
4370
4371         // Don't allow mixed content (HTTP and HTTPS) on the same website.
4372         if (Build.VERSION.SDK_INT >= 21) {
4373             nestedScrollWebView.getSettings().setMixedContentMode(WebSettings.MIXED_CONTENT_NEVER_ALLOW);
4374         }
4375
4376         // Set the WebView to use a wide viewport.  Otherwise, some web pages will be scrunched and some content will render outside the screen.
4377         nestedScrollWebView.getSettings().setUseWideViewPort(true);
4378
4379         // Set the WebView to load in overview mode (zoomed out to the maximum width).
4380         nestedScrollWebView.getSettings().setLoadWithOverviewMode(true);
4381
4382         // Explicitly disable geolocation.
4383         nestedScrollWebView.getSettings().setGeolocationEnabled(false);
4384
4385         // Create a double-tap gesture detector to toggle full-screen mode.
4386         GestureDetector doubleTapGestureDetector = new GestureDetector(getApplicationContext(), new GestureDetector.SimpleOnGestureListener() {
4387             // Override `onDoubleTap()`.  All other events are handled using the default settings.
4388             @Override
4389             public boolean onDoubleTap(MotionEvent event) {
4390                 if (fullScreenBrowsingModeEnabled) {  // Only process the double-tap if full screen browsing mode is enabled.
4391                     // Toggle the full screen browsing mode tracker.
4392                     inFullScreenBrowsingMode = !inFullScreenBrowsingMode;
4393
4394                     // Toggle the full screen browsing mode.
4395                     if (inFullScreenBrowsingMode) {  // Switch to full screen mode.
4396                         // Store the swipe refresh layout top padding.
4397                         swipeRefreshLayoutPaddingTop = swipeRefreshLayout.getPaddingTop();
4398
4399                         // Hide the app bar if specified.
4400                         if (hideAppBar) {
4401                             // Close the find on page bar if it is visible.
4402                             closeFindOnPage(null);
4403
4404                             // Hide the tab linear layout.
4405                             tabsLinearLayout.setVisibility(View.GONE);
4406
4407                             // Hide the action bar.
4408                             actionBar.hide();
4409
4410                             // Check to see if app bar scrolling is disabled.
4411                             if (!scrollAppBar) {
4412                                 // Remove the padding from the top of the swipe refresh layout.
4413                                 swipeRefreshLayout.setPadding(0, 0, 0, 0);
4414                             }
4415                         }
4416
4417                         // Hide the banner ad in the free flavor.
4418                         if (BuildConfig.FLAVOR.contentEquals("free")) {
4419                             AdHelper.hideAd(findViewById(R.id.adview));
4420                         }
4421
4422                         // Remove the translucent status flag.  This is necessary so the root frame layout can fill the entire screen.
4423                         getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
4424
4425                         /* Hide the system bars.
4426                          * SYSTEM_UI_FLAG_FULLSCREEN hides the status bar at the top of the screen.
4427                          * SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN makes the root frame layout fill the area that is normally reserved for the status bar.
4428                          * SYSTEM_UI_FLAG_HIDE_NAVIGATION hides the navigation bar on the bottom or right of the screen.
4429                          * SYSTEM_UI_FLAG_IMMERSIVE_STICKY makes the status and navigation bars translucent and automatically re-hides them after they are shown.
4430                          */
4431                         rootFrameLayout.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
4432                                 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
4433                     } else {  // Switch to normal viewing mode.
4434                         // Show the tab linear layout.
4435                         tabsLinearLayout.setVisibility(View.VISIBLE);
4436
4437                         // Show the action bar.
4438                         actionBar.show();
4439
4440                         // Check to see if app bar scrolling is disabled.
4441                         if (!scrollAppBar) {
4442                             // Add the padding from the top of the swipe refresh layout.
4443                             swipeRefreshLayout.setPadding(0, swipeRefreshLayoutPaddingTop, 0, 0);
4444                         }
4445
4446                         // Show the banner ad in the free flavor.
4447                         if (BuildConfig.FLAVOR.contentEquals("free")) {
4448                             // Reload the ad.
4449                             AdHelper.loadAd(findViewById(R.id.adview), getApplicationContext(), getString(R.string.ad_unit_id));
4450                         }
4451
4452                         // Remove the `SYSTEM_UI` flags from the root frame layout.
4453                         rootFrameLayout.setSystemUiVisibility(0);
4454
4455                         // Add the translucent status flag.
4456                         getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
4457                     }
4458
4459                     // Consume the double-tap.
4460                     return true;
4461                 } else { // Do not consume the double-tap because full screen browsing mode is disabled.
4462                     return false;
4463                 }
4464             }
4465         });
4466
4467         // Pass all touch events on the WebView through the double-tap gesture detector.
4468         nestedScrollWebView.setOnTouchListener((View view, MotionEvent event) -> {
4469             // Call `performClick()` on the view, which is required for accessibility.
4470             view.performClick();
4471
4472             // Send the event to the gesture detector.
4473             return doubleTapGestureDetector.onTouchEvent(event);
4474         });
4475
4476         // Register the WebView for a context menu.  This is used to see link targets and download images.
4477         registerForContextMenu(nestedScrollWebView);
4478
4479         // Allow the downloading of files.
4480         nestedScrollWebView.setDownloadListener((String url, String userAgent, String contentDisposition, String mimetype, long contentLength) -> {
4481             // Check if the download should be processed by an external app.
4482             if (downloadWithExternalApp) {  // Download with an external app.
4483                 // Create a download intent.  Not specifying the action type will display the maximum number of options.
4484                 Intent downloadIntent = new Intent();
4485
4486                 // Set the URI and the MIME type.  Specifying `text/html` displays a good number of options.
4487                 downloadIntent.setDataAndType(Uri.parse(url), "text/html");
4488
4489                 // Flag the intent to open in a new task.
4490                 downloadIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
4491
4492                 // Show the chooser.
4493                 startActivity(Intent.createChooser(downloadIntent, getString(R.string.open_with)));
4494             } else {  // Download with Android's download manager.
4495                 // Check to see if the WRITE_EXTERNAL_STORAGE permission has already been granted.
4496                 if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_DENIED) {  // The storage permission has not been granted.
4497                     // The WRITE_EXTERNAL_STORAGE permission needs to be requested.
4498
4499                     // Store the variables for future use by `onRequestPermissionsResult()`.
4500                     downloadUrl = url;
4501                     downloadContentDisposition = contentDisposition;
4502                     downloadContentLength = contentLength;
4503
4504                     // Show a dialog if the user has previously denied the permission.
4505                     if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)) {  // Show a dialog explaining the request first.
4506                         // Instantiate the download location permission alert dialog and set the download type to DOWNLOAD_FILE.
4507                         DialogFragment downloadLocationPermissionDialogFragment = DownloadLocationPermissionDialog.downloadType(DownloadLocationPermissionDialog.DOWNLOAD_FILE);
4508
4509                         // Show the download location permission alert dialog.  The permission will be requested when the the dialog is closed.
4510                         downloadLocationPermissionDialogFragment.show(getSupportFragmentManager(), getString(R.string.download_location));
4511                     } else {  // Show the permission request directly.
4512                         // Request the permission.  The download dialog will be launched by `onRequestPermissionResult()`.
4513                         ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, DOWNLOAD_FILE_REQUEST_CODE);
4514                     }
4515                 } else {  // The storage permission has already been granted.
4516                     // Get a handle for the download file alert dialog.
4517                     DialogFragment downloadFileDialogFragment = DownloadFileDialog.fromUrl(url, contentDisposition, contentLength);
4518
4519                     // Show the download file alert dialog.
4520                     downloadFileDialogFragment.show(getSupportFragmentManager(), getString(R.string.download));
4521                 }
4522             }
4523         });
4524
4525         // Update the find on page count.
4526         nestedScrollWebView.setFindListener(new WebView.FindListener() {
4527             // Get a handle for `findOnPageCountTextView`.
4528             final TextView findOnPageCountTextView = findViewById(R.id.find_on_page_count_textview);
4529
4530             @Override
4531             public void onFindResultReceived(int activeMatchOrdinal, int numberOfMatches, boolean isDoneCounting) {
4532                 if ((isDoneCounting) && (numberOfMatches == 0)) {  // There are no matches.
4533                     // Set `findOnPageCountTextView` to `0/0`.
4534                     findOnPageCountTextView.setText(R.string.zero_of_zero);
4535                 } else if (isDoneCounting) {  // There are matches.
4536                     // `activeMatchOrdinal` is zero-based.
4537                     int activeMatch = activeMatchOrdinal + 1;
4538
4539                     // Build the match string.
4540                     String matchString = activeMatch + "/" + numberOfMatches;
4541
4542                     // Set `findOnPageCountTextView`.
4543                     findOnPageCountTextView.setText(matchString);
4544                 }
4545             }
4546         });
4547
4548         // Update the status of swipe to refresh based on the scroll position of the nested scroll WebView.
4549         // Once the minimum API >= 23 this can be replaced with `nestedScrollWebView.setOnScrollChangeListener()`.
4550         nestedScrollWebView.getViewTreeObserver().addOnScrollChangedListener(() -> {
4551             if (nestedScrollWebView.getSwipeToRefresh()) {
4552                 // Only enable swipe to refresh if the WebView is scrolled to the top.
4553                 swipeRefreshLayout.setEnabled(nestedScrollWebView.getScrollY() == 0);
4554             }
4555         });
4556
4557         // Set the web chrome client.
4558         nestedScrollWebView.setWebChromeClient(new WebChromeClient() {
4559             // Update the progress bar when a page is loading.
4560             @Override
4561             public void onProgressChanged(WebView view, int progress) {
4562                 // Inject the night mode CSS if night mode is enabled.
4563                 if (nestedScrollWebView.getNightMode()) {  // Night mode is enabled.
4564                     // `background-color: #212121` sets the background to be dark gray.  `color: #BDBDBD` sets the text color to be light gray.  `box-shadow: none` removes a lower underline on links
4565                     // used by WordPress.  `text-decoration: none` removes all text underlines.  `text-shadow: none` removes text shadows, which usually have a hard coded color.
4566                     // `border: none` removes all borders, which can also be used to underline text.  `a {color: #1565C0}` sets links to be a dark blue.
4567                     // `::selection {background: #0D47A1}' sets the text selection highlight color to be a dark blue. `!important` takes precedent over any existing sub-settings.
4568                     nestedScrollWebView.evaluateJavascript("(function() {var parent = document.getElementsByTagName('head').item(0); var style = document.createElement('style'); style.type = 'text/css'; " +
4569                             "style.innerHTML = '* {background-color: #212121 !important; color: #BDBDBD !important; box-shadow: none !important; text-decoration: none !important;" +
4570                             "text-shadow: none !important; border: none !important;} a {color: #1565C0 !important;} ::selection {background: #0D47A1 !important;}'; parent.appendChild(style)})()", value -> {
4571                         // Initialize a handler to display `mainWebView`.
4572                         Handler displayWebViewHandler = new Handler();
4573
4574                         // Setup a runnable to display `mainWebView` after a delay to allow the CSS to be applied.
4575                         Runnable displayWebViewRunnable = () -> {
4576                             // Only display `mainWebView` if the progress bar is gone.  This prevents the display of the `WebView` while it is still loading.
4577                             if (progressBar.getVisibility() == View.GONE) {
4578                                 nestedScrollWebView.setVisibility(View.VISIBLE);
4579                             }
4580                         };
4581
4582                         // Display the WebView after 500 milliseconds.
4583                         displayWebViewHandler.postDelayed(displayWebViewRunnable, 500);
4584                     });
4585                 } else {  // Night mode is disabled.
4586                     // Display the nested scroll WebView if night mode is disabled.
4587                     // Because of a race condition between `applyDomainSettings` and `onPageStarted`,
4588                     // when night mode is set by domain settings the WebView may be hidden even if night mode is not currently enabled.
4589                     nestedScrollWebView.setVisibility(View.VISIBLE);
4590                 }
4591
4592                 // Update the progress bar.
4593                 progressBar.setProgress(progress);
4594
4595                 // Set the visibility of the progress bar.
4596                 if (progress < 100) {
4597                     // Show the progress bar.
4598                     progressBar.setVisibility(View.VISIBLE);
4599                 } else {
4600                     // Hide the progress bar.
4601                     progressBar.setVisibility(View.GONE);
4602
4603                     //Stop the swipe to refresh indicator if it is running
4604                     swipeRefreshLayout.setRefreshing(false);
4605                 }
4606             }
4607
4608             // Set the favorite icon when it changes.
4609             @Override
4610             public void onReceivedIcon(WebView view, Bitmap icon) {
4611                 // Only update the favorite icon if the website has finished loading.
4612                 if (progressBar.getVisibility() == View.GONE) {
4613                     // Store the new favorite icon.
4614                     nestedScrollWebView.setFavoriteOrDefaultIcon(icon);
4615
4616                     // Get the current page position.
4617                     int currentPosition = webViewPagerAdapter.getPositionForId(nestedScrollWebView.getWebViewFragmentId());
4618
4619                     // Get the current tab.
4620                     TabLayout.Tab tab = tabLayout.getTabAt(currentPosition);
4621
4622                     // Check to see if the tab has been populated.
4623                     if (tab != null) {
4624                         // Get the custom view from the tab.
4625                         View tabView = tab.getCustomView();
4626
4627                         // Check to see if the custom tab view has been populated.
4628                         if (tabView != null) {
4629                             // Get the favorite icon image view from the tab.
4630                             ImageView tabFavoriteIconImageView = tabView.findViewById(R.id.favorite_icon_imageview);
4631
4632                             // Display the favorite icon in the tab.
4633                             tabFavoriteIconImageView.setImageBitmap(Bitmap.createScaledBitmap(icon, 64, 64, true));
4634                         }
4635                     }
4636                 }
4637             }
4638
4639             // Save a copy of the title when it changes.
4640             @Override
4641             public void onReceivedTitle(WebView view, String title) {
4642                 // Get the current page position.
4643                 int currentPosition = webViewPagerAdapter.getPositionForId(nestedScrollWebView.getWebViewFragmentId());
4644
4645                 // Get the current tab.
4646                 TabLayout.Tab tab = tabLayout.getTabAt(currentPosition);
4647
4648                 // Only populate the title text view if the tab has been fully created.
4649                 if (tab != null) {
4650                     // Get the custom view from the tab.
4651                     View tabView = tab.getCustomView();
4652
4653                     // Remove the incorrect warning below that the current tab view might be null.
4654                     assert tabView != null;
4655
4656                     // Get the title text view from the tab.
4657                     TextView tabTitleTextView = tabView.findViewById(R.id.title_textview);
4658
4659                     // Set the title as the tab text.
4660                     tabTitleTextView.setText(title);
4661                 }
4662             }
4663
4664             // Enter full screen video.
4665             @Override
4666             public void onShowCustomView(View video, CustomViewCallback callback) {
4667                 // Get a handle for the full screen video frame layout.
4668                 FrameLayout fullScreenVideoFrameLayout = findViewById(R.id.full_screen_video_framelayout);
4669
4670                 // Set the full screen video flag.
4671                 displayingFullScreenVideo = true;
4672
4673                 // Pause the ad if this is the free flavor.
4674                 if (BuildConfig.FLAVOR.contentEquals("free")) {
4675                     // The AdView is destroyed and recreated, which changes the ID, every time it is reloaded to handle possible rotations.
4676                     AdHelper.pauseAd(findViewById(R.id.adview));
4677                 }
4678
4679                 // Hide the keyboard.
4680                 inputMethodManager.hideSoftInputFromWindow(nestedScrollWebView.getWindowToken(), 0);
4681
4682                 // Hide the main content relative layout.
4683                 mainContentRelativeLayout.setVisibility(View.GONE);
4684
4685                 // Remove the translucent status bar overlay on the `Drawer Layout`, which is special and needs its own command.
4686                 drawerLayout.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);
4687
4688                 // Remove the translucent status flag.  This is necessary so the root frame layout can fill the entire screen.
4689                 getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
4690
4691                 /* Hide the system bars.
4692                  * SYSTEM_UI_FLAG_FULLSCREEN hides the status bar at the top of the screen.
4693                  * SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN makes the root frame layout fill the area that is normally reserved for the status bar.
4694                  * SYSTEM_UI_FLAG_HIDE_NAVIGATION hides the navigation bar on the bottom or right of the screen.
4695                  * SYSTEM_UI_FLAG_IMMERSIVE_STICKY makes the status and navigation bars translucent and automatically re-hides them after they are shown.
4696                  */
4697                 rootFrameLayout.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
4698                         View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
4699
4700                 // Disable the sliding drawers.
4701                 drawerLayout.setDrawerLockMode(DrawerLayout.LOCK_MODE_LOCKED_CLOSED);
4702
4703                 // Add the video view to the full screen video frame layout.
4704                 fullScreenVideoFrameLayout.addView(video);
4705
4706                 // Show the full screen video frame layout.
4707                 fullScreenVideoFrameLayout.setVisibility(View.VISIBLE);
4708             }
4709
4710             // Exit full screen video.
4711             @Override
4712             public void onHideCustomView() {
4713                 // Get a handle for the full screen video frame layout.
4714                 FrameLayout fullScreenVideoFrameLayout = findViewById(R.id.full_screen_video_framelayout);
4715
4716                 // Unset the full screen video flag.
4717                 displayingFullScreenVideo = false;
4718
4719                 // Remove all the views from the full screen video frame layout.
4720                 fullScreenVideoFrameLayout.removeAllViews();
4721
4722                 // Hide the full screen video frame layout.
4723                 fullScreenVideoFrameLayout.setVisibility(View.GONE);
4724
4725                 // Enable the sliding drawers.
4726                 drawerLayout.setDrawerLockMode(DrawerLayout.LOCK_MODE_UNLOCKED);
4727
4728                 // Show the main content relative layout.
4729                 mainContentRelativeLayout.setVisibility(View.VISIBLE);
4730
4731                 // Apply the appropriate full screen mode flags.
4732                 if (fullScreenBrowsingModeEnabled && inFullScreenBrowsingMode) {  // Privacy Browser is currently in full screen browsing mode.
4733                     // Hide the app bar if specified.
4734                     if (hideAppBar) {
4735                         // Hide the tab linear layout.
4736                         tabsLinearLayout.setVisibility(View.GONE);
4737
4738                         // Hide the action bar.
4739                         actionBar.hide();
4740                     }
4741
4742                     // Hide the banner ad in the free flavor.
4743                     if (BuildConfig.FLAVOR.contentEquals("free")) {
4744                         AdHelper.hideAd(findViewById(R.id.adview));
4745                     }
4746
4747                     // Remove the translucent status flag.  This is necessary so the root frame layout can fill the entire screen.
4748                     getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
4749
4750                     /* Hide the system bars.
4751                      * SYSTEM_UI_FLAG_FULLSCREEN hides the status bar at the top of the screen.
4752                      * SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN makes the root frame layout fill the area that is normally reserved for the status bar.
4753                      * SYSTEM_UI_FLAG_HIDE_NAVIGATION hides the navigation bar on the bottom or right of the screen.
4754                      * SYSTEM_UI_FLAG_IMMERSIVE_STICKY makes the status and navigation bars translucent and automatically re-hides them after they are shown.
4755                      */
4756                     rootFrameLayout.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |
4757                             View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
4758                 } else {  // Switch to normal viewing mode.
4759                     // Remove the `SYSTEM_UI` flags from the root frame layout.
4760                     rootFrameLayout.setSystemUiVisibility(0);
4761
4762                     // Add the translucent status flag.
4763                     getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
4764                 }
4765
4766                 // Reload the ad for the free flavor if not in full screen mode.
4767                 if (BuildConfig.FLAVOR.contentEquals("free") && !inFullScreenBrowsingMode) {
4768                     // Reload the ad.
4769                     AdHelper.loadAd(findViewById(R.id.adview), getApplicationContext(), getString(R.string.ad_unit_id));
4770                 }
4771             }
4772
4773             // Upload files.
4774             @Override
4775             public boolean onShowFileChooser(WebView webView, ValueCallback<Uri[]> filePathCallback, FileChooserParams fileChooserParams) {
4776                 // Show the file chooser if the device is running API >= 21.
4777                 if (Build.VERSION.SDK_INT >= 21) {
4778                     // Store the file path callback.
4779                     fileChooserCallback = filePathCallback;
4780
4781                     // Create an intent to open a chooser based ont the file chooser parameters.
4782                     Intent fileChooserIntent = fileChooserParams.createIntent();
4783
4784                     // Open the file chooser.  Currently only one `startActivityForResult` exists in this activity, so the request code, used to differentiate them, is simply `0`.
4785                     startActivityForResult(fileChooserIntent, 0);
4786                 }
4787                 return true;
4788             }
4789         });
4790
4791         nestedScrollWebView.setWebViewClient(new WebViewClient() {
4792             // `shouldOverrideUrlLoading` makes this `WebView` the default handler for URLs inside the app, so that links are not kicked out to other apps.
4793             // The deprecated `shouldOverrideUrlLoading` must be used until API >= 24.
4794             @Override
4795             public boolean shouldOverrideUrlLoading(WebView view, String url) {
4796                 if (url.startsWith("http")) {  // Load the URL in Privacy Browser.
4797                     // Apply the domain settings for the new URL.  This doesn't do anything if the domain has not changed.
4798                     boolean userAgentChanged = applyDomainSettings(nestedScrollWebView, url, true, false);
4799
4800                     // Check if the user agent has changed.
4801                     if (userAgentChanged) {
4802                         // Manually load the URL.  The changing of the user agent will cause WebView to reload the previous URL.
4803                         nestedScrollWebView.loadUrl(url, customHeaders);
4804
4805                         // Returning true indicates that Privacy Browser is manually handling the loading of the URL.
4806                         return true;
4807                     } else {
4808                         // Returning false causes the current WebView to handle the URL and prevents it from adding redirects to the history list.
4809                         return false;
4810                     }
4811                 } else if (url.startsWith("mailto:")) {  // Load the email address in an external email program.
4812                     // Use `ACTION_SENDTO` instead of `ACTION_SEND` so that only email programs are launched.
4813                     Intent emailIntent = new Intent(Intent.ACTION_SENDTO);
4814
4815                     // Parse the url and set it as the data for the intent.
4816                     emailIntent.setData(Uri.parse(url));
4817
4818                     // Open the email program in a new task instead of as part of Privacy Browser.
4819                     emailIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
4820
4821                     // Make it so.
4822                     startActivity(emailIntent);
4823
4824                     // Returning true indicates Privacy Browser is handling the URL by creating an intent.
4825                     return true;
4826                 } else if (url.startsWith("tel:")) {  // Load the phone number in the dialer.
4827                     // Open the dialer and load the phone number, but wait for the user to place the call.
4828                     Intent dialIntent = new Intent(Intent.ACTION_DIAL);
4829
4830                     // Add the phone number to the intent.
4831                     dialIntent.setData(Uri.parse(url));
4832
4833                     // Open the dialer in a new task instead of as part of Privacy Browser.
4834                     dialIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
4835
4836                     // Make it so.
4837                     startActivity(dialIntent);
4838
4839                     // Returning true indicates Privacy Browser is handling the URL by creating an intent.
4840                     return true;
4841                 } else {  // Load a system chooser to select an app that can handle the URL.
4842                     // Open an app that can handle the URL.
4843                     Intent genericIntent = new Intent(Intent.ACTION_VIEW);
4844
4845                     // Add the URL to the intent.
4846                     genericIntent.setData(Uri.parse(url));
4847
4848                     // List all apps that can handle the URL instead of just opening the first one.
4849                     genericIntent.addCategory(Intent.CATEGORY_BROWSABLE);
4850
4851                     // Open the app in a new task instead of as part of Privacy Browser.
4852                     genericIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
4853
4854                     // Start the app or display a snackbar if no app is available to handle the URL.
4855                     try {
4856                         startActivity(genericIntent);
4857                     } catch (ActivityNotFoundException exception) {
4858                         Snackbar.make(nestedScrollWebView, getString(R.string.unrecognized_url) + "  " + url, Snackbar.LENGTH_SHORT).show();
4859                     }
4860
4861                     // Returning true indicates Privacy Browser is handling the URL by creating an intent.
4862                     return true;
4863                 }
4864             }
4865
4866             // Check requests against the block lists.  The deprecated `shouldInterceptRequest()` must be used until minimum API >= 21.
4867             @Override
4868             public WebResourceResponse shouldInterceptRequest(WebView view, String url) {
4869                 // Get a handle for the navigation view.
4870                 NavigationView navigationView = findViewById(R.id.navigationview);
4871
4872                 // Get a handle for the navigation menu.
4873                 Menu navigationMenu = navigationView.getMenu();
4874
4875                 // Get a handle for the navigation requests menu item.  The menu is 0 based.
4876                 MenuItem navigationRequestsMenuItem = navigationMenu.getItem(6);
4877
4878                 // Create an empty web resource response to be used if the resource request is blocked.
4879                 WebResourceResponse emptyWebResourceResponse = new WebResourceResponse("text/plain", "utf8", new ByteArrayInputStream("".getBytes()));
4880
4881                 // Reset the whitelist results tracker.
4882                 String[] whitelistResultStringArray = null;
4883
4884                 // Initialize the third party request tracker.
4885                 boolean isThirdPartyRequest = false;
4886
4887                 // Get the current URL.  `.getUrl()` throws an error because operations on the WebView cannot be made from this thread.
4888                 String currentBaseDomain = nestedScrollWebView.getCurrentDomainName();
4889
4890                 // Store a copy of the current domain for use in later requests.
4891                 String currentDomain = currentBaseDomain;
4892
4893                 // Nobody is happy when comparing null strings.
4894                 if ((currentBaseDomain != null) && (url != null)) {
4895                     // Convert the request URL to a URI.
4896                     Uri requestUri = Uri.parse(url);
4897
4898                     // Get the request host name.
4899                     String requestBaseDomain = requestUri.getHost();
4900
4901                     // Only check for third-party requests if the current base domain is not empty and the request domain is not null.
4902                     if (!currentBaseDomain.isEmpty() && (requestBaseDomain != null)) {
4903                         // Determine the current base domain.
4904                         while (currentBaseDomain.indexOf(".", currentBaseDomain.indexOf(".") + 1) > 0) {  // There is at least one subdomain.
4905                             // Remove the first subdomain.
4906                             currentBaseDomain = currentBaseDomain.substring(currentBaseDomain.indexOf(".") + 1);
4907                         }
4908
4909                         // Determine the request base domain.
4910                         while (requestBaseDomain.indexOf(".", requestBaseDomain.indexOf(".") + 1) > 0) {  // There is at least one subdomain.
4911                             // Remove the first subdomain.
4912                             requestBaseDomain = requestBaseDomain.substring(requestBaseDomain.indexOf(".") + 1);
4913                         }
4914
4915                         // Update the third party request tracker.
4916                         isThirdPartyRequest = !currentBaseDomain.equals(requestBaseDomain);
4917                     }
4918                 }
4919
4920                 // Get the current WebView page position.
4921                 int webViewPagePosition = webViewPagerAdapter.getPositionForId(nestedScrollWebView.getWebViewFragmentId());
4922
4923                 // Determine if the WebView is currently displayed.
4924                 boolean webViewDisplayed = (webViewPagePosition == tabLayout.getSelectedTabPosition());
4925
4926                 // Block third-party requests if enabled.
4927                 if (isThirdPartyRequest && nestedScrollWebView.isBlocklistEnabled(NestedScrollWebView.THIRD_PARTY_REQUESTS)) {
4928                     // Add the result to the resource requests.
4929                     nestedScrollWebView.addResourceRequest(new String[]{BlockListHelper.REQUEST_THIRD_PARTY, url});
4930
4931                     // Increment the blocked requests counters.
4932                     nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS);
4933                     nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.THIRD_PARTY_REQUESTS);
4934
4935                     // Update the titles of the blocklist menu items if the WebView is currently displayed.
4936                     if (webViewDisplayed) {
4937                         // Updating the UI must be run from the UI thread.
4938                         activity.runOnUiThread(() -> {
4939                             // Update the menu item titles.
4940                             navigationRequestsMenuItem.setTitle(getString(R.string.requests) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
4941
4942                             // Update the options menu if it has been populated.
4943                             if (optionsMenu != null) {
4944                                 optionsMenu.findItem(R.id.blocklists).setTitle(getString(R.string.blocklists) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
4945                                 optionsMenu.findItem(R.id.block_all_third_party_requests).setTitle(nestedScrollWebView.getRequestsCount(NestedScrollWebView.THIRD_PARTY_REQUESTS) + " - " +
4946                                         getString(R.string.block_all_third_party_requests));
4947                             }
4948                         });
4949                     }
4950
4951                     // Return an empty web resource response.
4952                     return emptyWebResourceResponse;
4953                 }
4954
4955                 // Check UltraPrivacy if it is enabled.
4956                 if (nestedScrollWebView.isBlocklistEnabled(NestedScrollWebView.ULTRA_PRIVACY)) {
4957                     // Check the URL against UltraPrivacy.
4958                     String[] ultraPrivacyResults = blockListHelper.checkBlocklist(currentDomain, url, isThirdPartyRequest, ultraPrivacy);
4959
4960                     // Process the UltraPrivacy results.
4961                     if (ultraPrivacyResults[0].equals(BlockListHelper.REQUEST_BLOCKED)) {  // The resource request matched UltraPrivacy's blacklist.
4962                         // Add the result to the resource requests.
4963                         nestedScrollWebView.addResourceRequest(new String[] {ultraPrivacyResults[0], ultraPrivacyResults[1], ultraPrivacyResults[2], ultraPrivacyResults[3], ultraPrivacyResults[4],
4964                                 ultraPrivacyResults[5]});
4965
4966                         // Increment the blocked requests counters.
4967                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS);
4968                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.ULTRA_PRIVACY);
4969
4970                         // Update the titles of the blocklist menu items if the WebView is currently displayed.
4971                         if (webViewDisplayed) {
4972                             // Updating the UI must be run from the UI thread.
4973                             activity.runOnUiThread(() -> {
4974                                 // Update the menu item titles.
4975                                 navigationRequestsMenuItem.setTitle(getString(R.string.requests) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
4976
4977                                 // Update the options menu if it has been populated.
4978                                 if (optionsMenu != null) {
4979                                     optionsMenu.findItem(R.id.blocklists).setTitle(getString(R.string.blocklists) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
4980                                     optionsMenu.findItem(R.id.ultraprivacy).setTitle(nestedScrollWebView.getRequestsCount(NestedScrollWebView.ULTRA_PRIVACY) + " - " + getString(R.string.ultraprivacy));
4981                                 }
4982                             });
4983                         }
4984
4985                         // The resource request was blocked.  Return an empty web resource response.
4986                         return emptyWebResourceResponse;
4987                     } else if (ultraPrivacyResults[0].equals(BlockListHelper.REQUEST_ALLOWED)) {  // The resource request matched UltraPrivacy's whitelist.
4988                         // Add a whitelist entry to the resource requests array.
4989                         nestedScrollWebView.addResourceRequest(new String[] {ultraPrivacyResults[0], ultraPrivacyResults[1], ultraPrivacyResults[2], ultraPrivacyResults[3], ultraPrivacyResults[4],
4990                                 ultraPrivacyResults[5]});
4991
4992                         // The resource request has been allowed by UltraPrivacy.  `return null` loads the requested resource.
4993                         return null;
4994                     }
4995                 }
4996
4997                 // Check EasyList if it is enabled.
4998                 if (nestedScrollWebView.isBlocklistEnabled(NestedScrollWebView.EASY_LIST)) {
4999                     // Check the URL against EasyList.
5000                     String[] easyListResults = blockListHelper.checkBlocklist(currentDomain, url, isThirdPartyRequest, easyList);
5001
5002                     // Process the EasyList results.
5003                     if (easyListResults[0].equals(BlockListHelper.REQUEST_BLOCKED)) {  // The resource request matched EasyList's blacklist.
5004                         // Add the result to the resource requests.
5005                         nestedScrollWebView.addResourceRequest(new String[] {easyListResults[0], easyListResults[1], easyListResults[2], easyListResults[3], easyListResults[4], easyListResults[5]});
5006
5007                         // Increment the blocked requests counters.
5008                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS);
5009                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.EASY_LIST);
5010
5011                         // Update the titles of the blocklist menu items if the WebView is currently displayed.
5012                         if (webViewDisplayed) {
5013                             // Updating the UI must be run from the UI thread.
5014                             activity.runOnUiThread(() -> {
5015                                 // Update the menu item titles.
5016                                 navigationRequestsMenuItem.setTitle(getString(R.string.requests) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
5017
5018                                 // Update the options menu if it has been populated.
5019                                 if (optionsMenu != null) {
5020                                     optionsMenu.findItem(R.id.blocklists).setTitle(getString(R.string.blocklists) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
5021                                     optionsMenu.findItem(R.id.easylist).setTitle(nestedScrollWebView.getRequestsCount(NestedScrollWebView.EASY_LIST) + " - " + getString(R.string.easylist));
5022                                 }
5023                             });
5024                         }
5025
5026                         // The resource request was blocked.  Return an empty web resource response.
5027                         return emptyWebResourceResponse;
5028                     } else if (easyListResults[0].equals(BlockListHelper.REQUEST_ALLOWED)) {  // The resource request matched EasyList's whitelist.
5029                         // Update the whitelist result string array tracker.
5030                         whitelistResultStringArray = new String[] {easyListResults[0], easyListResults[1], easyListResults[2], easyListResults[3], easyListResults[4], easyListResults[5]};
5031                     }
5032                 }
5033
5034                 // Check EasyPrivacy if it is enabled.
5035                 if (nestedScrollWebView.isBlocklistEnabled(NestedScrollWebView.EASY_PRIVACY)) {
5036                     // Check the URL against EasyPrivacy.
5037                     String[] easyPrivacyResults = blockListHelper.checkBlocklist(currentDomain, url, isThirdPartyRequest, easyPrivacy);
5038
5039                     // Process the EasyPrivacy results.
5040                     if (easyPrivacyResults[0].equals(BlockListHelper.REQUEST_BLOCKED)) {  // The resource request matched EasyPrivacy's blacklist.
5041                         // Add the result to the resource requests.
5042                         nestedScrollWebView.addResourceRequest(new String[] {easyPrivacyResults[0], easyPrivacyResults[1], easyPrivacyResults[2], easyPrivacyResults[3], easyPrivacyResults[4],
5043                                 easyPrivacyResults[5]});
5044
5045                         // Increment the blocked requests counters.
5046                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS);
5047                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.EASY_PRIVACY);
5048
5049                         // Update the titles of the blocklist menu items if the WebView is currently displayed.
5050                         if (webViewDisplayed) {
5051                             // Updating the UI must be run from the UI thread.
5052                             activity.runOnUiThread(() -> {
5053                                 // Update the menu item titles.
5054                                 navigationRequestsMenuItem.setTitle(getString(R.string.requests) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
5055
5056                                 // Update the options menu if it has been populated.
5057                                 if (optionsMenu != null) {
5058                                     optionsMenu.findItem(R.id.blocklists).setTitle(getString(R.string.blocklists) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
5059                                     optionsMenu.findItem(R.id.easyprivacy).setTitle(nestedScrollWebView.getRequestsCount(NestedScrollWebView.EASY_PRIVACY) + " - " + getString(R.string.easyprivacy));
5060                                 }
5061                             });
5062                         }
5063
5064                         // The resource request was blocked.  Return an empty web resource response.
5065                         return emptyWebResourceResponse;
5066                     } else if (easyPrivacyResults[0].equals(BlockListHelper.REQUEST_ALLOWED)) {  // The resource request matched EasyPrivacy's whitelist.
5067                         // Update the whitelist result string array tracker.
5068                         whitelistResultStringArray = new String[] {easyPrivacyResults[0], easyPrivacyResults[1], easyPrivacyResults[2], easyPrivacyResults[3], easyPrivacyResults[4], easyPrivacyResults[5]};
5069                     }
5070                 }
5071
5072                 // Check Fanboy’s Annoyance List if it is enabled.
5073                 if (nestedScrollWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST)) {
5074                     // Check the URL against Fanboy's Annoyance List.
5075                     String[] fanboysAnnoyanceListResults = blockListHelper.checkBlocklist(currentDomain, url, isThirdPartyRequest, fanboysAnnoyanceList);
5076
5077                     // Process the Fanboy's Annoyance List results.
5078                     if (fanboysAnnoyanceListResults[0].equals(BlockListHelper.REQUEST_BLOCKED)) {  // The resource request matched Fanboy's Annoyance List's blacklist.
5079                         // Add the result to the resource requests.
5080                         nestedScrollWebView.addResourceRequest(new String[] {fanboysAnnoyanceListResults[0], fanboysAnnoyanceListResults[1], fanboysAnnoyanceListResults[2], fanboysAnnoyanceListResults[3],
5081                                 fanboysAnnoyanceListResults[4], fanboysAnnoyanceListResults[5]});
5082
5083                         // Increment the blocked requests counters.
5084                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS);
5085                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST);
5086
5087                         // Update the titles of the blocklist menu items if the WebView is currently displayed.
5088                         if (webViewDisplayed) {
5089                             // Updating the UI must be run from the UI thread.
5090                             activity.runOnUiThread(() -> {
5091                                 // Update the menu item titles.
5092                                 navigationRequestsMenuItem.setTitle(getString(R.string.requests) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
5093
5094                                 // Update the options menu if it has been populated.
5095                                 if (optionsMenu != null) {
5096                                     optionsMenu.findItem(R.id.blocklists).setTitle(getString(R.string.blocklists) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
5097                                     optionsMenu.findItem(R.id.fanboys_annoyance_list).setTitle(nestedScrollWebView.getRequestsCount(NestedScrollWebView.FANBOYS_ANNOYANCE_LIST) + " - " +
5098                                             getString(R.string.fanboys_annoyance_list));
5099                                 }
5100                             });
5101                         }
5102
5103                         // The resource request was blocked.  Return an empty web resource response.
5104                         return emptyWebResourceResponse;
5105                     } else if (fanboysAnnoyanceListResults[0].equals(BlockListHelper.REQUEST_ALLOWED)){  // The resource request matched Fanboy's Annoyance List's whitelist.
5106                         // Update the whitelist result string array tracker.
5107                         whitelistResultStringArray = new String[] {fanboysAnnoyanceListResults[0], fanboysAnnoyanceListResults[1], fanboysAnnoyanceListResults[2], fanboysAnnoyanceListResults[3],
5108                                 fanboysAnnoyanceListResults[4], fanboysAnnoyanceListResults[5]};
5109                     }
5110                 } else if (nestedScrollWebView.isBlocklistEnabled(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST)) {  // Only check Fanboy’s Social Blocking List if Fanboy’s Annoyance List is disabled.
5111                     // Check the URL against Fanboy's Annoyance List.
5112                     String[] fanboysSocialListResults = blockListHelper.checkBlocklist(currentDomain, url, isThirdPartyRequest, fanboysSocialList);
5113
5114                     // Process the Fanboy's Social Blocking List results.
5115                     if (fanboysSocialListResults[0].equals(BlockListHelper.REQUEST_BLOCKED)) {  // The resource request matched Fanboy's Social Blocking List's blacklist.
5116                         // Add the result to the resource requests.
5117                         nestedScrollWebView.addResourceRequest(new String[] {fanboysSocialListResults[0], fanboysSocialListResults[1], fanboysSocialListResults[2], fanboysSocialListResults[3],
5118                                 fanboysSocialListResults[4], fanboysSocialListResults[5]});
5119
5120                         // Increment the blocked requests counters.
5121                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS);
5122                         nestedScrollWebView.incrementRequestsCount(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST);
5123
5124                         // Update the titles of the blocklist menu items if the WebView is currently displayed.
5125                         if (webViewDisplayed) {
5126                             // Updating the UI must be run from the UI thread.
5127                             activity.runOnUiThread(() -> {
5128                                 // Update the menu item titles.
5129                                 navigationRequestsMenuItem.setTitle(getString(R.string.requests) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
5130
5131                                 // Update the options menu if it has been populated.
5132                                 if (optionsMenu != null) {
5133                                     optionsMenu.findItem(R.id.blocklists).setTitle(getString(R.string.blocklists) + " - " + nestedScrollWebView.getRequestsCount(NestedScrollWebView.BLOCKED_REQUESTS));
5134                                     optionsMenu.findItem(R.id.fanboys_social_blocking_list).setTitle(nestedScrollWebView.getRequestsCount(NestedScrollWebView.FANBOYS_SOCIAL_BLOCKING_LIST) + " - " +
5135                                             getString(R.string.fanboys_social_blocking_list));
5136                                 }
5137                             });
5138                         }
5139
5140                         // The resource request was blocked.  Return an empty web resource response.
5141                         return emptyWebResourceResponse;
5142                     } else if (fanboysSocialListResults[0].equals(BlockListHelper.REQUEST_ALLOWED)) {  // The resource request matched Fanboy's Social Blocking List's whitelist.
5143                         // Update the whitelist result string array tracker.
5144                         whitelistResultStringArray = new String[] {fanboysSocialListResults[0], fanboysSocialListResults[1], fanboysSocialListResults[2], fanboysSocialListResults[3],
5145                                 fanboysSocialListResults[4], fanboysSocialListResults[5]};
5146                     }
5147                 }
5148
5149                 // Add the request to the log because it hasn't been processed by any of the previous checks.
5150                 if (whitelistResultStringArray != null) {  // The request was processed by a whitelist.
5151                     nestedScrollWebView.addResourceRequest(whitelistResultStringArray);
5152                 } else {  // The request didn't match any blocklist entry.  Log it as a default request.
5153                     nestedScrollWebView.addResourceRequest(new String[]{BlockListHelper.REQUEST_DEFAULT, url});
5154                 }
5155
5156                 // The resource request has not been blocked.  `return null` loads the requested resource.
5157                 return null;
5158             }
5159
5160             // Handle HTTP authentication requests.
5161             @Override
5162             public void onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host, String realm) {
5163                 // Store the handler.
5164                 nestedScrollWebView.setHttpAuthHandler(handler);
5165
5166                 // Instantiate an HTTP authentication dialog.
5167                 DialogFragment httpAuthenticationDialogFragment = HttpAuthenticationDialog.displayDialog(host, realm, nestedScrollWebView.getWebViewFragmentId());
5168
5169                 // Show the HTTP authentication dialog.
5170                 httpAuthenticationDialogFragment.show(getSupportFragmentManager(), getString(R.string.http_authentication));
5171             }
5172
5173             @Override
5174             public void onPageStarted(WebView view, String url, Bitmap favicon) {
5175                 // Get the preferences.
5176                 boolean scrollAppBar = sharedPreferences.getBoolean("scroll_app_bar", true);
5177                 boolean darkTheme = sharedPreferences.getBoolean("dark_theme", false);
5178
5179                 // Get a handler for the app bar layout.
5180                 AppBarLayout appBarLayout = findViewById(R.id.appbar_layout);
5181
5182                 // Set the top padding of the swipe refresh layout according to the app bar scrolling preference.
5183                 if (scrollAppBar) {
5184                     // No padding is needed because it will automatically be placed below the app bar layout due to the scrolling layout behavior.
5185                     swipeRefreshLayout.setPadding(0, 0, 0, 0);
5186
5187                     // The swipe to refresh circle doesn't always hide itself completely unless it is moved up 10 pixels.
5188                     swipeRefreshLayout.setProgressViewOffset(false, defaultProgressViewStartOffset - 10, defaultProgressViewEndOffset);
5189                 } else {
5190                     // Get the app bar layout height.  This can't be done in `applyAppSettings()` because the app bar is not yet populated.
5191                     int appBarHeight = appBarLayout.getHeight();
5192
5193                     // The swipe refresh layout must be manually moved below the app bar layout.
5194                     swipeRefreshLayout.setPadding(0, appBarHeight, 0, 0);
5195
5196                     // The swipe to refresh circle doesn't always hide itself completely unless it is moved up 10 pixels.
5197                     swipeRefreshLayout.setProgressViewOffset(false, defaultProgressViewStartOffset - 10 + appBarHeight, defaultProgressViewEndOffset + appBarHeight);
5198                 }
5199
5200                 // Reset the list of resource requests.
5201                 nestedScrollWebView.clearResourceRequests();
5202
5203                 // Reset the requests counters.
5204                 nestedScrollWebView.resetRequestsCounters();
5205
5206                 // If night mode is enabled, hide `mainWebView` until after the night mode CSS is applied.
5207                 if (nestedScrollWebView.getNightMode()) {
5208                     nestedScrollWebView.setVisibility(View.INVISIBLE);
5209                 } else {
5210                     nestedScrollWebView.setVisibility(View.VISIBLE);
5211                 }
5212
5213                 // Hide the keyboard.
5214                 inputMethodManager.hideSoftInputFromWindow(nestedScrollWebView.getWindowToken(), 0);
5215
5216                 // Check to see if Privacy Browser is waiting on Orbot.
5217                 if (!waitingForOrbot) {  // Process the URL.
5218                     // Get the current page position.
5219                     int currentPagePosition = webViewPagerAdapter.getPositionForId(nestedScrollWebView.getWebViewFragmentId());
5220
5221                     // Update the URL text bar if the page is currently selected.
5222                     if (tabLayout.getSelectedTabPosition() == currentPagePosition) {
5223                         // Clear the focus from the URL edit text.
5224                         urlEditText.clearFocus();
5225
5226                         // Display the formatted URL text.
5227                         urlEditText.setText(url);
5228
5229                         // Apply text highlighting to `urlTextBox`.
5230                         highlightUrlText();
5231                     }
5232
5233                     // Reset the list of host IP addresses.
5234                     nestedScrollWebView.clearCurrentIpAddresses();
5235
5236                     // Get a URI for the current URL.
5237                     Uri currentUri = Uri.parse(url);
5238
5239                     // Get the IP addresses for the host.
5240                     new GetHostIpAddresses(activity, getSupportFragmentManager(), nestedScrollWebView).execute(currentUri.getHost());
5241
5242                     // Apply any custom domain settings if the URL was loaded by navigating history.
5243                     if (nestedScrollWebView.getNavigatingHistory()) {
5244                         // Reset navigating history.
5245                         nestedScrollWebView.setNavigatingHistory(false);
5246
5247                         // Apply the domain settings.
5248                         boolean userAgentChanged = applyDomainSettings(nestedScrollWebView, url, true, false);
5249
5250                         // Manually load the URL if the user agent has changed, which will have caused the previous URL to be reloaded.
5251                         if (userAgentChanged) {
5252                             loadUrl(url);
5253                         }
5254                     }
5255
5256                     // Replace Refresh with Stop if the options menu has been created.  (The WebView typically begins loading before the menu items are instantiated.)
5257                     if (optionsMenu != null) {
5258                         // Get a handle for the refresh menu item.
5259                         MenuItem refreshMenuItem = optionsMenu.findItem(R.id.refresh);
5260
5261                         // Set the title.
5262                         refreshMenuItem.setTitle(R.string.stop);
5263
5264                         // Get the app bar and theme preferences.
5265                         boolean displayAdditionalAppBarIcons = sharedPreferences.getBoolean("display_additional_app_bar_icons", false);
5266
5267                         // If the icon is displayed in the AppBar, set it according to the theme.
5268                         if (displayAdditionalAppBarIcons) {
5269                             if (darkTheme) {
5270                                 refreshMenuItem.setIcon(R.drawable.close_dark);
5271                             } else {
5272                                 refreshMenuItem.setIcon(R.drawable.close_light);
5273                             }
5274                         }
5275                     }
5276                 }
5277             }
5278
5279             @Override
5280             public void onPageFinished(WebView view, String url) {
5281                 // Reset the wide view port if it has been turned off by the waiting for Orbot message.
5282                 if (!waitingForOrbot) {
5283                     // Only use a wide view port if the URL starts with `http`, not for `file://` and `content://`.
5284                     nestedScrollWebView.getSettings().setUseWideViewPort(url.startsWith("http"));
5285                 }
5286
5287                 // Flush any cookies to persistent storage.  The cookie manager has become very lazy about flushing cookies in recent versions.
5288                 if (nestedScrollWebView.getAcceptFirstPartyCookies() && Build.VERSION.SDK_INT >= 21) {
5289                     CookieManager.getInstance().flush();
5290                 }
5291
5292                 // Update the Refresh menu item if the options menu has been created.
5293                 if (optionsMenu != null) {
5294                     // Get a handle for the refresh menu item.
5295                     MenuItem refreshMenuItem = optionsMenu.findItem(R.id.refresh);
5296
5297                     // Reset the Refresh title.
5298                     refreshMenuItem.setTitle(R.string.refresh);
5299
5300                     // Get the app bar and theme preferences.
5301                     boolean displayAdditionalAppBarIcons = sharedPreferences.getBoolean("display_additional_app_bar_icons", false);
5302                     boolean darkTheme = sharedPreferences.getBoolean("dark_theme", false);
5303
5304                     // If the icon is displayed in the AppBar, reset it according to the theme.
5305                     if (displayAdditionalAppBarIcons) {
5306                         if (darkTheme) {
5307                             refreshMenuItem.setIcon(R.drawable.refresh_enabled_dark);
5308                         } else {
5309                             refreshMenuItem.setIcon(R.drawable.refresh_enabled_light);
5310                         }
5311                     }
5312                 }
5313
5314                 // Clear the cache and history if Incognito Mode is enabled.
5315                 if (incognitoModeEnabled) {
5316                     // Clear the cache.  `true` includes disk files.
5317                     nestedScrollWebView.clearCache(true);
5318
5319                     // Clear the back/forward history.
5320                     nestedScrollWebView.clearHistory();
5321
5322                     // Manually delete cache folders.
5323                     try {
5324                         // Get the application's private data directory, which will be something like `/data/user/0/com.stoutner.privacybrowser.standard`,
5325                         // which links to `/data/data/com.stoutner.privacybrowser.standard`.
5326                         String privateDataDirectoryString = getApplicationInfo().dataDir;
5327
5328                         // Delete the main cache directory.
5329                         Runtime.getRuntime().exec("rm -rf " + privateDataDirectoryString + "/cache");
5330
5331                         // Delete the secondary `Service Worker` cache directory.
5332                         // A `String[]` must be used because the directory contains a space and `Runtime.exec` will not escape the string correctly otherwise.
5333                         Runtime.getRuntime().exec(new String[]{"rm", "-rf", privateDataDirectoryString + "/app_webview/Service Worker/"});
5334                     } catch (IOException e) {
5335                         // Do nothing if an error is thrown.
5336                     }
5337                 }
5338
5339                 // Update the URL text box and apply domain settings if not waiting on Orbot.
5340                 if (!waitingForOrbot) {
5341                     // Get the current page position.
5342                     int currentPagePosition = webViewPagerAdapter.getPositionForId(nestedScrollWebView.getWebViewFragmentId());
5343
5344                     // Check the current website information against any pinned domain information if the current IP addresses have been loaded.
5345                     if ((nestedScrollWebView.hasPinnedSslCertificate() || nestedScrollWebView.hasPinnedIpAddresses()) && nestedScrollWebView.hasCurrentIpAddresses() &&
5346                             !nestedScrollWebView.ignorePinnedDomainInformation()) {
5347                         CheckPinnedMismatchHelper.checkPinnedMismatch(getSupportFragmentManager(), nestedScrollWebView);
5348                     }
5349
5350                     // Update the URL text bar if the page is currently selected and the user is not currently typing in the URL edit text.
5351                     if ((tabLayout.getSelectedTabPosition() == currentPagePosition) && !urlEditText.hasFocus()) {
5352                         // Check to see if the URL is `about:blank`.
5353                         if (nestedScrollWebView.getUrl().equals("about:blank")) {  // The WebView is blank.
5354                             // Display the hint in the URL edit text.
5355                             urlEditText.setText("");
5356
5357                             // Request focus for the URL text box.
5358                             urlEditText.requestFocus();
5359
5360                             // Display the keyboard.
5361                             inputMethodManager.showSoftInput(urlEditText, 0);
5362
5363                             // Hide the WebView, which causes the default background color to be displayed according to the theme.
5364                             nestedScrollWebView.setVisibility(View.INVISIBLE);
5365
5366                             // Apply the domain settings.  This clears any settings from the previous domain.
5367                             applyDomainSettings(nestedScrollWebView, "", true, false);
5368                         } else {  // The WebView has loaded a webpage.
5369                             // Display the final URL.  Getting the URL from the WebView instead of using the one provided by `onPageFinished()` makes websites like YouTube function correctly.
5370                             urlEditText.setText(nestedScrollWebView.getUrl());
5371
5372                             // Apply text highlighting to the URL.
5373                             highlightUrlText();
5374                         }
5375                     }
5376                 }
5377             }
5378
5379             // Handle SSL Certificate errors.
5380             @Override
5381             public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
5382                 // Get the current website SSL certificate.
5383                 SslCertificate currentWebsiteSslCertificate = error.getCertificate();
5384
5385                 // Extract the individual pieces of information from the current website SSL certificate.
5386                 String currentWebsiteIssuedToCName = currentWebsiteSslCertificate.getIssuedTo().getCName();
5387                 String currentWebsiteIssuedToOName = currentWebsiteSslCertificate.getIssuedTo().getOName();
5388                 String currentWebsiteIssuedToUName = currentWebsiteSslCertificate.getIssuedTo().getUName();
5389                 String currentWebsiteIssuedByCName = currentWebsiteSslCertificate.getIssuedBy().getCName();
5390                 String currentWebsiteIssuedByOName = currentWebsiteSslCertificate.getIssuedBy().getOName();
5391                 String currentWebsiteIssuedByUName = currentWebsiteSslCertificate.getIssuedBy().getUName();
5392                 Date currentWebsiteSslStartDate = currentWebsiteSslCertificate.getValidNotBeforeDate();
5393                 Date currentWebsiteSslEndDate = currentWebsiteSslCertificate.getValidNotAfterDate();
5394
5395                 // Proceed to the website if the current SSL website certificate matches the pinned domain certificate.
5396                 if (nestedScrollWebView.hasPinnedSslCertificate()) {
5397                     // Get the pinned SSL certificate.
5398                     ArrayList<Object> pinnedSslCertificateArrayList = nestedScrollWebView.getPinnedSslCertificate();
5399
5400                     // Extract the arrays from the array list.
5401                     String[] pinnedSslCertificateStringArray = (String[]) pinnedSslCertificateArrayList.get(0);
5402                     Date[] pinnedSslCertificateDateArray = (Date[]) pinnedSslCertificateArrayList.get(1);
5403
5404                     // Check if the current SSL certificate matches the pinned certificate.
5405                     if (currentWebsiteIssuedToCName.equals(pinnedSslCertificateStringArray[0]) && currentWebsiteIssuedToOName.equals(pinnedSslCertificateStringArray[1]) &&
5406                         currentWebsiteIssuedToUName.equals(pinnedSslCertificateStringArray[2]) && currentWebsiteIssuedByCName.equals(pinnedSslCertificateStringArray[3]) &&
5407                         currentWebsiteIssuedByOName.equals(pinnedSslCertificateStringArray[4]) && currentWebsiteIssuedByUName.equals(pinnedSslCertificateStringArray[5]) &&
5408                         currentWebsiteSslStartDate.equals(pinnedSslCertificateDateArray[0]) && currentWebsiteSslEndDate.equals(pinnedSslCertificateDateArray[1])) {
5409
5410                         // An SSL certificate is pinned and matches the current domain certificate.  Proceed to the website without displaying an error.
5411                         handler.proceed();
5412                     }
5413                 } else {  // Either there isn't a pinned SSL certificate or it doesn't match the current website certificate.
5414                     // Store the SSL error handler.
5415                     nestedScrollWebView.setSslErrorHandler(handler);
5416
5417                     // Instantiate an SSL certificate error alert dialog.
5418                     DialogFragment sslCertificateErrorDialogFragment = SslCertificateErrorDialog.displayDialog(error, nestedScrollWebView.getWebViewFragmentId());
5419
5420                     // Show the SSL certificate error dialog.
5421                     sslCertificateErrorDialogFragment.show(getSupportFragmentManager(), getString(R.string.ssl_certificate_error));
5422                 }
5423             }
5424         });
5425
5426         // Check to see if this is the first page.
5427         if (pageNumber == 0) {
5428             // Set this nested scroll WebView as the current WebView.
5429             currentWebView = nestedScrollWebView;
5430
5431             // Apply the app settings from the shared preferences.
5432             applyAppSettings();
5433
5434             // Load the website if not waiting for Orbot to connect.
5435             if (!waitingForOrbot) {
5436                 // Get the intent that started the app.
5437                 Intent launchingIntent = getIntent();
5438
5439                 // Get the information from the intent.
5440                 String launchingIntentAction = launchingIntent.getAction();
5441                 Uri launchingIntentUriData = launchingIntent.getData();
5442
5443                 // If the intent action is a web search, perform the search.
5444                 if ((launchingIntentAction != null) && launchingIntentAction.equals(Intent.ACTION_WEB_SEARCH)) {
5445                     // Create an encoded URL string.
5446                     String encodedUrlString;
5447
5448                     // Sanitize the search input and convert it to a search.
5449                     try {
5450                         encodedUrlString = URLEncoder.encode(launchingIntent.getStringExtra(SearchManager.QUERY), "UTF-8");
5451                     } catch (UnsupportedEncodingException exception) {
5452                         encodedUrlString = "";
5453                     }
5454
5455                     // Load the completed search URL.
5456                     loadUrl(searchURL + encodedUrlString);
5457                 } else if (launchingIntentUriData != null){  // Check to see if the intent contains a new URL.
5458                     // Load the URL from the intent.
5459                     loadUrl(launchingIntentUriData.toString());
5460                 } else {  // The is no URL in the intent.
5461                     // Select the homepage based on the proxy through Orbot status.
5462                     if (proxyThroughOrbot) {
5463                         // Load the Tor homepage.
5464                         loadUrl(sharedPreferences.getString("tor_homepage", getString(R.string.tor_homepage_default_value)));
5465                     } else {
5466                         // Load the normal homepage.
5467                         loadUrl(sharedPreferences.getString("homepage", getString(R.string.homepage_default_value)));
5468                     }
5469                 }
5470             }
5471         }
5472     }
5473 }