Configurer et recompiler l'application Android

Pointez l'application vers votre propre backend en modifiant un seul fichier, puis déterminez si une recompilation est réellement nécessaire.

1. Modifier www/settings.ini

xCRUD_Nova_Android_App/www/settings.ini est une simple liste de paires clé = valeur regroupées en [sections]. Comme le dit le commentaire d'en-tête du fichier lui-même : "Modifiez ce fichier et rechargez (ou resynchronisez l'application) - rien ici ne nécessite de recompilation ni de changement de code de l'application elle-même."

[backend]
url = https://yourdomain.com/xcrud_8

demo_username = admin
demo_password = admin123

[branding]
app_name = xCRUD Nova
tagline = Your xCRUD Nova/Pro dashboard, on your phone.

[purchase]
url =
label =

[documentation]
url = https://yourdomain.com/xcrud_8/docs
label = Documentation

Clé	Signification
`[backend] url`	Requis. Le serveur xCRUD Nova/Pro avec lequel dialogue cette application - une URL absolue, sans barre oblique finale, ex. `https://yourdomain.com/xcrud_8`. Tout ce que l'application affiche (connexion, puis le tableau de bord en direct) est récupéré depuis cette seule URL. Laissez vide et l'application affiche un avis de configuration au lieu d'un écran vide.
`[backend] demo_username` / `demo_password`	Identifiants de connexion de démonstration affichés comme indice sous le formulaire de connexion. Laissez les deux vides une fois que vous pointez ceci vers votre propre backend réel, non-démo.
`[branding] app_name`	Le nom de l'application affiché dans l'interface.
`[branding] tagline`	Un court slogan affiché sous le nom de l'application.
`[purchase] url`	Affiché comme bouton d'appel à l'action flottant sur chaque écran. Réglez sur une valeur vide pour masquer entièrement le bouton - la plupart des hébergeurs autonomes voudront le laisser vide, puisque c'était une fonctionnalité marketing/de démonstration d'évaluation, pas quelque chose dont a généralement besoin la copie installée d'un acheteur. Le vider désactive également la bannière "LIVE DEMO".
`[purchase] label`	Texte du bouton. Par défaut "Buy the xCRUD Nova server files" si laissé vide alors que `url` est défini.
`[documentation] url`	Affiché comme second lien flottant, juste au-dessus du bouton d'achat. Utile que cette copie soit une démonstration marketing ou la véritable installation d'un acheteur - réglez sur une valeur vide pour le masquer.
`[documentation] label`	Texte du lien, ex. "Documentation".

2. Test rapide contre recompilation complète

Deux niveaux d'effort très différents, selon ce qui a changé :

Test rapide - il suffit de recharger. Modifier settings.ini seul ne nécessite aucune recompilation ni changement de code de l'application - rechargez la WebView (ou resynchronisez l'application) et la nouvelle URL de backend/marque prend effet immédiatement.
Recompilation complète de l'APK. Nécessaire uniquement lorsque vous modifiez des éléments de la coquille native que Capacitor lui-même contrôle - l'icône de l'application, l'écran de démarrage, les permissions, appId/appName dans capacitor.config.json, ou les fichiers du projet Android eux-mêmes. Synchronisez les ressources web dans le projet natif, puis compilez :

npx cap sync android

Suivi de la compilation de l'APK, soit via Android Studio (ouvrez le dossier android/ et Build > Build APK), soit en ligne de commande avec Gradle :

cd android
./gradlew assembleDebug

3. CORS - généralement rien à changer

Le XcrudConfig::$allowedOrigins du backend inclut déjà par défaut https://localhost (l'origine WebView par défaut de Capacitor sur Android) et http://localhost:8081 (la propre origine du serveur de développement remote_frontend_demo de bureau) :

public static array $allowedOrigins = ['http://localhost:8081', 'https://localhost', 'http://localhost', 'http://127.0.0.1'];

Cela signifie que la plupart des hébergeurs autonomes pointant l'application standard vers leur propre backend n'ont AUCUN changement CORS à faire. Vous n'avez besoin de toucher à $allowedOrigins que si vous :

Personnalisez androidScheme/hostname de Capacitor en les éloignant de la valeur par défaut, changeant ainsi la propre origine de la WebView, ou
Déployez le frontend statique www/ séparément sur un vrai domaine (plutôt que de le charger depuis l'intérieur de la coquille de l'application), qui appelle alors le backend en cross-origin depuis ce domaine.

Voir Frontends découplés et CORS pour la référence complète de $allowedOrigins/$forceApiUrl.