Add AppLockSetupBiometricsScreen. (#1942)

ElementX/Sources/Generated/Strings.swift

@@ -220,6 +220,8 @@ public enum L10n {
   public static var commonError: String { return L10n.tr("Localizable", "common_error") }
   /// Everyone
   public static var commonEveryone: String { return L10n.tr("Localizable", "common_everyone") }
+  /// Face ID
+  public static var commonFaceIdIos: String { return L10n.tr("Localizable", "common_face_id_ios") }
   /// File
   public static var commonFile: String { return L10n.tr("Localizable", "common_file") }
   /// Forward message
@@ -258,6 +260,8 @@ public enum L10n {
   public static var commonNoResults: String { return L10n.tr("Localizable", "common_no_results") }
   /// Offline
   public static var commonOffline: String { return L10n.tr("Localizable", "common_offline") }
+  /// Optic ID
+  public static var commonOpticIdIos: String { return L10n.tr("Localizable", "common_optic_id_ios") }
   /// Password
   public static var commonPassword: String { return L10n.tr("Localizable", "common_password") }
   /// People
@@ -344,6 +348,8 @@ public enum L10n {
   public static var commonTopic: String { return L10n.tr("Localizable", "common_topic") }
   /// What is this room about?
   public static var commonTopicPlaceholder: String { return L10n.tr("Localizable", "common_topic_placeholder") }
+  /// Touch ID
+  public static var commonTouchIdIos: String { return L10n.tr("Localizable", "common_touch_id_ios") }
   /// Unable to decrypt
   public static var commonUnableToDecrypt: String { return L10n.tr("Localizable", "common_unable_to_decrypt") }
   /// Invites couldn't be sent to one or more users.
@@ -648,6 +654,10 @@ public enum L10n {
   public static var screenAnalyticsSettingsReadTermsContentLink: String { return L10n.tr("Localizable", "screen_analytics_settings_read_terms_content_link") }
   /// Share analytics data
   public static var screenAnalyticsSettingsShareData: String { return L10n.tr("Localizable", "screen_analytics_settings_share_data") }
+  /// biometric authentication
+  public static var screenAppLockBiometricAuthentication: String { return L10n.tr("Localizable", "screen_app_lock_biometric_authentication") }
+  /// biometric unlock
+  public static var screenAppLockBiometricUnlock: String { return L10n.tr("Localizable", "screen_app_lock_biometric_unlock") }
   /// Forgot PIN?
   public static var screenAppLockForgotPin: String { return L10n.tr("Localizable", "screen_app_lock_forgot_pin") }
   /// Change PIN code
@@ -666,6 +676,16 @@ public enum L10n {
   public static var screenAppLockSettingsRemovePinAlertMessage: String { return L10n.tr("Localizable", "screen_app_lock_settings_remove_pin_alert_message") }
   /// Remove PIN?
   public static var screenAppLockSettingsRemovePinAlertTitle: String { return L10n.tr("Localizable", "screen_app_lock_settings_remove_pin_alert_title") }
+  /// Allow %1$@
+  public static func screenAppLockSetupBiometricUnlockAllowTitle(_ p1: Any) -> String {
+    return L10n.tr("Localizable", "screen_app_lock_setup_biometric_unlock_allow_title", String(describing: p1))
+  }
+  /// I’d rather use PIN
+  public static var screenAppLockSetupBiometricUnlockSkip: String { return L10n.tr("Localizable", "screen_app_lock_setup_biometric_unlock_skip") }
+  /// Save yourself some time and use %1$@ to unlock the app each time
+  public static func screenAppLockSetupBiometricUnlockSubtitle(_ p1: Any) -> String {
+    return L10n.tr("Localizable", "screen_app_lock_setup_biometric_unlock_subtitle", String(describing: p1))
+  }
   /// Choose PIN
   public static var screenAppLockSetupChoosePin: String { return L10n.tr("Localizable", "screen_app_lock_setup_choose_pin") }
   /// Confirm PIN

ElementX/Sources/Screens/AppLock/AppLockSettingsScreen/AppLockSettingsScreenModels.swift

@@ -28,21 +28,7 @@ struct AppLockSettingsScreenViewState: BindableState {
     var bindings: AppLockSettingsScreenViewStateBindings
     
     var supportsBiometry: Bool { biometryType != .none }
-    var enableBiometryTitle: String {
-        switch biometryType {
-        case .none:
-            return L10n.commonError
-        case .touchID:
-            return L10n.screenAppLockSettingsEnableTouchIdIos
-        case .faceID:
-            return L10n.screenAppLockSettingsEnableFaceIdIos
-        // Requires Xcode 15:
-        // case .opticID:
-        //    L10n.screenAppLockSettingsEnableOpticIdIos
-        @unknown default:
-            return L10n.screenAppLockSettingsEnableBiometricUnlock
-        }
-    }
+    var enableBiometryTitle: String { L10n.screenAppLockSetupBiometricUnlockAllowTitle(biometryType.localizedString) }
 }
 
 struct AppLockSettingsScreenViewStateBindings {

ElementX/Sources/Screens/AppLock/AppLockSetupBiometricsScreen/AppLockSetupBiometricsScreenCoordinator.swift

@@ -0,0 +1,60 @@
+//
+// Copyright 2022 New Vector Ltd
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import Combine
+import SwiftUI
+
+struct AppLockSetupBiometricsScreenCoordinatorParameters {
+    let appLockService: AppLockServiceProtocol
+}
+
+enum AppLockSetupBiometricsScreenCoordinatorAction {
+    case `continue`
+}
+
+final class AppLockSetupBiometricsScreenCoordinator: CoordinatorProtocol {
+    private let parameters: AppLockSetupBiometricsScreenCoordinatorParameters
+    private var viewModel: AppLockSetupBiometricsScreenViewModelProtocol
+    private let actionsSubject: PassthroughSubject<AppLockSetupBiometricsScreenCoordinatorAction, Never> = .init()
+    private var cancellables = Set<AnyCancellable>()
+    
+    var actions: AnyPublisher<AppLockSetupBiometricsScreenCoordinatorAction, Never> {
+        actionsSubject.eraseToAnyPublisher()
+    }
+    
+    init(parameters: AppLockSetupBiometricsScreenCoordinatorParameters) {
+        self.parameters = parameters
+        
+        viewModel = AppLockSetupBiometricsScreenViewModel(appLockService: parameters.appLockService)
+    }
+    
+    func start() {
+        viewModel.actions.sink { [weak self] action in
+            MXLog.info("Coordinator: received view model action: \(action)")
+            
+            guard let self else { return }
+            switch action {
+            case .continue:
+                self.actionsSubject.send(.continue)
+            }
+        }
+        .store(in: &cancellables)
+    }
+        
+    func toPresentable() -> AnyView {
+        AnyView(AppLockSetupBiometricsScreen(context: viewModel.context))
+    }
+}

ElementX/Sources/Screens/AppLock/AppLockSetupBiometricsScreen/AppLockSetupBiometricsScreenModels.swift

@@ -0,0 +1,38 @@
+//
+// Copyright 2022 New Vector Ltd
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import LocalAuthentication
+import SFSafeSymbols
+
+enum AppLockSetupBiometricsScreenViewModelAction {
+    case `continue`
+}
+
+struct AppLockSetupBiometricsScreenViewState: BindableState {
+    /// The supported biometry type on this device.
+    let biometryType: LABiometryType
+    
+    var icon: SFSymbol { biometryType.systemSymbol }
+    var title: String { L10n.screenAppLockSetupBiometricUnlockAllowTitle(biometryType.localizedString) }
+    var subtitle: String { L10n.screenAppLockSetupBiometricUnlockSubtitle(biometryType.localizedString) }
+}
+
+enum AppLockSetupBiometricsScreenViewAction {
+    /// The user would like to use Touch/Face ID.
+    case allow
+    /// The user doesn't want to use biometrics.
+    case skip
+}

ElementX/Sources/Screens/AppLock/AppLockSetupBiometricsScreen/AppLockSetupBiometricsScreenViewModel.swift

@@ -0,0 +1,51 @@
+//
+// Copyright 2022 New Vector Ltd
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import Combine
+import SwiftUI
+
+typealias AppLockSetupBiometricsScreenViewModelType = StateStoreViewModel<AppLockSetupBiometricsScreenViewState, AppLockSetupBiometricsScreenViewAction>
+
+class AppLockSetupBiometricsScreenViewModel: AppLockSetupBiometricsScreenViewModelType, AppLockSetupBiometricsScreenViewModelProtocol {
+    private let appLockService: AppLockServiceProtocol
+    private var actionsSubject: PassthroughSubject<AppLockSetupBiometricsScreenViewModelAction, Never> = .init()
+    
+    var actions: AnyPublisher<AppLockSetupBiometricsScreenViewModelAction, Never> {
+        actionsSubject.eraseToAnyPublisher()
+    }
+
+    init(appLockService: AppLockServiceProtocol) {
+        self.appLockService = appLockService
+        super.init(initialViewState: AppLockSetupBiometricsScreenViewState(biometryType: appLockService.biometryType))
+    }
+    
+    // MARK: - Public
+    
+    override func process(viewAction: AppLockSetupBiometricsScreenViewAction) {
+        MXLog.info("View model: received view action: \(viewAction)")
+        
+        switch viewAction {
+        case .allow:
+            MXLog.info("Enable biometric unlock.")
+            appLockService.biometricUnlockEnabled = true
+            actionsSubject.send(.continue)
+        case .skip:
+            MXLog.info("Disable biometric unlock.")
+            appLockService.biometricUnlockEnabled = false
+            actionsSubject.send(.continue)
+        }
+    }
+}

ElementX/Sources/Screens/AppLock/AppLockSetupBiometricsScreen/AppLockSetupBiometricsScreenViewModelProtocol.swift

@@ -0,0 +1,23 @@
+//
+// Copyright 2022 New Vector Ltd
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import Combine
+
+@MainActor
+protocol AppLockSetupBiometricsScreenViewModelProtocol {
+    var actions: AnyPublisher<AppLockSetupBiometricsScreenViewModelAction, Never> { get }
+    var context: AppLockSetupBiometricsScreenViewModelType.Context { get }
+}

ElementX/Sources/Screens/AppLock/AppLockSetupBiometricsScreen/View/AppLockSetupBiometricsScreen.swift

@@ -0,0 +1,94 @@
+//
+// Copyright 2022 New Vector Ltd
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import Compound
+import SwiftUI
+
+/// The screen shown when setting up App Lock that asks the user whether
+/// the would like to use Face ID/Touch ID instead of entering their PIN code.
+struct AppLockSetupBiometricsScreen: View {
+    @ObservedObject var context: AppLockSetupBiometricsScreenViewModel.Context
+    
+    var body: some View {
+        ScrollView {
+            VStack(spacing: 48) {
+                header
+            }
+            .padding(.horizontal, 16)
+            .padding(.top, UIConstants.iconTopPaddingToNavigationBar)
+            .frame(maxWidth: .infinity)
+        }
+        .toolbar(.visible, for: .navigationBar)
+        .background(Color.compound.bgCanvasDefault.ignoresSafeArea())
+        .safeAreaInset(edge: .bottom) {
+            buttons
+                .padding(.top, 16)
+                .padding(.horizontal, 16)
+                .background(Color.compound.bgCanvasDefault.ignoresSafeArea())
+        }
+    }
+    
+    var header: some View {
+        VStack(spacing: 8) {
+            Image(systemSymbol: context.viewState.icon)
+                .font(.system(size: 72))
+                .padding(.top, 58)
+                .padding(.bottom, 26)
+            
+            Text(context.viewState.title)
+                .font(.compound.headingMDBold)
+                .multilineTextAlignment(.center)
+                .foregroundColor(.compound.textPrimary)
+            
+            Text(context.viewState.subtitle)
+                .font(.compound.bodyMD)
+                .multilineTextAlignment(.center)
+                .foregroundColor(.compound.textSecondary)
+        }
+    }
+    
+    var buttons: some View {
+        VStack(spacing: 16) {
+            Button(context.viewState.title) { context.send(viewAction: .allow) }
+                .buttonStyle(.compound(.primary))
+            
+            Button { context.send(viewAction: .skip) } label: {
+                Text(L10n.screenAppLockSetupBiometricUnlockSkip)
+                    .font(.compound.bodyLGSemibold)
+                    .padding(14)
+            }
+        }
+    }
+}
+
+// MARK: - Previews
+
+struct AppLockSetupBiometricsScreen_Previews: PreviewProvider, TestablePreview {
+    static let faceIDViewModel = AppLockSetupBiometricsScreenViewModel(appLockService: AppLockServiceMock.mock(biometryType: .faceID))
+    static let touchIDViewModel = AppLockSetupBiometricsScreenViewModel(appLockService: AppLockServiceMock.mock(biometryType: .touchID))
+    
+    static var previews: some View {
+        NavigationStack {
+            AppLockSetupBiometricsScreen(context: faceIDViewModel.context)
+        }
+        .previewDisplayName("Face ID")
+        
+        NavigationStack {
+            AppLockSetupBiometricsScreen(context: touchIDViewModel.context)
+        }
+        .previewDisplayName("Touch ID")
+    }
+}

ElementX/Sources/Screens/AppLock/Common/LABiometryType.swift

@@ -0,0 +1,56 @@
+//
+// Copyright 2023 New Vector Ltd
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import LocalAuthentication
+import SFSafeSymbols
+
+extension LABiometryType {
+    /// The SF Symbol that represents the biometry type.
+    var systemSymbol: SFSymbol {
+        switch self {
+        case .none:
+            MXLog.error("Invalid presentation: Biometry not supported.")
+            return .viewfinder
+        case .touchID:
+            return .touchid
+        case .faceID:
+            return .faceid
+        // Requires Xcode 15:
+        // case .opticID:
+        //    .opticid
+        @unknown default:
+            return .viewfinder
+        }
+    }
+    
+    /// The localized string for the biometry type.
+    var localizedString: String {
+        switch self {
+        case .none:
+            MXLog.error("Invalid presentation: Biometry not supported.")
+            return L10n.screenAppLockBiometricUnlock
+        case .touchID:
+            return L10n.commonTouchIdIos
+        case .faceID:
+            return L10n.commonFaceIdIos
+        // Requires Xcode 15:
+        // case .opticID:
+        //    L10n.commonOpticIdIos
+        @unknown default:
+            return L10n.screenAppLockBiometricUnlock
+        }
+    }
+}