[cloud_functions] Support for cloud functions emulators

packages/cloud_functions/CHANGELOG.md

@@ -1,99 +1,103 @@
+## 0.4.1
+
+- Automatically use version from pubspec.yaml when reporting usage to Firebase.
+
 ## 0.4.0+3
 
-* Update google-services Android gradle plugin to 4.3.0 in documentation and examples.
+- Update google-services Android gradle plugin to 4.3.0 in documentation and examples.
 
 ## 0.4.0+2
 
-* Automatically use version from pubspec.yaml when reporting usage to Firebase.
+- Automatically use version from pubspec.yaml when reporting usage to Firebase.
 
 ## 0.4.0+1
 
-* Remove reference to unused header file.
+- Remove reference to unused header file.
 
 ## 0.4.0
 
-* Removed unused `parameters` param from `getHttpsCallable`.
+- Removed unused `parameters` param from `getHttpsCallable`.
 
 ## 0.3.0+1
 
-* Update iOS dependencies to latest.
+- Update iOS dependencies to latest.
 
 ## 0.3.0
 
-* Update Android dependencies to latest.
+- Update Android dependencies to latest.
 
 ## 0.2.0+1
 
-* Removed flaky timeout test.
+- Removed flaky timeout test.
 
 ## 0.2.0
 
-* **Breaking change**. Updated Dart API to replace `call` with `getHttpsCallable`.
-* Added support for timeouts.
-* Additional integration testing.
+- **Breaking change**. Updated Dart API to replace `call` with `getHttpsCallable`.
+- Added support for timeouts.
+- Additional integration testing.
 
 ## 0.1.2+1
 
-* Added a driver test.
+- Added a driver test.
 
 ## 0.1.2
 
-* Specifying a version for Cloud Functions CocoaPod dependency to prevent build errors on iOS.
-* Fix on iOS when using a null region.
-* Upgrade the firebase_core dependency of the example app.
+- Specifying a version for Cloud Functions CocoaPod dependency to prevent build errors on iOS.
+- Fix on iOS when using a null region.
+- Upgrade the firebase_core dependency of the example app.
 
 ## 0.1.1+1
 
-* Log messages about automatic configuration of the default app are now less confusing.
+- Log messages about automatic configuration of the default app are now less confusing.
 
 ## 0.1.1
 
-* Support for regions and multiple apps
+- Support for regions and multiple apps
 
 ## 0.1.0+1
 
-* Log a more detailed warning at build time about the previous AndroidX
+- Log a more detailed warning at build time about the previous AndroidX
   migration.
 
 ## 0.1.0
 
-* **Breaking change**. Migrate from the deprecated original Android Support
+- **Breaking change**. Migrate from the deprecated original Android Support
   Library to AndroidX. This shouldn't result in any functional changes, but it
   requires any Android apps using this plugin to [also
   migrate](https://developer.android.com/jetpack/androidx/migrate) if they're
   using the original support library.
 
 ## 0.0.5
 
-* Set iOS deployment target to 8.0 (minimum supported by both Firebase SDKs and Flutter), fixes compilation errors.
-* Fixes null pointer error when callable function fails with exception (iOS).
+- Set iOS deployment target to 8.0 (minimum supported by both Firebase SDKs and Flutter), fixes compilation errors.
+- Fixes null pointer error when callable function fails with exception (iOS).
 
 ## 0.0.4+1
 
-* Bump Android dependencies to latest.
+- Bump Android dependencies to latest.
 
 ## 0.0.4
 
-* Fixed podspec to use static_framework
+- Fixed podspec to use static_framework
 
 ## 0.0.3
 
-* Added missing dependency on meta package.
+- Added missing dependency on meta package.
 
 ## 0.0.2
 
-* Bump Android and Firebase dependency versions.
+- Bump Android and Firebase dependency versions.
 
 ## 0.0.1
 
-* The Cloud Functions for Firebase client SDKs let you call functions
+- The Cloud Functions for Firebase client SDKs let you call functions
   directly from a Firebase app. This plugin exposes this ability to
   Flutter apps.
 
   [Callable functions](https://firebase.google.com/docs/functions/callable)
   are similar to other HTTP functions, with these additional features:
 
-    - With callables, Firebase Authentication and FCM tokens are
-      automatically included in requests.
-    - The functions.https.onCall trigger automatically deserializes
-      the request body and validates auth tokens.
+  - With callables, Firebase Authentication and FCM tokens are
+    automatically included in requests.
+  - The functions.https.onCall trigger automatically deserializes
+    the request body and validates auth tokens.

packages/cloud_functions/android/src/main/java/io/flutter/plugins/firebase/cloudfunctions/CloudFunctionsPlugin.java

@@ -38,12 +38,16 @@ public void onMethodCall(MethodCall call, final Result result) {
         String appName = call.argument("app");
         FirebaseApp app = FirebaseApp.getInstance(appName);
         String region = call.argument("region");
+        String origin = call.argument("origin");
         FirebaseFunctions functions;
         if (region != null) {
           functions = FirebaseFunctions.getInstance(app, region);
         } else {
           functions = FirebaseFunctions.getInstance(app);
         }
+        if (origin != null) {
+          functions.useFunctionsEmulator(origin);
+        } 
         HttpsCallableReference httpsCallableReference = functions.getHttpsCallable(functionName);
         Number timeoutMilliseconds = call.argument("timeoutMilliseconds");
         if (timeoutMilliseconds != null) {

packages/cloud_functions/ios/Classes/CloudFunctionsPlugin.m

@@ -44,6 +44,7 @@ - (void)handleMethodCall:(FlutterMethodCall *)call result:(FlutterResult)result
     NSObject *parameters = call.arguments[@"parameters"];
     NSString *appName = call.arguments[@"app"];
     NSString *region = call.arguments[@"region"];
+    NSString *origin = call.arguments[@"origin"];
     NSNumber *timeoutMicroseconds = call.arguments[@"timeoutMicroseconds"];
     FIRApp *app = [FIRApp appNamed:appName];
     FIRFunctions *functions;
@@ -52,6 +53,9 @@ - (void)handleMethodCall:(FlutterMethodCall *)call result:(FlutterResult)result
     } else {
       functions = [FIRFunctions functionsForApp:app];
     }
+    if (origin != nil && origin != (id)[NSNull null]) {
+      [functions useFunctionsEmulatorOrigin:origin];
+    }
     FIRHTTPSCallable *function = [functions HTTPSCallableWithName:functionName];
     if (timeoutMicroseconds != nil && timeoutMicroseconds != [NSNull null]) {
       [function setTimeoutInterval:(NSTimeInterval)timeoutMicroseconds.doubleValue / 1000000];

packages/cloud_functions/lib/src/cloud_functions.dart

@@ -16,9 +16,10 @@ class CloudFunctionsException implements Exception {
 ///
 /// You can get an instance by calling [CloudFunctions.instance].
 class CloudFunctions {
-  CloudFunctions({FirebaseApp app, String region})
+  CloudFunctions({FirebaseApp app, String region, String origin})
       : _app = app ?? FirebaseApp.instance,
-        _region = region;
+        _region = region,
+        _origin = origin;
 
   @visibleForTesting
   static const MethodChannel channel = MethodChannel('cloud_functions');
@@ -31,6 +32,8 @@ class CloudFunctions {
 
   final String _region;
 
+  String _origin;
+
   /// Gets an instance of a Callable HTTPS trigger in Cloud Functions.
   ///
   /// Can then be executed by calling `call()` on it.
@@ -39,4 +42,12 @@ class CloudFunctions {
   HttpsCallable getHttpsCallable({@required String functionName}) {
     return HttpsCallable._(this, functionName);
   }
+
+  /// Changes this instance to point to a Cloud Functions emulator running locally.
+  ///
+  /// @param origin The origin of the local emulator, such as "//10.0.2.2:5005".
+  CloudFunctions useFunctionsEmulator({@required String origin}) {
+    _origin = origin;
+    return this;
+  }
 }

packages/cloud_functions/lib/src/https_callable.dart

@@ -34,6 +34,7 @@ class HttpsCallable {
           .invokeMethod<dynamic>('CloudFunctions#call', <String, dynamic>{
         'app': _cloudFunctions._app.name,
         'region': _cloudFunctions._region,
+        'origin': _cloudFunctions._origin,
         'timeoutMicroseconds': timeout?.inMicroseconds,
         'functionName': _functionName,
         'parameters': parameters,

packages/cloud_functions/pubspec.yaml

@@ -23,5 +23,5 @@ dev_dependencies:
   test: any
 
 environment:
-  sdk: ">=2.0.0-dev.28.0 <3.0.0"
-  flutter: ">=0.2.4 <2.0.0"
+  sdk: '>=2.0.0-dev.28.0 <3.0.0'
+  flutter: '>=0.2.4 <2.0.0'

packages/cloud_functions/test/cloud_functions_test.dart

@@ -38,6 +38,10 @@ void main() {
       await callable.call(<String, dynamic>{
         'quux': 'quuz',
       });
+      await CloudFunctions.instance
+          .useEmulatorFunctions(origin: 'http://localhost:5001')
+          .getHttpsCallable(functionName: 'bez')
+          .call();
       expect(
         log,
         <Matcher>[
@@ -46,6 +50,7 @@ void main() {
             arguments: <String, dynamic>{
               'app': '[DEFAULT]',
               'region': null,
+              'origin': null,
               'functionName': 'baz',
               'timeoutMicroseconds': null,
               'parameters': null,
@@ -56,11 +61,23 @@ void main() {
             arguments: <String, dynamic>{
               'app': '1337',
               'region': 'space',
+              'origin': null,
               'functionName': 'qux',
               'timeoutMicroseconds': (const Duration(days: 300)).inMicroseconds,
               'parameters': <String, dynamic>{'quux': 'quuz'},
             },
           ),
+          isMethodCall(
+            'CloudFunctions#call',
+            arguments: <String, dynamic>{
+              'app': '[DEFAULT]',
+              'region': null,
+              'origin': 'http://localhost:5001',
+              'functionName': 'bez',
+              'timeoutMicroseconds': null,
+              'parameters': null,
+            },
+          ),
         ],
       );
     });