ٍSky Pulse

️ SkyPulse – تطبيق الطقس الديناميكي

تطبيق طقس جميل تم تطويره لنظام أندرويد باستخدام Jetpack Compose، يتميّز بقدرته على تغيير مظهره بشكل ديناميكي بناءً على موقع المستخدم والظروف الجوية الحالية.

-----------------------------------------------------------------------------------------------------

الميزات

نظام الثيمات الديناميكي

الثيم المعتمد على الموقع: يتغير تصميم التطبيق تلقائيًا حسب موقع المستخدم الحالي.

واجهة متجاوبة مع الطقس: ألوان وتدرجات الخلفية تتبدل تلقائيًا حسب حالة الطقس.

وضع النهار/الليل: يقوم التطبيق بالتبديل تلقائيًا بين وضع النهار (تدرج أزرق فاتح) ووضع الليل (تدرج بنفسجي غامق).

---------------------------------------------------------------------------------------------------------

خدمات الموقع

تحديد الموقع عبر GPS: يكتشف التطبيق موقعك الحالي تلقائيًا باستخدام GPS.

تحويل الإحداثيات إلى أسماء مدن: باستخدام Geocoder لتحويل الإحداثيات إلى أسماء قابلة للقراءة.

إدارة الأذونات الذكية: للتعامل مع أذونات الوصول للموقع بطريقة آمنة وفعالة.

-------------------------------------------------------------------------------------------------------------------------------

️ معلومات الطقس

الطقس الحالي: عرض درجة الحرارة، نسبة الرطوبة، سرعة الرياح، والضغط الجوي في الوقت الفعلي.

توقعات كل ساعة: توقعات تفصيلية لحالة الطقس لكل ساعة.

توقعات الأيام القادمة: نظرة شاملة على الطقس لعدة أيام مع درجات الحرارة الصغرى والكبرى.

أيقونات الطقس: أيقونات جميلة وذكية تعبّر عن الحالة الجوية بدقة.

بيانات شاملة: مؤشر الأشعة فوق البنفسجية، احتمال الهطول، وضغط السطح.

----------------------------------------------------------------------------------------------------------------------

الحالات الجوية المدعومة

سماء صافية – غيوم جزئية – غيوم كثيفة – ضباب – رذاذ بأشكال متعددة – أمطار – ثلوج – عواصف رعدية – والعديد من الحالات الأخرى.

️ التقنيات المستخدمة

? الهيكل المعماري

نمط MVVM: لفصل المهام بين واجهة المستخدم والمنطق البرمجي.

Clean Architecture: تقسيم المشروع إلى طبقات (Domain، Data، Presentation).

حقن الاعتمادية (Dependency Injection): باستخدام Koin لإدارة المكونات.

--------------------------------------------------------------------------------------------------------------------------

التقنيات

Jetpack Compose: أداة واجهات حديثة من أندرويد.

Kotlin: اللغة الأساسية للتطوير.

Ktor: عميل HTTP للتعامل مع واجهات الـAPI.

Kotlin Coroutines: للبرمجة غير المتزامنة.

Navigation Compose: للتنقل الآمن بين الشاشات.

Material Design 3: لتصميم واجهات عصرية.

Accompanist: مكتبة إضافية لتحسين تجربة Compose.

-------------------------------------------------------------------------------------------------------------

تكامل API

Open-Meteo API: واجهة مجانية لتوقعات الطقس.

تحديثات آنية: بيانات الطقس في الوقت الفعلي.

تغطية عالمية: دعم لجميع المواقع حول العالم.

---------------------------------------------------------------------------------------------------------------------

البدء بالاستخدام

المتطلبات

Android Studio Hedgehog أو أحدث

Android SDK 24+ (أندرويد 7.0)

Kotlin 2.0.21+

Gradle 8.10.1+

------------------------------------------------------------------------------------------------------

الأذونات المطلوبة

ACCESS_FINE_LOCATION: لتحديد الموقع بدقة.

ACCESS_COARSE_LOCATION: لتحديد الموقع التقريبي.

INTERNET: للاتصال بواجهة الطقس (API).

---------------------------------------------------------------------------------------------------------

نظام الثيمات

وضع النهار: تدرج أزرق سماوي، خلفية بيضاء إلى زرقاء، وأيقونات مشرقة.

وضع الليل: تدرج بنفسجي داكن مع أيقونات ليلية ناعمة.

استجابة للطقس: خلفيات متغيرة وألوان متناسقة مع الحالة الجوية.

---------------------------------------------------------------------------------------------------------------------------

المكتبات الأساسية

Compose BOM 2025.06.00

Ktor 2.3.8

Koin 3.5.3

Coroutines 1.10.2

Navigation Compose 2.7.0

Accompanist 0.31.4-beta