Importer des jeux

Spark prend en charge plusieurs methodes pour importer des jeux Ren’Py sur votre appareil iOS.

• ZIP (.zip) — Le plus courant
• APK (.apk) — Paquets Android
• 7-Zip (.7z) — Haute compression
• RAR (.rar) — Support ancien
• TAR (.tar) — Archives non compressees
• Gzip (.gz) — Archives TAR compressees en Gzip
• BZ2 (.bz2) — Archives TAR compressees en Bzip2
• IPA (.ipa) — Archives d’applications iOS
• APP (.app) — Paquets d’applications

1. Ouvrez Spark et appuyez sur le bouton Importer dans la bibliotheque
2. Naviguez jusqu’a votre archive de jeu en utilisant le selecteur de fichiers du systeme
3. Selectionnez le fichier et attendez la fin de l’extraction

Spark verifie l’archive avant l’extraction :

• Calcule la taille non compressee pour verifier que vous avez suffisamment d’espace libre
• Detecte si l’archive est protegee par mot de passe et vous invite a entrer le mot de passe si necessaire
• Analyse le contenu de l’archive pour localiser le dossier game/

Si plusieurs dossiers de jeu sont trouves dans l’archive, il vous sera demande de selectionner lequel importer.

L’archive est extraite dans un repertoire de transit temporaire. Spark surveille l’espace disque pendant l’extraction et s’arretera si le stockage devient critiquement bas. Les dossiers d’artefacts macOS (__MACOSX) sont automatiquement supprimes.

Pour les fichiers APK doublement empaquetes (un ZIP contenant un APK a l’interieur), Spark detecte cela et extrait automatiquement les deux couches.

Apres l’extraction, Spark organise les fichiers dans le repertoire final du jeu :

• Dossier de jeu — Le dossier game/ contenant les scripts, ressources et archives est deplace vers son emplacement final
• Nom du jeu — Determine a partir de android.json (imports APK), d’un fichier .py a cote du dossier de jeu, ou du nom du fichier archive en dernier recours
• Nommage unique — Si un jeu avec le meme nom existe deja, un suffixe numerique est ajoute

Spark recherche dans les fichiers extraits le dossier du moteur Ren’Py integre (renpy/). Si trouve :

• Le moteur est sauvegarde dans le repertoire advanced/renpy/ du jeu pour une utilisation avec le Mode avance
• La version de Ren’Py est lue a partir des fichiers de version dans le dossier du moteur (ex. vc_version.py, __init__.py, script_version.txt, ou leurs equivalents compiles)
• La version detectee est stockee dans les metadonnees du jeu pour la correspondance du moteur
• Pour les imports APK Android, un fichier integre (private.mp3) est extrait pour recuperer le moteur et detecter la version de Python

• Polices personnalisees — Si le moteur integre du jeu inclut des polices modifiees (differentes des polices par defaut de Ren’Py), elles sont copiees dans le dossier du jeu pour que le jeu puisse les utiliser a l’execution
• Support Live2D — L’archive est analysee pour les bibliotheques Live2D. Si trouvees, un marqueur est cree pour que Spark charge le framework Live2D au lancement du jeu

• Un fichier info.json est ecrit avec le nom du jeu, la version du moteur detectee, le nom du fichier archive original et l’horodatage de l’import
• Les repertoires de transit sont nettoyes et les fichiers temporaires sont supprimes
• La bibliotheque de jeux est actualisee et le nouveau jeu apparait dans votre bibliotheque

• Les gros jeux (1 Go+) peuvent prendre du temps a extraire
• Certains formats d’archives tels que 7z peuvent prendre un temps extremement long a extraire si l’archive contient des milliers de fichiers individuels. Les jeux devraient idealement etre empaquetes en utilisant des archives .rpa ou des formats consolides similaires. Certaines des bibliotheques d’extraction ne sont pas optimisees pour ces scenarios
• Si un jeu apparait mais ne se lance pas, essayez de changer la version du moteur dans les Reglages du jeu
• Les fichiers APK peuvent etre masques par le filtre de fichiers — desactivez-le dans Reglages > Bibliotheque de jeux