2 * Copyright © 2016-2023 Soren Stoutner <soren@stoutner.com>.
4 * This file is part of Privacy Browser Android <https://www.stoutner.com/privacy-browser-android>.
6 * Privacy Browser Android is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * Privacy Browser Android is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with Privacy Browser Android. If not, see <http://www.gnu.org/licenses/>.
20 package com.stoutner.privacybrowser.fragments
22 import android.content.Intent
23 import android.content.res.Configuration
24 import android.os.Build
25 import android.os.Bundle
26 import android.view.LayoutInflater
27 import android.view.View
28 import android.view.ViewGroup
29 import android.webkit.WebResourceRequest
30 import android.webkit.WebResourceResponse
31 import android.webkit.WebView
32 import android.webkit.WebViewClient
34 import androidx.fragment.app.Fragment
35 import androidx.webkit.WebSettingsCompat
36 import androidx.webkit.WebViewAssetLoader
37 import androidx.webkit.WebViewAssetLoader.AssetsPathHandler
38 import androidx.webkit.WebViewFeature
40 import com.stoutner.privacybrowser.R
42 // Define the class constants.
43 private const val TAB_NUMBER = "tab_number"
44 private const val SCROLL_X = "scroll_x"
45 private const val SCROLL_Y = "scroll_y"
47 class AboutWebViewFragment : Fragment() {
48 // Define the class variables.
49 private var tabNumber = 0
51 // Declare the class views.
52 private lateinit var webViewLayout: View
55 fun createTab(tabNumber: Int): AboutWebViewFragment {
56 // Create an arguments bundle.
57 val argumentsBundle = Bundle()
59 // Store the arguments in the bundle.
60 argumentsBundle.putInt(TAB_NUMBER, tabNumber)
62 // Create a new instance of the tab fragment.
63 val aboutWebViewFragment = AboutWebViewFragment()
65 // Add the arguments bundle to the fragment.
66 aboutWebViewFragment.arguments = argumentsBundle
68 // Return the new fragment.
69 return aboutWebViewFragment
73 override fun onCreate(savedInstanceState: Bundle?) {
74 // Run the default commands.
75 super.onCreate(savedInstanceState)
77 // Store the tab number in a class variable.
78 tabNumber = requireArguments().getInt(TAB_NUMBER)
81 override fun onCreateView(layoutInflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View {
82 // Inflate the layout. The fragment will take care of attaching the root automatically.
83 webViewLayout = layoutInflater.inflate(R.layout.bare_webview, container, false)
85 // Get a handle for tab WebView.
86 val tabWebView = webViewLayout as WebView
88 // Create a WebView asset loader.
89 val webViewAssetLoader = WebViewAssetLoader.Builder().addPathHandler("/assets/", AssetsPathHandler(requireContext())).build()
91 // Set a WebView client.
92 tabWebView.webViewClient = object : WebViewClient() {
93 // Send external links back to the main Privacy Browser WebView.
94 override fun shouldOverrideUrlLoading(view: WebView, webResourceRequest: WebResourceRequest): Boolean {
95 // Create an intent to view the URL.
96 val urlIntent = Intent(Intent.ACTION_VIEW)
98 // Add the URL to the intent.
99 urlIntent.data = webResourceRequest.url
102 startActivity(urlIntent)
104 // Consume the click.
108 // Process asset requests with the asset loader.
109 override fun shouldInterceptRequest(webView: WebView, webResourceRequest: WebResourceRequest): WebResourceResponse? {
110 // This allows using the `appassets.androidplatform.net` URL, which handles the loading of SVG files, which otherwise is prevented by the CORS policy.
111 return webViewAssetLoader.shouldInterceptRequest(webResourceRequest.url)
115 // Get the current theme status.
116 val currentThemeStatus = resources.configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK
118 // Check to see if the app is in night mode. This can be removed once the minimum API >= 33.
119 if ((Build.VERSION.SDK_INT < 33) && (currentThemeStatus == Configuration.UI_MODE_NIGHT_YES) && WebViewFeature.isFeatureSupported(WebViewFeature.FORCE_DARK)) { // The app is in night mode.
120 // Apply the dark WebView theme.
121 @Suppress("DEPRECATION")
122 WebSettingsCompat.setForceDark(tabWebView.settings, WebSettingsCompat.FORCE_DARK_ON)
125 // Load the indicated tab. The tab numbers start at 0, with the WebView tabs starting at 1.
127 1 -> tabWebView.loadUrl("https://appassets.androidplatform.net/assets/" + getString(R.string.android_asset_path) + "/about_permissions.html")
128 2 -> tabWebView.loadUrl("https://appassets.androidplatform.net/assets/" + getString(R.string.android_asset_path) + "/about_privacy_policy.html")
129 3 -> tabWebView.loadUrl("https://appassets.androidplatform.net/assets/" + getString(R.string.android_asset_path) + "/about_changelog.html")
130 4 -> tabWebView.loadUrl("https://appassets.androidplatform.net/assets/" + getString(R.string.android_asset_path) + "/about_licenses.html")
131 5 -> tabWebView.loadUrl("https://appassets.androidplatform.net/assets/" + getString(R.string.android_asset_path) + "/about_contributors.html")
132 6 -> tabWebView.loadUrl("https://appassets.androidplatform.net/assets/" + getString(R.string.android_asset_path) + "/about_links.html")
135 // Scroll the tab if the saved instance state is not null.
136 if (savedInstanceState != null) {
138 tabWebView.scrollX = savedInstanceState.getInt(SCROLL_X)
139 tabWebView.scrollY = savedInstanceState.getInt(SCROLL_Y)
143 // Return the formatted WebView layout.
147 override fun onSaveInstanceState(savedInstanceState: Bundle) {
148 // Run the default commands.
149 super.onSaveInstanceState(savedInstanceState)
151 // Get a handle for the tab WebView. A class variable cannot be used because it gets out of sync when restarting.
152 val tabWebView = webViewLayout as WebView?
154 // Save the scroll positions if the layout is not null, which can happen if a tab is not currently selected.
155 if (tabWebView != null) {
156 savedInstanceState.putInt(SCROLL_X, tabWebView.scrollX)
157 savedInstanceState.putInt(SCROLL_Y, tabWebView.scrollY)