Skip to content

README_TR.md

Latest commit

 

History

History
215 lines (155 loc) · 11 KB

README_TR.md

File metadata and controls

215 lines (155 loc) · 11 KB


MonoGram
MonoGram

Bu dokümanı diğer dillerde okuyun: English, Русский, Türkçe, 한국어, اُردو, Español

MonoGram, Android için modern, yıldırım hızında ve zarif bir resmi olmayan Telegram istemcisidir. Jetpack Compose ve Material Design 3 ile sıfırdan inşa edilen uygulama, resmi TDLib altyapısıyla desteklenen yerleşik (native) ve akıcı bir deneyim sunar.

Important

MonoGram şu an aktif geliştirme aşamasındadır. Sık güncellemeler, mimari değişiklikler ve nadiren de olsa hatalar (bug) bekleyebilirsiniz.

Projeyi Boosty üzerinden destekleyebilirsiniz.

Ekran Görüntüleri
Ekran Görüntüsü 1 Ekran Görüntüsü 2 Ekran Görüntüsü 3 Ekran Görüntüsü 4

Öne Çıkan Özellikler

  • Bağımsız İstemci — Android için Telegram'ın bir çatalı (fork) değildir. MonoGram, tamamen sıfırdan bağımsız bir proje olarak inşa edilmiştir.
  • Material Design 3 — Telefonlar, tabletler ve katlanabilir cihazlarda harika görünen, estetik ve uyarlanabilir kullanıcı arayüzü.
  • Güvenli — Yerleşik biyometrik kilitleme ve şifrelenmiş yerel depolama.
  • Zengin Medya Deneyimi — ExoPlayer ve Coil 3 ile yüksek performanslı medya oynatma.
  • Hızlı ve Verimli — Kotlin Coroutines ile desteklenen, performans için optimize edilmiş yapı.
  • Temiz Mimari (Clean Architecture) — Domain, Data ve Presentation katmanları ile sorumlulukların net bir şekilde ayrılması.
  • MVI Deseni — MVIKotlin kullanılarak sağlanan öngörülebilir durum yönetimi.
  • NFT veya Kripto Yok — MonoGram; Telegram tarafından dayatılan ve bir mesajlaşma uygulamasının kapsamı dışında gördüğümüz NFT tanıtımları, hediyeleri veya benzeri özellikleri asla içermeyecektir.

Başlangıç

Projeyi yerel ortamınızda kurmak için bu adımları izleyin.

Ön Koşullar

  • Android Studio: Ladybug veya daha yeni bir sürüm (önerilir).
  • JDK: Java 17 veya daha yeni bir sürüm.

1. Depoyu Klonlayın

git clone --recurse-submodules https://github.com/monogram-android/monogram.git
cd monogram

2. Telegram API Anahtarlarını Yapılandırın

Telegram sunucularına bağlanmak için kendi API kimlik bilgilerinize ihtiyacınız vardır.

  1. my.telegram.org adresinde oturum açın.
  2. API development tools (API geliştirme araçları) bölümüne gidin.
  3. App api_id ve App api_hash değerlerinizi almak için yeni bir uygulama oluşturun.
  4. Projenin kök dizininde (eğer yoksa) local.properties adlı bir dosya oluşturun.
  5. Aşağıdaki satırları dosyaya ekleyin:
API_ID=12345678
API_HASH=your_api_hash_here

3. Anlık Bildirimleri (Push Notifications) Yapılandırın

  1. Firebase konsolunda oturum açın.
  2. Yeni bir proje oluşturun.
  3. İhtiyacınız olan applicationId değerine sahip yeni bir uygulama ekleyin. Farklı ID'lere sahip birden fazla uygulamanız varsa, birden fazla Firebase uygulaması oluşturun. Varsayılan olarak, hata ayıklama (debug) ve yayınlama (release) sürümlerinin applicationId değerleri farklıdır.
  4. google-services.json dosyasını indirin ve app modülünün kök dizinine kopyalayın (monogram/app/google-services.json). Birden fazla uygulama oluşturduysanız, yalnızca en güncel yapılandırmayı kopyalayın.
  5. Cloud Messaging bölümüne gidin.
  6. Manage service accounts (Hizmet hesaplarını yönet) seçeneğine tıklayın.
  7. Açılan pencerenin üst kısmındaki Keys (Anahtarlar) sekmesini seçin.
  8. Add key (Anahtar ekle) seçeneğine tıklayın ve JSON opsiyonunu seçin. Dosyanın indirilmesini bekleyin.
  9. Uygulama ID'nizi aldığınız Telegram API sayfasına geri dönün.
  10. FCM kimlik bilgileri (FCM credentials) bölümünün yanındaki Update (Güncelle) butonuna tıklayın.
  11. Açılan sayfada hizmet hesabı (service account) JSON dosyasını yükleyin.

4. İlk Kurulum: libvpx Derlemesi

Animasyonların çalışması için libvpx'in derlenmiş olması gerekir. Bu işlem, Gradle derlemesini başlatmadan önce yapılmalıdır; aksi takdirde derleme hatalarıyla karşılaşırsınız.

  1. Çalışma dizininizi presentation/src/main/cpp olarak değiştirin.
  2. build.sh dosyası içerisine kendi ANDROID_NDK_HOME yolunuzu ekleyin.
  3. build.sh dosyasını çalıştırın ve işlemin tamamlanmasını bekleyin.

5. Derleyin ve Çalıştırın

  1. Projeyi Android Studio ile açın.
  2. TdApi.java (TDLib sarmalayıcısı) dosyasının doğru şekilde indekslenebilmesi için IDE indeksleme limitlerini artırın. Android Studio veya IntelliJ IDEA içerisinde, Help (Yardım) → Edit Custom Properties... (Özel Özellikleri Düzenle) yolunu izleyin, aşağıdaki satırları yapıştırın ve istenirse IDE'yi yeniden başlatın:
# Kb cinsinden boyut
idea.max.intellisense.filesize=20480
# Kb cinsinden boyut
idea.max.content.load.filesize=20480
  1. Gradle senkronizasyonunu (Sync) yapın.
  2. app çalıştırma yapılandırmasını (run configuration) seçin.
  3. Bir cihaz bağlayın veya bir emülatör başlatın.
  4. Run (Çalıştır) butonuna tıklayın.

TDLib Derlemesi

Eğer TDLib'i kaynaktan derlemeniz gerekirse, öncelikle gerekli bağımlılıkları kurun. Debian/Ubuntu tabanlı dağıtımlar için:

sudo apt-get update
sudo apt-get install build-essential git curl wget php perl gperf unzip zip default-jdk cmake

Ardından projenin kök dizininden derleme betiğini (script) çalıştırın:

./build-tdlib.sh

Katkıda Bulunma

Katkılarınızı memnuniyetle karşılıyoruz! İster hataları gidermek, ister dokümantasyonu iyileştirmek veya yeni özellikler önermek olsun, her türlü katkıya açığız.

  1. Sorunları (Issues) Kontrol Edin — Açık sorunlara göz atın veya fikirlerinizi tartışmak için yeni bir sorun kaydı oluşturun.
  2. develop Dalında Çalışın — Kendi dalınızı (branch) develop üzerinden oluşturun ve çalışmalarınızı bu dalı temel alarak sürdürün.
  3. Fork & Branch — Depoyu (repo) çatallayın (fork) ve bir özellik dalı (feature branch) oluşturun.
  4. Kod Stili — Mevcut Kotlin kod yazım stiline ve Temiz Mimari (Clean Architecture) yönergelerine uyun.
  5. PR Gönderin — Değişikliklerinizin net bir açıklamasını içeren bir Çekme İsteğini (Pull Request) develop dalına açın.

Important

Hata Bildirme ve Özellik Önerileri

  • Hatalar (Bugs) — Bir sorun kaydı (issue) açın ve başlıkta [Bug] etiketini kullanın (Örn: [Bug] Uygulama başlangıçta çöküyor). Ayrıca, bilinen tüm hatalara Hata Takipçisi üzerinden göz atabilirsiniz.
  • Özellik İstekleri — [Feature] etiketini içeren bir sorun kaydı açın (Örn: [Feature] Planlanmış mesaj desteği). Mevcut özellik isteklerini Özellik Panosu üzerinden inceleyebilirsiniz.

Çeviriler

MonoGram topluluk tarafından yapılan çevirileri memnuniyetle karşılar! Kendi dilinizle katkıda bulunmak için metin kaynak (strings resource) dosyasını düzenleyebilirsiniz.

Kaynak metinler presentation/src/main/res/values/string.xml adresinde yer almaktadır. Yeni bir dil eklemek için, ilgili dile ait bir values-<yerel-kod>/string.xml dosyası oluşturun (örneğin Almanca için values-de/string.xml) ve metinleri orada çevirin. Çevirinizi içeren bir Çekme İsteği (PR) açın, biz de onu projeye dahil edelim.

Teknoloji Yığını

MonoGram, en güncel Android geliştirme araçlarından ve kütüphanelerinden yararlanır:

Kategori Kütüphaneler
Dil Kotlin
Kullanıcı Arayüzü (UI) Jetpack Compose (Material 3)
Mimari Decompose (Navigasyon), MVIKotlin
Bağımlılık Enjeksiyonu (DI) Koin
Asenkron İşlemler Coroutines & Flow
Telegram Çekirdeği TDLib (Telegram Database Library)
Görsel Yükleme Coil 3
Medya Media3 (ExoPlayer)
Haritalar MapLibre
Yerel Veritabanı Room

Proje Yapısı

Proje, sorumlulukların ayrılmasını ve ölçeklenebilirliği sağlamak amacıyla çok modüllü (multi-module) bir yapı izlemektedir:

Modül Açıklama
:app Ana Android uygulama modülü.
:domain İş mantığı (business logic), kullanım durumları (use cases) ve depo (repository) arayüzlerini içeren saf Kotlin modülü.
:data Depo (repository) uygulamaları, veri kaynakları ve TDLib entegrasyonu.
:presentation Kullanıcı arayüzü (UI) bileşenleri, ekranlar ve görünüm modelleri (MVI Store'ları).
:core Modüller genelinde kullanılan ortak yardımcı sınıflar ve uzantılar (extensions).
:baselineprofile Uygulama başlangıcı ve performans optimizasyonu için Baseline Profilleri.

Lisans

Bu proje GNU General Public License v3.0 (GNU Genel Kamu Lisansı v3.0) kapsamında lisanslanmıştır.