{"id":10895,"date":"2024-02-26T13:58:11","date_gmt":"2024-02-26T13:58:11","guid":{"rendered":"https:\/\/testgrid.io\/blog\/?p=10895"},"modified":"2026-05-14T15:27:32","modified_gmt":"2026-05-14T15:27:32","slug":"appium-flutter-testing","status":"publish","type":"post","link":"https:\/\/testgrid.io\/blog\/appium-flutter-testing\/","title":{"rendered":"How to Automate Flutter App Testing With Appium Flutter Driver"},"content":{"rendered":"\n

In the fast-paced development landscape, building high-quality mobile apps that provide a great user experience is crucial. This high quality can be ensured with thorough testing of these apps. The availability of numerous devices and platforms can be incredibly time-consuming. Thankfully, there are effective tools available for automating mobile app testing.<\/p>\n\n\n\n

One increasingly popular framework for building mobile apps is Flutter. It enables you to build cross-platform mobile apps, leading to fast development times. However, Flutter app testing is still critical \u2014 the impact of bugs on your customer base can be enormous. Since manual testing is time-consuming and error-prone, the best approach is Appium Flutter testing, which lets you automate test coverage across both Android and iOS from a single test suite.<\/p>\n\n\n\n

In this step-by-step guide, we will go through an overview of Flutter and Appium, and walk through how to automate Flutter mobile app testing using the Appium Flutter Driver with real code examples in Java.<\/p>\n\n\n\n

What Are Flutter and Appium in Mobile Test Automation?<\/h2>\n\n\n\n

Flutter is an open-source framework developed by Google to build high-performance and beautiful mobile apps for iOS and Android using a single Dart codebase. It comes with reactive views, powerful widgets, and native performance. It provides the advantage of a fast development cycle as well.<\/p>\n\n\n\n

Appium is an open-source automation testing framework for mobile apps. It allows automation across native, hybrid, and mobile web apps for iOS, Android, and Windows.  Appium uses the WebDriver protocol to interact with the apps.<\/p>\n\n\n\n

However, standard Appium cannot directly interact with Flutter widgets. Unlike native Android or iOS apps, Flutter renders its entire UI using the Skia graphics engine, meaning every button, text field, and screen element is a painted pixel, not a native element. This is why Appium Flutter testing requires the dedicated Appium Flutter Driver, which communicates with the Dart VM directly to locate and interact with Flutter widgets.<\/p>\n\n\n\n

Appium enables you to write tests against Flutter apps using any WebDriver-compatible language, such as Java, Python, C#, Ruby, JavaScript, or PHP. We will be using Java in this article for demonstrations.<\/p>\n\n\n\n

How to Set Up Flutter<\/h2>\n\n\n\n

To start working with the Flutter framework, you need to have Appium installed and set up in your system. You can easily install Flutter by following the steps in the Flutter Official Documentation<\/a>. <\/p>\n\n\n\n

You can check the status of the Flutter setup by using the command below in the terminal-<\/p>\n\n\n\n

flutter doctor<\/code><\/pre>\n\n\n\n
If everything is installed, you will see results like the following screenshot; if not, you can manually fix the errors as would be listed in the report.<\/p>\n\n\n\n
\"flutter<\/figure>\n\n\n\n
Before jumping into creating or opening a Flutter app in Android Studio, ensure that Flutter and Dart plugins are installed in your Android Studio.<\/p>\n\n\n\n
\"install<\/figure>\n\n\n\n
How to Run a Flutter App on an Android Emulator<\/h2>\n\n\n\n
Once you are done setting up Flutter, the next step is to clone or import the Flutter app you want to automate. You may either use your application or refer to any of the sample apps<\/a> available for Flutter practice. For this article, we will be using a simple calculator application<\/a>.<\/p>\n\n\n\n
1. <\/strong>Open Android Studio, and open the application folder of your Flutter app.<\/p>\n\n\n\n
2. <\/strong>Next, we will open the pubspec.yml<\/em><\/strong> file and update the dev_dependencies<\/em> as follows:<\/p>\n\n\n\n
dev_dependencies:\n test: any\n flutter_driver:\n   sdk: flutter\n flutter_test:\n   sdk: flutter<\/code><\/pre>\n\n\n\n
The screenshot below shows the pubspec.yml file and the added dependencies.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
3. <\/strong>After adding the dependencies, we will have to import them, which can be done using the command below in the terminal<\/p>\n\n\n\n
flutter pub get\n\n<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
4. <\/strong>Now, we will update the main.dart<\/em><\/strong> file to import the flutter_driver_extension. We will be writing an import statement- import \u2018package:flutter_driver\/driver_extension.dart\u2019; and also add a method- enableFlutterDriverExtension() in the main method. This should be written before the runApp() method. <\/p>\n\n\n\n
The code would look like this:<\/p>\n\n\n\n
import 'package:flutter\/material.dart';\nimport 'package:flutter_calculator\/bindings\/my_bindings.dart';\nimport 'package:flutter_calculator\/screen\/main_screen.dart';\nimport 'package:get\/get.dart';\nimport 'package:flutter_driver\/driver_extension.dart';\n\nvoid main() {\n\n enableFlutterDriverExtension();\n runApp(const MyApp());\n}\n\n\nclass MyApp extends StatelessWidget {\n const MyApp({Key? key}) : super(key: key);\n\n\n @override\n Widget build(BuildContext context) {\n   return GetMaterialApp(\n     debugShowCheckedModeBanner: false,\n     initialBinding: MyBindings(),\n     title: \"Flutter Calculator\",\n     home: MainScreen(),\n   );\n }\n}\n<\/code><\/pre>\n\n\n\n
5.<\/strong> After the above changes are made, we will start the Flutter app on the Android emulator<\/a>. We will be selecting the device that we would want to use to run our application.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
6. <\/strong>Once the emulator is connected, click on the Run button,<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
7. <\/strong>You will notice that the Flutter app opens up in the emulator as shown in the screenshot.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Now that we know how to run a Flutter app on our system, in the next section, we will learn about Appium Flutter Driver to automate Flutter apps.<\/p>\n\n\n\n
How to Use Appium Flutter Driver for Flutter Test Automation<\/h2>\n\n\n\n
Appium comes with a dedicated extension called the Appium Flutter Driver, which is the backbone of all Flutter app testing with Appium. It simplifies automation by acting as a bridge between your test scripts and the Flutter app’s Dart VM. It acts as a bridge between the test scripts and the Flutter Driver.<\/p>\n\n\n\n