mirror of
https://github.com/firebase/firebase-ios-sdk
synced 2026-11-09 22:36:01 +05:45
Maksym Malyhin
27384c0a2c
* Unrecoverable errors: basic unit tests defined.
* Registration Error models introduced.
* Storage: storage version handling fix.
* Formatting.
* Get Installation: return registration error from previous attempt.
* Retry registration request on configuration change.
* Store unrecoverable registration error.
* FIRInstallations Swift API improvements.
* Add Swift integration tests
* Revert "Add Swift integration tests"
This reverts commit a8e06418be.
* Invalid config integration tests and fixes.
* Missing tests and cleanup.
* ./scripts/style.sh
* Log messages.
* More elaborative log message. Typo.
* Reorganize imports and umberella header to fix Swift compilation errors.
* Formatting.
119 lines
5.3 KiB
Objective-C
119 lines
5.3 KiB
Objective-C
/*
|
|
* Copyright 2019 Google
|
|
*
|
|
* 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 <Foundation/Foundation.h>
|
|
|
|
@class FIRApp;
|
|
@class FIRInstallationsAuthTokenResult;
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/** A notification with this name is sent each time an installation is created or deleted. */
|
|
FOUNDATION_EXPORT const NSNotificationName FIRInstallationIDDidChangeNotification;
|
|
/** `userInfo` key for the `FirebaseApp.name` in `FIRInstallationIDDidChangeNotification`. */
|
|
FOUNDATION_EXPORT NSString *const kFIRInstallationIDDidChangeNotificationAppNameKey;
|
|
|
|
/**
|
|
* An installation ID handler block.
|
|
* @param identifier The installation ID string if exists or `nil` otherwise.
|
|
* @param error The error when `identifier == nil` or `nil` otherwise.
|
|
*/
|
|
typedef void (^FIRInstallationsIDHandler)(NSString *__nullable identifier,
|
|
NSError *__nullable error)
|
|
NS_SWIFT_NAME(InstallationsIDHandler);
|
|
|
|
/**
|
|
* An authorization token handler block.
|
|
* @param tokenResult An instance of `InstallationsAuthTokenResult` in case of success or `nil`
|
|
* otherwise.
|
|
* @param error The error when `tokenResult == nil` or `nil` otherwise.
|
|
*/
|
|
typedef void (^FIRInstallationsTokenHandler)(
|
|
FIRInstallationsAuthTokenResult *__nullable tokenResult, NSError *__nullable error)
|
|
NS_SWIFT_NAME(InstallationsTokenHandler);
|
|
|
|
/**
|
|
* The class provides API for Firebase Installations.
|
|
* Each configured `FirebaseApp` has a corresponding single instance of `Installations`.
|
|
* An instance of the class provides access to the installation info for the `FirebaseApp` as well
|
|
* as the ability to delete it. A Firebase Installation is unique by `FirebaseApp.name` and
|
|
* `FirebaseApp.options.googleAppID` .
|
|
*/
|
|
NS_SWIFT_NAME(Installations)
|
|
@interface FIRInstallations : NSObject
|
|
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
|
|
/**
|
|
* Returns a default instance of `Installations`.
|
|
* @return Returns an instance of `Installations` for `FirebaseApp.defaultApp(). Throws an exception
|
|
* if the default app is not configured yet.
|
|
*/
|
|
+ (FIRInstallations *)installations NS_SWIFT_NAME(installations());
|
|
|
|
/**
|
|
* Returns an instance of `Installations` for an application.
|
|
* @param application A configured `FirebaseApp` instance.
|
|
* @return Returns an instance of `Installations` corresponding to the passed application.
|
|
*/
|
|
+ (FIRInstallations *)installationsWithApp:(FIRApp *)application NS_SWIFT_NAME(installations(app:));
|
|
|
|
/**
|
|
* The method creates or retrieves an installation ID. The installation ID is a stable identifier
|
|
* that uniquely identifies the app instance. NOTE: If the application already has an existing
|
|
* FirebaseInstanceID then the InstanceID identifier will be used.
|
|
* @param completion A completion handler which is invoked when the operation completes. See
|
|
* `InstallationsIDHandler` for additional details.
|
|
*/
|
|
- (void)installationIDWithCompletion:(FIRInstallationsIDHandler)completion;
|
|
|
|
/**
|
|
* Retrieves (locally if it exists or from the server) a valid authorization token. An existing
|
|
* token may be invalidated or expired, so it is recommended to fetch the auth token before each
|
|
* server request. The method does the same as `Installations.authTokenForcingRefresh(:,
|
|
* completion:)` with forcing refresh `NO`.
|
|
* @param completion A completion handler which is invoked when the operation completes. See
|
|
* `InstallationsTokenHandler` for additional details.
|
|
*/
|
|
- (void)authTokenWithCompletion:(FIRInstallationsTokenHandler)completion;
|
|
|
|
/**
|
|
* Retrieves (locally or from the server depending on `forceRefresh` value) a valid authorization
|
|
* token. An existing token may be invalidated or expire, so it is recommended to fetch the auth
|
|
* token before each server request. This method should be used with `forceRefresh == YES` when e.g.
|
|
* a request with the previously fetched auth token failed with "Not Authorized" error.
|
|
* @param forceRefresh If `YES` then the locally cached auth token will be ignored and a new one
|
|
* will be requested from the server. If `NO`, then the locally cached auth token will be returned
|
|
* if exists and has not expired yet.
|
|
* @param completion A completion handler which is invoked when the operation completes. See
|
|
* `InstallationsTokenHandler` for additional details.
|
|
*/
|
|
- (void)authTokenForcingRefresh:(BOOL)forceRefresh
|
|
completion:(FIRInstallationsTokenHandler)completion;
|
|
|
|
/**
|
|
* Deletes all the installation data including the unique identifier, auth tokens and
|
|
* all related data on the server side. A network connection is required for the method to
|
|
* succeed. If fails, the existing installation data remains untouched.
|
|
* @param completion A completion handler which is invoked when the operation completes. `error ==
|
|
* nil` indicates success.
|
|
*/
|
|
- (void)deleteWithCompletion:(void (^)(NSError *__nullable error))completion;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|