TITLE=WarpEngine RetroArch Store
ROUTE=/stores/warp-engine-retroarch-store
LOCALE=hu
MODIFIED=1792417593
URL=https://wiki.teletypegames.org/hu/stores/warp-engine-retroarch-store
L=1 #22
L=2 #24
L=3 #44
L=4 https://git.teletypegames.org/stores/warp-engine-retroarch-store
L=5 #45
L=6 https://www.retroarch.com
L=7 #57
L=8 #63
L=9 #64


q│ A 
cwarp-engine-retroarch-store
q egy 1WarpEngine-katalógusból húzza be a

q│ játékokat a RetroArch könyvtárába: platformonként egy 
c.lpl
q lejátszási lista,

q│ borítóképekkel azokban a bélyegkép-mappákban, amelyekre a lista neve mutat.

q│ Ez csak a motor — a site, az áruház neve és az, hogy hova kerülnek a

q│ játékok, egy külön 
báruházrepó
q 
cconfig.json
q fájljából jön. A közös fele a

q│ 2warpstore.


p warpstore                     a közös mag                                    

p     ▲                                                                        

p warp-engine-retroarch-store   ez a motor — retroarch_store.py, install.sh    

p     ▲                                                                        

p     │ config.json                                                            

p ttg-retroarch-store           áruházrepók                                    

p     ▼                                                                        

p teletypegames.org                                                            

A referenciaáruház a 3TTG RetroArch Store.


bRepó:
0 4https://git.teletypegames.org/stores/warp-engine-retroarch-store 
bKözös

bmag:
0 2warpstore 
bTestvérmotor:
0 5Batocera áruházmotor 
bRetroArch:
6https://www.retroarch.com


1Amit kapsz

1══════════

• 
bMinden gép, amin fut a RetroArch
0 — asztali Linux, Windows, macOS, Android,
  Steam Deck, a konzolportok. Ugyanazok a kazetták, amiket a Batocera-áruház
  telepít, jóval nagyobb közönséggel.
• 
bSemmilyen feltételezett útvonal
0 — a négy szükséges könyvtár a felhasználó
  saját 
cretroarch.cfg
0 fájljából jön.
• 
bOlyan gépre is tud írni, amelyen nem fut
0 (
cexport
0), és ez az egyetlen módja
  Android kiszolgálásának, ahol fut a RetroArch, de Python nincs.
• 
bSoha nem szerkeszti a 
cretroarch.cfg
b fájlt
0, és nem nyúl a megjelenítési
  beállításokhoz.
• 
bNulla függőség
0 — csak a Python 3 szabványkönyvtára.


p <store>-retroarch-store sync                                                 

p         │                                                                    

p         ├─ GET /api/software                      a teljes katalógus         

p         ├─ a libretro core által indítható platformok  c64 → VICE x64, plus4»

p  → VICE xplus4, tic80 → TIC-80                                               

p         ├─ a legfrissebb nem dev kiadás           amely a kazettát hordozza  

p         ├─ GET /api/download?path=<asset>         .prg / .tic a tartalommapp»

p ába                                                                          

p         ├─ GET <software.imageUrl>                borítókép, PNG-be konvertá»

p lva                                                                          

p         └─ <store> - <label>.lpl kiírása          lejátszási lista + bélyegk»

p épek                                                                         


r──────────────────────────────────────────────────────────────────────────────


1Miért nem a Batocera-áruház ez

1══════════════════════════════

A RetroArch nem egyetlen gép. Ebből három tervezési pont következik.


bOlvassa a 
cretroarch.cfg
b fájlt.
0 A lejátszási listák mappája nem mindig a
RetroArch könyvtárán belül van. Azon a macOS-telepítésen, amelyen ez készült,
a 
cplaylist_directory
0 a 
c~/Documents/RetroArch/playlists
0, miközben a core-ok és
a bélyegképek a 
c~/Library/Application Support/RetroArch
0 alatt élnek. A 
c~
feloldódik, és a hordozható telepítés által a saját könyvtárához használt
vezető 
c:
0 is.


bTud másik gépre írni.
0 Az Androidon nincs Python, így az egyetlen módja a
kiszolgálásának, ha máshol rendereljük le a fát, és átmásoljuk. Ugyanez a
mechanizmus fedi le azt az SD-kártyát is, amely a kézikonzolon más útvonalra
lesz felcsatolva.


bFutó RetroArch mellett nem hajlandó írni.
0 A RetroArch memóriában tartja a
lejátszási listákat, és kilépéskor visszaírja őket — kedvencek, utoljára
játszott, rendezési sorrend —, így egy alatta végzett írás elveszhet. A
Batocera-motor helyette későbbre halasztja, mert ott a Ports-menü indította
el; itt semmi nem indít minket, így a visszautasítás egyszerűbb és
biztonságosabb.


bAmit a Batoceráhozhoz képest elveszítünk:
0 egy 
c.lpl
0 bejegyzésnek nincs leírás-
vagy fejlesztőmezője, így a 
cdesc
0 és az 
cauthor
0 nem marad meg — a RetroArch
ezeket a saját adatbázisaiból veszi. A RetroArch ráadásul nem tud szkriptet
indítani, tehát nincs alkalmazáson belüli indítás: a szinkron shellből vagy
ütemezőből fut.


r──────────────────────────────────────────────────────────────────────────────


1Egy áruház telepítése

1═════════════════════

A telepítő paraméterként kapja az áruházat, így bármilyen konfigurációval
működik:


p curl -fsSL https://git.teletypegames.org/stores/warp-engine-retroarch-store/»

p raw/branch/master/install.sh |                                               

p   STORE_CONFIG=https://git.example.org/tools/my-store/raw/branch/master/conf»

p ig.json sh                                                                   

Kiolvassa a 
cstore.id
0 értéket a konfigurációból, majd a motort, a közös magot
és a konfigurációt a 
c~/.local/share/warp-engine-store/example-retroarch/
könyvtárba telepíti, az 
cexample-retroarch-store
0 indítót a 
c~/.local/bin
0 alá
írja, kiírja a feloldott útvonalakat, és lefuttatja az első szinkront.

Az áruház könyvtárának neve az áruházazonosító 
c-retroarch
0 utótaggal, nem a
csupasz azonosító: az asztali áruházmotor ugyanezt a gyökeret használja, és a
közös könyvtár közös 
cconfig.json
0 és 
cstate.json
0 fájlt jelentene. Egy korábbi
telepítést a telepítő következő futása áthelyez.


t┌────────────────────┬───────────────────────────────────────────────────────┐

t│
h Környezeti változó 
t│
h Jelentés                                              
t│

t├────────────────────┼───────────────────────────────────────────────────────┤

t│
0 
cSTORE_CONFIG
0       
t│
0 
bkötelező
0 — az áruház 
cconfig.json
0 fájljának útvonala   
t│

t│
0                    
t│
0 vagy URL-je                                           
t│

t├────────────────────┼───────────────────────────────────────────────────────┤

t│
0 
cSTORE_ROOT
0         
t│
0 hol élnek az áruházak (alapérték                      
t│

t│
0                    
t│
0 
c${XDG_DATA_HOME:-~/.local/share}/warp-engine-store
0)   
t│

t├────────────────────┼───────────────────────────────────────────────────────┤

t│
0 
cBIN_DIR
0            
t│
0 hova kerül az indító (alapérték 
c~/.local/bin
0)         
t│

t├────────────────────┼───────────────────────────────────────────────────────┤

t│
0 
cRETROARCH_DIR
0      
t│
0 a RetroArch könyvtára, ha szokatlan helyen van        
t│

t├────────────────────┼───────────────────────────────────────────────────────┤

t│
0 
cSTORE_SKIP_SYNC
0    
t│
0 
c1
0 esetén szinkron nélküli telepítés                   
t│

t├────────────────────┼───────────────────────────────────────────────────────┤

t│
0 
cENGINE_RAW_BASE
0    
t│
0 honnan töltse le a 
cretroarch_store.py
0 fájlt           
t│

t├────────────────────┼───────────────────────────────────────────────────────┤

t│
0 
cWARPSTORE_RAW_BASE
0 
t│
0 honnan töltse le a 
cwarpstore.py
0 fájlt                 
t│

t├────────────────────┼───────────────────────────────────────────────────────┤

t│
0 
cWARPSTORE_SRC
0      
t│
0 egy helyi 
cwarpstore.py
0, amit letöltés helyett         
t│

t│
0                    
t│
0 telepítsen                                            
t│

t└────────────────────┴───────────────────────────────────────────────────────┘

Fájlból futtatva a telepítő a mellette heverő 
cretroarch_store.py
0-t vagy

cwarpstore.py
0-t telepíti a letöltött helyett — így telepíti egy checkout a
saját kódját. Ezért ha egy wrapper lehúzza az 
cinstall.sh
0-t, egy saját
könyvtárba kell mentenie (
cmktemp -d
0), nem egy csupasz fájlba a 
c/tmp
0-ben,
különben az ott heverő példányok kerülnek fel.


r──────────────────────────────────────────────────────────────────────────────


1Használat

1═════════


p S=~/.local/bin/example-retroarch-store                                       

p                                                                              

p $S paths                # a feloldott könyvtárak, és hogy megvannak-e a core»

p -ok                                                                          

p $S list                 # kompatibilis bejegyzések; * telepítve, ^ van friss»

p ítés                                                                         

p $S sync                 # minden újdonság letöltése, a listák frissítése     

p $S sync blessingofra    # csak egy cím (soha nem takarít)                    

p $S -n sync              # szárazon futtatás                                  

p $S remove c64:c64demo   # eltávolítás (a csupasz név is jó)                  

p $S purge                # minden eltávolítása, amit ez az áruház telepített  

p $S config               # az érvényes konfiguráció                           

A globális kapcsolók az alparancs 
belé
0 jönnek: 
c$S --retroarch-dir /mnt/ra sync
0.


bSzinkron után indítsd újra a RetroArchot
0 — a menüjét induláskor építi fel, így
egy új lejátszási lista nem jelenik meg egy futó példányban.


r──────────────────────────────────────────────────────────────────────────────


1Eltávolítás

1═══════════


p curl -fsSL https://git.teletypegames.org/stores/warp-engine-retroarch-store/»

p raw/branch/master/uninstall.sh | sh                                          

Az eltávolítást a motor végzi, nem a shellszkript: előbb 
cpurge
0, majd az indító
és az áruház könyvtára. Csak a 
cstate.json
0 tudja, mely lejátszási listák,
bélyegképek és tartalomfájlok voltak a mieink — és ha a motor nem tud végezni
(fut a RetroArch, eltűnt egy könyvtár), semmi máshoz nem nyúl, így soha nem
maradsz úgy, hogy a fájlok megvannak, de a motor nincs, amely ismerné őket.


t┌─────────────────────┬──────────────────────────────────────────────────────┐

t│
h Környezeti változó  
t│
h Jelentés                                             
t│

t├─────────────────────┼──────────────────────────────────────────────────────┤

t│
0 
cSTORE_ID
0            
t│
0 melyik áruházat távolítsa el; csak több telepített   
t│

t│
0                     
t│
0 áruház esetén kell                                   
t│

t├─────────────────────┼──────────────────────────────────────────────────────┤

t│
0 
cSTORE_CONFIG
0        
t│
0 a 
cSTORE_ID
0 alternatívája — az azonosítót a           
t│

t│
0                     
t│
0 konfigurációból olvassa ki                           
t│

t├─────────────────────┼──────────────────────────────────────────────────────┤

t│
0 
cDRY_RUN
0             
t│
0 
c1
0 esetén kiírja, mi tűnne el, és semmit nem távolít  
t│

t│
0                     
t│
0 el                                                   
t│

t├─────────────────────┼──────────────────────────────────────────────────────┤

t│
0 
cKEEP_HOME
0           
t│
0 
c1
0 esetén megtartja az áruház könyvtárát (állapot,    
t│

t│
0                     
t│
0 katalógus-gyorsítótár, napló) az újratelepítéshez    
t│

t├─────────────────────┼──────────────────────────────────────────────────────┤

t│
0 
cFORCE
0               
t│
0 
c1
0 esetén futó RetroArch mellett is takarít           
t│

t├─────────────────────┼──────────────────────────────────────────────────────┤

t│
0 
cSTORE_ROOT
0, 
cBIN_DIR
0 
t│
0 ugyanaz, mint a telepítőnél                          
t│

t└─────────────────────┴──────────────────────────────────────────────────────┘

Amit szándékosan meghagy:

• 
ba felhasználó által az áruház mappájába tett tartalom
0 — egy könyvtár csak
  akkor tűnik el, ha üres, tehát egyetlen kósza fájl megtartja.
• 
begy lejátszási lista, amelyben még vannak saját bejegyzései
0 — csak az áruház
  tartalommappájába mutató elemek kerülnek ki. Az üresen maradt listát törli;
  amelyik nem üres, azt nélkülünk újraírja.
• 
baz 
c.lpl
b mentések
0 — mindegyik a lejátszási listáról, az áruházazonosítóról és
  a 
c-backup
0 utótagról kapja a nevét, és a futás végén kilistázódik. Ezek a
  listák abban az állapotban, ahogy először találtuk őket, tehát
  tartalmazhatnak olyan bejegyzéseket is, amelyek soha nem voltak a mieink.

A szárazon futtatás fájlokat listáz, könyvtártörléseket nem: nem tudhatja,
mely könyvtárak maradnak üresen.

Ha 
bminden
0 áruházat le akarsz szedni egy gépről — mindkét motort, a közös
magot, az indítókat —, használd a 2warpstore szkriptjét:


p curl -fsSL https://git.teletypegames.org/engines/warpstore/raw/branch/master»

p /uninstall.sh | sh                                                           


r──────────────────────────────────────────────────────────────────────────────


1Hova kerülnek a dolgok

1══════════════════════


p ~/.local/share/warp-engine-store/example-retroarch/                          

p ├── retroarch_store.py, warpstore.py, config.json                            

p └── state.json, catalog.json                                                 

p                                                                              

p <content_root>/example/c64/           blessingofra-2.0.0.prg, rabbit-1.0.0.p»

p rg, …                                                                        

p <playlists_dir>/Example Store - Commodore 64.lpl                             

p <thumbnails_dir>/Example Store - Commodore 64/Named_Boxarts/Blessing of Ra.p»

p ng                                                                           

p                                              /Named_Titles/…  /Named_Snaps/… 

A 
ccontent_root
0 alapértelmezés szerint a RetroArch könyvtárán belüli 
ccontent
mappa; a másik kettő a 
cretroarch.cfg
0 fájlból jön. A 
cpaths
0 kiírja, mi lett
feloldva, és melyik válasz honnan jött — ezt futtasd először, ha egy szinkron
váratlan helyre került.

Minden az áruház saját 
cpaths.subfolder
0 mappájába kerül, és a takarítás csak
ehhez nyúlhat: soha nem a felhasználó tartalmához, és soha nem egy másik
áruházéhoz. A lejátszásilista-fájl az áruház nevét viseli, tehát a miénk — de
egy 
ia felhasználó által
0 felvett bejegyzés túléli az újraírást, mert csak az
áruház tartalommappájába mutató elemek cserélődnek le. Amikor egy lejátszási
listához először nyúlunk, 
c-backup
0 másolat készül róla.


r──────────────────────────────────────────────────────────────────────────────


1A lejátszási lista

1══════════════════


p {                                                                            

p   "version": "1.5",                                                          

p   "default_core_path": "/…/cores/vice_x64_libretro.dylib",                   

p   "default_core_name": "VICE x64",                                           

p   "label_display_mode": 0,                                                   

p   "right_thumbnail_mode": 0,                                                 

p   "left_thumbnail_mode": 0,                                                  

p   "thumbnail_match_mode": 0,                                                 

p   "sort_mode": 0,                                                            

p   "items": [                                                                 

p     {                                                                        

p       "path": "/…/content/example/c64/blessingofra-2.0.0.prg",               

p       "entry_slot": -1,                                                      

p       "label": "Blessing of Ra",                                             

p       "core_path": "DETECT",                                                 

p       "core_name": "DETECT",                                                 

p       "crc32": "4253CFC6|crc",                                               

p       "db_name": "Example Store - Commodore 64.lpl"                          

p     }                                                                        

p   ]                                                                          

p }                                                                            

• 
bPlatformonként egy lejátszási lista
0, mert a 
cdefault_core_path
0 
ifejléc
0mező.
  Csak így indul minden bejegyzés egyetlen kattintással, core-kérdés nélkül. A
  bejegyzések 
cDETECT
0 értéken maradnak, így a fájl ott is működik, ahol a
  core-ok máshol vannak — legrosszabb esetben egy kérdés, nem egy halott
  bejegyzés.
• 
bA név a névtér.
0 A 
c{store} - {label}
0 soha nem ír bele a RetroArch saját
  
cCommodore - 64.lpl
0 fájljába, és soha nem ütközik a hivatalos
  bélyegképcsomagokkal. Ez egyben a 
cdb_name
0 is, amelyből a RetroArch
  megtalálja a bélyegképeket: a 
cthumbnails_dir
0 alatti mappát, amelynek a neve
  pontosan a lejátszási lista neve 
c.lpl
0 nélkül, benne a 
cNamed_*
0 mappákkal.
• 
bA megjelenítési mezők mind 
c0
b értékűek
0 — amit a felhasználó globálisan
  beállított. Egy áruháznak semmi köze felülbírálni.
• 
bA 
ccrc32
b valódi
0, a letöltött fájlból számolva, így a RetroArch a mentéseket
  és a bélyegképeket a tartalomhoz tudja kötni.


bA hiányzó core megjegyzés, nem hiba.
0 Ha a platform core-ja nincs meg a

clibretro_directory
0 mappában, a lejátszási lista akkor is kiíródik: a

cdefault_core_path
0 üresen marad, a bejegyzések 
cDETECT
0 értéken maradnak, a
RetroArch pedig egyszer rákérdez. A 
clist
0 és a 
cpaths
0 ezt jelzi, a megoldással
együtt:


p c64: core not found: vice_x64_libretro.dylib — entries stay on DETECT        

p      (Online Updater ▸ Core Downloader ▸ VICE x64)                           


bA borítóképnek PNG-nek kell lennie.
0 A RetroArch a címkét 
c.png
0 kiterjesztéssel
keresi, mással nem. A katalógus azt szolgálja ki, amit feltöltöttek — az egyik
borítónk GIF —, a szabványkönyvtár pedig nem tud képet újrakódolni, ezért a
motor kifelé hív: 
csips
0 (macOS-be építve), 
cmagick
0, 
cconvert
0 vagy 
cffmpeg
0,
amelyiket elsőként megtalálja. Ha egyik sincs, a bejegyzés borítókép nélkül
marad, ami jobb, mint egy elbukott szinkron. Az őszinte megoldás felfelé van:
a WarpEngine kiszolgálhatna PNG-változatot.

A borító egyszer töltődik le, és mindhárom 
cNamed_*
0 mappába bekerül,
hardlinkelve, ahol a fájlrendszer engedi.


r──────────────────────────────────────────────────────────────────────────────


1Másik gépre: export

1═══════════════════

A 
csync
0 ennek a gépnek a RetroArchjába telepít. Az 
cexport
0 az egész áruházat egy
kanonikus fába rendereli le máshova.


p # Android adb-n keresztül                                                    

p $S export /tmp/ra-example \                                                  

p     --target-prefix /storage/emulated/0/RetroArch \                          

p     --target-libretro-dir /data/data/com.retroarch.aarch64/cores \           

p     --core-suffix _android.so                                                

p adb push /tmp/ra-example/. /storage/emulated/0/RetroArch/                    

p                                                                              

p # Itt felcsatolt SD-kártya, ami a kézikonzolon a /mnt/sdcard alatt lesz      

p $S export /Volumes/SDCARD/RetroArch --target-prefix /mnt/sdcard/RetroArch    

A fa mindig 
cplaylists
0, 
cthumbnails
0 és 
ccontent
0 a megadott könyvtáron belül. A

c--target-prefix
0 az, aminek a lejátszási listák szerint a tartalmat hívják azon
a gépen, amely futtatni fogja; enélkül az exportkönyvtár saját útvonala kerül
bele. A célútvonalak úgy íródnak, ahogy a cél írja őket — POSIX, hacsak az
előtag nem néz ki windowsosnak.

Az 
cexport
0 
bszándékosan állapotmentes
0: a katalógus teljes pillanatképe, nem
inkrementális frissítés, és nem zavarhatja meg az ugyanabban az
áruházkönyvtárban lévő helyi telepítést.


r──────────────────────────────────────────────────────────────────────────────


1Platform-leképezés

1══════════════════

Egy katalógusplatform akkor telepíthető, ha valamelyik libretro core
közvetlenül el tudja indítani az assetjét:


t┌───────────────────┬──────────────┬──────────────────────────┬──────────────┐

t│
h Katalógusplatform 
t│
h Asset típusa 
t│
h Core                     
t│
h Kiterjesztés 
t│

t├───────────────────┼──────────────┼──────────────────────────┼──────────────┤

t│
0 7
cc64
0               
t│
0 
ccartridge
0    
t│
0 
cvice_x64_libretro
0 (VICE  
t│
0 
c.prg
0         
t│

t│
0                   
t│
0              
t│
0 x64)                     
t│
0              
t│

t├───────────────────┼──────────────┼──────────────────────────┼──────────────┤

t│
0 8
cplus4
0             
t│
0 
ccartridge
0    
t│
0 
cvice_xplus4_libretro
0     
t│
0 
c.prg
0         
t│

t│
0                   
t│
0              
t│
0 (VICE xplus4)            
t│
0              
t│

t├───────────────────┼──────────────┼──────────────────────────┼──────────────┤

t│
0 9
ctic80
0             
t│
0 
ccartridge
0    
t│
0 
ctic80_libretro
0 (TIC-80)  
t│
0 
c.tic
0         
t│

t└───────────────────┴──────────────┴──────────────────────────┴──────────────┘

Mindhárom core minden releváns célra elkészül — macOS x86_64/arm64, Linux
x86_64/aarch64/armhf, Windows x86_64, Android arm64-v8a/armeabi-v7a —, tehát a
kazetták mindenhol futnak, ahol a RetroArch.

A többi WarpEngine-platform (
cebitengine
0, 
clove
0, 
cgodot
0, 
cbevy
0, 
cphaser
0) webes
buildet és operációs rendszerenkénti natív archívumokat szállít. Ezeket
egyetlen libretro core sem futtatja, tehát ez a motor nem tudja kiszolgálni
őket; Batocera-dobozon 5Portként telepíthetők.


r──────────────────────────────────────────────────────────────────────────────


1Amit valódi hardveren még nem ellenőriztünk

1═══════════════════════════════════════════

A motort végponttól végpontig kipróbáltuk az éles katalóguson: letöltés,
lejátszási listák, bélyegképek, GIF-konverzió, idegen bejegyzések megőrzése,
takarítás, eltávolítás, androidos export és teljes telepítés a forge-ból. Két
dolog kíván valódi futtatást:

• 
bAutomatikusan elindítja-e a VICE core a nyers 
c.prg
b fájlt
0, vagy betölti és
  megvárja a 
cRUN
0 parancsot? Ha vár, a megoldás egy core-beállítás vagy 
c.d64
  szállítása.
• 
bAz androidos átmásolás
0 — a fenti útvonalak dokumentált alapértékek, nem
  mérések, és az sem tesztelt, hogy a scoped storage engedi-e a RetroArchnak
  olvasni azt, amit az 
cadb push
0 írt.

A tervezési jegyzetek és a mérések, amelyekből ez a motor készült, a

cdevarea/RETROARCH_STORE.md
0 fájlban vannak.