settings: Add browser preference setting ui

The translation for the label is taken from zulip-mobile.

The UI currently does not have a design, and is made to be as simple as
possible to implement for now.

Fixes: #1228

Signed-off-by: Zixuan James Li <[email protected]>

Author: PIG208

assets/l10n/app_en.arb

@@ -803,6 +803,10 @@
   "@themeSettingSystem": {
     "description": "Label for system theme setting."
   },
+  "openLinksWithInAppBrowser": "Open links with in-app browser",
+  "@openLinksWithInAppBrowser": {
+    "description": "Label for toggling setting to open links with in-app browser"
+  },
   "pollWidgetQuestionMissing": "No question.",
   "@pollWidgetQuestionMissing": {
     "description": "Text to display for a poll when the question is missing"

lib/generated/l10n/zulip_localizations.dart

@@ -1173,6 +1173,12 @@ abstract class ZulipLocalizations {
   /// **'System'**
   String get themeSettingSystem;
 
+  /// Label for toggling setting to open links with in-app browser
+  ///
+  /// In en, this message translates to:
+  /// **'Open links with in-app browser'**
+  String get openLinksWithInAppBrowser;
+
   /// Text to display for a poll when the question is missing
   ///
   /// In en, this message translates to:

lib/generated/l10n/zulip_localizations_ar.dart

@@ -628,6 +628,9 @@ class ZulipLocalizationsAr extends ZulipLocalizations {
   @override
   String get themeSettingSystem => 'System';
 
+  @override
+  String get openLinksWithInAppBrowser => 'Open links with in-app browser';
+
   @override
   String get pollWidgetQuestionMissing => 'No question.';
 

lib/generated/l10n/zulip_localizations_en.dart

@@ -628,6 +628,9 @@ class ZulipLocalizationsEn extends ZulipLocalizations {
   @override
   String get themeSettingSystem => 'System';
 
+  @override
+  String get openLinksWithInAppBrowser => 'Open links with in-app browser';
+
   @override
   String get pollWidgetQuestionMissing => 'No question.';
 

lib/generated/l10n/zulip_localizations_ja.dart

@@ -628,6 +628,9 @@ class ZulipLocalizationsJa extends ZulipLocalizations {
   @override
   String get themeSettingSystem => 'System';
 
+  @override
+  String get openLinksWithInAppBrowser => 'Open links with in-app browser';
+
   @override
   String get pollWidgetQuestionMissing => 'No question.';
 

lib/generated/l10n/zulip_localizations_nb.dart

@@ -628,6 +628,9 @@ class ZulipLocalizationsNb extends ZulipLocalizations {
   @override
   String get themeSettingSystem => 'System';
 
+  @override
+  String get openLinksWithInAppBrowser => 'Open links with in-app browser';
+
   @override
   String get pollWidgetQuestionMissing => 'No question.';
 

lib/generated/l10n/zulip_localizations_pl.dart

@@ -628,6 +628,9 @@ class ZulipLocalizationsPl extends ZulipLocalizations {
   @override
   String get themeSettingSystem => 'System';
 
+  @override
+  String get openLinksWithInAppBrowser => 'Open links with in-app browser';
+
   @override
   String get pollWidgetQuestionMissing => 'Brak pytania.';
 

lib/generated/l10n/zulip_localizations_ru.dart

@@ -628,6 +628,9 @@ class ZulipLocalizationsRu extends ZulipLocalizations {
   @override
   String get themeSettingSystem => 'System';
 
+  @override
+  String get openLinksWithInAppBrowser => 'Open links with in-app browser';
+
   @override
   String get pollWidgetQuestionMissing => 'Нет вопроса.';
 

lib/generated/l10n/zulip_localizations_sk.dart

@@ -628,6 +628,9 @@ class ZulipLocalizationsSk extends ZulipLocalizations {
   @override
   String get themeSettingSystem => 'System';
 
+  @override
+  String get openLinksWithInAppBrowser => 'Open links with in-app browser';
+
   @override
   String get pollWidgetQuestionMissing => 'Bez otázky.';
 

lib/widgets/settings.dart

@@ -24,11 +24,50 @@ class SettingsPage extends StatelessWidget {
       appBar: ZulipAppBar(
         title: Text(zulipLocalizations.settingsPageTitle)),
       body: Column(children: [
+        _BrowserPreferenceSetting(),
         _ThemeSetting(),
       ]));
   }
 }
 
+class _BrowserPreferenceSetting extends StatefulWidget {
+  const _BrowserPreferenceSetting();
+
+  @override
+  State<_BrowserPreferenceSetting> createState() => _BrowserPreferenceSettingState();
+}
+
+class _BrowserPreferenceSettingState extends State<_BrowserPreferenceSetting> {
+  late bool openLinksWithInAppBrowser;
+
+  @override
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    openLinksWithInAppBrowser =
+      GlobalStoreWidget.of(context).globalSettings.effectiveBrowserPreference
+      == BrowserPreference.embedded;
+  }
+
+  void _handleChange(bool openLinksWithInAppBrowser) {
+    GlobalStoreWidget.of(context).updateGlobalSettings(
+      GlobalSettingsCompanion(browserPreference: Value(
+        openLinksWithInAppBrowser ? BrowserPreference.embedded
+                                  : BrowserPreference.external)));
+    setState(() {
+      this.openLinksWithInAppBrowser = openLinksWithInAppBrowser;
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final zulipLocalizations = ZulipLocalizations.of(context);
+    return SwitchListTile.adaptive(
+      title: Text(zulipLocalizations.openLinksWithInAppBrowser),
+      value: openLinksWithInAppBrowser,
+      onChanged: _handleChange);
+  }
+}
+
 class _ThemeSetting extends StatefulWidget {
   const _ThemeSetting();
 

test/flutter_checks.dart

@@ -69,6 +69,10 @@ extension RadioListTileChecks<T> on Subject<RadioListTile<T>> {
   Subject<bool> get checked => has((x) => x.checked, 'checked');
 }
 
+extension SwitchListTileChecks<T> on Subject<SwitchListTile> {
+  Subject<bool> get value => has((x) => x.value, 'value');
+}
+
 extension TextChecks on Subject<Text> {
   Subject<String?> get data => has((t) => t.data, 'data');
   Subject<TextStyle?> get style => has((t) => t.style, 'style');

test/widgets/settings_test.dart

@@ -1,4 +1,5 @@
 import 'package:checks/checks.dart';
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:zulip/model/settings.dart';
@@ -24,6 +25,43 @@ void main() {
     await tester.pump();
   }
 
+  group('BrowserPreference', () {
+    Finder useInAppBrowserSwitchFinder = find.ancestor(
+      of: find.text('Open links with in-app browser'),
+      matching: find.byType(SwitchListTile));
+
+    void checkSwitchAndGlobalSettings(WidgetTester tester, {
+      required bool useInAppBrowser,
+    }) {
+      check(tester.widget<SwitchListTile>(useInAppBrowserSwitchFinder))
+        .value.equals(useInAppBrowser);
+      check(testBinding.globalStore).globalSettings.effectiveBrowserPreference.equals(
+        useInAppBrowser ? BrowserPreference.embedded : BrowserPreference.external);
+    }
+
+    testWidgets('smoke', (tester) async {
+      await testBinding.globalStore.updateGlobalSettings(
+        eg.globalSettings(
+          browserPreference: BrowserPreference.external).toCompanion(false));
+      await prepare(tester);
+      checkSwitchAndGlobalSettings(tester, useInAppBrowser: false);
+
+      await tester.tap(useInAppBrowserSwitchFinder);
+      await tester.pump();
+      checkSwitchAndGlobalSettings(tester, useInAppBrowser: true);
+    });
+
+    testWidgets('use platform-specific default browser preference', (tester) async {
+      await prepare(tester);
+      final defaultUseInAppBrowser = defaultTargetPlatform == TargetPlatform.android;
+      checkSwitchAndGlobalSettings(tester, useInAppBrowser: defaultUseInAppBrowser);
+
+      await tester.tap(useInAppBrowserSwitchFinder);
+      await tester.pump();
+      checkSwitchAndGlobalSettings(tester, useInAppBrowser: !defaultUseInAppBrowser);
+    }, variant: TargetPlatformVariant({TargetPlatform.android, TargetPlatform.iOS}));
+  });
+
   group('ThemeSetting', () {
     Finder findRadioListTileWithTitle(String title) => find.ancestor(
       of: find.text(title),