Work-in-Progress Android App for Finding Bike Parking
Developing the application depends on Node Package Manager (npm), installation instructions for npm can be found here.
This app is built on the Expo framework for react-native development. Expo handles packaging, compiling, and building react-native code for development on both Android and IOS. It's simpler to use and faster to get started with than pure react-native. Documentation for Expo can be found here.
When running Expo projects you have 2 options, development builds and ExpoGo builds. ExpoGo builds are for very simple projects without many complex libraries. As soon as custom native code must be written a developer has to switch from ExpoGo to development builds. Since we are using a mapping library which contains custom native code we need development builds.
To run the application first clone it to your desired directory using git and move to the directory via the command line.
Warning
If you are on windows you may run into a path length error which is fairly difficult to identify. Try to clone the git project into a top level directory with a short name. If you find that you are getting errors like "CMAKE could not be found in your path" you may be experiencing the path length error.
Run npm install expo to get the expo framework.
Run npm install expo-development-client to get the development client for expo.
Then, run npx expo run:android to start the development server locally on your machine and follow the instructions that come up in your command line. There should be a QR code for you to read with your testing device of choice. Since we're using maps it's better to use a physical device than an emulator.
If you're interested in contributing but don't know where to start please contact either @DanielJDufour or @Bstrutt, or if you know what changes you want made, fork this repository, make your changes, and send us a pull request to merge your changes.