Skip to content

Repository files navigation

Ezan Hatırlatıcı — Islamic Prayer Times & Life Assistant 🕌

Ezan Hatırlatıcı Logo

Son Final Sürüm CI/CD Build Android 5.0+ Flutter & Dart Material 3 License MIT

Namaz vakitlerini takip edin, insan sesli ezan ve kişiselleştirilmiş bildirimler alın.
Android ve iOS için Flutter & Material 3 ile geliştirilmiş, çevrimdışı önbellekli ve tam donanımlı İslami yaşam asistanı.

↓ Son Final APK'yı İndir (v5.3.0) · Kurulum · Sürüm Notları · İmzalama · Mimari · Geri Bildirim


🕌 Tamamen Ücretsiz, Reklamsız ve Açık Kaynaklı. Kullanıcı verilerini izlemez; tüm konum, takvim ve bildirim ayarları cihazınızda yerel olarak saklanır.


🌟 Neler Sunuyor?

Ezan Hatırlatıcı, sıradan vakit uygulamalarının ötesinde, her vakit için bağımsız bildirim zamanlaması, gerçek dünya ezanları, donanımsal kıble pusulası, dokunsal zikirmatik ve manuel vakit tolerans motoru sunar.

Modül / Özellik Nasıl Çalışır ve Ne Sağlar?
⏱️ Manuel Tolerans (Offset) Her vakit için (Sabah, Güneş, Öğle, İkindi, Akşam, Yatsı) yerel cami veya takviminize göre +/- 15 dakikaya kadar ince ayar yapabilme.
📊 Canlı İlerleme Göstergesi Bir sonraki vakte kalan süreyi ve mevcut vakit aralığının tamamlanma yüzdesini gösteren canlı dinamik ilerleme çubuğu.
🕌 5 Dünya Ezanı & Manevi Tonlar Mekke 🕋, Medine 🕌, İstanbul 🇹🇷, Mısır (Kahire) 🇪🇬 ve Mescid-i Aksa (Kudüs) 🇵🇸 makamlarında gerçek ezan okumaları; Ney, Çağrı müziği ve Salavat tonları.
🔔 Dinamik Bildirim Sistemi 5 vakit için ayrı ayrı 0-60 dakika öncesi/sonrası bağımsız hatırlatıcılar ve AlarmClock düzeyinde tam zamanlı bildirim kanalları.
🌙 Sahur & Cuma Uyarıları İmsak'a 45 dakika kala Sahur & Teheccüd uyarısı; Cuma günleri öğleden 1 saat önce mübarek Cuma hatırlatması.
🧭 Donanımsal Kıble Pusulası FlutterCompass manyetometre sensör akışı, yumuşatılmış pusula açısı ve tam Kabe yönünde dokunsal titreşim (HapticFeedback).
📿 Dokunsal Zikirmatik 33, 99 ve Serbest modlu; Arapça metin, okunuş, mealler ve hedef tamamlandığında titreşimli uyarı.
📖 Dualar & Sureler Namaz duaları, günlük dualar, Kuran'dan dualar; Arapça orijinal metin, Türkçe meal ve sesli dinleme.
📅 Hicri & Dini Günler Takvimi Kandiller, Ramazan, Kadir Gecesi ve bayramlar için canlı kalan gün sayacı ve aylık namaz takvimi.
🚀 Uygulama İçi GitHub Güncelleyici GitHub Releases API entegrasyonu; yeni sürüm çıktığında sürüm notları ve tek tıkla doğrudan APK indirme penceresi.
0ms Çevrimdışı Önbellek Bellek içi + SharedPreferences çift katmanlı önbellek; internetsiz ortamda bile 30 günlük verilerle anında açılış.
🎨 PRO Temalar & Material 3 Sistem, Açık ve Koyu mod; Zümrüt, Safir, Turkuaz, Lal ve Kehribar renk paletleri.
🌍 Çift Dil Desteği Türkçe 🇹🇷 ve İngilizce 🇬🇧 tam kapsamlı dil sözlüğü.

🎉 5.3.0 ile Gelen Yenilikler

Kalıcı paket ve imza korunur; önceki sürümleri kaldırmadan doğrudan güncelleyebilirsiniz:

  • 📖 Sticky Ayet Şeridi: Günün ayeti ince sabit şeritte, dokununca tam metin açılıyor.

🕘 Önceki Sürümler

  • Performans: Önbellekli arka plan, pil dostu sayaç, hızlı bildirim planlama.
  • 📍 Konum Adı: GPS ile il/ilçe gösterimi.
  • 🌅 Güneş Zaman Çizelgesi: Sabah sonrası sıradaki vakit artık Güneş; sayaç, ilerleme çubuğu ve bildirimler 6'lı çizelgeyle senkron.
  • 🔔 Bildirim Sesi Düzeltmesi: Zamanlanmış ezan/hatırlatıcı sesleri artık ayara uygun çalıyor.
  • 🌙 Gece Yarısı Sayacı Düzeltmesi: 00:00–Sabah arası mevcut-vakit mantığı düzeltildi.
  • 🔊 Ses Tercihleri Korunur: Ana ses anahtarı alt tercihleri ezmiyor.
  • 🚀 Uygulama İçi GitHub Güncelleme Sistemi: Yeni bir sürüm çıktığında uygulama içinde otomatik algılama, sürüm notlarını görüntüleme ve tek tıkla APK indirip güncelleme desteği.
  • 📦 Dinamik Sürüm Yönetimi: Tüm ekranlarda ve ayarlarda merkezi AppVersion kaynağı; versiyon uyumsuzlukları ve manuel metin hataları tamamen sonlandırıldı.
  • ⏱️ Namaz Vakti Manuel Tolerans (Offset) Motoru: Bölgesel farklılıklar veya yerel cami saatleri için her vakte bağımsız +/- 15 dk ekleyebilme/çıkarabilme.
  • 📊 Canlı Vakit İlerleme Çubuğu: Ana sayaç kartında vakit aralığının ne kadarının tamamlandığını gösteren canlı bar.
  • 🎨 Modernize Edilmiş Vakit Kartları: Glow parıltı efektleri, tolerans rozetleri ve dinamik renk uyumu.
  • 🔐 Gelişmiş Android Release İmzalaması: Hem yerel key.properties hem de GitHub Secrets üzerinden CI/CD imzalı APK & Google Play hazır AAB üretimi.
  • 🚀 GitHub Actions CI/CD: Her sürüm için otomatik APK, AAB ve SHA256 sağlama toplamı yayınlama iş akışı.
  • 🏷️ Zenginleştirilmiş Dokümantasyon ve Yeni Birim Testleri.

📦 Kurulum ve Kullanım

1. Kullanıcılar İçin (APK İndirme)

  1. Son Final Sürümünü açın.
  2. EzanApp-v5.3.0.apk dosyasını telefonunuza indirin ve kurun.
  3. Uygulamayı açtığınızda GPS izni verin veya listeden şehrinizi seçin.

2. Geliştiriciler İçin (Kaynak Koddan Derleme)

Gereksinimler:

  • Flutter SDK (v3.38+ / Dart 3.10+)
  • Android SDK (API 34+)
  • Java JDK 17
# Depoyu klonlayın
git clone https://github.com/eekilinc/EzanApp.git
cd EzanApp

# Bağımlılıkları yükleyin
flutter pub get

# Testleri çalıştırın
flutter test

# Hata ayıklama modunda çalıştırın
flutter run

🔐 Android İmzalaması (App Signing)

1. Yerel Keystore Üretimi

Projede hazır bulunan betiği çalıştırarak imzalama anahtarınızı ve key.properties dosyanızı tek adımda oluşturabilirsiniz:

chmod +x scripts/generate_keystore.sh
./scripts/generate_keystore.sh

Veya manuel olarak:

keytool -genkey -v -keystore android/app/upload-keystore.jks -alias upload -keyalg RSA -keysize 2048 -validity 10000

android/key.properties dosyasını oluşturun:

storePassword=PAROLANIZ
keyPassword=PAROLANIZ
keyAlias=upload
storeFile=upload-keystore.jks

2. İmzalı Paketleri Derleme

# Doğrudan cihaza yüklenebilir Release APK
flutter build apk --release

# Google Play Store için Release App Bundle (AAB)
flutter build appbundle --release

🛠️ Teknik Mimari ve Altyapı

lib/
├── 🎯 main.dart                  # Uygulama başlangıcı, bildirim kanalları ve tema kurulumu
├── 📦 models/                   # Veri modelleri (PrayerTimes, LocationData, DailyContent, IslamicEvent)
├── 🔄 providers/                # Reaktif State Management (PrayerProvider, SettingsProvider)
├── ⚙️ services/                 # Servisler (API, Bildirim, Ses, Konum, Kıble, Hicri, Widget)
├── 📱 screens/                  # 10 adet zengin arayüz ekranı
├── 🧩 widgets/                  # Yeniden kullanılabilir modern UI bileşenleri
└── 📝 constants/                # Çift dilli lokalizasyon sözlüğü ve sabitler
  • API İstemcisi: Aladhan REST API (method=13 Diyanet, MWL, ISNA, Makkah vb.).
  • Bildirim Motoru: flutter_local_notifications ile Android Notification Channels (Importance.max, AudioAttributesUsage.alarm).
  • Kıble Hesaplama: Küresel Trigonometri (Great-Circle Distance & Bearing) algoritması ile True North kerte açısı.
  • Hicri Takvim: Kuveyt astronomik algoritması ile Miladi <-> Hicri takvim dönüşümü.

🤖 GitHub Actions CI/CD Pipeline

Projede yer alan .github/workflows/release.yml iş akışı tam otomatiktir:

graph LR
    A[Git Tag v* / Workflow Dispatch] --> B[Java 17 & Flutter Setup]
    B --> C[Run Unit Tests]
    C --> D[Build Release APK & AAB]
    D --> E[Generate SHA256 Checksums]
    E --> F[Publish GitHub Release Artifacts]
Loading

📄 Lisans

Bu proje MIT Lisansı kapsamında özgür bir yazılımdır. Ticari veya kişisel amaçlarla özgürce kullanılabilir, kopyalanabilir ve dağıtılabilir.


Geliştirici: Ekrem Eşref Kılınç (@eekilinc)
Made with ❤️ for the Muslim Community

About

🕌 Islamic prayer times & customizable reminder app built with Flutter

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages