Açık Kaynak Astronomi Kütüphanesi: Tek Yama Betiğiyle Android ve iOS
Nesim Razon, bağımsız mobil uygulama geliştiricisi · 2026-11-18
Burç ve Ay uygulamamız gerçek astronomiye ihtiyaç duyar: Ay nerede, evre ne zaman değişir, bir gezegen ne zaman geriye gidiyormuş gibi görünür. Bunun için açık kaynak bir motor kullanıyoruz ve Android'de çalışıyordu. Uygulamayı iPhone için Kotlin Multiplatform'a taşıyınca motor yanımıza gelmedi. Bu yazı, tek bir hesabı değiştirmeden onu iki platformda nasıl çalıştırdığımızı anlatıyor.
Sorun: yalnızca JVM'e özel bir paket
Motor bir Kotlin kütüphanesi olarak yayınlanıyor ve merkezi Maven deposundaki hazır sürüm yalnızca Java sanal makinesinde çalışıyor. Bu, Android'de sorun değil; ama iPhone için de derlenmesi gereken ortak kodda işe yaramıyor. Binlerce satırlık yörünge matematiğini yeniden yazmak da, her platformda farklı bir kütüphane çağırmak da istemedik; çünkü iki motor Ay evresi saatlerinde birbirinden azıcık farklı sonuç verebilir.
Paketi değil kaynağı kullan
Motor MIT lisansıyla açık kaynak ve tamamı tek bir Kotlin kaynak dosyası. Biz de paket yerine kaynak dosyanın kendisini alıp ortak modülün ortak kaynak kümesine koyduk. Soru, o dosyada Java'ya özel olanın ne olduğuna döndü. Çıktığına göre çok azdı.
Neyi değiştirmek gerekti
- Java sınıf adını belirleyen dosya düzeyinde bir ek açıklama; ortak kod bunu bilmez.
- Fonksiyonları statik yapan ya da Java aşırı yüklemeleri üreten birkaç ek açıklama; bunlar da yalnızca Java'ya özel. Kaldırınca Kotlin çağıranlar için hiçbir şey değişmez.
- Kullanmadığımız bir nesnenin önbelleğini koruyan Java eşzamanlama bloğunun düz bir blokla değiştirilmesi.
- Zamanı metne çeviren fonksiyondaki bir metin biçimlendirme çağrısının, aynı çıktıyı veren elle sıfır doldurmayla değiştirilmesi.
Sesli başarısız olan bir yama betiği
Dosyayı elle düzenlemedik. Küçük bir betik her değişikliği düzenli ifadeyle uygular ve kaç eşleşme beklediğini doğrular. Motorun gelecek bir sürümü bir satırı oynatırsa, betik yarım yamalı bir dosyayı sessizce üretmek yerine hata vererek durur. Betik ayrıca sonuca, hangi motor sürümü olduğunu, yalnızca bu değişikliklerin yapıldığını ve hesap kodunun el değmeden kaldığını söyleyen bir başlık yorumu yazar; bu da lisans notunu dürüst tutar.
Motoru güncellemek tekrarlanabilir bir rutine dönüşür: yeni kaynağı indir, betiği çalıştır, testleri çalıştır.
Hiçbir şeyin değişmediğini kanıtlamak: altın testler
Derleyici memnun diye hiç kimse bir taşımaya güvenmemeli. Taşımadan önce eski Android kodunun çıktısını geniş bir durum kümesi için kaydettik: bir yıldan uzun günler boyunca her burç için yorum özeti, tam metin örnekleri, Ay burç geçişleri, evreler ve retro tarihleri, ISO hafta ve uyum sonuçları, ayrıca içerik bankasının özeti. Taşımadan sonra ortak kodun bu dosyaları birebir yeniden üretmesi gerekir.
Üretiyor ve asıl güvenlik ağı da bu. İçerik bankası metni bilerek değiştiğinde, altın dosyalar tek bir anahtarla yeniden üretilir ve fark, diğer her değişiklik gibi gözden geçirilir.
Taşımanın geri kalanı
Motorun çevresinde olağan değişimler uygulandı: Java zaman sınıfları Kotlin tarih ve saat kütüphanesine, bir JSON kütüphanesi Kotlin serileştirmesine, yerel ayara bağlı biçimlendirme küçük yardımcılara dönüştü. Bunların hiçbiri akıllı bir fikir istemedi, yalnızca bir liste ve sabır istedi. Astronomi motoru, bir plan gerektiren tek bağımlılıktı.
Sık sorulan sorular
Neden her platformda yerel bir astronomi kütüphanesi çağırmadık?
İki motor Ay evresi saatlerinde azıcık ayrılabilir. Tek ortak kaynak her yerde aynı sonuçları verir.
MIT lisanslı bir kütüphaneyi değiştirmek serbest mi?
Evet, lisans notu kaldığı sürece. Yamalı dosyamız onu korur ve değişiklikleri sayan bir başlık ekler.
Motor yeni sürüm yayınlayınca ne olur?
Yeni kaynak indirilir, yama betiği ve altın testler çalıştırılır. Bir yama artık uygulanmıyorsa betik durur.
Altın testler burada nasıl yardım eder?
Yeni ortak kodu eski kodun kayıtlı çıktısıyla karşılaştırır; bir sonuçtaki herhangi bir fark hemen yakalanır.
Diğer yazılar
Ay Evreleri Neden 29,5 Günde Döner? Yeniay ve Dolunay
Burçlar Takımyıldızlardan Neden Kaydı? 13. Burç Yılancı
Merkür Retrosu Nedir? Gökyüzünde Gerçekte Ne Oluyor?
İzin İstemeden Android ve iOS İçin Fotoğraf Seçici
Android ve iOS'ta Bulut Kaydı: İlerlemeyi Asla Kaybetmeyen Birleştirme Kuralı
Bir Advent Takvimi Uygulaması Bugün Hangi Kapının Açılacağına Nasıl Karar Verir