---
title: Riaslink Port Builder
emoji: 🏮
colorFrom: yellow
colorTo: red
sdk: docker
app_port: 7860
pinned: false
license: apache-2.0
---

# Riaslink Port Builder

Bir RPG Maker MV/MZ web dışa aktarımını (`www/` klasörü) Android APK'ya
dönüştürür ve oyuna otomatik olarak **taverna temalı bir menü** ile
**FPS sayacı** eklentisi enjekte eder.

Bu Space, [Ludens](https://github.com/yoimerdr/ludens) projesinden yalnızca
"Android WebView port" fikrini ödünç alır (Ludens'in kod tabanı doğrudan
kullanılmaz); menü, eklentiler ve build pipeline'ı sıfırdan yazılmıştır.
Ayrıntılar için `android-template/README.md` dosyasına bakabilirsin.

## Mimari

Arayüz düz **FastAPI + statik HTML/CSS/JS** ile yazılmıştır — hiçbir UI
framework'ü (Gradio, Streamlit vb.) kullanılmaz. Bunun nedeni tarihsel:
ilk sürüm Gradio ile yazılmıştı, ama o sürümün kullandığı Gradio sürümünde
(5.9.1) art arda farklı iç route/şema hataları çıktı — her düzeltme farklı
bir iç mekanizmayı bozdu. Az sayıda, sade route'a sahip kendi FastAPI
uygulamamızı yazmak, üzerinde kontrolümüz olmayan bir kütüphanenin iç
davranışına bağımlı kalmaktan daha güvenilir çıktı.

```
hf-space/
├── app.py              FastAPI backend: form, build başlatma, SSE log akışı, indirme
├── build_pipeline.py   Asıl iş: zip enjeksiyonu, plugin kaydı, Gradle çağrısı
├── static/
│   ├── index.html      Build formu (taverna temalı)
│   ├── style.css        Aynı --ria-* renk paleti, RIA_TavernMenu.js ile tutarlı
│   └── app.js            Form gönderimi, sürükle-bırak, canlı log (Server-Sent Events)
└── android-template/    Native Android port + menü eklentileri (bkz. kendi README'si)
```

**Backend route'ları:**

| Route | Ne yapar |
|---|---|
| `GET /` | Build formunu döner (`static/index.html`) |
| `POST /api/build` | Formu + zip'i alır, arka planda build başlatır, `{build_id}` döner |
| `GET /api/build/{id}/stream` | Server-Sent Events ile canlı log satırları |
| `GET /api/build/{id}/download` | Tamamlanan APK'yı indirir |

Her build, bellekte tutulan bir `BuildState` nesnesiyle takip edilir (log
satırları + durum). `stream_build_log`, bu state'i yarım saniyede bir
kontrol edip yeni log satırlarını tarayıcıya SSE ile akıtır; build bitince
(`success` ya da `failed`) akış otomatik kapanır ve indirme linki (varsa)
gösterilir. Tek process içinde çalıştığı için harici bir kuyruk/veritabanı
gerekmez — bu, tek instance'lı bir Space için yeterlidir.

## Nasıl çalışır

1. RPG Maker'da projeni web'e dışa aktar (Deploy Masterpiece).
2. Oluşan `www` klasörünü (ya da içeriğini) zip'le.
3. Bu Space'e yükle, uygulama adı / paket adı / versiyon bilgilerini gir.
4. "APK Oluştur" — arka planda `android-template/` projesi kopyalanır,
   `www/` senin oyununla değiştirilir, `RIA_FPSCounter.js` ve
   `RIA_TavernMenu.js` eklentileri `js/plugins/` altına konur ve projenin
   kendi `js/plugins.js` dosyasına (mevcut eklentilerine dokunmadan)
   kaydedilir, ardından Gradle ile APK derlenir. Build günlüğü sağ panelde
   canlı olarak akar.

## Release imzalama

Release APK'lar varsayılan olarak konteynerin debug anahtarıyla imzalanır
(kurulabilir, ama Space yeniden başladığında anahtar değişir ve yeni sürüm
eskisinin üzerine güncelleme olarak kurulamaz). Kalıcı imza için Space
ayarlarında şu **secret**'ları tanımla:

| Secret | Değer |
|---|---|
| `RIASLINK_KEYSTORE_B64` | `.jks`/`.keystore` dosyasının base64 hali (`base64 -w0 release.jks`) |
| `RIASLINK_KEYSTORE_PASSWORD` | keystore şifresi |
| `RIASLINK_KEY_ALIAS` | anahtar alias'ı |
| `RIASLINK_KEY_PASSWORD` | anahtar şifresi (boşsa keystore şifresi kullanılır) |

## Sınırlamalar

- `release` build'i imzasızdır (unsigned) — kendi keystore'unla imzalamadan
  cihaza kurulamaz. Test için `debug` seçeneğini kullan.
- Build süresi, oyunun asset boyutuna ve Space'in donanımına bağlı olarak
  birkaç dakika sürebilir.
- Bu Space'in Docker imajı derleme sırasında Android SDK ve Gradle
  indirdiğinden, ilk build (soğuk başlatma) internet erişimi gerektirir;
  Hugging Face'in Space build ortamı bunu otomatik sağlar.
- Build durumu bellekte tutulur; Space yeniden başlarsa devam eden build'ler
  kaybolur (yeniden başlatmak gerekir).

## Yerel geliştirme

```bash
docker build -t riaslink-port-builder .
docker run -p 7860:7860 riaslink-port-builder
```

Ya da Docker olmadan, sadece Python tarafını test etmek için:

```bash
pip install -r requirements.txt
python3 app.py
# http://localhost:7860
```

(`android-template/` build'i için yine de Android SDK + Gradle gerekir —
bu yol sadece formu/arayüzü test etmek içindir.)

Android projesini Space dışında (örn. Android Studio'da) elle de
açabilirsin — bkz. `android-template/README.md`.