Implementing integration tests for Flutter applications is essential to ensure app stability across various devices and configurations. Firebase Test Lab provides a scalable platform to run these tests on real devices hosted in Google's data centers. This tutorial guides you through the process of setting up and executing Flutter integration tests using Firebase Test Lab.

Prerequisites

  • Flutter SDK installed on your development machine
  • Google Cloud account with billing enabled
  • Firebase project created and linked to your app
  • Firebase CLI installed
  • App tested locally and ready for remote testing

Step 1: Set Up Firebase in Your Flutter Project

Integrate Firebase into your Flutter project by adding the necessary dependencies and configuration files. Follow the Firebase documentation to add the Firebase SDKs and initialize Firebase in your app.

Add Firebase Dependencies

Edit your pubspec.yaml to include Firebase dependencies:

Example:

```yaml
dependencies:
flutter:
sdk: flutter
firebase_core: ^2.0.0
cloud_firestore: ^4.0.0
```

Configure Firebase

Download the google-services.json (Android) and GoogleService-Info.plist (iOS) files from your Firebase project settings and add them to your project directories.

Step 2: Write Integration Tests

Create a new directory called test_driver and add a integration_test.dart file. Use the Flutter integration_test package to write your tests.

Example:

```dart
import 'package:integration_test/integration_test.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:your_app/main.dart' as app;

void main() {
IntegrationTestWidgetsFlutterBinding.ensureInitialized();
testWidgets('full app test', (tester) async {
app.main();
await tester.pumpAndSettle();
// Add your test steps here
});
}
```

Step 3: Build the App for Testing

Build a release version of your app suitable for testing. For Android, generate an APK:

Command:

```bash
flutter build apk --release
```

For iOS, build an archive using Xcode.

Step 4: Upload and Run Tests on Firebase Test Lab

Authenticate with Google Cloud CLI:

Command:

```bash
gcloud auth login
```

Set your project:

Command:

```bash
gcloud config set project [YOUR_PROJECT_ID]
```

Upload your APK and run the test:

Command:

```bash
gcloud firebase test android run --type instrumentation --app=path/to/your_app.apk --test=path/to/your_integration_test.apk --device=model=Pixel2,version=28
```

Step 5: Analyze Test Results

After tests complete, Firebase provides detailed reports and logs. Access these via the Firebase Console under the Test Lab section to review test outcomes and troubleshoot issues.

Best Practices and Tips

  • Write comprehensive tests covering critical app flows.
  • Use device farms to test across multiple device configurations.
  • Automate test runs in your CI/CD pipeline for continuous quality.
  • Regularly update your tests to match app changes.

Implementing Flutter integration tests with Firebase Test Lab enhances your app's reliability and user experience. Follow these steps to streamline your testing process and leverage the power of cloud-based device testing.