Files
firebase-ios-sdk/Firebase/InAppMessaging/Public/FIRInAppMessaging.h
T
christibbs 93ebe6f9bf FIAM Programmatic triggers (#3081)
* Add card scene to storyboard, use IBDesignable rounded corners view

* Use IBdesignable rounded corners view for modal message

* Add card message type

* Parse card message type, add new fields for secondary actions and landscape URLs to view model classes

* Display a really basic card message

* Naive landscape image loading (needs error handling)

* Quick bug fix

* Wire up Display to show cards

* Wire up Display to show cards

* Fix tablet width

* Pick right image for orientation

* Remove placeholder image sizing constraints at build time

* Add more test functionality

* Better image sizes

* Size message image out

* Switch to body text view rather than body label

* Make the body text view scrollable. Set correct text color on button.

* Hook up buttons and text color

* Include action URL in messageClicked callback

* Fix action URL

* Update pod specs

* Update message clicked delegate to pass an action object, not just the actionURL

* Change podspec versions back, hook up background color

* Don't animate scroll to top on scroll view

* Fix text scrolling bug

* Fix portrait and landscape fetching code. Fix background color bug

* Flesh out FIRIAMMessageContentDataWithImageURLTests

* Fix up FIRIAMFetchFlowTests

* Fix up FIRIAMMessageClientCacheTests

* Fix up FIRIAMMessageDisplayForTesting

* Fix fetching in FIRIAMMessageContentDataWithImageURL

* Tests for message parsing

* Fix up view controllers for banner, modal, image only. Add a view controller for testing card

* Add required vertical compression resistance for primary and secondary action button

* Add UI tests for card view controller

* Add back deprecated messageClicked: method, call it if the newer method isn't implemented. Make all display delegate methods optional.

* Run scripts/styles.sh

* Add FIRIAMDisplayExecutor logic to display an in-app message programmatically.

* Add a public method on FIRInAppMessaging that triggers a message to be shown via the display executor

* Add button to test app that programmatically triggers a message

* Add unit tests for display executor programmatic trigger flow

* Documentation cleanup

* Fix style in FIRIAMMessageContentDataWithImageURLTests.m

* Add missing copyright notices

* Bump versions of both FIAM SDKS

* Remove default.profraw

* Address some logging punctuation nits. Cancel landscape image load if portrait image load fails.

* Add missing error flow in image fetch. A few comment nits.

* Shorten up init method for CardDisplayMessage

* Documentation updates

* Deintegrate cocoa pods

* Include landscape image data in test image load class

* Fix Swift naming for InAppMessagingAction in UItests

* Remove card message initializer from public API, place into a private header

* Mark some properties on the card object as readonly that should've been already, Find a way to initialize a card message in the UI tests.

* Bump dependency on InAppMessaging given changes

* Bump versions in podspecs for both SDKs

* Make all view model properties for message subclasses readonly

* Revert changes to other message subclasses

* Make card view model properties readonly

* Run styles.sh

* Run styles.sh, address some comments about logging

* Reuse analytic trigger method to show programmatic messages. Fix issue with overriding accessibility of card message params
2019-05-28 13:42:06 -04:00

92 lines
3.7 KiB
Objective-C

/*
* Copyright 2017 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;
#import "FIRInAppMessagingRendering.h"
NS_ASSUME_NONNULL_BEGIN
/**
* The root object for in-app messaging iOS SDK.
*
* Note: Firebase InApp Messaging depends on using a Firebase Instance ID & token pair to be able
* to retrieve FIAM messages defined for the current app instance. By default, Firebase in-app
* messaging SDK would obtain the ID & token pair on app/SDK startup. As a result of using
* ID & token pair, some device client data (linked to the instance ID) would be collected and sent
* over to Firebase backend periodically.
*
* The app can tune the default data collection behavior via certain controls. They are listed in
* descending order below. If a higher-priority setting exists, lower level settings are ignored.
*
* 1. Dynamically turn on/off data collection behavior by setting the
* `automaticDataCollectionEnabled` property on the `FIRInAppMessaging` instance to true/false
* Swift or YES/NO (objective-c).
* 2. Set `FirebaseInAppMessagingAutomaticDataCollectionEnabled` to false in the app's plist file.
* 3. Global Firebase data collection setting.
**/
NS_SWIFT_NAME(InAppMessaging)
@interface FIRInAppMessaging : NSObject
/** @fn inAppMessaging
@brief Gets the singleton FIRInAppMessaging object constructed from default Firebase App
settings.
*/
+ (FIRInAppMessaging *)inAppMessaging NS_SWIFT_NAME(inAppMessaging());
/**
* Unavailable. Use +inAppMessaging instead.
*/
- (instancetype)init __attribute__((unavailable("Use +inAppMessaging instead.")));
/**
* A boolean flag that can be used to suppress messaging display at runtime. It's
* initialized to false at app startup. Once set to true, fiam SDK would stop rendering any
* new messages until it's set back to false.
*/
@property(nonatomic) BOOL messageDisplaySuppressed;
/**
* A boolean flag that can be set at runtime to allow/disallow fiam SDK automatically
* collect user data on app startup. Settings made via this property is persisted across app
* restarts and has higher priority over FirebaseInAppMessagingAutomaticDataCollectionEnabled
* flag (if present) in plist file.
*/
@property(nonatomic) BOOL automaticDataCollectionEnabled;
/**
* This is the display component that will be used by FirebaseInAppMessaging to render messages.
* If it's nil (the default case when FirebaseIAppMessaging SDK starts), FirebaseInAppMessaging
* would only perform other non-rendering flows (fetching messages for example). SDK
* FirebaseInAppMessagingDisplay would set itself as the display component if it's included by
* the app. Any other custom implementation of FIRInAppMessagingDisplay would need to set this
* property so that it can be used for rendering fiam message UIs.
*/
@property(nonatomic) id<FIRInAppMessagingDisplay> messageDisplayComponent;
/**
* Directly requests an in-app message with the given trigger to be shown.
*/
- (void)triggerEvent:(NSString *)eventName;
/**
* This delegate should be set on the app side to receive message lifecycle events in app runtime.
*/
@property(nonatomic, weak) id<FIRInAppMessagingDisplayDelegate> delegate;
@end
NS_ASSUME_NONNULL_END