Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

More details in F-Droid progress steps #273

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 15 additions & 9 deletions _i18n/en/documentation/general/f-droid.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,23 @@ Did you see that there's a new AntennaPod release and wonder:
* _why isn't the latest version not on F-Droid yet?_
* _when will the new release be available on F-Droid?_

If the new version is in beta, it is _only_ available through Google Play ((here is why)[/documentation/general/beta]). When we think it's ready we upload it to Google Play. A few days later, when we're confident there are no critical bugs, we tag the release on GitHub. F-Droid then has to find out about this release, build it and make it available. All these steps may take some time.
Due to the different steps and because we are not involved in publishing releases on F-Droid, we can't tell when exactly the latest version will be available there. It usually takes a few days after the release is tagged on GitHub.
If the new version is in beta, it is _only_ available through Google Play ([here is why](/documentation/general/beta)). When we think it's ready we upload it to Google Play. A few days later, when we're confident there are no critical bugs, we tag the release on GitHub. F-Droid then has to find out about this release, build it and make it available. All these steps may take some time.

In short: it may take some time. Please be patient.
Due to the different steps and because we are not involved in publishing releases on F-Droid, we can't tell when exactly the latest version will be available there. It usually takes four to seven days after the [release](https://github.com/AntennaPod/AntennaPod/releases) is tagged on GitHub.

### The steps of getting a new version on F-Droid
- After we create a [release](https://github.com/AntennaPod/AntennaPod/releases), F-Droid needs to detect that something in AntennaPod changed. For this, F-Droid runs an update checker server about every 2 days.
- After F-Droid detects that there is a new AntennaPod release, it builds the app. With this, F-Droid makes sure that the app you download really matches the source code that AntennaPod publishes. Because there are many apps to build, the F-Droid server takes an additional 1-2 days to build the app.
- Finally, the resulting app needs to get signed cryptographically. This happens on a computer that is not connected to the internet. A person at F-Droid needs to take the app and physically walk it to that special computer. How long this takes depends on how often the person walks to that special computer. Usually, this step takes an additional 1-2 days after the app was built.
**In short: it may take some time. Please be patient.**

### What you can do if it takes longer than expected
As you can see it can easily take a week before a new AntennaPod release is available on F-Droid. If an update is still not available more than a week after its release, feel free to let us know by creating a post on our [forum](https://forum.antennapod.org/), and we'll investigate it.
Is an update still not available on F-Droid more than a week after its release? Feel free to let us know by creating a post on our [forum](https://forum.antennapod.org/c/support/7).

### What steps are needed to get a new version on F-Droid
- After we create a release, F-Droid needs to detect that something in AntennaPod changed. For this, F-Droid has an update checker server which runs daily (in EU night hours).
- After F-Droid detects that there is a new AntennaPod release, it builds the app. With this, F-Droid makes sure that the app you download really matches the source code that AntennaPod publishes. Because there are many apps to build, the F-Droid server takes an additional 1-2 days to build the app.
- Then the resulting app needs to get signed cryptographically. This happens on a computer that is not connected to the internet. A person at F-Droid needs to take the app and physically walk it to that special computer. How long this takes depends on how often the person walks to that special computer. Usually, this step takes an additional 1-2 days after the app was built.
- Finally, after the new release was updated, the F-Droid app on your phone (and the F-Droid website) need to get the new index of apps.

You can get an idea of the progress by checking [if F-Droid's releases list was updated](https://gitlab.com/fdroid/fdroiddata/-/commits/master?search=Update+known+apks) since the new AntennaPod release and by checking on [F-Droid Monitor](https://monitor.f-droid.org/builds/build) if the new release was built yet.
### How you can check the progress
1. Check if [F-Droid's AntennaPod versions list](https://gitlab.com/fdroid/fdroiddata/-/commits/master/metadata/de.danoeh.antennapod.yml) was updated since the new [release was tagged on GitHub](https://github.com/AntennaPod/AntennaPod/releases/latest) (you may need to hover, for example, 'last week' to see the exact date on GitHub).
2. Check if AntennaPod was built in the [running cycle](https://monitor.f-droid.org/builds/running) or the [last cycle](https://monitor.f-droid.org/builds/build). Note that there's no queue for apps that need to be built.
* If AntennaPod is not listed in the success and fail lists yet, you can check whether the release will be included in the respective cycles: click on 'fdroiddata version' @ commit of a build cycle, click on 'Find file', type `de.antennapod`, click on the file, and check if it includes the latest release.
3. Check if the release is included in latest `known_apks.txt` ([download](https://gitlab.com/fdroid/fdroiddata/-/raw/master/stats/known_apks.txt?inline=false) the file and search for AntennaPod, or check the file's [commits](https://gitlab.com/fdroid/fdroiddata/-/commits/master/stats/known_apks.txt)). If the file includes the latest AntennaPod release, it means that it has been cryptographically signed and uploaded, and that it should appear soon on the F-Droid website and in the app.