

پلتفرم: اندروید (Native - Kotlin)
وضعیت فعلی: حدود ۹۵٪ توسعه انجام شده – نیاز به نهاییسازی و تولید خروجی APK
ویژگیها:
دریافت قیمت از APIها و در صورت قطع، استخراج از صفحات HTML با Web Scraping
ویجت حرفهای ۲×۲ برای صفحه اصلی اندروید
تحلیل روند قیمتها و هشدارهای صعودی/نزولی
سبک طراحی مینیمال + پشتیبانی از حالت تیره
بهینهسازی برای مصرف رم، CPU و حذف کش شبانه --- ساختار فایلهای پروژه
مسیر توضیح
/app/src/main/java/ فایلهای اصلی Kotlin شامل صفحات، تحلیلگرها و web scraper /app/src/main/res/layout/ رابطهای کاربری XML برای صفحات و ویجت /app/src/main/res/drawable/ آیکونها و منابع گرافیکی /app/src/main/AndroidManifest.xml تنظیمات ویجت، دسترسیها و اکتیویتیها /app/src/main/res/xml/widget_info.xml مشخصات ویجت اندروید /build.gradle وابستگیها و پیکربندی Gradle (Jsoup, Retrofit, WorkManager و ...) --- مراحل کار فریلنسر
- تنظیم محیط توسعه
نصب Android Studio (ترجیحاً نسخه Arctic Fox یا بالاتر)
باز کردن پروژه از مسیر فایل ZIP
همگامسازی Gradle (File > Sync Project with Gradle Files)
نصب SDK با حداقل API 33 یا بالاتر ---
- تست عملکرد پروژه
اجرای پروژه روی شبیهساز یا موبایل واقعی
بررسی صفحه اصلی (MainActivity)
بررسی عملکرد دریافت قیمت از منابع مختلف (API + HTML)
بررسی ویجت روی صفحه خانگی (رفرش، رنگ، فلش صعود/نزول) ---
- نهاییسازی Web Scraping
فایل مربوط به Web Scraper در مسیر:
/utils/WebScraper.kt
حاوی کد استفاده از Jsoup برای استخراج قیمت از سایتهایی مانند:
tgju.org
mesghal.live
web.archive یا صفحات HTML ثابت در صورت نیاز
بررسی Selectors برای اطمینان از عملکرد صحیح Jsoup.parse ---
- خروجی APK (نهایی)
برای ساخت خروجی نهایی APK:
از مسیر Android Studio:
Build > Generate Signed APK
استفاده از keystore برای امضای نهایی (یا ساخت keystore جدید)
انتخاب Build Variant → release -
- وظایف پایانی پیشنهادی
تنظیم فایل Clear Cache (با AlarmManager یا WorkManager برای پاکسازی شبانه)
تست نهایی ویجت روی Android 14 و 13
افزودن Splash Screen (در صورت نیاز)
فشردهسازی سایز APK (با استفاده از R8 یا Proguard)


