metadidomi-builder 1.4.171125 → 1.5.2411250404

package/README.md

@@ -19,15 +19,16 @@
 6. **[Gestion des Dépendances](#-gestion-des-dépendances)** - Electron et Python
 7. **[Protection du Code](#-système-de-protection-avancé)** - Sécurité
 8. **[Packaging Python](#-packaging-dapplications-python)** - Applications Python
-9. **[Comparaison](#-comparaison-avec-electron-builder)** - vs electron-builder
-10. **[Roadmap](#-roadmap)** - Futures versions
-11. **[Support](#-support-et-contribution)** - Aide et contact
+9. **[Packaging Android](#-packaging-dapplications-android)** - Applications Android APK
+10. **[Comparaison](#-comparaison-avec-electron-builder)** - vs electron-builder
+11. **[Roadmap](#-roadmap)** - Futures versions
+12. **[Support](#-support-et-contribution)** - Aide et contact
 
 ---
 
 ## 💝 À Propos
 
-Constructeur **professionnel** pour applications Electron et Python exigeant :
+Constructeur **professionnel** pour applications Electron et Python, Android exigeant :
 - ✅ **Sécurité maximale** - Chiffrement AES-256, bytecode, obfuscation
 - ✅ **Builds reproductibles** - 100% déterministe et offline
 - ✅ **Customisation totale** - Contrôle complet du processus
@@ -61,6 +62,9 @@ Si lors de l'installation le dossier `build_tools/vendor` n'est pas présent, su
 . Téléchargez le fichier `vendor.zip` depuis :
   https://github.com/METADIDOMIOFFICIEL/Metadidomi-Builder/releases/download/1.3.171125/vendor.zip
 
+En suite télécharger le kit Android:
+https://github.com/METADIDOMIOFFICIEL/Metadidomi-Builder/releases/download/Android.zip/android.zip
+
 💡 **Suite** :
 Vous pouvez aussi extraire manuellement le contenu de `vendor.zip` dans le dossier `build_tools/vendor`.
 
@@ -1553,6 +1557,776 @@ Python Embeddable distribution not found
 ```
 **✅ SOLUTION:** Vérifiez le dossier `build_tools/vendor/python_embeddable/`
 
+---
+# Metadidomi Crone - Générateur d'APK Android
+
+Une solution complète et automatisée pour créer des applications Android (APK) sans besoin de connaissances avancées en Android Studio.
+
+<a id="top"></a>
+
+## 📋 Table des matières
+
+- [Installation rapide](#installation-rapide)
+- [Structure d'un projet](#structure-dun-projet)
+- [Créer une nouvelle application](#créer-une-nouvelle-application)
+- [Configuration de l'application](#configuration-de-lapplication)
+- [Générer l'APK](#générer-lapk)
+- [Exemples](#exemples)
+- [Dépannage](#dépannage)
+- [Options avancées](#options-avancées)
+
+---
+
+## Installation rapide
+
+🔝 [Retour en haut](#top)
+
+### Prérequis
+
+- **Node.js** (v14 ou supérieur) - [Télécharger](https://nodejs.org)
+- **PowerShell** (Windows) ou **Bash** (Mac/Linux)
+- **Python 3** (pour la génération d'icônes) - [Télécharger](https://www.python.org)
+- **Pillow** (PIL) pour Python : `pip install Pillow`
+
+### Vérifier l'installation
+
+```powershell
+node --version
+python --version
+npm --version
+```
+
+### Installation via npm (Recommandé)
+
+Installez metadidomi-builder comme dépendance locale dans votre projet :
+
+```powershell
+
+npm install metadidomi-builder
+```
+
+Créez un `package.json` à la racine de votre projet :
+
+```json
+{
+  "name": "mon-app-android",
+  "version": "1.0.0",
+    "scripts": {
+    "build": "node node_modules/metadidomi-builder/build_tools/build_apk.js .",
+    "build-debug": "node node_modules/metadidomi-builder/build_tools/build_apk.js . --fail-on-missing",
+    "build-restore": "node node_modules/metadidomi-builder/build_tools/build_apk.js . --restore",
+    "build-icons": "node node_modules/metadidomi-builder/build_tools/generate-icons.js ."
+  },
+  "keywords": [
+    "android",
+    "apk",
+    "builder"
+  ],
+  "author": "Metadidomi",
+  "license": "MIT",
+  "dependencies": {
+    "metadidomi-builder": "file:../metadidomi-builder",
+    "sharp": "^0.32.0"
+  }
+}
+```
+
+Puis installez et lancez le build :
+
+```powershell
+npm install
+npm run build
+```
+
+---
+
+## Structure d'un projet
+
+🔝 [Retour en haut](#top)
+
+Chaque application Android doit suivre cette structure :
+
+```
+MonApp/
+├── app-config.json           # Configuration de l'app
+├── AndroidManifest.xml       # Déclaration Android (généré automatiquement)
+├── src/
+│   └── com/example/monapp/
+│       └── MainActivity.java  # Code Java principal
+├── res/
+│   ├── layout/
+│   │   └── activity_main.xml # Interface utilisateur
+│   ├── values/
+│   │   ├── strings.xml       # Textes et traductions
+│   │   ├── colors.xml        # Couleurs
+│   │   └── styles.xml        # Styles et thèmes
+│   ├── mipmap-hdpi/
+│   │   └── ic_launcher.png   # Icône de l'app (auto-générée)
+│   └── drawable/             # Images supplémentaires (optionnel)
+└── build/                     # Généré automatiquement (à ignorer)
+```
+
+---
+
+## Créer une nouvelle application
+
+### Étape 1 : Créer la structure des dossiers
+
+🔝 [Retour en haut](#top)
+
+```powershell
+mkdir MonApp\src\com\example\monapp
+mkdir MonApp\res\layout
+mkdir MonApp\res\values
+mkdir MonApp\res\mipmap-hdpi
+```
+
+### Étape 2 : Créer `app-config.json`
+
+Ce fichier contient toutes les informations de votre application.
+
+```json
+{
+  "appName": "MonApp",
+  "appVersion": "1.0.0",
+  "appDescription": "Ma première application Android",
+  "packageName": "com.example.monapp",
+  "minSdkVersion": 21,
+  "targetSdkVersion": 34,
+  "colors": {
+    "primary": "#2196F3",
+    "primaryDark": "#1976D2",
+    "accent": "#FF5722"
+  }
+}
+```
+
+**Explications des paramètres :**
+- `appName` : Nom affiché de l'application
+- `appVersion` : Version sémantique (majeur.mineur.patch)
+- `packageName` : Identifiant unique (format domaine inversé)
+- `minSdkVersion` : Version Android minimale (21 = Android 5.0)
+- `targetSdkVersion` : Version Android ciblée (34 = Android 14)
+- `colors` : Couleurs principales (format hexadécimal)
+
+### Étape 3 : Créer l'interface (`activity_main.xml`)
+
+Fichier : `res/layout/activity_main.xml`
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:gravity="center"
+    android:padding="16dp">
+
+    <TextView
+        android:id="@+id/titleText"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Bienvenue dans MonApp"
+        android:textSize="24sp"
+        android:textStyle="bold" />
+
+    <Button
+        android:id="@+id/myButton"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Appuyez-moi"
+        android:layout_marginTop="16dp" />
+
+</LinearLayout>
+```
+
+### Étape 4 : Créer les textes (`strings.xml`)
+
+Fichier : `res/values/strings.xml`
+
+```xml
+<resources>
+    <string name="app_name">MonApp</string>
+    <string name="app_version">1.0.0</string>
+    <string name="app_description">Ma première application</string>
+    <string name="hello_world">Bienvenue</string>
+    <string name="action_settings">Paramètres</string>
+    <string name="back">Retour</string>
+    <string name="forward">Suivant</string>
+    <string name="reload">Recharger</string>
+</resources>
+```
+
+### Étape 5 : Créer le code Java (`MainActivity.java`)
+
+Fichier : `src/com/example/monapp/MainActivity.java`
+
+```java
+package com.example.monapp;
+
+import android.app.Activity;
+import android.os.Bundle;
+import android.widget.Button;
+import android.widget.Toast;
+import android.view.View;
+import android.util.Log;
+
+public class MainActivity extends Activity {
+    private static final String TAG = "MonApp";
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+        Log.d(TAG, "MainActivity créée");
+
+        Button myButton = (Button) findViewById(R.id.myButton);
+        myButton.setOnClickListener(new View.OnClickListener() {
+            @Override
+            public void onClick(View v) {
+                Toast.makeText(MainActivity.this, "Bouton cliqué!", Toast.LENGTH_SHORT).show();
+                Log.d(TAG, "Bouton cliqué");
+            }
+        });
+    }
+}
+```
+
+### Étape 6 : Ajouter une icône
+
+Placez une image PNG (96x96 pixels) dans `res/mipmap/`.
+
+**Le système générera automatiquement les variantes pour tous les écrans.**
+
+---
+
+## Configuration de l'application
+
+🔝 [Retour en haut](#top)
+
+### `app-config.json` complet
+
+```json
+{
+  "appName": "MonApp",
+  "appVersion": "1.0.0",
+  "appDescription": "Ma première application Android",
+  "packageName": "com.example.monapp",
+  "minSdkVersion": 21,
+  "targetSdkVersion": 34,
+  "colors": {
+    "primary": "#2196F3",
+    "primaryDark": "#1976D2",
+    "accent": "#FF5722"
+  },
+  "minimalRequiredFiles": [
+    "AndroidManifest.xml",
+    "res/values/strings.xml",
+    "res/values/styles.xml",
+    "res/layout/activity_main.xml"
+  ]
+}
+```
+
+---
+
+## Générer l'APK
+
+🔝 [Retour en haut](#top)
+
+### Avec npm
+
+```powershell
+# Build standard
+npm run build
+
+# Build avec vérification stricte
+npm run build-debug
+
+# Générer les icônes
+npm run build-icons
+```
+
+### Sans sauvegarde
+
+```powershell
+node "metadidomi-builder\build_tools\build_apk.js" "MonApp" --no-backup
+```
+
+### Restaurer depuis une sauvegarde
+
+```powershell
+node "metadidomi-builder\build_tools\build_apk.js" "MonApp" --restore
+```
+
+### Résultat
+
+Après une génération réussie, vous trouverez :
+
+```
+MonApp/
+└── MonApp.apk  ← Votre application, prête à installer!
+```
+
+Fichier de sortie : `MonApp/MonApp.apk`
+
+**Taille typique :** 2-5 MB
+
+---
+
+## Exemples
+
+🔝 [Retour en haut](#top)
+
+### Exemple 1 : Application Compteur
+
+Voir le dossier `CounterApp/` pour un exemple complet d'une application de compteur avec :
+- Boutons d'incrémentation/décrémentation
+- Affichage d'un compteur
+- Interface colorée
+
+### Exemple 2 : Application Simple
+
+Consultez `MyApp/` pour une application de base.
+
+### Exemple 3 : Application Avancée
+
+`MyApp_Advanced/` contient des fonctionnalités plus complexes.
+
+---
+
+## Dépannage
+
+🔝 [Retour en haut](#top)
+
+### Erreur : "Aucun fichier Java trouvé"
+
+**Cause** : Le dossier `src/` est vide ou mal structuré.
+
+**Solution** :
+1. Vérifiez que `MainActivity.java` existe dans `src/com/example/monapp/`
+2. Vérifiez le nom du package (doit correspondre à `packageName` dans `app-config.json`)
+
+```
+src/
+└── com/example/monapp/
+    └── MainActivity.java  ✓ Correct
+```
+
+### Erreur : "resource string/... not found"
+
+**Cause** : Une chaîne de caractères référencée n'existe pas dans `strings.xml`.
+
+**Solution** :
+1. Ouvrez `res/values/strings.xml`
+2. Ajoutez la chaîne manquante avec son ID correct :
+   ```xml
+   <string name="fragment1">Fragments</string>
+   <string name="action_click">Cliquez ici</string>
+   ```
+3. **Assurez-vous que le nom correspond exactement** à celui utilisé dans votre layout XML
+
+**Exemple d'erreur rencontrée (CounterApp) :**
+```
+error: resource string/fragment1 not found
+```
+**Correction appliquée :**
+```xml
+<!-- res/values/strings.xml -->
+<resources>
+    <string name="app_name">CounterApp</string>
+    <string name="fragment1">Compteur</string>
+    <string name="increment">Incrémenter</string>
+    <string name="decrement">Décrémenter</string>
+    <string name="reset">Réinitialiser</string>
+</resources>
+```
+
+### Erreur : "cannot find symbol: variable R"
+
+**Cause** : Les ressources n'ont pas été compilées correctement.
+
+**Solution** :
+1. Supprimez le dossier `build/`
+2. Vérifiez que `res/values/strings.xml` est valide (XML bien formé, pas d'accents mal encodés)
+3. Relancez la génération complète
+
+### Erreur : "D8 compilation failed" avec "NullPointerException"
+
+**Cause** : Classes anonymes mal générées lors de la compilation DEX.
+
+**Symptômes** :
+```
+java.lang.NullPointerException: Cannot invoke "String.length()"
+Exception in thread "main" java.lang.NullPointerException
+```
+
+**Solution - Utilisez `implements View.OnClickListener` au lieu de classes anonymes** :
+
+❌ **INCORRECT (cause l'erreur D8)** :
+```java
+button.setOnClickListener(new View.OnClickListener() {
+    @Override
+    public void onClick(View v) {
+        counter++;
+        updateDisplay();
+    }
+});
+```
+
+✅ **CORRECT** :
+```java
+public class MainActivity extends Activity implements View.OnClickListener {
+    private Button incrementBtn, decrementBtn;
+    
+    @Override
+    public void onClick(View v) {
+        int id = v.getId();
+        if (id == R.id.incrementBtn) counter++;
+        else if (id == R.id.decrementBtn) counter--;
+    }
+}
+```
+
+**Pourquoi** : D8 (compilateur DEX) a des problèmes avec les classes anonymes imbriquées. Les interfaces nommées sont plus fiables.
+
+### Erreur : "cannot find symbol: variable helloText" ou autre ID de ressource
+
+**Cause** : Le code Java référence un ID qui n'existe pas dans le layout XML.
+
+**Symptôme** :
+```
+error: cannot find symbol
+symbol: variable helloText
+location: class MainActivity
+```
+
+**Solution** :
+1. Vérifiez que l'ID existe dans `res/layout/activity_main.xml` :
+   ```xml
+   <TextView
+       android:id="@+id/helloText"
+       ...
+   />
+   ```
+2. Vérifiez que vous utilisez le bon nom en Java :
+   ```java
+   TextView helloText = (TextView) findViewById(R.id.helloText);
+   ```
+3. Assurez-vous que l'ID correspond EXACTEMENT (majuscules/minuscules)
+
+**Exemple de correction (CounterApp)** :
+```xml
+<!-- res/layout/activity_main.xml -->
+<LinearLayout ...>
+    <TextView
+        android:id="@+id/counterDisplay"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="0"
+        android:textSize="72sp" />
+    
+    <Button
+        android:id="@+id/incrementBtn"
+        android:text="Incrémenter" />
+</LinearLayout>
+```
+
+### Erreur : "AndroidManifest.xml not found"
+
+**Cause** : Fichier de configuration critique manquant ou mal généré.
+
+**Solution** :
+1. Vérifiez que `app-config.json` existe à la racine du projet
+2. Assurez-vous que le JSON est valide (syntaxe correcte, pas de virgules manquantes)
+3. Relancez le build avec l'option `--fail-on-missing` pour diagnostiquer :
+   ```powershell
+   node "metadidomi-builder\build_tools\build_apk.js" "MonApp" --fail-on-missing
+   ```
+
+### Erreur : "Fichiers minimums manquants"
+
+**Cause** : Des fichiers essentiels n'existent pas.
+
+**Files requises minimales** :
+- `app-config.json` → Configuration de l'app
+- `AndroidManifest.xml` → Descripteur (généré automatiquement)
+- `res/values/strings.xml` → Textes
+- `res/values/styles.xml` → Styles (généré automatiquement)
+- `res/layout/activity_main.xml` → Interface utilisateur
+- `src/com/example/monapp/MainActivity.java` → Code principal
+
+**Solution** :
+```powershell
+# Mode diagnostique - affiche les fichiers manquants sans échouer
+node "metadidomi-builder\build_tools\build_apk.js" "MonApp"
+
+# Mode strict - échoue si des fichiers manquent
+node "metadidomi-builder\build_tools\build_apk.js" "MonApp" --fail-on-missing
+```
+
+### L'APK n'est pas généré
+
+**Cause** : Erreur lors de la signature ou de l'assemblage final.
+
+**Solution** :
+1. Supprimez le fichier `.keystore` dans le dossier du projet :
+   ```powershell
+   rm "MonApp\.keystore"
+   ```
+2. Relancez la génération (un nouveau keystore sera créé) :
+   ```powershell
+   node "metadidomi-builder\build_tools\build_apk.js" "MonApp"
+   ```
+
+### Erreur : "Invalid app-config.json"
+
+**Cause** : Fichier de configuration mal formé.
+
+**Vérifiez** :
+```json
+{
+  "appName": "MonApp",           // ✓ String valide
+  "appVersion": "1.0.0",        // ✓ Format sémantique (majeur.mineur.patch)
+  "packageName": "com.example.monapp",  // ✓ Format domaine inversé
+  "minSdkVersion": 21,          // ✓ Nombre entier >= 21
+  "targetSdkVersion": 34,       // ✓ Nombre entier
+  "colors": {
+    "primary": "#2196F3",       // ✓ Couleur hexadécimale valide
+    "primaryDark": "#1976D2",
+    "accent": "#FF5722"
+  }
+}
+```
+
+### Erreur : "Layout XML invalide"
+
+**Cause** : Syntaxe XML incorrecte dans `activity_main.xml`.
+
+**Vérifiez** :
+- Les balises ouvrantes et fermantes correspondent (`<LinearLayout>` ... `</LinearLayout>`)
+- Les attributs android: sont valides
+- Les IDs sont uniques et bien formatés (`android:id="@+id/monId"`)
+- Les textes spéciaux sont échappés (`&amp;`, `&lt;`, `&gt;`)
+
+**Exemple correct** :
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:orientation="vertical"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent">
+    
+    <Button
+        android:id="@+id/myButton"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Cliquez-moi" />
+    
+</LinearLayout>
+```
+
+### Erreur : "Icônes manquantes"
+
+**Cause** : L'icône n'a pas été générée ou redimensionnée correctement.
+
+**Solution** :
+1. Placez une image PNG (96x96 pixels minimum) dans `res/drawable/` ou `res/mipmap/`
+2. Exécutez le générateur d'icônes :
+   ```powershell
+   node "metadidomi-builder\build_tools\generate-icons.js" "MonApp"
+   ```
+3. Vérifiez que tous les dossiers mipmap ont été créés :
+   ```
+   res/mipmap-mdpi/ic_launcher.png       (48x48)
+   res/mipmap-hdpi/ic_launcher.png       (72x72)
+   res/mipmap-xhdpi/ic_launcher.png      (96x96)
+   res/mipmap-xxhdpi/ic_launcher.png     (144x144)
+   res/mipmap-xxxhdpi/ic_launcher.png    (192x192)
+   ```
+
+### Erreur : "Package name already exists"
+
+**Cause** : Un package Android avec le même nom est déjà installé.
+
+**Solution** :
+1. Changez le `packageName` dans `app-config.json` :
+   ```json
+   "packageName": "com.example.monapp.v2"
+   ```
+2. Régénérez l'APK
+3. Ou : désinstallez l'ancienne app avant d'installer la nouvelle
+
+---
+
+## Options avancées
+
+🔝 [Retour en haut](#top)
+
+### Personnaliser les ressources générées automatiquement
+
+Par défaut, le système génère :
+- `AndroidManifest.xml` (descripteur de l'app)
+- `res/values/colors.xml` (couleurs)
+- `res/values/styles.xml` (thèmes)
+
+Ces fichiers sont générés à chaque build. Pour les personnaliser, créez-les manuellement et le système les préservera.
+
+### Ajouter des ressources personnalisées
+
+```
+res/
+├── drawable/           # Images 1x (160 DPI)
+├── drawable-hdpi/      # Images 1.5x (240 DPI)
+├── drawable-xhdpi/     # Images 2x (320 DPI)
+├── drawable-xxhdpi/    # Images 3x (480 DPI)
+├── drawable-xxxhdpi/   # Images 4x (640 DPI)
+├── font/               # Polices personnalisées
+├── menu/               # Menus
+├── raw/                # Fichiers non compressés
+└── anim/               # Animations
+```
+
+### Générer les icônes automatiquement
+
+Placez une image source dans `res/drawable/` ou `res/mipmap/` :
+
+```powershell
+node "metadidomi-builder\build_tools\generate-icons.js" "MonApp"
+```
+
+Le système créera automatiquement les variantes pour tous les écrans :
+- `mipmap-mdpi` (48×48)
+- `mipmap-hdpi` (72×72)
+- `mipmap-xhdpi` (96×96)
+- `mipmap-xxhdpi` (144×144)
+- `mipmap-xxxhdpi` (192×192)
+
+### Utiliser des variables d'environnement
+
+```powershell
+$env:PROJECT_PATH = "C:\MonApp"
+node "metadidomi-builder\build_tools\build_apk.js"
+```
+
+---
+
+## Architecture du système
+
+🔝 [Retour en haut](#top)
+
+```
+metadidomi-builder/
+├── build_tools/
+│   ├── build_apk.js              # Orchestration principale
+│   ├── generate-resources.js     # Génération des ressources XML
+│   ├── generate-icons.js         # Redimensionnement des icônes
+│   ├── backup-manager.js         # Gestion des sauvegardes
+│   └── vendor/                   # SDK Android et JDK (inclus)
+└── build_tools_py/               # Outils Python avancés (optionnel)
+```
+
+---
+
+## Étapes du build expliquées
+
+🔝 [Retour en haut](#top)
+
+1. **Génération des ressources** : Crée `AndroidManifest.xml`, couleurs, styles
+2. **Génération des icônes** : Redimensionne l'icône pour toutes les densités
+3. **Vérification des fichiers** : Contrôle la présence des fichiers minimums
+4. **Compilation des ressources** : AAPT2 compile XML et images
+5. **Liaison des ressources** : Génération de `R.java` avec les IDs de ressources
+6. **Compilation Java** : Javac compile le code Java
+7. **Création du JAR** : Empaquetage des classes Java
+8. **Conversion DEX** : D8 convertit en format Android (DEX)
+9. **Assemblage APK** : Création de la structure APK
+10. **Alignement** : Zipalign optimise la structure APK
+11. **Signature** : Signature numérique de l'APK
+12. **Résultat** : APK prête à être installée
+
+---
+
+## Installation de l'APK sur un téléphone
+
+🔝 [Retour en haut](#top)
+
+### Via USB
+
+```powershell
+adb install -r "MonApp\MonApp.apk"
+```
+
+### Via partage de fichier
+
+1. Transférez le fichier `.apk` sur votre téléphone
+2. Ouvrez l'explorateur de fichiers
+3. Appuyez sur le fichier `.apk`
+4. Confirmez l'installation
+
+---
+
+## Conseils et bonnes pratiques
+
+🔝 [Retour en haut](#top)
+
+✅ **À faire :**
+- Tester l'app fréquemment
+- Utiliser des noms de ressources explicites
+- Commenter le code Java
+- Utiliser `Log.d()` pour déboguer
+- Versionner votre code (Git)
+
+❌ **À éviter :**
+- Charger des images trop volumineuses
+- Utiliser des classes anonymes complexes
+- Modifier les fichiers générés automatiquement
+- Laisser des ressources inutilisées
+
+---
+
+## Foire aux questions
+
+🔝 [Retour en haut](#top)
+
+**Q : Puis-je créer plusieurs activités ?**
+A : Oui, ajoutez des classes Java dans `src/` et déclarez-les dans `AndroidManifest.xml`.
+
+**Q : Comment ajouter des dépendances externes ?**
+A : Actuellement, seules les APIs Android intégrées sont supportées.
+
+**Q : L'APK fonctionne-t-il sur tous les téléphones ?**
+A : Oui, tant qu'ils sont Android 5.0 (API 21) ou supérieur.
+
+**Q : Puis-je mettre à jour l'APK ?**
+A : Oui, augmentez `appVersion` dans `app-config.json` et régénérez.
+
+**Q : Les APK sont-elles vraiment signées ?**
+A : Oui, automatiquement avec une clé de développement auto-générée.
+
+---
+
+## Support
+
+🔝 [Retour en haut](#top)
+
+Pour des problèmes ou des questions :
+
+1. Consultez le dossier `CounterApp/` pour un exemple complet
+2. Vérifiez les logs du build pour les erreurs
+3. Assurez-vous que tous les fichiers requis existent
+
+---
+
+## Version
+
+- **Metadidomi Crone** : v1.0.0
+- **Android SDK** : 34 (Android 14)
+- **Build Tools** : 34.0.0
+- **Dernière mise à jour** : Novembre 2025
+
+---
+
 ### 📞 Support
 
 Pour les questions sur le packaging Python :
@@ -1562,7 +2336,7 @@ Pour les questions sur le packaging Python :
 
 ---
 
-## �🗺️ Roadmap - Vision Multi-Plateforme
+## 🗺️ Roadmap - Vision Multi-Plateforme
 
 ### Phase 1 : Windows ✅ (Actuelle)
 - ✅ Build portable (.exe)