Completely remove Privacy Browser from RAM after exit. Updated German translations...
[PrivacyBrowser.git] / app / src / main / java / com / stoutner / privacybrowser / MainWebViewActivity.java
1 /**
2  * Copyright 2015-2016 Soren Stoutner <soren@stoutner.com>.
3  *
4  * This file is part of Privacy Browser <https://www.stoutner.com/privacy-browser>.
5  *
6  * Privacy Browser is free software: you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation, either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * Privacy Browser is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with Privacy Browser.  If not, see <http://www.gnu.org/licenses/>.
18  */
19
20 package com.stoutner.privacybrowser;
21
22 import android.annotation.SuppressLint;
23 import android.app.Activity;
24 import android.app.DialogFragment;
25 import android.app.DownloadManager;
26 import android.content.Context;
27 import android.content.Intent;
28 import android.content.SharedPreferences;
29 import android.content.res.Configuration;
30 import android.graphics.Bitmap;
31 import android.graphics.drawable.BitmapDrawable;
32 import android.graphics.drawable.Drawable;
33 import android.net.Uri;
34 import android.net.http.SslCertificate;
35 import android.net.http.SslError;
36 import android.os.Build;
37 import android.os.Bundle;
38 import android.preference.PreferenceManager;
39 import android.print.PrintDocumentAdapter;
40 import android.print.PrintManager;
41 import android.support.annotation.NonNull;
42 import android.support.design.widget.NavigationView;
43 import android.support.design.widget.Snackbar;
44 import android.support.v4.app.ActivityCompat;
45 import android.support.v4.content.ContextCompat;
46 import android.support.v4.view.GravityCompat;
47 import android.support.v4.widget.DrawerLayout;
48 import android.support.v4.widget.SwipeRefreshLayout;
49 import android.support.v7.app.ActionBar;
50 import android.support.v7.app.ActionBarDrawerToggle;
51 import android.support.v7.app.AppCompatActivity;
52 import android.support.v7.app.AppCompatDialogFragment;
53 import android.support.v7.widget.Toolbar;
54 import android.util.Patterns;
55 import android.view.KeyEvent;
56 import android.view.Menu;
57 import android.view.MenuItem;
58 import android.view.View;
59 import android.view.inputmethod.InputMethodManager;
60 import android.webkit.CookieManager;
61 import android.webkit.DownloadListener;
62 import android.webkit.SslErrorHandler;
63 import android.webkit.WebChromeClient;
64 import android.webkit.WebStorage;
65 import android.webkit.WebView;
66 import android.webkit.WebViewClient;
67 import android.webkit.WebViewDatabase;
68 import android.widget.EditText;
69 import android.widget.FrameLayout;
70 import android.widget.ImageView;
71 import android.widget.ProgressBar;
72
73 import java.io.UnsupportedEncodingException;
74 import java.net.MalformedURLException;
75 import java.net.URL;
76 import java.net.URLEncoder;
77 import java.util.HashMap;
78 import java.util.Map;
79
80 // We need to use AppCompatActivity from android.support.v7.app.AppCompatActivity to have access to the SupportActionBar until the minimum API is >= 21.
81 public class MainWebViewActivity extends AppCompatActivity implements NavigationView.OnNavigationItemSelectedListener, CreateHomeScreenShortcut.CreateHomeScreenSchortcutListener,
82         SslCertificateError.SslCertificateErrorListener, DownloadFile.DownloadFileListener {
83
84     // `appBar` is public static so it can be accessed from `OrbotProxyHelper`.
85     // It is also used in `onCreate()` and `onOptionsItemSelected()`.
86     public static ActionBar appBar;
87
88     // `favoriteIcon` is public static so it can be accessed from `CreateHomeScreenShortcut`, `BookmarksActivity`, `CreateBookmark`, `CreateBookmarkFolder`, and `EditBookmark`.
89     // It is also used in `onCreate()` and `onCreateHomeScreenShortcutCreate()`.
90     public static Bitmap favoriteIcon;
91
92     // `formattedUrlString` is public static so it can be accessed from `BookmarksActivity`.
93     // It is also used in `onCreate()`, `onOptionsItemSelected()`, `onCreateHomeScreenShortcutCreate()`, and `loadUrlFromTextBox()`.
94     public static String formattedUrlString;
95
96     // `sslCertificate` is public static so it can be accessed from `ViewSslCertificate`.  It is also used in `onCreate()`.
97     public static SslCertificate sslCertificate;
98
99
100     // 'mainWebView' is used in `onCreate()`, `onOptionsItemSelected()`, `onNavigationItemSelected()`, `onRestart()`, and `loadUrlFromTextBox()`.
101     private WebView mainWebView;
102
103     // `swipeRefreshLayout` is used in `onCreate()`, `onPrepareOptionsMenu`, and `onRestart()`.
104     private SwipeRefreshLayout swipeRefreshLayout;
105
106     // `cookieManager` is used in `onCreate()`, `onOptionsItemSelected()`, and `onNavigationItemSelected()`, and `onRestart()`.
107     private CookieManager cookieManager;
108
109     // `customHeader` is used in `onCreate()`, `onOptionsItemSelected()`, and `loadUrlFromTextBox()`.
110     private final Map<String, String> customHeaders = new HashMap<>();
111
112     // `javaScriptEnabled` is also used in `onCreate()`, `onCreateOptionsMenu()`, `onOptionsItemSelected()`, `loadUrlFromTextBox()`, and `applySettings()`.
113     // It is `Boolean` instead of `boolean` because `applySettings()` needs to know if it is `null`.
114     private Boolean javaScriptEnabled;
115
116     // `firstPartyCookiesEnabled` is used in `onCreate()`, `onCreateOptionsMenu()`, `onPrepareOptionsMenu()`, `onOptionsItemSelected()`, and `applySettings()`.
117     private boolean firstPartyCookiesEnabled;
118
119     // `thirdPartyCookiesEnabled` used in `onCreate()`, `onCreateOptionsMenu()`, `onPrepareOptionsMenu()`, `onOptionsItemSelected()`, and `applySettings()`.
120     private boolean thirdPartyCookiesEnabled;
121
122     // `domStorageEnabled` is used in `onCreate()`, `onCreateOptionsMenu()`, `onOptionsItemSelected()`, and `applySettings()`.
123     private boolean domStorageEnabled;
124
125     // `saveFormDataEnabled` is used in `onCreate()`, `onCreateOptionsMenu()`, `onOptionsItemSelected()`, and `applySettings()`.
126     private boolean saveFormDataEnabled;
127
128     // `swipeToRefreshEnabled` is used in `onPrepareOptionsMenu()` and `applySettings()`.
129     private boolean swipeToRefreshEnabled;
130
131     // 'homepage' is used in `onCreate()`, `onNavigationItemSelected()`, and `applySettings()`.
132     private String homepage;
133
134     // `javaScriptDisabledSearchURL` is used in `loadURLFromTextBox()` and `applySettings()`.
135     private String javaScriptDisabledSearchURL;
136
137     // `javaScriptEnabledSearchURL` is used in `loadURLFromTextBox()` and `applySettings()`.
138     private String javaScriptEnabledSearchURL;
139
140     // `mainMenu` is used in `onCreateOptionsMenu()` and `updatePrivacyIcons()`.
141     private Menu mainMenu;
142
143     // `drawerToggle` is used in `onCreate()`, `onPostCreate()`, `onConfigurationChanged()`, `onNewIntent()`, and `onNavigationItemSelected()`.
144     private ActionBarDrawerToggle drawerToggle;
145
146     // `drawerLayout` is used in `onCreate()`, `onNewIntent()`, and `onBackPressed()`.
147     private DrawerLayout drawerLayout;
148
149     // `urlTextBox` is used in `onCreate()`, `onOptionsItemSelected()`, and `loadUrlFromTextBox()`.
150     private EditText urlTextBox;
151
152     // `adView` is used in `onCreate()` and `onConfigurationChanged()`.
153     private View adView;
154
155     // `sslErrorHandler` is used in `onCreate()`, `onSslErrorCancel()`, and `onSslErrorProceed`.
156     private SslErrorHandler sslErrorHandler;
157
158     private MenuItem toggleJavaScript;
159
160     @Override
161     // Remove Android Studio's warning about the dangers of using SetJavaScriptEnabled.  The whole premise of Privacy Browser is built around an understanding of these dangers.
162     @SuppressLint("SetJavaScriptEnabled")
163     protected void onCreate(Bundle savedInstanceState) {
164         super.onCreate(savedInstanceState);
165         setContentView(R.layout.main_coordinatorlayout);
166
167         // We need to use the SupportActionBar from android.support.v7.app.ActionBar until the minimum API is >= 21.
168         Toolbar supportAppBar = (Toolbar) findViewById(R.id.appBar);
169         setSupportActionBar(supportAppBar);
170         appBar = getSupportActionBar();
171
172         // This is needed to get rid of the Android Studio warning that appBar might be null.
173         assert appBar != null;
174
175         // Add the custom url_app_bar layout, which shows the favoriteIcon, urlTextBar, and progressBar.
176         appBar.setCustomView(R.layout.url_app_bar);
177         appBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM);
178
179         // Set the "go" button on the keyboard to load the URL in urlTextBox.
180         urlTextBox = (EditText) appBar.getCustomView().findViewById(R.id.urlTextBox);
181         urlTextBox.setOnKeyListener(new View.OnKeyListener() {
182             public boolean onKey(View v, int keyCode, KeyEvent event) {
183                 // If the event is a key-down event on the "enter" button, load the URL.
184                 if ((event.getAction() == KeyEvent.ACTION_DOWN) && (keyCode == KeyEvent.KEYCODE_ENTER)) {
185                     // Load the URL into the mainWebView and consume the event.
186                     try {
187                         loadUrlFromTextBox();
188                     } catch (UnsupportedEncodingException e) {
189                         e.printStackTrace();
190                     }
191                     // If the enter key was pressed, consume the event.
192                     return true;
193                 } else {
194                     // If any other key was pressed, do not consume the event.
195                     return false;
196                 }
197             }
198         });
199
200         final FrameLayout fullScreenVideoFrameLayout = (FrameLayout) findViewById(R.id.fullScreenVideoFrameLayout);
201
202         // Implement swipe to refresh
203         swipeRefreshLayout = (SwipeRefreshLayout) findViewById(R.id.swipeRefreshLayout);
204         swipeRefreshLayout.setColorSchemeResources(R.color.blue_700);
205         swipeRefreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
206             @Override
207             public void onRefresh() {
208                 mainWebView.reload();
209             }
210         });
211
212         mainWebView = (WebView) findViewById(R.id.mainWebView);
213
214         // Create the navigation drawer.
215         drawerLayout = (DrawerLayout) findViewById(R.id.drawerLayout);
216         // The DrawerTitle identifies the drawer in accessibility mode.
217         drawerLayout.setDrawerTitle(GravityCompat.START, getString(R.string.navigation_drawer));
218
219         // Listen for touches on the navigation menu.
220         final NavigationView navigationView = (NavigationView) findViewById(R.id.navigationView);
221         navigationView.setNavigationItemSelectedListener(this);
222
223         // drawerToggle creates the hamburger icon at the start of the AppBar.
224         drawerToggle = new ActionBarDrawerToggle(this, drawerLayout, supportAppBar, R.string.open_navigation, R.string.close_navigation);
225
226         mainWebView.setWebViewClient(new WebViewClient() {
227             // `shouldOverrideUrlLoading` makes this `WebView` the default handler for URLs inside the app, so that links are not kicked out to other apps.
228             // We have to use the deprecated `shouldOverrideUrlLoading` until API >= 24.
229             @SuppressWarnings("deprecation")
230             @Override
231             public boolean shouldOverrideUrlLoading(WebView view, String url) {
232                 // Use an external email program if the link begins with "mailto:".
233                 if (url.startsWith("mailto:")) {
234                     // We use `ACTION_SENDTO` instead of `ACTION_SEND` so that only email programs are launched.
235                     Intent emailIntent = new Intent(Intent.ACTION_SENDTO);
236
237                     // Parse the url and set it as the data for the `Intent`.
238                     emailIntent.setData(Uri.parse(url));
239
240                     // `FLAG_ACTIVITY_NEW_TASK` opens the email program in a new task instead as part of Privacy Browser.
241                     emailIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
242
243                     // Make it so.
244                     startActivity(emailIntent);
245                     return true;
246                 } else {  // Load the URL in Privacy Browser.
247                     mainWebView.loadUrl(url, customHeaders);
248                     return true;
249                 }
250             }
251
252             // Update the URL in urlTextBox when the page starts to load.
253             @Override
254             public void onPageStarted(WebView view, String url, Bitmap favicon) {
255                 // We need to update `formattedUrlString` at the beginning of the load, so that if the user toggles JavaScript during the load the new website is reloaded.
256                 formattedUrlString = url;
257
258                 // Display the loading URL is the URL text box.
259                 urlTextBox.setText(url);
260             }
261
262             // Update formattedUrlString and urlTextBox.  It is necessary to do this after the page finishes loading because the final URL can change during load.
263             @Override
264             public void onPageFinished(WebView view, String url) {
265                 formattedUrlString = url;
266
267                 // Only update urlTextBox if the user is not typing in it.
268                 if (!urlTextBox.hasFocus()) {
269                     urlTextBox.setText(formattedUrlString);
270                 }
271
272                 // Store the SSL certificate so it can be accessed from `ViewSslCertificate`.
273                 sslCertificate = mainWebView.getCertificate();
274             }
275
276             // Handle SSL Certificate errors.
277             @Override
278             public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
279                 // Store `handler` so it can be accesses from `onSslErrorCancel()` and `onSslErrorProceed()`.
280                 sslErrorHandler = handler;
281
282                 // Display the SSL error `AlertDialog`.
283                 DialogFragment sslCertificateErrorDialogFragment = SslCertificateError.displayDialog(error);
284                 sslCertificateErrorDialogFragment.show(getFragmentManager(), getResources().getString(R.string.ssl_certificate_error));
285             }
286         });
287
288         mainWebView.setWebChromeClient(new WebChromeClient() {
289             // Update the progress bar when a page is loading.
290             @Override
291             public void onProgressChanged(WebView view, int progress) {
292                 ProgressBar progressBar = (ProgressBar) appBar.getCustomView().findViewById(R.id.progressBar);
293                 progressBar.setProgress(progress);
294                 if (progress < 100) {
295                     progressBar.setVisibility(View.VISIBLE);
296                 } else {
297                     progressBar.setVisibility(View.GONE);
298
299                     //Stop the `SwipeToRefresh` indicator if it is running
300                     swipeRefreshLayout.setRefreshing(false);
301                 }
302             }
303
304             // Set the favorite icon when it changes.
305             @Override
306             public void onReceivedIcon(WebView view, Bitmap icon) {
307                 // Save a copy of the favorite icon for use if a shortcut is added to the home screen.
308                 favoriteIcon = icon;
309
310                 // Place the favorite icon in the appBar.
311                 ImageView imageViewFavoriteIcon = (ImageView) appBar.getCustomView().findViewById(R.id.favoriteIcon);
312                 imageViewFavoriteIcon.setImageBitmap(Bitmap.createScaledBitmap(icon, 64, 64, true));
313             }
314
315             // Enter full screen video
316             @Override
317             public void onShowCustomView(View view, CustomViewCallback callback) {
318                 appBar.hide();
319
320                 // Show the fullScreenVideoFrameLayout.
321                 fullScreenVideoFrameLayout.addView(view);
322                 fullScreenVideoFrameLayout.setVisibility(View.VISIBLE);
323
324                 // Hide the mainWebView.
325                 mainWebView.setVisibility(View.GONE);
326
327                 // Hide the ad if this is the free flavor.
328                 BannerAd.hideAd(adView);
329
330                 /* SYSTEM_UI_FLAG_HIDE_NAVIGATION hides the navigation bars on the bottom or right of the screen.
331                  * SYSTEM_UI_FLAG_FULLSCREEN hides the status bar across the top of the screen.
332                  * SYSTEM_UI_FLAG_IMMERSIVE_STICKY makes the navigation and status bars ghosted overlays and automatically rehides them.
333                  */
334                 view.setSystemUiVisibility(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION | View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
335             }
336
337             // Exit full screen video
338             public void onHideCustomView() {
339                 appBar.show();
340
341                 // Show the mainWebView.
342                 mainWebView.setVisibility(View.VISIBLE);
343
344                 // Show the ad if this is the free flavor.
345                 BannerAd.showAd(adView);
346
347                 // Hide the fullScreenVideoFrameLayout.
348                 fullScreenVideoFrameLayout.removeAllViews();
349                 fullScreenVideoFrameLayout.setVisibility(View.GONE);
350             }
351         });
352
353         // Allow the downloading of files.
354         mainWebView.setDownloadListener(new DownloadListener() {
355             @Override
356             public void onDownloadStart(String url, String userAgent, String contentDisposition, String mimetype, long contentLength) {
357                 // Show the `DownloadFile` `AlertDialog` and name this instance `@string/download`.
358                 AppCompatDialogFragment downloadFileDialogFragment = DownloadFile.fromUrl(url, contentDisposition, contentLength);
359                 downloadFileDialogFragment.show(getSupportFragmentManager(), getResources().getString(R.string.download));
360             }
361         });
362
363         // Allow pinch to zoom.
364         mainWebView.getSettings().setBuiltInZoomControls(true);
365
366         // Hide zoom controls.
367         mainWebView.getSettings().setDisplayZoomControls(false);
368
369         // Initialize cookieManager.
370         cookieManager = CookieManager.getInstance();
371
372         // 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).
373         customHeaders.put("X-Requested-With", "");
374
375         // Initialize the default preference values the first time the program is run.
376         PreferenceManager.setDefaultValues(this, R.xml.preferences, false);
377
378         // Apply the settings from the shared preferences.
379         applySettings();
380
381         // Get the intent information that started the app.
382         final Intent intent = getIntent();
383
384         if (intent.getData() != null) {
385             // Get the intent data and convert it to a string.
386             final Uri intentUriData = intent.getData();
387             formattedUrlString = intentUriData.toString();
388         }
389
390         // If formattedUrlString is null assign the homepage to it.
391         if (formattedUrlString == null) {
392             formattedUrlString = homepage;
393         }
394
395         // Load the initial website.
396         mainWebView.loadUrl(formattedUrlString, customHeaders);
397
398         // If the favorite icon is null, load the default.
399         if (favoriteIcon == null) {
400             // We have to use `ContextCompat` until API >= 21.
401             Drawable favoriteIconDrawable = ContextCompat.getDrawable(getApplicationContext(), R.drawable.world);
402             BitmapDrawable favoriteIconBitmapDrawable = (BitmapDrawable) favoriteIconDrawable;
403             favoriteIcon = favoriteIconBitmapDrawable.getBitmap();
404         }
405
406         // Initialize AdView for the free flavor and request an ad.  If this is not the free flavor BannerAd.requestAd() does nothing.
407         adView = findViewById(R.id.adView);
408         BannerAd.requestAd(adView);
409     }
410
411
412     @Override
413     protected void onNewIntent(Intent intent) {
414         // Sets the new intent as the activity intent, so that any future `getIntent()`s pick up this one instead of creating a new activity.
415         setIntent(intent);
416
417         if (intent.getData() != null) {
418             // Get the intent data and convert it to a string.
419             final Uri intentUriData = intent.getData();
420             formattedUrlString = intentUriData.toString();
421         }
422
423         // Close the navigation drawer if it is open.
424         if (drawerLayout.isDrawerVisible(GravityCompat.START)) {
425             drawerLayout.closeDrawer(GravityCompat.START);
426         }
427
428         // Load the website.
429         mainWebView.loadUrl(formattedUrlString, customHeaders);
430
431         // Clear the keyboard if displayed and remove the focus on the urlTextBar if it has it.
432         mainWebView.requestFocus();
433     }
434
435     @Override
436     public boolean onCreateOptionsMenu(Menu menu) {
437         // Inflate the menu; this adds items to the action bar if it is present.
438         getMenuInflater().inflate(R.menu.webview_options_menu, menu);
439
440         // Set mainMenu so it can be used by `onOptionsItemSelected()` and `updatePrivacyIcons`.
441         mainMenu = menu;
442
443         // Set the initial status of the privacy icons.  `false` does not call `invalidateOptionsMenu` as the last step.
444         updatePrivacyIcons(false);
445
446         // Get handles for the menu items.
447         toggleJavaScript = menu.findItem(R.id.toggleJavaScript);
448         MenuItem toggleFirstPartyCookies = menu.findItem(R.id.toggleFirstPartyCookies);
449         MenuItem toggleThirdPartyCookies = menu.findItem(R.id.toggleThirdPartyCookies);
450         MenuItem toggleDomStorage = menu.findItem(R.id.toggleDomStorage);
451         MenuItem toggleSaveFormData = menu.findItem(R.id.toggleSaveFormData);
452
453         // Only display third-Party Cookies if SDK >= 21
454         toggleThirdPartyCookies.setVisible(Build.VERSION.SDK_INT >= 21);
455
456         // Get the shared preference values.  `this` references the current context.
457         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
458
459         // Set the status of the additional app bar icons.  The default is `false`.
460         if (sharedPreferences.getBoolean("display_additional_app_bar_icons", false)) {
461             toggleFirstPartyCookies.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
462             toggleDomStorage.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
463             toggleSaveFormData.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
464         } else { //Do not display the additional icons.
465             toggleFirstPartyCookies.setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
466             toggleDomStorage.setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
467             toggleSaveFormData.setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
468         }
469
470         return true;
471     }
472
473     @Override
474     public boolean onPrepareOptionsMenu(Menu menu) {
475         // Get handles for the menu items.
476         MenuItem toggleFirstPartyCookies = menu.findItem(R.id.toggleFirstPartyCookies);
477         MenuItem toggleThirdPartyCookies = menu.findItem(R.id.toggleThirdPartyCookies);
478         MenuItem toggleDomStorage = menu.findItem(R.id.toggleDomStorage);
479         MenuItem toggleSaveFormData = menu.findItem(R.id.toggleSaveFormData);
480         MenuItem clearCookies = menu.findItem(R.id.clearCookies);
481         MenuItem clearFormData = menu.findItem(R.id.clearFormData);
482         MenuItem refreshMenuItem = menu.findItem(R.id.refresh);
483
484         // Set the status of the menu item checkboxes.
485         toggleFirstPartyCookies.setChecked(firstPartyCookiesEnabled);
486         toggleThirdPartyCookies.setChecked(thirdPartyCookiesEnabled);
487         toggleDomStorage.setChecked(domStorageEnabled);
488         toggleSaveFormData.setChecked(saveFormDataEnabled);
489
490         // Enable third-party cookies if first-party cookies are enabled.
491         toggleThirdPartyCookies.setEnabled(firstPartyCookiesEnabled);
492
493         // Enable DOM Storage if JavaScript is enabled.
494         toggleDomStorage.setEnabled(javaScriptEnabled);
495
496         // Enable Clear Cookies if there are any.
497         clearCookies.setEnabled(cookieManager.hasCookies());
498
499         // Enable Clear Form Data is there is any.
500         WebViewDatabase mainWebViewDatabase = WebViewDatabase.getInstance(this);
501         clearFormData.setEnabled(mainWebViewDatabase.hasFormData());
502
503         // Only show `Refresh` if `swipeToRefresh` is disabled.
504         refreshMenuItem.setVisible(!swipeToRefreshEnabled);
505
506         // Initialize font size variables.
507         int fontSize = mainWebView.getSettings().getTextZoom();
508         String fontSizeTitle;
509         MenuItem selectedFontSizeMenuItem;
510
511         // Prepare the font size title and current size menu item.
512         switch (fontSize) {
513             case 50:
514                 fontSizeTitle = getResources().getString(R.string.font_size) + " - " + getResources().getString(R.string.fifty_percent);
515                 selectedFontSizeMenuItem = menu.findItem(R.id.fontSizeFiftyPercent);
516                 break;
517
518             case 75:
519                 fontSizeTitle = getResources().getString(R.string.font_size) + " - " + getResources().getString(R.string.seventy_five_percent);
520                 selectedFontSizeMenuItem = menu.findItem(R.id.fontSizeSeventyFivePercent);
521                 break;
522
523             case 100:
524                 fontSizeTitle = getResources().getString(R.string.font_size) + " - " + getResources().getString(R.string.one_hundred_percent);
525                 selectedFontSizeMenuItem = menu.findItem(R.id.fontSizeOneHundredPercent);
526                 break;
527
528             case 125:
529                 fontSizeTitle = getResources().getString(R.string.font_size) + " - " + getResources().getString(R.string.one_hundred_twenty_five_percent);
530                 selectedFontSizeMenuItem = menu.findItem(R.id.fontSizeOneHundredTwentyFivePercent);
531                 break;
532
533             case 150:
534                 fontSizeTitle = getResources().getString(R.string.font_size) + " - " + getResources().getString(R.string.one_hundred_fifty_percent);
535                 selectedFontSizeMenuItem = menu.findItem(R.id.fontSizeOneHundredFiftyPercent);
536                 break;
537
538             case 175:
539                 fontSizeTitle = getResources().getString(R.string.font_size) + " - " + getResources().getString(R.string.one_hundred_seventy_five_percent);
540                 selectedFontSizeMenuItem = menu.findItem(R.id.fontSizeOneHundredSeventyFivePercent);
541                 break;
542
543             case 200:
544                 fontSizeTitle = getResources().getString(R.string.font_size) + " - " + getResources().getString(R.string.two_hundred_percent);
545                 selectedFontSizeMenuItem = menu.findItem(R.id.fontSizeTwoHundredPercent);
546                 break;
547
548             default:
549                 fontSizeTitle = getResources().getString(R.string.font_size) + " - " + getResources().getString(R.string.one_hundred_percent);
550                 selectedFontSizeMenuItem = menu.findItem(R.id.fontSizeOneHundredPercent);
551                 break;
552         }
553
554         // Set the font size title and select the current size menu item.
555         MenuItem fontSizeMenuItem = menu.findItem(R.id.fontSize);
556         fontSizeMenuItem.setTitle(fontSizeTitle);
557         selectedFontSizeMenuItem.setChecked(true);
558
559         // Run all the other default commands.
560         super.onPrepareOptionsMenu(menu);
561
562         // `return true` displays the menu.
563         return true;
564     }
565
566     @Override
567     // Remove Android Studio's warning about the dangers of using SetJavaScriptEnabled.
568     @SuppressLint("SetJavaScriptEnabled")
569     // removeAllCookies is deprecated, but it is required for API < 21.
570     @SuppressWarnings("deprecation")
571     public boolean onOptionsItemSelected(MenuItem menuItem) {
572         int menuItemId = menuItem.getItemId();
573
574         // Set the commands that relate to the menu entries.
575         switch (menuItemId) {
576             case R.id.toggleJavaScript:
577                 // Switch the status of javaScriptEnabled.
578                 javaScriptEnabled = !javaScriptEnabled;
579
580                 // Apply the new JavaScript status.
581                 mainWebView.getSettings().setJavaScriptEnabled(javaScriptEnabled);
582
583                 // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.
584                 updatePrivacyIcons(true);
585
586                 // Display a `Snackbar`.
587                 if (javaScriptEnabled) {  // JavaScrip is enabled.
588                     Snackbar.make(findViewById(R.id.mainWebView), R.string.javascript_enabled, Snackbar.LENGTH_SHORT).show();
589                 } else if (firstPartyCookiesEnabled) {  // JavaScript is disabled, but first-party cookies are enabled.
590                     Snackbar.make(findViewById(R.id.mainWebView), R.string.javascript_disabled, Snackbar.LENGTH_SHORT).show();
591                 } else {  // Privacy mode.
592                     Snackbar.make(findViewById(R.id.mainWebView), R.string.privacy_mode, Snackbar.LENGTH_SHORT).show();
593                 }
594
595                 // Reload the WebView.
596                 mainWebView.reload();
597                 return true;
598
599             case R.id.toggleFirstPartyCookies:
600                 // Switch the status of firstPartyCookiesEnabled.
601                 firstPartyCookiesEnabled = !firstPartyCookiesEnabled;
602
603                 // Update the menu checkbox.
604                 menuItem.setChecked(firstPartyCookiesEnabled);
605
606                 // Apply the new cookie status.
607                 cookieManager.setAcceptCookie(firstPartyCookiesEnabled);
608
609                 // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.
610                 updatePrivacyIcons(true);
611
612                 // Display a `Snackbar`.
613                 if (firstPartyCookiesEnabled) {  // First-party cookies are enabled.
614                     Snackbar.make(findViewById(R.id.mainWebView), R.string.first_party_cookies_enabled, Snackbar.LENGTH_SHORT).show();
615                 } else if (javaScriptEnabled){  // JavaScript is still enabled.
616                     Snackbar.make(findViewById(R.id.mainWebView), R.string.first_party_cookies_disabled, Snackbar.LENGTH_SHORT).show();
617                 } else {  // Privacy mode.
618                     Snackbar.make(findViewById(R.id.mainWebView), R.string.privacy_mode, Snackbar.LENGTH_SHORT).show();
619                 }
620
621                 // Reload the WebView.
622                 mainWebView.reload();
623                 return true;
624
625             case R.id.toggleThirdPartyCookies:
626                 if (Build.VERSION.SDK_INT >= 21) {
627                     // Switch the status of thirdPartyCookiesEnabled.
628                     thirdPartyCookiesEnabled = !thirdPartyCookiesEnabled;
629
630                     // Update the menu checkbox.
631                     menuItem.setChecked(thirdPartyCookiesEnabled);
632
633                     // Apply the new cookie status.
634                     cookieManager.setAcceptThirdPartyCookies(mainWebView, thirdPartyCookiesEnabled);
635
636                     // Display a `Snackbar`.
637                     if (thirdPartyCookiesEnabled) {
638                         Snackbar.make(findViewById(R.id.mainWebView), R.string.third_party_cookies_enabled, Snackbar.LENGTH_SHORT).show();
639                     } else {
640                         Snackbar.make(findViewById(R.id.mainWebView), R.string.third_party_cookies_disabled, Snackbar.LENGTH_SHORT).show();
641                     }
642
643                     // Reload the WebView.
644                     mainWebView.reload();
645                 } // Else do nothing because SDK < 21.
646                 return true;
647
648             case R.id.toggleDomStorage:
649                 // Switch the status of domStorageEnabled.
650                 domStorageEnabled = !domStorageEnabled;
651
652                 // Update the menu checkbox.
653                 menuItem.setChecked(domStorageEnabled);
654
655                 // Apply the new DOM Storage status.
656                 mainWebView.getSettings().setDomStorageEnabled(domStorageEnabled);
657
658                 // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.
659                 updatePrivacyIcons(true);
660
661                 // Display a `Snackbar`.
662                 if (domStorageEnabled) {
663                     Snackbar.make(findViewById(R.id.mainWebView), R.string.dom_storage_enabled, Snackbar.LENGTH_SHORT).show();
664                 } else {
665                     Snackbar.make(findViewById(R.id.mainWebView), R.string.dom_storage_disabled, Snackbar.LENGTH_SHORT).show();
666                 }
667
668                 // Reload the WebView.
669                 mainWebView.reload();
670                 return true;
671
672             case R.id.toggleSaveFormData:
673                 // Switch the status of saveFormDataEnabled.
674                 saveFormDataEnabled = !saveFormDataEnabled;
675
676                 // Update the menu checkbox.
677                 menuItem.setChecked(saveFormDataEnabled);
678
679                 // Apply the new form data status.
680                 mainWebView.getSettings().setSaveFormData(saveFormDataEnabled);
681
682                 // Display a `Snackbar`.
683                 if (saveFormDataEnabled) {
684                     Snackbar.make(findViewById(R.id.mainWebView), R.string.form_data_enabled, Snackbar.LENGTH_SHORT).show();
685                 } else {
686                     Snackbar.make(findViewById(R.id.mainWebView), R.string.form_data_disabled, Snackbar.LENGTH_SHORT).show();
687                 }
688
689                 // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.
690                 updatePrivacyIcons(true);
691
692                 // Reload the WebView.
693                 mainWebView.reload();
694                 return true;
695
696             case R.id.clearCookies:
697                 if (Build.VERSION.SDK_INT < 21) {
698                     cookieManager.removeAllCookie();
699                 } else {
700                     cookieManager.removeAllCookies(null);
701                 }
702                 Snackbar.make(findViewById(R.id.mainWebView), R.string.cookies_deleted, Snackbar.LENGTH_SHORT).show();
703                 return true;
704
705             case R.id.clearDomStorage:
706                 WebStorage webStorage = WebStorage.getInstance();
707                 webStorage.deleteAllData();
708                 Snackbar.make(findViewById(R.id.mainWebView), R.string.dom_storage_deleted, Snackbar.LENGTH_SHORT).show();
709                 return true;
710
711             case R.id.clearFormData:
712                 WebViewDatabase mainWebViewDatabase = WebViewDatabase.getInstance(this);
713                 mainWebViewDatabase.clearFormData();
714                 mainWebView.reload();
715                 return true;
716
717             case R.id.fontSizeFiftyPercent:
718                 mainWebView.getSettings().setTextZoom(50);
719                 return true;
720
721             case R.id.fontSizeSeventyFivePercent:
722                 mainWebView.getSettings().setTextZoom(75);
723                 return true;
724
725             case R.id.fontSizeOneHundredPercent:
726                 mainWebView.getSettings().setTextZoom(100);
727                 return true;
728
729             case R.id.fontSizeOneHundredTwentyFivePercent:
730                 mainWebView.getSettings().setTextZoom(125);
731                 return true;
732
733             case R.id.fontSizeOneHundredFiftyPercent:
734                 mainWebView.getSettings().setTextZoom(150);
735                 return true;
736
737             case R.id.fontSizeOneHundredSeventyFivePercent:
738                 mainWebView.getSettings().setTextZoom(175);
739                 return true;
740
741             case R.id.fontSizeTwoHundredPercent:
742                 mainWebView.getSettings().setTextZoom(200);
743                 return true;
744
745             /*
746             case R.id.find_on_page:
747                 appBar.setCustomView(R.layout.find_on_page_app_bar);
748                 toggleJavaScript.setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
749                 appBar.invalidateOptionsMenu();
750                 return true;
751                 */
752
753             case R.id.share:
754                 Intent shareIntent = new Intent();
755                 shareIntent.setAction(Intent.ACTION_SEND);
756                 shareIntent.putExtra(Intent.EXTRA_TEXT, urlTextBox.getText().toString());
757                 shareIntent.setType("text/plain");
758                 startActivity(Intent.createChooser(shareIntent, "Share URL"));
759                 return true;
760
761             case R.id.addToHomescreen:
762                 // Show the `CreateHomeScreenShortcut` `AlertDialog` and name this instance `@string/create_shortcut`.
763                 AppCompatDialogFragment createHomeScreenShortcutDialogFragment = new CreateHomeScreenShortcut();
764                 createHomeScreenShortcutDialogFragment.show(getSupportFragmentManager(), getResources().getString(R.string.create_shortcut));
765
766                 //Everything else will be handled by `CreateHomeScreenShortcut` and the associated listener below.
767                 return true;
768
769             case R.id.print:
770                 // Get a `PrintManager` instance.
771                 PrintManager printManager = (PrintManager) getSystemService(Context.PRINT_SERVICE);
772
773                 // Convert `mainWebView` to `printDocumentAdapter`.
774                 PrintDocumentAdapter printDocumentAdapter = mainWebView.createPrintDocumentAdapter();
775
776                 // Print the document.  The print attributes are `null`.
777                 printManager.print(getResources().getString(R.string.privacy_browser_web_page), printDocumentAdapter, null);
778                 return true;
779
780             case R.id.refresh:
781                 mainWebView.reload();
782                 return true;
783
784             default:
785                 // Don't consume the event.
786                 return super.onOptionsItemSelected(menuItem);
787         }
788     }
789
790     // removeAllCookies is deprecated, but it is required for API < 21.
791     @SuppressWarnings("deprecation")
792     @Override
793     public boolean onNavigationItemSelected(@NonNull MenuItem menuItem) {
794         int menuItemId = menuItem.getItemId();
795
796         switch (menuItemId) {
797             case R.id.home:
798                 mainWebView.loadUrl(homepage, customHeaders);
799                 break;
800
801             case R.id.back:
802                 if (mainWebView.canGoBack()) {
803                     mainWebView.goBack();
804                 }
805                 break;
806
807             case R.id.forward:
808                 if (mainWebView.canGoForward()) {
809                     mainWebView.goForward();
810                 }
811                 break;
812
813             case R.id.bookmarks:
814                 // Launch BookmarksActivity.
815                 Intent bookmarksIntent = new Intent(this, BookmarksActivity.class);
816                 startActivity(bookmarksIntent);
817                 break;
818
819             case R.id.downloads:
820                 // Launch the system Download Manager.
821                 Intent downloadManagerIntent = new Intent(DownloadManager.ACTION_VIEW_DOWNLOADS);
822
823                 // Launch as a new task so that Download Manager and Privacy Browser show as separate windows in the recent tasks list.
824                 downloadManagerIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
825
826                 startActivity(downloadManagerIntent);
827                 break;
828
829             case R.id.settings:
830                 // Launch `SettingsActivity`.
831                 Intent settingsIntent = new Intent(this, SettingsActivity.class);
832                 startActivity(settingsIntent);
833                 break;
834
835             case R.id.guide:
836                 // Launch `GuideActivity`.
837                 Intent guideIntent = new Intent(this, GuideActivity.class);
838                 startActivity(guideIntent);
839                 break;
840
841             case R.id.about:
842                 // Launch `AboutActivity`.
843                 Intent aboutIntent = new Intent(this, AboutActivity.class);
844                 startActivity(aboutIntent);
845                 break;
846
847             case R.id.clearAndExit:
848                 // Clear cookies.  The commands changed slightly in API 21.
849                 if (Build.VERSION.SDK_INT >= 21) {
850                     cookieManager.removeAllCookies(null);
851                 } else {
852                     cookieManager.removeAllCookie();
853                 }
854
855                 // Clear DOM storage.
856                 WebStorage domStorage = WebStorage.getInstance();
857                 domStorage.deleteAllData();
858
859                 // Clear form data.
860                 WebViewDatabase formData = WebViewDatabase.getInstance(this);
861                 formData.clearFormData();
862
863                 // Clear cache.  The argument of "true" includes disk files.
864                 mainWebView.clearCache(true);
865
866                 // Clear the back/forward history.
867                 mainWebView.clearHistory();
868
869                 // Clear any SSL certificate preferences.
870                 mainWebView.clearSslPreferences();
871
872                 // Clear `formattedUrlString`.
873                 formattedUrlString = null;
874
875                 // Clear `customHeaders`.
876                 customHeaders.clear();
877
878                 // Destroy the internal state of the webview.
879                 mainWebView.destroy();
880
881                 // Close Privacy Browser.  `finishAndRemoveTask` also removes Privacy Browser from the recent app list.
882                 if (Build.VERSION.SDK_INT >= 21) {
883                     finishAndRemoveTask();
884                 } else {
885                     finish();
886                 }
887
888                 // Remove the terminated program from RAM.  The status code is `0`.
889                 System.exit(0);
890                 break;
891
892             default:
893                 break;
894         }
895
896         // Close the navigation drawer.
897         drawerLayout.closeDrawer(GravityCompat.START);
898         return true;
899     }
900
901     @Override
902     public void onPostCreate(Bundle savedInstanceState) {
903         super.onPostCreate(savedInstanceState);
904
905         // Sync the state of the DrawerToggle after onRestoreInstanceState has finished.
906         drawerToggle.syncState();
907     }
908
909     @Override
910     public void onConfigurationChanged(Configuration newConfig) {
911         super.onConfigurationChanged(newConfig);
912
913         // Reload the ad if this is the free flavor.
914         BannerAd.reloadAfterRotate(adView, getApplicationContext(), getString(R.string.ad_id));
915
916         // Reinitialize the adView variable, as the View will have been removed and re-added in the free flavor by BannerAd.reloadAfterRotate().
917         adView = findViewById(R.id.adView);
918
919         // `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:  https://code.google.com/p/android/issues/detail?id=20493#c8
920         // ActivityCompat.invalidateOptionsMenu(this);
921     }
922
923     @Override
924     public void onCreateHomeScreenShortcut(AppCompatDialogFragment dialogFragment) {
925         // Get shortcutNameEditText from the alert dialog.
926         EditText shortcutNameEditText = (EditText) dialogFragment.getDialog().findViewById(R.id.shortcut_name_edittext);
927
928         // Create the bookmark shortcut based on formattedUrlString.
929         Intent bookmarkShortcut = new Intent();
930         bookmarkShortcut.setAction(Intent.ACTION_VIEW);
931         bookmarkShortcut.setData(Uri.parse(formattedUrlString));
932
933         // Place the bookmark shortcut on the home screen.
934         Intent placeBookmarkShortcut = new Intent();
935         placeBookmarkShortcut.putExtra("android.intent.extra.shortcut.INTENT", bookmarkShortcut);
936         placeBookmarkShortcut.putExtra("android.intent.extra.shortcut.NAME", shortcutNameEditText.getText().toString());
937         placeBookmarkShortcut.putExtra("android.intent.extra.shortcut.ICON", favoriteIcon);
938         placeBookmarkShortcut.setAction("com.android.launcher.action.INSTALL_SHORTCUT");
939         sendBroadcast(placeBookmarkShortcut);
940     }
941
942     @Override
943     public void onDownloadFile(AppCompatDialogFragment dialogFragment, String downloadUrl) {
944         DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
945         DownloadManager.Request downloadRequest = new DownloadManager.Request(Uri.parse(downloadUrl));
946
947         // Get the file name from `dialogFragment`.
948         EditText downloadFileNameEditText = (EditText) dialogFragment.getDialog().findViewById(R.id.download_file_name);
949         String fileName = downloadFileNameEditText.getText().toString();
950
951         // Once we have `WRITE_EXTERNAL_STORAGE` permissions we can use `setDestinationInExternalPublicDir`.
952         if (Build.VERSION.SDK_INT >= 23) { // If API >= 23, set the download save in the the `DIRECTORY_DOWNLOADS` using `fileName`.
953             downloadRequest.setDestinationInExternalFilesDir(this, "/", fileName);
954         } else { // Only set the title using `fileName`.
955             downloadRequest.setTitle(fileName);
956         }
957
958         // Allow `MediaScanner` to index the download if it is a media file.
959         downloadRequest.allowScanningByMediaScanner();
960
961         // Add the URL as the description for the download.
962         downloadRequest.setDescription(downloadUrl);
963
964         // Show the download notification after the download is completed.
965         downloadRequest.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
966
967         // Initiate the download and display a Snackbar.
968         downloadManager.enqueue(downloadRequest);
969     }
970
971     public void viewSslCertificate(View view) {
972         // Show the `ViewSslCertificate` `AlertDialog` and name this instance `@string/view_ssl_certificate`.
973         DialogFragment viewSslCertificateDialogFragment = new ViewSslCertificate();
974         viewSslCertificateDialogFragment.show(getFragmentManager(), getResources().getString(R.string.view_ssl_certificate));
975     }
976
977     @Override
978     public void onSslErrorCancel() {
979         sslErrorHandler.cancel();
980     }
981
982     @Override
983     public void onSslErrorProceed() {
984         sslErrorHandler.proceed();
985     }
986
987     // Override onBackPressed to handle the navigation drawer and mainWebView.
988     @Override
989     public void onBackPressed() {
990         final WebView mainWebView = (WebView) findViewById(R.id.mainWebView);
991
992         // Close the navigation drawer if it is available.  GravityCompat.START is the drawer on the left on Left-to-Right layout text.
993         if (drawerLayout.isDrawerVisible(GravityCompat.START)) {
994             drawerLayout.closeDrawer(GravityCompat.START);
995         } else {
996             // Load the previous URL if available.
997             if (mainWebView.canGoBack()) {
998                 mainWebView.goBack();
999             } else {
1000                 // Pass onBackPressed to the system.
1001                 super.onBackPressed();
1002             }
1003         }
1004     }
1005
1006     @Override
1007     public void onPause() {
1008         // We need to pause the adView or it will continue to consume resources in the background on the free flavor.
1009         BannerAd.pauseAd(adView);
1010
1011         super.onPause();
1012     }
1013
1014     @Override
1015     public void onResume() {
1016         super.onResume();
1017
1018         // We need to resume the adView for the free flavor.
1019         BannerAd.resumeAd(adView);
1020     }
1021
1022     @Override
1023     public void onRestart() {
1024         super.onRestart();
1025
1026         // Apply the settings from shared preferences, which might have been changed in `SettingsActivity`.
1027         applySettings();
1028
1029         // Update the privacy icon.  `true` runs `invalidateOptionsMenu` as the last step.
1030         updatePrivacyIcons(true);
1031
1032     }
1033
1034     private void loadUrlFromTextBox() throws UnsupportedEncodingException {
1035         // Get the text from urlTextBox and convert it to a string.  trim() removes white spaces from the beginning and end of the string.
1036         String unformattedUrlString = urlTextBox.getText().toString().trim();
1037
1038         URL unformattedUrl = null;
1039         Uri.Builder formattedUri = new Uri.Builder();
1040
1041         // Check to see if unformattedUrlString is a valid URL.  Otherwise, convert it into a Duck Duck Go search.
1042         if (Patterns.WEB_URL.matcher(unformattedUrlString).matches()) {
1043             // Add http:// at the beginning if it is missing.  Otherwise the app will segfault.
1044             if (!unformattedUrlString.startsWith("http")) {
1045                 unformattedUrlString = "http://" + unformattedUrlString;
1046             }
1047
1048             // 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.
1049             try {
1050                 unformattedUrl = new URL(unformattedUrlString);
1051             } catch (MalformedURLException e) {
1052                 e.printStackTrace();
1053             }
1054
1055             // The ternary operator (? :) makes sure that a null pointer exception is not thrown, which would happen if .get was called on a null value.
1056             final String scheme = unformattedUrl != null ? unformattedUrl.getProtocol() : null;
1057             final String authority = unformattedUrl != null ? unformattedUrl.getAuthority() : null;
1058             final String path = unformattedUrl != null ? unformattedUrl.getPath() : null;
1059             final String query = unformattedUrl != null ? unformattedUrl.getQuery() : null;
1060             final String fragment = unformattedUrl != null ? unformattedUrl.getRef() : null;
1061
1062             formattedUri.scheme(scheme).authority(authority).path(path).query(query).fragment(fragment);
1063             formattedUrlString = formattedUri.build().toString();
1064         } else {
1065             // Sanitize the search input and convert it to a DuckDuckGo search.
1066             final String encodedUrlString = URLEncoder.encode(unformattedUrlString, "UTF-8");
1067
1068             // Use the correct search URL.
1069             if (javaScriptEnabled) {  // JavaScript is enabled.
1070                 formattedUrlString = javaScriptEnabledSearchURL + encodedUrlString;
1071             } else { // JavaScript is disabled.
1072                 formattedUrlString = javaScriptDisabledSearchURL + encodedUrlString;
1073             }
1074         }
1075
1076         mainWebView.loadUrl(formattedUrlString, customHeaders);
1077
1078         // Hides the keyboard so we can see the webpage.
1079         InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Activity.INPUT_METHOD_SERVICE);
1080         inputMethodManager.hideSoftInputFromWindow(mainWebView.getWindowToken(), 0);
1081     }
1082
1083     private void applySettings() {
1084         // Get the shared preference values.  `this` references the current context.
1085         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
1086
1087         // Store the values from `sharedPreferences` in variables.
1088         String userAgentString = sharedPreferences.getString("user_agent", "Default user agent");
1089         String customUserAgentString = sharedPreferences.getString("custom_user_agent", "PrivacyBrowser/1.0");
1090         String javaScriptDisabledSearchString = sharedPreferences.getString("javascript_disabled_search", "https://duckduckgo.com/html/?q=");
1091         String javaScriptDisabledCustomSearchString = sharedPreferences.getString("javascript_disabled_search_custom_url", "");
1092         String javaScriptEnabledSearchString = sharedPreferences.getString("javascript_enabled_search", "https://duckduckgo.com/?q=");
1093         String javaScriptEnabledCustomSearchString = sharedPreferences.getString("javascript_enabled_search_custom_url", "");
1094         String homepageString = sharedPreferences.getString("homepage", "https://www.duckduckgo.com");
1095         String defaultFontSizeString = sharedPreferences.getString("default_font_size", "100");
1096         swipeToRefreshEnabled = sharedPreferences.getBoolean("swipe_to_refresh_enabled", false);
1097         boolean doNotTrackEnabled = sharedPreferences.getBoolean("do_not_track", true);
1098         boolean proxyThroughOrbot = sharedPreferences.getBoolean("proxy_through_orbot", false);
1099
1100         // Because they can be modified on-the-fly by the user, these default settings are only applied when the program first runs.
1101         if (javaScriptEnabled == null) {  // If `javaScriptEnabled` is null the program is just starting.
1102             // Get the values from `sharedPreferences`.
1103             javaScriptEnabled = sharedPreferences.getBoolean("javascript_enabled", false);
1104             firstPartyCookiesEnabled = sharedPreferences.getBoolean("first_party_cookies_enabled", false);
1105             thirdPartyCookiesEnabled = sharedPreferences.getBoolean("third_party_cookies_enabled", false);
1106             domStorageEnabled = sharedPreferences.getBoolean("dom_storage_enabled", false);
1107             saveFormDataEnabled = sharedPreferences.getBoolean("save_form_data_enabled", false);
1108
1109             // Apply the default settings.
1110             mainWebView.getSettings().setJavaScriptEnabled(javaScriptEnabled);
1111             cookieManager.setAcceptCookie(firstPartyCookiesEnabled);
1112             mainWebView.getSettings().setDomStorageEnabled(domStorageEnabled);
1113             mainWebView.getSettings().setSaveFormData(saveFormDataEnabled);
1114             mainWebView.getSettings().setTextZoom(Integer.valueOf(defaultFontSizeString));
1115
1116             // Set third-party cookies status if API >= 21.
1117             if (Build.VERSION.SDK_INT >= 21) {
1118                 cookieManager.setAcceptThirdPartyCookies(mainWebView, thirdPartyCookiesEnabled);
1119             }
1120         }
1121
1122         // Apply the other settings from `sharedPreferences`.
1123         homepage = homepageString;
1124         swipeRefreshLayout.setEnabled(swipeToRefreshEnabled);
1125
1126         // Set the user agent initial status.
1127         switch (userAgentString) {
1128             case "Default user agent":
1129                 // Set the user agent to `""`, which uses the default value.
1130                 mainWebView.getSettings().setUserAgentString("");
1131                 break;
1132
1133             case "Custom user agent":
1134                 // Set the custom user agent.
1135                 mainWebView.getSettings().setUserAgentString(customUserAgentString);
1136                 break;
1137
1138             default:
1139                 // Use the selected user agent.
1140                 mainWebView.getSettings().setUserAgentString(userAgentString);
1141                 break;
1142         }
1143
1144         // Set JavaScript disabled search.
1145         if (javaScriptDisabledSearchString.equals("Custom URL")) {  // Get the custom URL string.
1146             javaScriptDisabledSearchURL = javaScriptDisabledCustomSearchString;
1147         } else {  // Use the string from the pre-built list.
1148             javaScriptDisabledSearchURL = javaScriptDisabledSearchString;
1149         }
1150
1151         // Set JavaScript enabled search.
1152         if (javaScriptEnabledSearchString.equals("Custom URL")) {  // Get the custom URL string.
1153             javaScriptEnabledSearchURL = javaScriptEnabledCustomSearchString;
1154         } else {  // Use the string from the pre-built list.
1155             javaScriptEnabledSearchURL = javaScriptEnabledSearchString;
1156         }
1157
1158         // Set Do Not Track status.
1159         if (doNotTrackEnabled) {
1160             customHeaders.put("DNT", "1");
1161         } else {
1162             customHeaders.remove("DNT");
1163         }
1164
1165         // Set Orbot proxy status.
1166         if (proxyThroughOrbot) {
1167             // Set the proxy.  `this` refers to the current activity where an `AlertDialog` might be displayed.
1168             OrbotProxyHelper.setProxy(getApplicationContext(), this, "localhost", "8118");
1169         } else {  // Reset the proxy to default.  The host is `""` and the port is `"0"`.
1170             OrbotProxyHelper.setProxy(getApplicationContext(), this, "", "0");
1171         }
1172     }
1173
1174     private void updatePrivacyIcons(boolean runInvalidateOptionsMenu) {
1175         // Get handles for the icons.
1176         MenuItem privacyIcon = mainMenu.findItem(R.id.toggleJavaScript);
1177         MenuItem firstPartyCookiesIcon = mainMenu.findItem(R.id.toggleFirstPartyCookies);
1178         MenuItem domStorageIcon = mainMenu.findItem(R.id.toggleDomStorage);
1179         MenuItem formDataIcon = mainMenu.findItem(R.id.toggleSaveFormData);
1180
1181         // Update `privacyIcon`.
1182         if (javaScriptEnabled) {  // JavaScript is enabled.
1183             privacyIcon.setIcon(R.drawable.javascript_enabled);
1184         } else if (firstPartyCookiesEnabled) {  // JavaScript is disabled but cookies are enabled.
1185             privacyIcon.setIcon(R.drawable.warning);
1186         } else {  // All the dangerous features are disabled.
1187             privacyIcon.setIcon(R.drawable.privacy_mode);
1188         }
1189
1190         // Update `firstPartyCookiesIcon`.
1191         if (firstPartyCookiesEnabled) {  // First-party cookies are enabled.
1192             firstPartyCookiesIcon.setIcon(R.drawable.cookies_enabled);
1193         } else {  // First-party cookies are disabled.
1194             firstPartyCookiesIcon.setIcon(R.drawable.cookies_disabled);
1195         }
1196
1197         // Update `domStorageIcon`.
1198         if (javaScriptEnabled && domStorageEnabled) {  // Both JavaScript and DOM storage are enabled.
1199             domStorageIcon.setIcon(R.drawable.dom_storage_enabled);
1200         } else if (javaScriptEnabled) {  // JavaScript is enabled but DOM storage is disabled.
1201             domStorageIcon.setIcon(R.drawable.dom_storage_disabled);
1202         } else {  // JavaScript is disabled, so DOM storage is ghosted.
1203             domStorageIcon.setIcon(R.drawable.dom_storage_ghosted);
1204         }
1205
1206         // Update `formDataIcon`.
1207         if (saveFormDataEnabled) {  // Form data is enabled.
1208             formDataIcon.setIcon(R.drawable.form_data_enabled);
1209         } else {  // Form data is disabled.
1210             formDataIcon.setIcon(R.drawable.form_data_disabled);
1211         }
1212
1213         // `invalidateOptionsMenu` calls `onPrepareOptionsMenu()` and redraws the icons in the `AppBar`.  `this` references the current activity.
1214         if (runInvalidateOptionsMenu) {
1215             ActivityCompat.invalidateOptionsMenu(this);
1216         }
1217     }
1218 }