[ios] Adds protocols for native app launching

ios/public/provider/chrome/browser/native_app_launcher/native_app_metadata.h

+// Copyright 2016 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef IOS_PUBLIC_PROVIDER_CHROME_BROWSER_NATIVE_APP_LAUNCHER_NATIVE_APP_METADATA_H_
+#define IOS_PUBLIC_PROVIDER_CHROME_BROWSER_NATIVE_APP_LAUNCHER_NATIVE_APP_METADATA_H_
+
+#import <Foundation/Foundation.h>
+// TODO(sczs) Import NativeAppInfoBarDelegate once it lands upstream.
+
+@class ChromeIdentity;
+class GURL;
+@class UIImage;
+
+namespace net {
+class URLRequestContextGetter;
+}
+
+// Protocol todo describe
+@protocol NativeAppMetadata<NSObject>
+
+// Defines whether the app should be opened automatically upon Link Navigation.
+// This is a tri-state value internally: Yes, No, not set. However, externally,
+// only the Yes/No state is returned via the property getter. If the internal
+// value is "not set", then it is up to the current implementation to decide
+// whether it should be treated as a YES or a NO. The property setter can set
+// the value to either YES or NO. To set the value to "not set", use
+// -unsetShouldAutoOpenLinks.
+@property(nonatomic, assign) BOOL shouldAutoOpenLinks;
+- (void)unsetShouldAutoOpenLinks;

[rohitrao (ping after 24h), 2016/11/09 02:19:21]

Blank line above this and add a method comment.

// Resets |shouldAutoOpenLinks| to the "not set" state.

[sczs1, 2016/11/10 03:30:19]

Done.

+
+// Defines whether infobars for this app should be bypassed.
+@property(nonatomic, assign) BOOL shouldBypassInfoBars;
+// Stores the number of times a banner is dismissed or ignored.

[rohitrao (ping after 24h), 2016/11/09 02:19:21]

Blank line above this.

[sczs1, 2016/11/10 03:30:19]

Done.

+@property(nonatomic, assign) NSInteger numberOfDismissedInfoBars;
+
+// Returns the application name for this native app. If there is a localized
+// name for the current locale, return the localized name. Otherwise, return
+// the default application name.
+- (NSString*)appName;
+
+// Returns the App Store application id for this native app or |nil| if
+// app does not have an AppStore ID.
+- (NSString*)appId;
+
+// Returns whether this native app is a Google App.
+- (BOOL)isGoogleOwnedApp;
+
+// Returns whether this native app is installed.
+- (BOOL)isInstalled;
+
+// Returns the URL string that launches Apple AppStore for this app.
+- (NSString*)appStoreURL;
+
+// Returns the URL to test if the app is installed.
+- (NSURL*)appURLforURL:(NSURL*)url;
+
+// Calls |block| with the application icon. |contextGetter| must not be nil.
+- (void)fetchSmallIconWithContext:(net::URLRequestContextGetter*)contextGetter
+                  completionBlock:(void (^)(UIImage*))block;
+
+// Returns whether this native application can open the |url|.
+- (BOOL)canOpenURL:(const GURL&)url;
+
+// Returns the launch URL with which the application can be opened. |gurl| is
+// the URL of the content in the web app. If |identity| is not nil, the
+// returned URL contains a hash associated with |identity|.
+- (GURL)launchURLWithURL:(const GURL&)gurl identity:(ChromeIdentity*)identity;
+
+// Resets values of shouldBypassInfobars and numberOfDismissedInfoBarsKey.
+- (void)resetInfobarHistory;
+
+// Enumerates the app's registered schemes. The block can be called multiple
+// times for the same scheme.
+- (void)enumerateSchemesWithBlock:(void (^)(NSString* scheme, BOOL* stop))block;
+
+// Informs the metadata that user has requested the application to be installed
+// from a user interface other than a Launcher infobar.
+- (void)updateCounterWithAppInstallation;
+
+// Returns any of the schemes that the app has registered.
+- (NSString*)anyScheme;
+
+// TODO(sczs) Remove comments once rest of NativeAppInfoBarDelegate lands
+// upstream.
+// This method needs to be called whenever the metadata info is displayed by an
+// infobar.
+//- (void)willBeShownInInfobarOfType:
+//    (NativeAppInfoBarDelegate::NativeAppControllerType)type;

[rohitrao (ping after 24h), 2016/11/09 02:19:21]

Per discussion, let's add these enums to a new file in this CL.

[sczs1, 2016/11/10 03:30:19]

Acknowledged.

+//
+//// Informs the metadata on what user action on the infobar has been taken.
+//// Requires to have previously send the message -[NativeAppMetadata
+//// willBeShownInInfobarOfType:].
+//- (void)updateWithUserAction:(NativeAppInfoBarDelegate::UserAction)userAction;
+
+@end
+
+#endif  // IOS_PUBLIC_PROVIDER_CHROME_BROWSER_NATIVE_APP_LAUNCHER_NATIVE_APP_METADATA_H_