| # Riaslink Port — Android Template |
|
|
| RPG Maker MV/MZ web dışa aktarımlarını (`www/` klasörü) saran, minimal bir |
| Android WebView port'u. [Ludens](https://github.com/yoimerdr/ludens) |
| projesinden yalnızca "port yeteneği" fikri esinlenmiştir; bu proje ayrı bir |
| kod tabanıdır, Ludens'in koduna bağımlılığı yoktur (Apache 2.0 lisanslı |
| Ludens'in kodu doğrudan kullanılmamıştır). |
|
|
| ## Mimari |
|
|
| Bu proje kasıtlı olarak küçük tutulmuştur: |
|
|
| - **Kotlin Multiplatform yok** — sadece Android hedefleniyor. |
| - **Dependency injection framework yok** — tek Activity, manuel wiring. |
| - **Üçüncü parti WebView kütüphanesi yok** — `android.webkit.WebView` |
| doğrudan kullanılıyor. |
|
|
| ``` |
| app/src/main/java/fun/riaslink/port/ |
| ├── RiaslinkApplication.kt Application sınıfı (boş, kasıtlı) |
| ├── GameActivity.kt Tek Activity: immersive mod, back-press yönetimi |
| └── core/ |
| ├── GameWebView.kt WebView kurulumu + WebViewAssetLoader |
| └── RiaslinkJsBridge.kt JS→native köprü (sadece titreşim + çıkış) |
| ``` |
|
|
| `app/src/main/assets/www/` — buraya bir RPG Maker projesinin `www/` klasörü |
| kopyalanır. `js/plugins/RIA_FPSCounter.js` ve `js/plugins/RIA_TavernMenu.js` |
| oyunun kendi eklenti sistemine (`js/plugins.js` üzerinden) kaydolan, saf |
| JavaScript RPG Maker eklentileridir — native Kotlin koduyla hiçbir bağı |
| yoktur, herhangi bir RPG Maker projesine (Android portu olmadan, tarayıcıda |
| bile) tek başına kurulabilirler. |
|
|
| ## Native ↔ Web sözleşmesi |
|
|
| Native taraf ile menü arasındaki tek bağlantı noktaları: |
|
|
| 1. `window.RiaslinkNative.vibrate(ms)` / `.exitApp()` — menüden native'e. |
| 2. `window.RIA_TavernMenu.handleBackPress()` — native'den menüye. Android |
| geri tuşuna basıldığında `GameWebView.handleBackPress()` bunu çağırır; |
| menü açıksa kapatır, değilse taverna temalı bir çıkış onayı gösterir. |
|
|
| Bunların dışında native taraf menünün iç mantığına hiç karışmaz. |
|
|
| ## Yapılandırma (`riaslink.build.properties`) |
|
|
| `applicationId`, uygulama adı, versiyon gibi alanlar `build.gradle.kts`'e |
| sabit yazılı değildir; proje kökündeki `riaslink.build.properties` |
| dosyasından okunur. Bu dosya build'e özgüdür ve git'e eklenmez |
| (`.gitignore`'a bakın). Manuel/lokal build için `riaslink.build.properties.example` |
| dosyasını kopyalayıp doldurun: |
|
|
| ```bash |
| cp riaslink.build.properties.example riaslink.build.properties |
| # değerleri düzenle |
| ``` |
|
|
| ## Manuel build |
|
|
| ```bash |
| ./gradlew assembleDebug # imzasız, hemen kurulup test edilebilir |
| ./gradlew assembleRelease # R8 küçültme uygulanır, imzasızdır |
| ``` |
|
|
| APK çıktısı: `app/build/outputs/apk/<debug|release>/` |
|
|
| `release` build'i imzasız olduğu için cihaza doğrudan kurulamaz — kendi |
| keystore'unla `apksigner` ile imzalaman gerekir. |
|
|
| ## Kendi oyununu elle yerleştirme |
|
|
| Hugging Face Space pipeline'ını kullanmadan, `www/` klasörünü elle de |
| yerleştirebilirsin: |
|
|
| 1. RPG Maker'da projeni web'e dışa aktar (Deploy Masterpiece). |
| 2. Oluşan `www/` klasörünün içeriğini `app/src/main/assets/www/` üzerine |
| kopyala (mevcut placeholder içeriğin üzerine yaz). |
| 3. `RIA_FPSCounter.js` ve `RIA_TavernMenu.js` dosyalarını |
| `app/src/main/assets/www/js/plugins/` altına kopyala (zaten template'te |
| mevcutlarsa atlayabilirsin). |
| 4. Kendi `js/plugins.js` dosyana şu girişleri ekle (RPG Maker editörünün |
| Plugin Manager'ından da ekleyebilirsin): |
|
|
| ```js |
| $plugins.push( |
| { "name": "RIA_FPSCounter", "status": true, "description": "", "parameters": { "defaultVisible": "false" } }, |
| { "name": "RIA_TavernMenu", "status": true, "description": "", "parameters": { "accentEmberHex": "#e8a343" } } |
| ); |
| ``` |
|
|
| ## Menüyü genişletme |
|
|
| `RIA_TavernMenu.js`, gelecekteki eklentilerin kendi sekmelerini eklemesine |
| izin veren bir `registerSection()` API'si sağlar: |
|
|
| ```js |
| window.RIA_TavernMenu.registerSection({ |
| id: 'cheats', |
| label: 'Hileler', |
| render: function(container) { |
| // container'ı DOM elemanlarıyla doldur |
| } |
| }); |
| ``` |
|
|
| Bu sayede örneğin ileride bir "cheat menu" eklentisi, `RIA_TavernMenu.js` |
| dosyasının kendisine hiç dokunmadan sidebar'a yeni bir sekme ekleyebilir. |
|
|
