diff --git a/AGENTS.md b/AGENTS.md index f5e652f..4c114d9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -84,7 +84,8 @@ branch names, credentials, signing material, or other secrets. fdroidrepo/fdroidrepos links use its API; other named installers use GitHub. Unknown installers or failed capability lookup require a source choice. Preserve the installed APK variant and existing version-code offsets. Downloads require explicit consent; ignored notifications repeat after a week, with skip-version and disable-checks actions. -- The app is not yet available in F-Droid; do not document it as an installation source. +- The app is available in F-Droid: https://f-droid.org/packages/net.megaproxy487/. Keep installation + instructions for F-Droid and GitHub APKs in both English and Russian. - After creating and verifying a release, update the corresponding F-Droid submission/build recipe when required. The repository's F-Droid-related files are for reproducible verification, not an excuse to maintain a duplicate unused build path. diff --git a/README.md b/README.md index 11cba14..cf2e7c2 100644 --- a/README.md +++ b/README.md @@ -143,9 +143,9 @@ vendors may impose additional background-execution restrictions. ## Installation MegaProxy requires Android 8.0 (API 26) or newer. Download a signed APK from -[GitHub Releases](https://github.com/andre487/AndroidMegaProxy/releases/latest). +[GitHub Releases](https://github.com/andre487/AndroidMegaProxy/releases/latest) or install it through +[F-Droid](https://f-droid.org/packages/net.megaproxy487/). For most users, choose **[mega-proxy-universal.apk](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)**. -The app is not yet available in F-Droid. Detailed instructions cover choosing an APK, installation permissions, checksums, ADB, updates without losing settings, and troubleshooting: diff --git a/docs/en/installation.md b/docs/en/installation.md index ad1be6d..8c6978f 100644 --- a/docs/en/installation.md +++ b/docs/en/installation.md @@ -1,4 +1,4 @@ -# Installing MegaProxy from an APK +# Installing MegaProxy [Русская инструкция](../ru/installation.md) @@ -7,6 +7,8 @@ You need a phone or tablet running Android 8.0 or newer. No computer, commands, or GitHub account are needed. An APK is an Android app installation file. +### From a GitHub APK + **[Download the latest MegaProxy for Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)** 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. [Samsung instructions](https://www.samsung.com/us/support/answer/ANS10003636/). Button names vary between phones. If a work device's administrator blocks installation, contact -that administrator. The app is not yet available in F-Droid. +that administrator. **Updating:** download the new version using the same link, open the file, and confirm the update. 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. Update checks, notifications, skipped versions, and installation: [App updates](updates.md). +### Through F-Droid + +1. Install the [F-Droid client](https://f-droid.org/) on your phone if you do not have it yet. +2. Open F-Droid, wait for its catalog to refresh, and search for **MegaProxy** + (`net.megaproxy487`). [App listing](https://f-droid.org/packages/net.megaproxy487/). +3. Tap **Install**. If Android asks for permission to install apps from F-Droid, + grant it and confirm installation. +4. Open MegaProxy, add or import your server settings, and tap **Connect**. + Confirm Android's VPN connection request. + +You can install updates through F-Droid. MegaProxy does not provide servers or passwords: +ask the person who set up your server for its settings. + ## For developers: APK variants, verification, and troubleshooting The section above is sufficient for a normal installation. The following technical information diff --git a/docs/en/updates.md b/docs/en/updates.md index 643bed9..ed0e654 100644 --- a/docs/en/updates.md +++ b/docs/en/updates.md @@ -71,7 +71,7 @@ MegaProxy queries the official per-app API and compares its **suggested**, publi with the installed APK. It does not choose a higher experimental version just because one exists. Installation is handled by F-Droid, including package selection and verification. -MegaProxy is not yet published in F-Droid. A missing listing is displayed as unavailable, not as +A missing listing is displayed as unavailable, not as an up-to-date result. Network/API failures never silently switch the source to GitHub. ## GitHub diff --git a/docs/ru/installation.md b/docs/ru/installation.md index 9d5a4fc..4bef029 100644 --- a/docs/ru/installation.md +++ b/docs/ru/installation.md @@ -1,4 +1,4 @@ -# Установка MegaProxy из APK +# Установка MegaProxy [English installation instructions](../en/installation.md) @@ -7,6 +7,8 @@ Понадобится телефон или планшет с Android 8.0 или новее. Компьютер, команды и аккаунт GitHub не нужны. APK — это установочный файл приложения для Android. +### Из APK с GitHub + **[Скачать последнюю версию MegaProxy для Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)** Это постоянная ссылка на последний универсальный APK: она остаётся той же при выходе новых версий. @@ -38,7 +40,7 @@ [Инструкция Samsung](https://www.samsung.com/us/support/answer/ANS10003636/). Названия кнопок могут отличаться в зависимости от телефона. Если установку запрещает администратор -рабочего устройства, обратитесь к нему. Приложение пока не добавлено в F-Droid. +рабочего устройства, обратитесь к нему. **Обновление:** скачайте новую версию по той же ссылке, откройте файл и подтвердите обновление. Не удаляйте приложение перед этим — так сохранятся профили и настройки. Если раньше вы ставили @@ -47,6 +49,19 @@ Проверки, уведомления, пропуск версий и установка: [Обновления приложения](updates.md). +### Через F-Droid + +1. Установите [клиент F-Droid](https://f-droid.org/) на телефон, если его ещё нет. +2. Откройте F-Droid, дождитесь обновления каталога и найдите **MegaProxy** + (`net.megaproxy487`). [Карточка приложения](https://f-droid.org/packages/net.megaproxy487/). +3. Нажмите **Установить**. Если Android запросит разрешение на установку приложений + из F-Droid, выдайте его и подтвердите установку. +4. Откройте MegaProxy, добавьте или импортируйте настройки своего сервера и нажмите + **Подключить**. Подтвердите системный запрос на создание VPN-подключения. + +Обновления можно устанавливать через F-Droid. MegaProxy не предоставляет серверы и пароли: +получите настройки у человека, который настроил ваш сервер. + ## Для разработчиков: варианты APK, проверка и диагностика Для обычной установки достаточно раздела выше. Далее приведены технические сведения @@ -56,7 +71,7 @@ Откройте [последний релиз](https://github.com/andre487/AndroidMegaProxy/releases/latest), разверните список **Assets** и скачайте файл с окончанием `universal.apk`. Это основной рекомендуемый вариант: он поддерживает все перечисленные ниже -архитектуры. Приложение пока не добавлено в F-Droid. Для скачивания релизных APK аккаунт GitHub +архитектуры. Для скачивания релизных APK аккаунт GitHub не нужен. При обновлении по возможности сохраняйте выбранный вариант APK. | APK | Для каких устройств | diff --git a/docs/ru/updates.md b/docs/ru/updates.md index 51cc0cd..613ed2c 100644 --- a/docs/ru/updates.md +++ b/docs/ru/updates.md @@ -73,7 +73,7 @@ MegaProxy обращается к официальному API приложен версии с установленным APK. Более высокая экспериментальная версия не выбирается только из-за большего кода. Установкой, выбором пакета и его проверкой занимается F-Droid. -Приложение пока не опубликовано в F-Droid. Отсутствие карточки показывается как недоступность, +Отсутствие карточки показывается как недоступность, а не как отсутствие обновлений. При ошибке сети или API источник не переключается на GitHub. ## GitHub