DeviceInformationChange

public protocol DeviceInformationChange : HttpOperation

The object that updates a device information. The device information change can be used

• to modify the name of the device and/or

• to change the Firebase registration token or to disable push notifications.

  Warning

  If neither name(_:) or fcmRegistrationToken(_:) are provided, the provided onSuccess(_:) object will be called when DeviceInformationChange.execute() is invoked.

Usage example:

client.operations.deviceInformationChange
    .name(newName)
    .fcmRegistrationToken(fcmToken)
    .onSuccess { in
        ...
    }
    .onError { error in
        ...
    }
    .execute()

client.operations.deviceInformationChange
    .name(newName)
    .disablePushNotifications()
    .onSuccess { in
        ...
    }
    .onError { error in
        ...
    }
    .execute()

Synchronization with retry strategy

The retry strategy can be useful when updating the Firebase Cloud Messaging token. But since it is not known when the token will be updated, synchronization is necessary and should be done by the caller. Below a sample code is provided that solves the synchronization using dispatch queues and groups.

import Firebase

class SampleAppMessagingService {
    let queue = DispatchQueue(label: "com.sample.fcm.update.serial")
}

extension SampleAppMessagingService: MessagingDelegate {
    func messaging(_: Messaging, didReceiveRegistrationToken fcmToken: String?) {
        guard let fcmToken else { return }
        processNewToken(fcmToken, client)
    }

    private func processNewToken(_ firebaseRegistrationToken: String, _ client: MobileAuthenticationClient) {
        queue.async {
            let group = DispatchGroup()
            group.enter()
            DispatchQueue.global().async {
                client.operations.deviceInformationChange
                    .fcmRegistrationToken(firebaseRegistrationToken)
                    .retryPolicy(.constant(maxRetries: 3, delayInSeconds: 30))
                    .onSuccess {
                        defer { group.leave() }
                        // Firebase registration token successfully updated
                    }
                    .onError { _ in
                        defer { group.leave() }
                        // handle unsuccessful update
                    }
                    .execute()
            }
            group.wait()
        }
    }
}