Ruby finder elements for


Add this line to your application's Gemfile:

gem 'appium_flutter_finder'

And then execute:

$ bundle

Or install it yourself as:

$ gem install appium_flutter_finder


include Appium::Flutter::Finder

@driver = ::Appium::Core.for(caps).start_driver

# Send a request to an element
element =
  finder: by_text('You have pushed the button this many times:')
assert element.text == 'You have pushed the button this many times:'

# Get render tree by Flutter
@driver.execute_script 'flutter:getRenderTree', {}


After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to


  • 0.7.1
    • Update the upper limit of ruby_lib_core
  • 0.7.0
    • Update the upper limit of ruby_lib_core
  • 0.6.0
    • Fix type of match_root and first_match_only in by_ancestor and by_descendant
  • 0.5.0
    • Support appium_lib_core version to v7 as well. The appium_lib_core requires Ruby v3.
  • 0.4.2
    • Relax the dependency version restriction
  • 0.4.1
    • Add attr_reader for Appium::Flutter::Element#id
  • 0.4.0
    • Bump appium_lib_core version to v5+
  • 0.3, 0.3.1
    • Add first_match_only option in by_ancestor and by_descendant
  • 0.2.1
  • 0.2.0
    • Bump ruby_lib_core version to 4+


Bug reports and pull requests are welcome on GitHub at .