From cee80685d732a050ce1d5a8f1181ca0522154be5 Mon Sep 17 00:00:00 2001
From: Sarto <sartoopjj@gmail.com>
Date: Sat, 2 May 2026 16:15:53 +0330
Subject: [PATCH] fix: update Android APK filenames and documentation for
 clarity

---
 .github/workflows/build.yml | 12 ++++++------
 README-FA.md                | 13 +++++++++++++
 README.md                   | 10 +++++++---
 3 files changed, 26 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 571a03b..bc57ea3 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -186,16 +186,16 @@ jobs:
           ./gradlew --no-daemon clean $TASK
 
           APK_DIR=app/build/outputs/apk/$BT
-          cp "$APK_DIR"/app-arm64-v8a-${BT}.apk    ../artifacts/thefeed-android-${VERSION}-arm64.apk
-          cp "$APK_DIR"/app-armeabi-v7a-${BT}.apk  ../artifacts/thefeed-android-${VERSION}-arm.apk
+          cp "$APK_DIR"/app-arm64-v8a-${BT}.apk    ../artifacts/thefeed-android-${VERSION}-arm64-v8a.apk
+          cp "$APK_DIR"/app-armeabi-v7a-${BT}.apk  ../artifacts/thefeed-android-${VERSION}-armeabi-v7a.apk
 
       - name: Upload Android APK artifacts
         uses: actions/upload-artifact@v4
         with:
           name: thefeed-android-apk
           path: |
-            artifacts/thefeed-android-*-arm64.apk
-            artifacts/thefeed-android-*-arm.apk
+            artifacts/thefeed-android-*-arm64-v8a.apk
+            artifacts/thefeed-android-*-armeabi-v7a.apk
 
   release:
     needs: [build, android-apk]
@@ -227,5 +227,5 @@ jobs:
             | FreeBSD | amd64 | [server-سرور](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-server-freebsd-amd64) / [client-کلاینت](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-client-${{ github.ref_name }}-freebsd-amd64) |
             | FreeBSD | arm64 | [server-سرور](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-server-freebsd-arm64) / [client-کلاینت](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-client-${{ github.ref_name }}-freebsd-arm64) |
             | Windows | amd64 | [server-سرور](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-server-windows-amd64.exe) / [client-کلاینت](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-client-${{ github.ref_name }}-windows-amd64.exe) |
-            | Android | arm64 (v8a) | [thefeed-android-${{ github.ref_name }}-arm64.apk - اندروید](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-android-${{ github.ref_name }}-arm64.apk) |
-            | Android | arm (v7a)   | [thefeed-android-${{ github.ref_name }}-arm.apk - اندروید (دستگاه‌های قدیمی‌تر)](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-android-${{ github.ref_name }}-arm.apk) |
+            | Android | arm64-v8a (most modern phones) | [thefeed-android-${{ github.ref_name }}-arm64-v8a.apk - اندروید (گوشی‌های جدید)](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-android-${{ github.ref_name }}-arm64-v8a.apk) |
+            | Android | armeabi-v7a (older 32-bit phones) | [thefeed-android-${{ github.ref_name }}-armeabi-v7a.apk - اندروید (دستگاه‌های قدیمی‌تر)](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/thefeed-android-${{ github.ref_name }}-armeabi-v7a.apk) |
diff --git a/README-FA.md b/README-FA.md
index 8f053b8..86aeedb 100644
--- a/README-FA.md
+++ b/README-FA.md
@@ -330,6 +330,19 @@ chmod +x thefeed-client
 # مرورگر را باز کنید: http://127.0.0.1:8080
 ```
 
+### اندروید (نسخه APK)
+
+از صفحه‌ی [Releases](https://github.com/sartoopjj/thefeed/releases) فایل APK مناسب گوشی خود را دانلود کنید:
+
+- `thefeed-android-<version>-arm64-v8a.apk` — برای گوشی‌های ۶۴ بیتی (تقریباً همه‌ی گوشی‌های جدید از سال ۱۳۹۶ به بعد). **این گزینه برای اکثر کاربران درست است.**
+- `thefeed-android-<version>-armeabi-v7a.apk` — فقط برای گوشی‌های قدیمی ۳۲ بیتی.
+
+> ⚠️ اگر نسخه‌ی اشتباه را نصب کنید، اندروید ممکن است نصب را قبول کند ولی باینری داخل APK اجرا نشود و برنامه کار نکند. اگر مطمئن نیستید، نسخه‌ی `arm64-v8a` را انتخاب کنید.
+>
+> برای دیدن معماری دقیق گوشی: تنظیمات → درباره‌ی گوشی → یا با اپ‌هایی مثل CPU-Z معماری CPU را ببینید (`arm64-v8a` یا `armeabi-v7a`).
+
+برنامه در اولین اجرا اجازه‌ی Battery Optimization Exemption را می‌گیرد تا سرویس پس‌زمینه توسط سیستم بسته نشود.
+
 ## ⚙️ تنظیمات DNS
 
 شما به **دو رکورد DNS** نیاز دارید. فرض کنید IP سرور شما `203.0.113.10` است:
diff --git a/README.md b/README.md
index f963943..4ba9511 100644
--- a/README.md
+++ b/README.md
@@ -438,7 +438,11 @@ chmod +x thefeed-client
 
 #### Android (Native APK Wrapper)
 
-> download it from the latest release assets: `thefeed-android-arm64.apk`
+> download it from the latest release assets:
+> - `thefeed-android-<version>-arm64-v8a.apk` — modern 64-bit phones (most devices since 2017)
+> - `thefeed-android-<version>-armeabi-v7a.apk` — older 32-bit phones
+>
+> If you install the wrong one, Android may accept the install but the bundled native binary won't run. Pick `arm64-v8a` unless you know your device is 32-bit only.
 
 The Android app automatically requests battery optimization exemption on first launch so the background service is not killed by the OS.
 
@@ -539,8 +543,8 @@ Rule:
 
 Release assets include:
 - Server/client binaries for all current target platforms
-- Native Android wrapper APK (raw client): `thefeed-android-arm64.apk`
-- Native Android wrapper APK (UPX client): `thefeed-android-arm64-upx.apk`
+- Native Android wrapper APK (64-bit, recommended): `thefeed-android-<version>-arm64-v8a.apk`
+- Native Android wrapper APK (32-bit, legacy devices): `thefeed-android-<version>-armeabi-v7a.apk`
 
 ## DNS Records Setup