README_ar.md

WeatherAPP

🌐

📜 الوصف

WeatherApp هو تطبيق أندرويد بسيط يسمح للمستخدمين بالبحث في الوقت الفعلي عن معلومات الطقس في أي مدينة باستخدام OpenWeather API. من خلال واجهة مستخدم بديهية، يمكن للمستخدمين الاطلاع على درجة الحرارة الحالية، ودرجة الحرارة المحسوسة، والرطوبة، وآخر وقت تم تحديثه.

🌟 الميزات

• البحث في الوقت الفعلي عن الطقس في المدينة.
• عرض درجة الحرارة الحالية (بالدرجات المئوية)، ودرجة الحرارة المحسوسة، والرطوبة، واسم المدينة.
• واجهة بسيطة وسهلة الاستخدام.
• رسائل Toast مخصصة للإشعارات والأخطاء.

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

• Kotlin: لغة البرمجة الرئيسية لتطوير التطبيق.
• Coroutines: تُستخدم للعمليات غير المتزامنة، مثل طلبات API للطقس.
• Retrofit: مكتبة للتفاعل مع RESTful API.
• OpenWeather API: API للحصول على معلومات الطقس.
• Material Design: مكونات تصميم المواد من أندرويد، تقدم واجهة مستخدم مرئية جذابة.
• Toast مخصص: لعرض رسائل الخطأ بشكل أكثر وضوحًا.

⚙️ إعداد المشروع

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

- Android Studio 4.1 أو إصدار أعلى.
- Gradle 7.0 أو إصدار أعلى.
- التسجيل للحصول على حساب على [OpenWeather API](https://openweathermap.org/api) للحصول على مفتاح API.

التثبيت

1. استنساخ المستودع:
   ```bash
   git clone git@github.com:SamuelRocha91/kotlinWeatherApp.git
   ```

2. افتح المشروع في **Android Studio**.

3. أضف مفتاح API الخاص بك إلى ملف `local.properties`:
   ```
   API_KEY=your_api_key_here
   ```

4. قم ببناء المشروع وتشغيله على محاكي أو جهاز أندرويد.

📂 هيكل الشيفرة

• MainActivity.kt: النشاط الرئيسي للتطبيق، يدير واجهة المستخدم ويتعامل مع تفاعلات المستخدم.
• OpenWeather.kt: تعريف واجهة الاتصال مع API للطقس، باستخدام Retrofit.
• الأدوات: وظائف مساعدة، مثل تحويل الطوابع الزمنية UNIX إلى تنسيق مقروء، يمكن استخراجها ووضعها في فئة أدوات.
• التخطيطات: ملفات تخطيط XML المحددة في مجلد res/layout، بما في ذلك بنية واجهة المستخدم.

📦 التبعيات

• implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.5.2"
• implementation "com.squareup.retrofit2:retrofit:2.9.0"
• implementation "com.squareup.retrofit2:converter-gson:2.9.0"
• implementation "com.google.android.material:material:1.4.0"

🧑‍🤝‍🧑 كيفية الاستخدام

1. افتح التطبيق.
2. أدخل اسم المدينة في مربع البحث.
3. انقر على زر "بحث".
4. تحقق من معلومات الطقس، بما في ذلك:
   • درجة الحرارة الحالية.
   • درجة الحرارة المحسوسة.
   • الرطوبة.
   • اسم المدينة والدولة.

📁 مشاريع كوتلن أخرى:

• 📜 قائمة الطعام الافتراضية
• 👤 تسجيل الدخول الاجتماعي
• 💱 سعر الصرف