Skip to content

Plant-for-the-Planet-org/treemapper

develop
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
app
 
 
ios
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

TreeMapper App

iOS build on MacOS Android build on Ubuntu

TreeMapper is open source application based on react-native licensed under terms of GPL v3. It is managed by Plant-for-the-Planet Foundation and open source contributors.

For contributions please read our contribution guide as well as our code of conduct and the following information:

TreeMapper on Web

Data uploaded by TreeMapper can be viewed on the Plant-for-the-Planet Platform Screen Shot 2021-08-04 at 4 05 38 PM

Directory Structure

ios houses the iOS project files and android contains Android project files. The app contains the react code base for all platform.

index.js is the entry point of both iOS and android platform build process.

Configuration

Copy .env.sample to .env and add the necessary API keys for your development environment. Install nvm following instructions from https://github.com/nvm-sh/nvm#install--update-script Run nvm install && nvm use to install and use required version of node.

iOS Setup

  • Install latest Xcode.
  • Run following commands
bash
brew install node
brew install watchman
npm install -g react-native-cli
npm install
cd ios && pod install

Running into iOS simulator

Build and run the app in development mode deployed from Metro Bundler in an iOS simulator (starts Metro Bundler automatically if not already running, also starts iOS simulator):

bash
npm run ios

If you have problems with a cached version of the bundle, you can stop the Metro Bundler and manually start it with the reset cache option:

react-native start --reset-cache

Android Setup

Steps for setting up Dev Env for android on MAC is as follows:

  • Install Latest Android Studio.
  • From Android studio’s SDK Manager add SDK 28 and Build tool Version 28.0.3
  • Install JDK 8 if not already there and set JAVA_HOME specific to your JDK Version (below version number is just an example).
  • Create .bash_profile if not already there and add following variables in it:
bash
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_191.jdk/Contents/Home
  • Run following commands
bash
brew install node
brew install watchman
npm install -g react-native-cli
npm install

Running into Android emulator

Build and run the app in development mode deployed from Metro Bundler (starts Metro Bundler automatically if not already running) on an emulator or device. You need to start an Android emulator or attach a device manually before:

bash
npm run android

If you have problems with a cached version of the bundle, you can stop the Metro Bundler and manually start it with the reset cache option:

react-native start --reset-cache

Development process

This project uses GitFlow (https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow) with Master-Branch master and Development-Branch develop.

Versioning

App Versioning Guide

eg: Version M.F.B V 1.1.10

M = Major Changes F = Feature Addition B = Critical Bug Fixes and Additions

Release candidate can have the target version number V 1.1.11 RC 1

Beta and Alpha builds can also have target version number V 1.1.11 B 12 V 1.1.11 A 12 [increment per release]

Supporters

The deployment and production of this app is also possible due to support from open-source software contributors.              

About

TreeMapper extends the Plant-for-the-Planet Platform and allows on site data registration for restoration initiatives.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks