Launch forms via odkcollect:// links, with entity preselection

[zestyping]

This proof of concept enables the use of a browsable link to launch the FormFillingActivity on a specific form. A query parameter in the link can also preselect an entity in the form.

The implementation consists of three parts:

1. Add an <intent-filter> to the manifest entry for FormFillingActivity, which catches URLs that begin with odkcollect://form/

2. Add a branch in the FormLoaderTask that handles an incoming intent with this kind of URL by looking up a specific form by its Form ID (e.g. "trees_follow_up") rather than its internal id (e.g. "forms/2").

3. Add a method preselectEntity that pre-answers a question in the form, according to a query parameter in the URL. The parameter name should match the name of the question, and the parameter value should be the UUID of the entity.

With these changes, a webpage with a link such as the following will launch ODK Collect into the form filling flow, for a specific form, with an entity preselected:

Launch a form:
<a href="odkcollect://form/trees_follow_up?tree=71297c7d-6a22-4354-b08a-3fbee155d74e">
  trees_follow_up
</a>

For testing, the above HTML is available here so you can load it on a phone browser: https://zestyping.github.io/odkform

[spwoodcock]

Selecting the feature via the intent works perfectly.

I need to investigate further next week, but the form id in the intent URL seems to be causing an error on form submission hotosm/fmtm#1538

Perhaps the value of the form id is being injected somewhere it shouldn't be? When the form is submitted, the error is displayed: Sorry, form save failed! For input string: "x_form_id_here"

[spwoodcock]

Thanks @amias-samir for the fix!

The new build is available at:
https://github.com/hotosm/odkcollect/releases/tag/v2024.1.3-entity-select
https://github.com/hotosm/odkcollect/releases/download/v2024.1.3-entity-select/ODK-Collect-v2024.1.3-entity-select.apk

I cherry-picked this code on top of the 2024.1.3 release.
🎉

[spwoodcock]

I think something went wrong with the rebase: if it helps I can reset this to it's original state?

Let me know! 😃