# F-Droid - Overview

- <https://f-droid.org/en/packages/com.b44t.messenger/>
  is the Delta Chat page on F-Droid.org,
  the F-Droid app will show similar information.

- <https://github.com/deltachat/deltachat-android/tree/main/metadata>
  contains the description, icon, screenshots and all meta data shown for Delta Chat on F-Droid
  in the [fastlane format](https://f-droid.org/en/docs/All_About_Descriptions_Graphics_and_Screenshots/#fastlane-structure).

- <https://gitlab.com/fdroid/fdroiddata/blob/master/metadata/com.b44t.messenger.yml>
  contains [additional F-Droid-specific metadata](https://f-droid.org/en/docs/All_About_Descriptions_Graphics_and_Screenshots/#in-the-f-droid-repo)
  and build instructions that do not fit the fastlane format.
  F-Droid adds new versions automatically to the end of `.yml` file.

- New versions are recognized by tags in the form `v1.2.3` -
  before adding tags like that, have a look at
  <https://github.com/deltachat/deltachat-android/blob/main/RELEASE.md#release-on-f-droid>.
  The build and distribution is expected to take
  [up to 7 days](https://gitlab.com/fdroid/wiki/-/wikis/FAQ#how-long-does-it-take-for-my-app-to-show-up-on-website-and-client).


# F-Droid Build status

- <https://monitor.f-droid.org/builds>
  shows F-Droid's overall build status,
  if Delta Chat shows up at "Need updating" or "Running",
  things are working as expected. :)

- <https://f-droid.org/repo/com.b44t.messenger_VERSIONCODE.apk>  
  (with VERSIONCODE = 537 or so) links to successfully built apk
  even if it is not yet in the index (which may take some more time).
  F-Droid keeps the last 3 successful builds in the main repo,
  while the rest will be moved to the Archive repo:
  <https://f-droid.org/archive/com.b44t.messenger_VERSIONCODE.apk>


# Use F-Droid-tools locally

$ git clone https://gitlab.com/fdroid/fdroiddata  
$ git clone https://gitlab.com/fdroid/fdroidserver  
$ cd fdroiddata  

Now, metadata/com.b44t.messenger.yml can be modified.
For testing, one can change the repo to a branch
by adding the line `Update Check Mode:RepoManifest/BRANCH` to the file.

Set some path to ndk etc:  
$ cp ../fdroidserver/examples/config.py .  # adapt file as needed

Checkout repo as F-Droid would do:  
$ ../fdroidserver/fdroid checkupdates -v com.b44t.messenger  
(for testing with uncommitted changes, add --allow-dirty)

Build repo as F-Droid would do:  
$ ../froidserver/fdroid build -v com.b44t.messenger:<versionCode>

(via <https://f-droid.org/docs/Installing_the_Server_and_Repo_Tools/> 
and <https://f-droid.org/docs/Building_Applications/> -
might require `pip install pyasn1 pyasn1_modules pyaml requests`)


# Changing the description

- Change the files `metadata/en-US/short_description.txt`
  and `metadata/en-US/full_description.txt`
  in <https://github.com/deltachat/deltachat-android/> repository.

- Make sure there is a "newline" at the end of the description
  (see <https://gitlab.com/fdroid/fdroiddata/merge_requests/3580>).


# Changing F-Droid metadata

- The file `com.b44t.messenger.yml` can be changed via a PR to the <https://gitlab.com/fdroid/fdroiddata/> repository.

- Reformat the metadata using  
  $ ../fdroidserver/fdroid rewritemeta com.b44t.messenger  # called from fdroiddata dir