VPN-7203 - Add a warning when not running with "unrestricted" background usage permission

android/AndroidManifest.xml

@@ -12,6 +12,7 @@ file, You can obtain one at http://mozilla.org/MPL/2.0/.
     <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
     <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"/>
     <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+    <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"/>
     <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
 
     <!-- The following comment will be replaced upon deployment with default features based on the dependencies of the application.

android/common/src/main/java/org/mozilla/firefox/qt/common/BatteryOptimizationHelper.kt

@@ -0,0 +1,50 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+package org.mozilla.firefox.qt.common
+
+import android.content.Context
+import android.content.Intent
+import android.content.pm.PackageManager
+import android.net.Uri
+import android.os.Build
+import android.os.PowerManager
+import android.provider.Settings
+
+object BatteryOptimizationHelper {
+
+    @JvmStatic
+    fun isIgnoringBatteryOptimizations(context: Context): Boolean {
+        return try {
+            val pm = context.getSystemService(Context.POWER_SERVICE) as PowerManager
+            pm.isIgnoringBatteryOptimizations(context.packageName)
+        } catch (e: Exception) { true }
+    }
+
+    @JvmStatic
+    fun hasRequestIgnoreBatteryOptimizationsPermission(context: Context): Boolean {
+        return try {
+            context.packageManager.checkPermission(
+                "android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS",
+                context.packageName) == PackageManager.PERMISSION_GRANTED
+        } catch (e: Exception) { false }
+    }
+
+    @JvmStatic
+    fun getRequestIgnoreBatteryOptimizationsIntent(context: Context): Intent? {
+        return try {
+            if (hasRequestIgnoreBatteryOptimizationsPermission(context)) {
+                Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS).apply {
+                    data = Uri.parse("package:${context.packageName}")
+                }
+            } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+                Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
+                    data = Uri.parse("package:${context.packageName}")
+                }
+            } else {
+                Intent(Settings.ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS)
+            }
+        } catch (e: Exception) { null }
+    }
+}

src/platforms/android/androidbatteryoptimizer.cpp

@@ -0,0 +1,43 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#include "androidbatteryoptimizer.h"
+
+#include <QJniObject>
+
+#include "androidcommons.h"
+
+constexpr auto BATTERY_HELPER_CLASS =
+    "org/mozilla/firefox/qt/common/BatteryOptimizationHelper";
+
+// static
+bool AndroidBatteryOptimizer::batteryOptimizationEnabled() {
+  QJniObject ctx = AndroidCommons::getActivity();
+  jboolean ignoring = QJniObject::callStaticMethod<jboolean>(
+      BATTERY_HELPER_CLASS, "isIgnoringBatteryOptimizations",
+      "(Landroid/content/Context;)Z", ctx.object<jobject>());
+  return !ignoring;
+}
+
+// static
+bool AndroidBatteryOptimizer::canTriggerIntent() {
+  QJniObject ctx = AndroidCommons::getActivity();
+  return (bool)QJniObject::callStaticMethod<jboolean>(
+      BATTERY_HELPER_CLASS, "hasRequestIgnoreBatteryOptimizationsPermission",
+      "(Landroid/content/Context;)Z", ctx.object<jobject>());
+}
+
+// static
+void AndroidBatteryOptimizer::triggerBatteryOptimizationIntent() {
+  QJniObject ctx = AndroidCommons::getActivity();
+  QJniObject intent = QJniObject::callStaticObjectMethod(
+      BATTERY_HELPER_CLASS, "getRequestIgnoreBatteryOptimizationsIntent",
+      "(Landroid/content/Context;)Landroid/content/Intent;",
+      ctx.object<jobject>());
+  if (!intent.isValid()) {
+    return;
+  }
+  ctx.callMethod<void>("startActivity", "(Landroid/content/Intent;)V",
+                       intent.object<jobject>());
+}

src/platforms/android/androidbatteryoptimizer.h

@@ -0,0 +1,23 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef ANDROIDBATTERYOPTIMIZER_H
+#define ANDROIDBATTERYOPTIMIZER_H
+
+class AndroidBatteryOptimizer {
+ public:
+  // true  → optimization IS enabled (VPN at risk)
+  // false → app is exempted (good)
+  static bool batteryOptimizationEnabled();
+
+  // true → app holds REQUEST_IGNORE_BATTERY_OPTIMIZATIONS; system dialog shown
+  // directly
+  static bool canTriggerIntent();
+
+  // Opens battery settings (system dialog or app details depending on
+  // permission/SDK)
+  static void triggerBatteryOptimizationIntent();
+};
+
+#endif  // ANDROIDBATTERYOPTIMIZER_H

src/platforms/android/sources.cmake

@@ -7,6 +7,8 @@ target_sources(shared-sources INTERFACE
      ${CMAKE_CURRENT_SOURCE_DIR}/platforms/android/androidcryptosettings.cpp
      ${CMAKE_CURRENT_SOURCE_DIR}/platforms/android/androidcommons.cpp
      ${CMAKE_CURRENT_SOURCE_DIR}/platforms/android/androidcommons.h
+     ${CMAKE_CURRENT_SOURCE_DIR}/platforms/android/androidbatteryoptimizer.h
+     ${CMAKE_CURRENT_SOURCE_DIR}/platforms/android/androidbatteryoptimizer.cpp
 )
 
 target_link_libraries(shared-sources INTERFACE -ljnigraphics)

src/settingslist.h

@@ -335,6 +335,16 @@ SETTING_BOOL(onboardingCompleted,        // getter
              false                       // sensitive (do not log)
 )
 
+SETTING_BOOL(hasDismissedBatteryOptimization,        // getter
+             setHasDismissedBatteryOptimization,     // setter
+             removeHasDismissedBatteryOptimization,  // remover
+             hasHasDismissedBatteryOptimization,     // has
+             "hasDismissedBatteryOptimization",      // key
+             false,                                  // default value
+             true,  // remove when reset (clears on logout)
+             false  // sensitive (do not log)
+)
+
 SETTING_BOOL(onboardingDataCollectionEnabled,        // getter
              setOnboardingDataCollectionEnabled,     // setter
              removeOnboardingDataCollectionEnabled,  // remover

src/translations/strings.yaml

@@ -359,6 +359,12 @@ settings:
   dnsSettingsWarning: These options may cause some websites to break or not display content correctly.
   dnsSettingsInputPlaceholder: Enter custom DNS
   dnsSettingsDisconnectWarning: Changing these settings will cause the VPN to disconnect and reconnect automatically.
+  batteryOptimizationWarning:
+    value: On some devices, Mozilla VPN may be disconnected in the background. If you’ve experienced this, allow it to run in the background.
+    comment: Warning shown in the settings screen on Android when battery optimization is enabled for the app.
+  batteryOptimizationWarningButton:
+    value: Allow background permissions
+    comment: Button label for the call to action to allow background permissions on Android.
   appExclusionClearAllApps:
     value: Clear all
     comment: Button label to clear all apps from the exclusions list

src/ui/CMakeLists.txt

@@ -167,7 +167,10 @@ target_include_directories(mozillavpn-uiplugin PUBLIC
     ${CMAKE_CURRENT_SOURCE_DIR}/types
 )
 
+target_sources(mozillavpn-ui PRIVATE singletons/BatteryOptimizer.h)
+
 if(${CMAKE_SYSTEM_NAME} STREQUAL "Android")
+    target_compile_definitions(mozillavpn-ui PRIVATE MZ_ANDROID)
     target_sources(mozillavpn-ui PRIVATE singletons/VPNAndroidUtils.h)
     target_sources(mozillavpn-ui PRIVATE singletons/VPNAndroidCommons.h)
 endif()

src/ui/screens/settings/ViewSettingsMenu.qml

@@ -24,6 +24,30 @@ MZViewBase {
         spacing: MZTheme.theme.windowMargin
         Layout.fillWidth: true
 
+        MZInformationCard {
+            id: batteryOptimizationCard
+            visible: !MZSettings.hasDismissedBatteryOptimization
+                     && BatteryOptimizer.batteryOptimizationEnabled
+                     && BatteryOptimizer.canTriggerIntent
+            cardType: MZInformationCard.CardType.Warning
+            Layout.preferredWidth: Math.min(window.width - MZTheme.theme.windowMargin * 2,
+                                            MZTheme.theme.navBarMaxWidth)
+            Layout.minimumHeight: batteryWarningText.height + MZTheme.theme.windowMargin * 2
+            Layout.alignment: Qt.AlignHCenter
+
+            _infoContent: MZTextBlock {
+                id: batteryWarningText
+                Layout.fillWidth: true
+                text: MZI18n.SettingsBatteryOptimizationWarning
+            }
+            _buttonAction: function() {
+                    MZSettings.hasDismissedBatteryOptimization = true
+                    BatteryOptimizer.triggerBatteryOptimizationIntent()
+            }
+            _buttonText : MZI18n.SettingsBatteryOptimizationWarningButton
+
+        }
+
         ColumnLayout {
             Layout.fillWidth: true
             Layout.leftMargin: MZTheme.theme.windowMargin /2

src/ui/singletons/BatteryOptimizer.h

@@ -0,0 +1,54 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef BATTERYOPTIMIZER_H
+#define BATTERYOPTIMIZER_H
+
+#include <QObject>
+#include <QQmlEngine>
+
+#ifdef MZ_ANDROID
+#  include "platforms/android/androidbatteryoptimizer.h"
+#endif
+
+class BatteryOptimizer : public QObject {
+  Q_OBJECT
+  QML_ELEMENT
+  QML_SINGLETON
+
+  Q_PROPERTY(bool batteryOptimizationEnabled READ batteryOptimizationEnabled
+                 NOTIFY stateChanged)
+  Q_PROPERTY(bool canTriggerIntent READ canTriggerIntent NOTIFY stateChanged)
+
+ public:
+  bool batteryOptimizationEnabled() const {
+#ifdef MZ_ANDROID
+    return AndroidBatteryOptimizer::batteryOptimizationEnabled();
+#else
+    return false;
+#endif
+  }
+
+  bool canTriggerIntent() const {
+#ifdef MZ_ANDROID
+    return AndroidBatteryOptimizer::canTriggerIntent();
+#else
+    return false;
+#endif
+  }
+
+  Q_INVOKABLE void triggerBatteryOptimizationIntent() {
+#ifdef MZ_ANDROID
+    AndroidBatteryOptimizer::triggerBatteryOptimizationIntent();
+#endif
+  }
+
+  // Call from QML after returning from the settings screen to refresh bindings.
+  Q_INVOKABLE void refreshState() { emit stateChanged(); }
+
+ signals:
+  void stateChanged();
+};
+
+#endif  // BATTERYOPTIMIZER_H