AgriDex

Connecting sheep to you

About

A Flutter app that helps manage farm livestock

Building

You can follow these instructions to build the AgriDex app and install it onto your device.

Prerequisites

If you are new to Flutter, please first follow the Flutter Setup guide.

Google API Configs

Obtain a copy of GoogleService-Info.plist and google-services.json from the firebase console and put them in the following directories if you need to build for release

./ios/Runner/GoogleService-Info.plist
./android/app/google-services.json

Build/Debug App

If you are debugging the application on a simulator, run the following to launch the iOS simulator

open -a Simulator

Then run the following to debug with live reloading

flutter run --debug

Deploying Firebase Configuration

First install the firebase-tools package

npm install -g firebase-tools

Run the following to login to firebase cli

firebase login

Run the following within your ./firebase/functions/ directory if you are deploying functions

npm install

Make all the necessary changes within ./firebase/ in this project repository and then push the configuration using the following.

$ firebase deploy

=== Deploying to 'agri-dex'...

i  deploying storage, firestore, functions, hosting

etc...

✔  Deploy complete!

Generating the App Icons

Icon was created using: https://pub.dartlang.org/packages/flutter_launcher_icons

flutter pub get
flutter pub pub run flutter_launcher_icons:main

Due to a difference in the way that iOS and Android handle transparency, there's a separate icon file for iOS and a method for toggling on and off the icon changes in the pubspec.yaml

Build Issues

MissingPluginException

If you are getting a missing plugin exception (likely due to Firestore Cloud) simply run the following to clear out the old builds

flutter clean
flutter packages get

Can't Compile Debug APK

If you are unable to compile a debug version of the APK go into ./android/app/build.gradle and change the following line (comment out release and add the debug config)

buildTypes {
    release {
        //signingConfig signingConfigs.release
        signingConfig signingConfigs.debug
    }
}

iOS Build Fails around BoringSSL/internal.h

As Flutter is still in development and more importantly, the external packages that tie in to services like Google Play are still changing a lot, there's often some teething issues with breaking dependencies and build. Run the following in to hopefully resolve most of the issues

cd ios/
rm -rf Pods/ Podfile.lock ; pod install

Authors

• Nathan Glover @nathangloverAUS (Twitter), @t04glovern (Github)
• Rico Beti @RicoBeti (Twitter), @silentbyte (Github)