← Nesim Apps

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

#Geliştirici notları#Astronomi#iOS

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

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