This tutorial guides you through setting up your Flutter app on Nevercode. You will need to set up the project just once to build it for both iOS and Android.
Nevercode doesn't require any kind of additional software or configuration files from your side. We’ll scan your repository and from what you have there, our builders find everything they need. You’ll just have to confirm what configuration you want to build.
The guide covers how to:
- Add a new app
- Define build configuration
- Define additional settings and build arguments
- Sign code
- Set up Git hooks
- Run tests
- Publish build artefacts
- Manage build versions
- Other configuration
- If this is your very first app on Nevercode, you can immediately move on to the next step and specify your app repository. Otherwise, click Add a new app on Nevercode dashboard.
- Select the appropriate option for where your app repository is hosted. See Specifying app repository for details.
Connecting your repo
- After specifying the app repository, Nevercode takes a first look at it by listing the
branchesin your repository. Select a branch from the dropdown that Nevercode should scan for projects. Note that you can change the branch later if needed.
- Click Scan branch.
Nevercode scans the repository from the specified branch. This includes cloning the repository, looking for projects from it and searching for the configurations. All these actions can be monitored real-time from your browser via the live log window.
- After the scan is complete, select a project from the Project dropdown.
Configuring build settings
- Choose which configuration to build. The available options are
- Select the platform(s) for which you would like to build the app.
- Enable the appropriate build options by checking the corresponding boxes.
- Finally, click the Save and start build button. Nevercode will start the very first build of your app and you can monitor the real-time logs right in your browser.
For repositories hosted on GitHub, Bitbucket or GitLab, you can also specify the feature branches to be watched for changes.
Our environment variables and files functionality enables you to fine-tune the settings of your project. Navigate to the Environment tab in your app settings to add the following Flutter-specific variables:
Flutter version to be checked out (default is
Flutter channel to be checked out. Note that when you define both
NC_FLUTTER_VERSION, we will use the Flutter version specified by
Verbose output for Flutter builds.
Custom Gradle task to be built.
Custom iOS scheme to be built.
List of build arguments for Android. For example:
-t lib/staging.dart --build-number=1.3
List of build arguments for iOS. For example: -t
Location of Flutter checkout
Our Flutter checkout is located at
The very first version of your app on Nevercode is built without code signing. Navigate to the Code signing tab in your project settings to set up code signing for both platforms. See how to sign your Android binaries and iOS binaries on Nevercode.
By setting up Git hooks, you can have Nevercode automatically build your app every time you push changes to the repository. Please refer to Building automatically (Git hooks) for instructions.
Nevercode detects and runs your Flutter tests automatically. As Flutter does not generate a xUnit report that we could parse, we cannot display the test logs on Nevercode's UI. Depending on the test results, you'll be able to see either "tests passed" or "tests failed" in the build log.
Your build artefacts will be available on the Artefacts tab in build overview. You can set up Nevercode to automatically publish the artefacts to our supported distribution channels.
To make your build version management easy, Nevercode exports two environment variables that you can use in your build scripts:
NEVERCODE_BUILD_NUMBER. You can read more about it from Incrementing Android app version.
See also how to: