Les problèmes les plus fréquents avec l'application mobile LaraClassifier et l'application mobile JobClass, et comment les résoudre. La plupart viennent de la connexion entre l'application et votre site : l'adresse de l'API, le jeton d'API, le certificat, ou le fichier /.env du site.
À retenir : les valeurs de
.env.local sont intégrées à l'application. Après une modification, relancez avec npx expo start --clear et recompilez l'application pour les stores. Après une modification du /.env du site, videz son cache de configuration (Panneau d'administration → Clear cache ou php artisan config:clear).
Les messages de l'application sont cités ici dans leur version française (avec la version anglaise entre parenthèses) quand ils sont traduits.
Connexion
| Symptôme | Cause et solution |
|---|---|
| Écran « Setup required » | EXPO_PUBLIC_API_URL ou EXPO_PUBLIC_API_TOKEN manque dans .env.local. Ajoutez-le, puis lancez npx expo start --clear. |
| « Impossible de joindre le serveur » (« Can't reach the server ») | Mauvaise adresse, pas de connexion Internet, ou certificat HTTPS invalide. Ouvrez votre EXPO_PUBLIC_API_URL suivi de /categories dans le navigateur du téléphone pour vérifier. |
| « Impossible de joindre le serveur » avec un site installé sur votre ordinateur | Le site n'accepte pas les connexions venant du réseau (démarrez-le sur 0.0.0.0), l'application utilise un domaine local au lieu de l'adresse IP, l'adresse IP de l'ordinateur a changé (elle peut changer quand vous vous reconnectez au Wi-Fi), le pare-feu bloque le port, le téléphone est sur un autre réseau ou sur un réseau invité, ou Expo Go n'a pas le droit d'utiliser le réseau local (iPhone : Réglages → Expo Go → Réseau local). Voir la partie « Tester avec un site installé sur votre ordinateur » de Publier l'application mobile. |
| « You don't have access to this API » | Le jeton ne correspond pas au APP_API_TOKEN du site, ou la configuration du site est en cache : videz le cache. |
| « Bot access is not allowed » | Une couche de sécurité (pare-feu, CDN, WAF de l'hébergeur) a modifié ou bloqué la requête. Autorisez les requêtes dont le User-Agent commence par ClassifiedsMobile/ (LaraClassifier) ou JobBoardMobile/ (JobClass). |
| « Échec de la requête (404) » (« Request failed (404) ») sur certains écrans | Le site est plus ancien que LaraClassifier ou JobClass 19.1.13. Mettez-le à jour. |
Contenu et langues
| Symptôme | Cause et solution |
|---|---|
| Les annonces s'affichent mais pas les photos (LaraClassifier), ou les offres s'affichent mais pas les logos d'entreprise (JobClass) | APP_URL dans le /.env du site ne correspond pas à l'adresse utilisée par l'application (par exemple http au lieu de https, avec ou sans www). |
| Un CV ou une pièce jointe ne s'ouvre pas (JobClass) | Les liens vers les fichiers sont construits à partir de APP_URL (voir ci-dessus), et ils sont temporaires : revenez en arrière et rouvrez l'écran pour obtenir un nouveau lien. |
| Catégories ou villes vides dans certaines langues | Réglez FALLBACK_LOCALE_FOR_DB sur la langue de vos données (en général en) dans le /.env du site. |
| Aucun champ personnalisé dans le formulaire de publication | La catégorie choisie n'a pas de champs personnalisés dans le panneau d'administration, ou le site est plus ancien que la version 19.1.13. |
| Pas de lien vers les conditions d'utilisation ou la politique de confidentialité | Votre site n'a pas de page de type Terms ou Privacy. Créez-les dans Panneau d'administration → Pages. |
| Mise en page arabe ou hébreu qui ne passe pas de droite à gauche | Le sens d'affichage change une fois l'application fermée puis rouverte. |
Envoi de fichiers
| Symptôme | Cause et solution |
|---|---|
| Envoi d'une photo ou d'un logo refusé | L'application compresse les images selon la taille maximale des images de vos réglages d'upload. Si cette taille est très faible (moins de 300 Ko) ou que le format est refusé, ajustez les réglages d'upload dans le panneau d'administration. |
| Envoi d'image refusé avec « must be a file of type: . » | Le site n'accepte aucun format d'image : son IMAGE_DRIVER vaut imagick mais le PHP qui le fait tourner n'a pas l'extension Imagick. Réglez IMAGE_DRIVER=gd dans le /.env du site, ou installez Imagick. Cela arrive souvent pendant les tests avec php artisan serve ou le serveur intégré de PHP, qui utilisent le PHP en ligne de commande de votre ordinateur. |
| Envoi d'un CV refusé (JobClass) | Le type ou la taille du fichier n'est pas autorisé par les réglages d'upload du panneau d'administration (types de fichiers, taille maximale des fichiers). |
Expo et builds
| Symptôme | Cause et solution |
|---|---|
| Expo Go : « You need to be signed in » | Connectez-vous avec le même compte Expo dans Expo Go et avec npx expo login sur votre ordinateur. |
| Le build EAS échoue | Ouvrez le lien vers le journal du build affiché par EAS. La plupart des échecs viennent d'une valeur de brand.json (identifiant invalide, fichier image manquant). |
| Le store refuse le build | Le numéro de build a déjà été utilisé : augmentez ios.buildNumber et android.versionCode dans brand.json, puis recompilez. |
Notifications push, connexion sociale et liens vers l'application
| Symptôme | Cause et solution |
|---|---|
| Aucune notification push | Le push est désactivé dans les réglages Mobile App du site, l'utilisateur a refusé les notifications, eas.projectId est absent, ou les identifiants FCM Android manquent. Expo Go sur Android ne peut pas recevoir de notifications push. |
| La connexion Google échoue | Les identifiants client de brand.json ne figurent pas dans les réglages Mobile App du site, ou l'empreinte SHA-1 Android ne correspond pas au build. |
| Les liens ouvrent le navigateur au lieu de l'application | Les réglages Mobile App (iOS app ID, empreintes Android) sont absents ou erronés, ou l'application a été compilée avant qu'ils soient renseignés. |
La configuration de ces fonctions est décrite dans Application mobile : notifications push, connexion sociale et liens vers l'application.
Toujours bloqué ?
Contactez-nous via le Centre d'aide en indiquant votre code d'achat, votre version de LaraClassifier ou de JobClass, la version de l'application, la plateforme (iOS ou Android), le message exact affiché et les étapes pour reproduire le problème. Le support couvre l'application telle qu'elle est livrée ; les personnalisations, la création des comptes sur les stores et les refus de validation causés par votre contenu ou votre fiche sur les stores ne sont pas couverts.