Project Report (Note: 11mb PDF)
A cross-platform location-aware guidance app for the Final Year Project Open Day. My final year project for BSc Computer Science in UCC.
The Final Year Project (FYP) open day is an event attended by staff, students and industry professionals every year where around 75 students exhibit projects in different rooms in the Western Gateway Building. A booklet is produced every year listing the projects, but this is inefficient for many staff and visitors.
This project (Mizen) aimed to improve this experience by using a cross-platform mobile app that provides guidance for navigating the event with providing location-aware information, provided by Bluetooth beacons in each of the rooms. The information should be easy to search through, and provide the ability to bookmark projects or mark them as seen.
Mizen aimed also to explore the feasibility of creating similar applications for other uses, exploring the idea of beacon-driven applications for similar events such as trade shows and conferences, and the reliability of the beacon technology in applications such as the smart home.
Mizen also aims to explore the feasibility of developing an application for both major mobile platforms under the time constraint of being available before the FYP Open Day, using the React Native framework.
Follow the React Native setup guidelines. A brief summary follows:
Android SDK or XCode, Node.js with Node Package Manager, Python2.7.
- If using Android SDK, make sure the environment variable ANDROID_HOME is defined.
- Clone this repository & navigate to this directory
- Run
npm install -g react-native-cli- this will install react-native cli and put it on your PATH. - Run
npm install --save- this will fetch required libraries that I've included. - To run on a configured Android emulator or an Android device with USB debugging enabled:
react-native run-android- To build a release, change to the
androiddirectory and rungradlew assembleRelease - (possibly
./gradlew assembleReleasedepending on platform)
- To build a release, change to the
- To run on the iOS simulator:
react-native run-ios - To run on an iPhone: connect the iPhone, open ios/Mizen.xcodeproj in Xcode, and build to run with your iPhone as the target.
Alternatively: Mizen is still available on the Google Play Store: http://colm.cf/mizen
Mizen is licenced under the MIT Licence.
Mizen depends on React Native, and some other NPM packages. All of these implement the MIT licence with the exception of react-navigation which implements BSD-2-Clause. All bear the licence "Redistribution and use in source and binary forms, with or without modification, are permitted". These are specified in package.json so will be loaded when you run npm install, not included in the zip. They'll be found in a folder called node_modules.