mirror of
https://github.com/firebase/firebase-ios-sdk
synced 2026-11-10 22:45:59 +05:45
Maksym Malyhin
1bc3255436
* FIS: Throw exception on incomplete Firebase config. * API docs updated. * FirebaseInstallations bump minor version: 1.1.0 * Fix tests * Text fixed * Make exception message more informative * Fix Remote Config tests. * Tests updated to use GCMSenderID if projectID is not available. * Use `GCMSenderID` when `projectID` is not available. * ./scripts/style.sh * Comments * GCMSenderID and projectID validation updated. * Comment * FirebaseInstallations: version bump to 1.0.1. * FIS changelog * FirebaseInstallations: version bump to 1.1.0 * FIS and Core changelogs. * Changelogs remove GCMSenderID * Typo * Typo * fix link * Revert Core changelog * FIS changelog fix.
121 lines
5.4 KiB
Objective-C
121 lines
5.4 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`.
|
|
* @returns An instance of `Installations` for `FirebaseApp.defaultApp().
|
|
* @throw Throws an exception if the default app is not configured yet or required `FirebaseApp`
|
|
* options are missing.
|
|
*/
|
|
+ (FIRInstallations *)installations NS_SWIFT_NAME(installations());
|
|
|
|
/**
|
|
* Returns an instance of `Installations` for an application.
|
|
* @param application A configured `FirebaseApp` instance.
|
|
* @returns An instance of `Installations` corresponding to the passed application.
|
|
* @throw Throws an exception if required `FirebaseApp` options are missing.
|
|
*/
|
|
+ (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
|