dolfin-flutter

The Flutter-based app for the DOLFIN Project. Note, there is a dev version of the code in a seperate repo that bipasses the verification with NPEU's databases so that we can create users and have access to the app through a dev version. Currently this is only available for Android. It's a hastle, but development is probably best done in the dev app first to test before transferring updates to this one.

About

Babies who are born very early, or who suffer poor blood supply or lack of oxygen to the brain before or around birth, are more likely to have problems with their brain development and child neurological development. This may affect how children think and learn, communicate, play, and interact with the world around them.

DOLFIN aims to answer the research question:

In babies who are born very early or who suffer poor blood supply or lack of oxygen to the brain before or around birth, does giving a nutritional supplement daily for a year improve long-term cognitive development?

Nice to know

The NPEU team have access to the Firebase database using a service account with a private key. This expires around the beginning of June annually. NPEU will give us a new public key and we upload this to the service account through the Google console.

Project Team

PI: Jeremy Parr
RSEs:

Project Structure

doflin-flutter: Production repository (left side of the diagram)
dolfin-development: This repository. DOLFIN Admin app 'dev' branch, created for NPEU team (right side of the diagram)
dolfin-firebase: Includes Firebase Cloud Funcitons, Push Notifications and Database (top left of the diagram)
dolfin-firebase: Development Firebase Cloud Funcitons, Push Notifications and Database (top right of the diagram)

Project Diagram

This repository contains both 'DOLFIN App' & 'DOLFIN App Admin'.
The apps are identical with a key exception: Admin app is built with the .env file pointing to the test API, while the DOLFIN App is the production ready version.
The production ready version is not accessible to anyone besides the trial participants. This also excludes both DOLFIN and RSE teams.

Prerequisite Installs

The application uses Flutter, which is written in Dart; both developed and maintained by Google.

Install the following to get started on the project:
- Flutter Framework (this also installs Dart for you, no need to do it explicitly): Flutter MacOS
  - IMPORTANT NOTES POST INSTALL:
  - Must be downgraded to: Flutter version 3.16.9 channel stable
  - Do NOT run $ dart fix
  - Do NOT adjust pubspec.yaml file! Unless you are keen on predicate logic
- Xcode available on the Mac App Store
- Android Studio available from the Jetbrains Toolbox App
If you have an instalation of Flutter already, and installed this using homebrew, you may not be able to downgrade Flutter. If this is the case, remove your Flutter installation and install only the required version using these instructions for installation and selecting the correct installation from here.
Determine whether you need Ruby (version manager) on a Mac

Developing on Mac requires you to install additional Ruby versions, which is not interfering with the system built-in one.
Recommended to check out rbenv. A Ruby version manager. chruby is also a good alternative.

To determine if you need to install a Ruby Version manager, run:
```
   $ which ruby
```
If it returns
```
   $ /usr/bin/ruby
```
You need to install a ruby version manager for MacOS to develop iOS apps.
Refer to rbenv repo regarding installation.
Install Android Emulator

Android requires Java 11. Anything newer will NOT work.

You want to set up an Android emulator with API 34 or above running Android 14 or above. Do this within Android Studio (Step 1)
The project is 80:20 split focused in favour of Android, recommended to use Android Studio throughout the development in general.
Install iOS Simulators

XCode 15 (or newer) will come pre-installed with the relevant up-to-date iOS simulators. No need to do anything else.

Getting Started

Run the following command to confirm you installed everything above correctly:

    $ flutter doctor

If you see the following output, you are good to go:

Project Setup to Firebase

Find the .env file on RSE Team OneDrive.
Clone the repository and place the .env file at root level of dolfin-flutter/ directory

You need to configure the application on Android as well as on iOS with Firebase.
If you skip this step, you will have a hard time debugging what is going on with no errors showing.

Android

Download the relevant google-services.json file from Firebase.
To confirm you have the correct file, you will see uk.ac.ncl.rse.dolfin under package-name.
Copy the file to dolfin-flutter/android/app/ directory

Run the Android App for the first time

Open the Android Simulator manually (as flutter can't do it for you)
Install the flutter packages
```
    $ flutter pub get 
```
Run the project
```
    $ flutter run
```
Manually select the Android Simulator
Wait until it builds

iOS

Download the relevant GoogleService-Info.plist file from Firebase
Copy the file to dolfin-flutter/ios/ directory
Open XCode at dolfin-flutter/ios/Runner.xcodeproj
Right-click 'Runner'
Add Files to "Runner"
Select GoogleService-Info.plist
To confirm XCode recognises your file, you need to see it in the XCode file directory

If it doesn't work, follow these steps.

Run the iOS App for the first time

Open the iOS Simulator manually (as flutter can't do it for you)
Install the flutter packages
```
    $ flutter pub get
```
Install Pods
```
    $ cd ios 
```
```
    $ pod install 
```
Run the project
```
     $ flutter run
```
Manually select the iOS Simulator
Wait until it builds

Building the iOS app to the App Store

flutter build ipa

Following a successful build, ask Imre to sort the rest out.

Building the iOS app to the App Store [depricated]

# fastlane match development
# fastlane match appstore
# pod install
# bundle install
flutter build ipa
# bundle exec fastlane beta

Regenerating the Icons (not needed unless there is an error)

The base icon image is specified in pubspec.yaml and the relevant dependencies should be installed automatically. To regenerate the icons (for Android and iOS), edit the master image file and then use the following commands:

flutter pub get  
flutter pub run flutter_launcher_icons:main

Roadmap

[x] Initial Development
[x] Minimum viable product
[x] Feature-Complete
[x] Late 2023 Update by Imre
[x] Early 2024 Update by Imre

Acknowledgements

This work was funded by a grant from the UK Research Councils, EPSRC grant ref. EP/L012345/1, “Example project title, please update”.

NewcastleRSE / dolfin-flutter

readme