App for cataloguing trees planted and allowing the recorded trees to be uploaded via a custom API to a centralised database. Mainly used by people who plant trees so they don't have to manually type coordinates with pictures they took and then try to guess the site/species afterwards.
- Make sure you have downloaded Xcode 13.4+
- Open the project in Xcode (you'll notice the dependencies will start to fetch in the background). (In the meantime, Xcode will need to fetch dependencies for the project... 😴)
- The signing settings for the project are configured for our CICD build pipeline, and will not allow you to build and run the app on your own device. To fix this, simply enable automatic signing in XCode and update the bundle identifier to something unique to you. This will update the .xcodeproj file accordingly. NOTE Changes to signing settings must not be checked in, as these will break the automated builds.
- Running the
Tree Trackerscheme will use the API settings you configure in your secrets file. - When running on a device, you'll also need to trust the certificate in Settings -> General -> Profiles, otherwise you'll see an error after installing the build and before running it.
Cloudinary is used as an image storage and manipulation service, to temporarily hold captured images of the trees and allow these to be quickly resized for our needs.
- Create a free account on Cloudinary (this will give you the needed Cloud name).
- Now create an upload preset (this will give you the Upload Preset name).
- Keep the keys as you'd need to add them to Secrets.swift later on.
We use Rollbar for centralised logging of errors, to help us troubleshoot issues with the app during real world usage.
If you wish, you can sign up for a free Rollbar account, generate your own API token and provide it through ROLLBAR_AUTH_TOKEN to see telemetry in Rollbar during development. This can be useful if you are specifically adding telemetry features, but otherwise is probably more complex than just looking at the logs in XCode console.
If you choose not to setup Rollbar, simply add a dummy value for ROLLBAR_AUTH_TOKEN and any Rollbar calls will silently fail.
Now, to run the project, we'll need to generate the Secrets file. This means you need to run first install pouch (the easiest is using brew install sunshinejr/formulae/pouch). Now, you need to have these environment variables available. It would be wise to prepare this file once and keep it somewhere obvious but take care not to check it in to Git. You can simply source the file whenever you need to regenerate Secrets.
export CLOUDINARY_CLOUD_NAME=qqq2ek4mq
export CLOUDINARY_UPLOAD_PRESET_NAME=iadfadff
export PROTECT_EARTH_API_TOKEN="n|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export PROTECT_EARTH_API_BASE_URL="api.endpoint.com"
export PROTECT_EARTH_ENV_NAME=Development
export ROLLBAR_AUTH_TOKEN=yourRollbarToken
In the root folder, run pouch, which should generate a file at ./TreeTracker/Secrets.swift.
With all that, you can switch the scheme to Tree Tracker and it should run just fine.
Please feel free to create issues and PRs for anything, really. However, bear in mind that this app is created for specific audience so PRs with functionality that is out of scope might not be merged (if you feel like the PR you're working on is questionable, please feel free to reach out via Issues).