Adds mailto: URL support to app launching.

ios/chrome/browser/web/mailto_url_rewriter.h

Index: ios/chrome/browser/web/mailto_url_rewriter.h
diff --git a/ios/chrome/browser/web/mailto_url_rewriter.h b/ios/chrome/browser/web/mailto_url_rewriter.h
new file mode 100644
index 0000000000000000000000000000000000000000..67599ba81cacbad0fe04d3b425d981066f20a46b
--- /dev/null
+++ b/ios/chrome/browser/web/mailto_url_rewriter.h
@@ -0,0 +1,46 @@
+// Copyright 2017 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_CHROME_BROWSER_WEB_MAILTO_URL_REWRITER_H_
+#define IOS_CHROME_BROWSER_WEB_MAILTO_URL_REWRITER_H_
+
+#import <Foundation/Foundation.h>
+
+@class MailtoHandler;
+class GURL;
+
+// An object that manages the available Mail client apps. The currently selected
+// Mail client to handle mailto: URL is stored in a key in NSUserDefaults.
+// If the key in NSUserDefaults is not set, the system-provided Mail client app
+// will be used.
+@interface MailtoURLRewriter : NSObject
+
+// Returns the ID as a string for the system-provided Mail client app.
++ (NSString*)systemMailApp;
+
+// An initializer returning an instance that has the standard set of
+// MailtoHandlers initialized. Unit tests can use -init and then set up the
+// different handlers.
+- (instancetype)initWithStandardHandlers;
+
+// Returns an array of all the currently supported Mail client apps that claims
+// to handle mailto: URL scheme through their own custom defined URL schemes.
+- (NSArray<MailtoHandler*>*)defaultHandlers;
+
+// Returns the ID as a string for the Mail client app was set to handle mailto:
+// URL scheme.
+- (NSString*)defaultHandlerID;

[rohitrao (ping after 24h), 2017/05/06 00:09:41]

Could this/should this be a property?

[pkl (ping after 24h if needed), 2017/05/08 17:07:56]

Indeed it can be declared as a property in the API. The internal implementation
does not need a backing ivar because the value is actually stored into
NSUserDefaults.

+
+// Sets the ID as a string for the Mail client app that will handle mailto:
+// URL scheme.
+- (void)setDefaultHandlerID:(NSString*)appStoreID;
+
+// Rewrites |gURL| into a new URL that can be "opened" to launch the Mail
+// client app. May return nil if |gURL| is not a mailto: URL or there are no
+// Mail client app available.
+- (NSString*)rewriteMailtoURL:(const GURL&)gURL;
+
+@end
+
+#endif  // IOS_CHROME_BROWSER_WEB_MAILTO_URL_REWRITER_H_