To start using the Cloud Functions for Firebase package within your project, import it at the top of your project files:
Before using Cloud Functions, you must first have ensured you have initialized FlutterFire.
By default, this allows you to interact with Cloud Functions using the default Firebase App used whilst installing Cloud Functions on your
platform. If however you'd like to use Cloud Functions with a secondary Firebase App, use the
Assuming we have a deployed function named
listFruit, we can call the Cloud Function using the
Within Flutter, the function can be called, and the results accessed:
If you wish to specify a region for a Cloud Function that runs in any region other than
us-central1, you can do this
by passing the region to the FirebaseFunctions instance, using
If you are using the local Cloud Functions emulators, then it is possible to connect to these using the
Ensure you pass the correct port on which the Firebase emulator is running on.
Ensure you have enabled network connections to the emulators in your apps following the emulator usage instructions in the general FlutterFire installation notes for each operating system. You only have to call
useFunctionsEmulator once, so do it as early as possible.
If you have specified a region for your Cloud Function emulator, you will also have to provide the same region in your setup:
When using the Firebase emulator while debugging an iOS application, you may receive an error regarding App Transport Security. To fix it, please use the following steps:
- Open ios/Runner.xcworkspace in Xcode.
- Open Runner/info.plist.
- Add a property called App Transport Security Settings.
- Right click on that property and click Add Row.
- Add a property called Allows Local Networking and enter its value as YES.
If you are targeting apps using Android 8.0+, the platform will block the http endpoint. The simplest solution is to change
this in your debug builds by adding the following to your
If you are concerned about security, you can set a more advanced per-host network security file