Skip to content

Commit 20e8224

Browse files
authored
docs: add F-Droid installation instructions (#92)
* docs: add F-Droid installation instructions * docs: put GitHub installation before F-Droid
1 parent 13c75cd commit 20e8224

6 files changed

Lines changed: 41 additions & 10 deletions

File tree

‎AGENTS.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,8 @@ branch names, credentials, signing material, or other secrets.
8484
fdroidrepo/fdroidrepos links use its API; other named installers use GitHub. Unknown installers
8585
or failed capability lookup require a source choice. Preserve the installed APK variant and existing version-code offsets. Downloads require explicit consent;
8686
ignored notifications repeat after a week, with skip-version and disable-checks actions.
87-
- The app is not yet available in F-Droid; do not document it as an installation source.
87+
- The app is available in F-Droid: https://f-droid.org/packages/net.megaproxy487/. Keep installation
88+
instructions for F-Droid and GitHub APKs in both English and Russian.
8889
- After creating and verifying a release, update the corresponding F-Droid submission/build recipe
8990
when required. The repository's F-Droid-related files are for reproducible verification, not an
9091
excuse to maintain a duplicate unused build path.

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -143,9 +143,9 @@ vendors may impose additional background-execution restrictions.
143143
## Installation
144144

145145
MegaProxy requires Android 8.0 (API 26) or newer. Download a signed APK from
146-
[GitHub Releases](https://github.com/andre487/AndroidMegaProxy/releases/latest).
146+
[GitHub Releases](https://github.com/andre487/AndroidMegaProxy/releases/latest) or install it through
147+
[F-Droid](https://f-droid.org/packages/net.megaproxy487/).
147148
For most users, choose **[mega-proxy-universal.apk](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)**.
148-
The app is not yet available in F-Droid.
149149

150150
Detailed instructions cover choosing an APK, installation permissions, checksums, ADB,
151151
updates without losing settings, and troubleshooting:

‎docs/en/installation.md‎

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Installing MegaProxy from an APK
1+
# Installing MegaProxy
22

33
[Русская инструкция](../ru/installation.md)
44

@@ -7,6 +7,8 @@
77
You need a phone or tablet running Android 8.0 or newer. No computer, commands, or GitHub account
88
are needed. An APK is an Android app installation file.
99

10+
### From a GitHub APK
11+
1012
**[Download the latest MegaProxy for Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)**
1113

1214
This permanent link points to the latest universal APK and stays the same when a new version is released.
@@ -36,7 +38,7 @@ including updates downloaded within MegaProxy. Menu names may vary.
3638
[Samsung instructions](https://www.samsung.com/us/support/answer/ANS10003636/).
3739

3840
Button names vary between phones. If a work device's administrator blocks installation, contact
39-
that administrator. The app is not yet available in F-Droid.
41+
that administrator.
4042

4143
**Updating:** download the new version using the same link, open the file, and confirm the update.
4244
Do not uninstall first; this preserves profiles and settings. If you previously installed an
@@ -45,6 +47,19 @@ see the update section below or ask a developer for help.
4547

4648
Update checks, notifications, skipped versions, and installation: [App updates](updates.md).
4749

50+
### Through F-Droid
51+
52+
1. Install the [F-Droid client](https://f-droid.org/) on your phone if you do not have it yet.
53+
2. Open F-Droid, wait for its catalog to refresh, and search for **MegaProxy**
54+
(`net.megaproxy487`). [App listing](https://f-droid.org/packages/net.megaproxy487/).
55+
3. Tap **Install**. If Android asks for permission to install apps from F-Droid,
56+
grant it and confirm installation.
57+
4. Open MegaProxy, add or import your server settings, and tap **Connect**.
58+
Confirm Android's VPN connection request.
59+
60+
You can install updates through F-Droid. MegaProxy does not provide servers or passwords:
61+
ask the person who set up your server for its settings.
62+
4863
## For developers: APK variants, verification, and troubleshooting
4964

5065
The section above is sufficient for a normal installation. The following technical information

‎docs/en/updates.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ MegaProxy queries the official per-app API and compares its **suggested**, publi
7171
with the installed APK. It does not choose a higher experimental version just because one exists.
7272
Installation is handled by F-Droid, including package selection and verification.
7373

74-
MegaProxy is not yet published in F-Droid. A missing listing is displayed as unavailable, not as
74+
A missing listing is displayed as unavailable, not as
7575
an up-to-date result. Network/API failures never silently switch the source to GitHub.
7676

7777
## GitHub

‎docs/ru/installation.md‎

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Установка MegaProxy из APK
1+
# Установка MegaProxy
22

33
[English installation instructions](../en/installation.md)
44

@@ -7,6 +7,8 @@
77
Понадобится телефон или планшет с Android 8.0 или новее. Компьютер, команды и аккаунт GitHub
88
не нужны. APK — это установочный файл приложения для Android.
99

10+
### Из APK с GitHub
11+
1012
**[Скачать последнюю версию MegaProxy для Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)**
1113

1214
Это постоянная ссылка на последний универсальный APK: она остаётся той же при выходе новых версий.
@@ -38,7 +40,7 @@
3840
[Инструкция Samsung](https://www.samsung.com/us/support/answer/ANS10003636/).
3941

4042
Названия кнопок могут отличаться в зависимости от телефона. Если установку запрещает администратор
41-
рабочего устройства, обратитесь к нему. Приложение пока не добавлено в F-Droid.
43+
рабочего устройства, обратитесь к нему.
4244

4345
**Обновление:** скачайте новую версию по той же ссылке, откройте файл и подтвердите обновление.
4446
Не удаляйте приложение перед этим — так сохранятся профили и настройки. Если раньше вы ставили
@@ -47,6 +49,19 @@
4749

4850
Проверки, уведомления, пропуск версий и установка: [Обновления приложения](updates.md).
4951

52+
### Через F-Droid
53+
54+
1. Установите [клиент F-Droid](https://f-droid.org/) на телефон, если его ещё нет.
55+
2. Откройте F-Droid, дождитесь обновления каталога и найдите **MegaProxy**
56+
(`net.megaproxy487`). [Карточка приложения](https://f-droid.org/packages/net.megaproxy487/).
57+
3. Нажмите **Установить**. Если Android запросит разрешение на установку приложений
58+
из F-Droid, выдайте его и подтвердите установку.
59+
4. Откройте MegaProxy, добавьте или импортируйте настройки своего сервера и нажмите
60+
**Подключить**. Подтвердите системный запрос на создание VPN-подключения.
61+
62+
Обновления можно устанавливать через F-Droid. MegaProxy не предоставляет серверы и пароли:
63+
получите настройки у человека, который настроил ваш сервер.
64+
5065
## Для разработчиков: варианты APK, проверка и диагностика
5166

5267
Для обычной установки достаточно раздела выше. Далее приведены технические сведения
@@ -56,7 +71,7 @@
5671

5772
Откройте [последний релиз](https://github.com/andre487/AndroidMegaProxy/releases/latest), разверните список **Assets** и скачайте файл с окончанием
5873
`universal.apk`. Это основной рекомендуемый вариант: он поддерживает все перечисленные ниже
59-
архитектуры. Приложение пока не добавлено в F-Droid. Для скачивания релизных APK аккаунт GitHub
74+
архитектуры. Для скачивания релизных APK аккаунт GitHub
6075
не нужен. При обновлении по возможности сохраняйте выбранный вариант APK.
6176

6277
| APK | Для каких устройств |

‎docs/ru/updates.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ MegaProxy обращается к официальному API приложен
7373
версии с установленным APK. Более высокая экспериментальная версия не выбирается только из-за
7474
большего кода. Установкой, выбором пакета и его проверкой занимается F-Droid.
7575

76-
Приложение пока не опубликовано в F-Droid. Отсутствие карточки показывается как недоступность,
76+
Отсутствие карточки показывается как недоступность,
7777
а не как отсутствие обновлений. При ошибке сети или API источник не переключается на GitHub.
7878

7979
## GitHub

0 commit comments

Comments
 (0)