A month of Flutter: configuring continuous integration

When starting a new project I like to automate as much as possible. One of the most important tasks is getting tests running on CI. There are a number of great CI services but for this project I'm going with Travis CI.

Let's take a look at the configuration I've settled on and what it all means:

language: dart
dist: xenial
addons:
  apt:
    packages:
    - lib32stdc++6
install:
- git clone https://github.com/flutter/flutter.git -b beta
- ./flutter/bin/flutter doctor
script:
- cd app
- ../flutter/bin/flutter test
cache:
  directories:
  - $HOME/.pub-cache
  • language tailors the CI environment for a specific language. If you leave this out, the default language is Ruby. This isn't strictly needed as Flutter will actually download its own version of Dart. I specified Dart so that if I write CI tooling in the future, I can do it in Dart.
  • dist specifies the Ubuntu base version that gets used. Travis currently defaults to Trusty Tahr which is end of life in 2019 so I'm specifying Xenial Xerus which is supported until 2021.
  • addons lets you have additional packages installed on the OS. In my experimentation, tests still pass without lib32stdc++6 but flutter doctor complains so I'm including it anyway.
  • install would typically call Dart's pub get but Flutter complains so we'll just override that and install Flutter instead.
  • script is where we run the tests. Not that the Birb app is in the app directory so we have to cd into it first.
  • cache is the final bit. This tells Travis to cache the contents of the default Dart package cache. This should make it faster for Flutter to install the app's dependencies.

This configuration runs great and takes about 2 minutes 30 seconds on the base app.

I also tried caching the flutter directory to boost install speed. Here is an configuration iteration I tried:

install:
- |
    if [ ! -d flutter ] ; then
      git clone https://github.com/flutter/flutter.git -b beta
    fi
- ./flutter/bin/flutter doctor
cache:
  directories:
  - flutter
  - $HOME/.pub-cache

Caching the flutter directory dropped the test run time to to about 1 minute 10 seconds! The install step was then more complex as it has to check if the flutter directory exists and only run git clone if it doesn't. But there was a larger issue where the "if directory does not exist" was having false positives and causing Flutter to not get installed correctly. I would like to improve CI performance but don't want to spend any more time on it now so I've added #6 Cache flutter directory on CI to the backlog as a future improvement.

With CI setup, I like to protect the master branch from accidental pushes. This is less important when you are working on your own but is very important when working with teams. It's also a good way to require that tests are kept in a passing state.

This is how I configured GitHub's branch protection on the master branch:

Configuring master as a protected branch on GitHub

Come back tomorrow when I'll set up linting.

Code changes

Posts in this series

  • A month of Flutter
  • A month of Flutter: create the app
  • A month of Flutter: configuring continuous integration
  • A month of Flutter: continuous linting
  • A month of Flutter: upgrading to 1.0
  • A month of Flutter: initial theme
  • A month of Flutter: no content widget
  • A month of Flutter: a list of posts
  • A month of Flutter: extract post item widget
  • A month of Flutter: post model and mock data
  • A month of Flutter: rendering a ListView with StreamBuilder
  • A month of Flutter: Stream transforms and failing tests
  • A month of Flutter: real faker data
  • A month of Flutter: rendering network images
  • A month of Flutter: FABulous authentication
  • A month of Flutter: configure Firebase Auth for Sign in with Google on Android
  • A month of Flutter: configure Firebase Auth for Sign in with Google on iOS
  • A month of Flutter: Sign in with Google
  • A month of Flutter: mocking Firebase Auth in tests
  • A month of Flutter: delicious welcome snackbar
  • A month of Flutter: navigate to user registration
  • A month of Flutter: user registration form
  • A month of Flutter: testing forms
  • A month of Flutter: setting up Firebase Firestore
  • A month of Flutter: awesome adaptive icons
  • A month of Flutter: set up Firestore rules tests
  • A month of Flutter: Firestore create user rules and tests
  • A month of Flutter: WIP save users to Firestore
  • A month of Flutter: user registration refactor with reactive scoped model
  • A month of Flutter: the real hero animation
  • A month of Flutter: a look back

  • Category: Development