mirror of
https://github.com/firebase/firebase-ios-sdk
synced 2026-11-11 22:55:59 +05:45
Morgan Chen
25c29f5928
* Revert "Include subheaders in script output (#10212)"
This reverts commit 11313da887.
* make app distro swizzling compatible
* add changelog
* fix build
107 lines
3.6 KiB
Objective-C
107 lines
3.6 KiB
Objective-C
// Copyright 2020 Google LLC
|
|
//
|
|
// 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.
|
|
|
|
@class FIRAppDistributionRelease;
|
|
@class UIApplication;
|
|
#import <Foundation/Foundation.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
* The Firebase App Distribution API provides methods to check for update to
|
|
* the app and returns information that enables updating the app.
|
|
*
|
|
* By default, Firebase App Distribution is initialized with `FirebaseApp.configure()`.
|
|
*
|
|
* Note: The App Distribution class cannot be subclassed. If this makes testing difficult,
|
|
* we suggest using a wrapper class or a protocol extension.
|
|
*/
|
|
|
|
NS_EXTENSION_UNAVAILABLE_IOS("Firebase App Distribution is not supported for iOS extensions.")
|
|
NS_SWIFT_NAME(AppDistribution)
|
|
@interface FIRAppDistribution : NSObject
|
|
|
|
/// Returns true if the App Distribution tester is signed in.
|
|
@property(nonatomic, readonly) BOOL isTesterSignedIn;
|
|
|
|
/** :nodoc: */
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
|
|
/**
|
|
* Sign-in the App Distribution tester
|
|
*/
|
|
- (void)signInTesterWithCompletion:(void (^)(NSError *_Nullable error))completion
|
|
NS_SWIFT_NAME(signInTester(completion:));
|
|
|
|
/**
|
|
* Check to see whether a new distribution is available
|
|
*/
|
|
- (void)checkForUpdateWithCompletion:(void (^)(FIRAppDistributionRelease *_Nullable_result release,
|
|
NSError *_Nullable error))completion
|
|
NS_SWIFT_NAME(checkForUpdate(completion:));
|
|
|
|
/**
|
|
* Sign out App Distribution tester
|
|
*/
|
|
- (void)signOutTester;
|
|
|
|
/**
|
|
* Handle an App Distribution URL, for example a link to download a new pre-release version.
|
|
* Call this method in your app delegate's `openURL` implementation if swizzling is disabled.
|
|
*/
|
|
- (BOOL)application:(UIApplication *)application
|
|
openURL:(NSURL *)url
|
|
options:(NSDictionary<NSString *, id> *)options;
|
|
|
|
/**
|
|
* Accesses the singleton App Distribution instance.
|
|
*
|
|
* @return The singleton App Distribution instance.
|
|
*/
|
|
+ (instancetype)appDistribution NS_SWIFT_NAME(appDistribution());
|
|
|
|
@end
|
|
|
|
/// The error domain for codes in the `FIRAppDistributionError` enum.
|
|
// clang-format off
|
|
// clang-format12 will merge lines and exceed 100 character limit.
|
|
FOUNDATION_EXPORT NSString *const FIRAppDistributionErrorDomain
|
|
NS_SWIFT_NAME(AppDistributionErrorDomain);
|
|
|
|
/// The key for finding error details in the `NSError`'s `userInfo`.
|
|
FOUNDATION_EXPORT NSString *const FIRAppDistributionErrorDetailsKey
|
|
NS_SWIFT_NAME(AppDistributionErrorDetailsKey);
|
|
// clang-format on
|
|
|
|
/**
|
|
* Error codes representing sign in or version check failure reasons.
|
|
*/
|
|
typedef NS_ERROR_ENUM(FIRAppDistributionErrorDomain, FIRAppDistributionError){
|
|
/// Returned when an unknown error occurred.
|
|
FIRAppDistributionErrorUnknown = 0,
|
|
|
|
/// Returned when App Distribution failed to authenticate the user.
|
|
FIRAppDistributionErrorAuthenticationFailure = 1,
|
|
|
|
/// Returned when sign-in was cancelled.
|
|
FIRAppDistributionErrorAuthenticationCancelled = 2,
|
|
|
|
/// Returned when the network was unavailable to make requests or
|
|
/// the request timed out.
|
|
FIRAppDistributionErrorNetworkFailure = 3,
|
|
|
|
} NS_SWIFT_NAME(AppDistributionError);
|
|
|
|
NS_ASSUME_NONNULL_END
|