Les appareils Android avec des pages de mémoire de 16 KB sont déployés. Si un plugin Capacitor (ou l'une de ses dépendances natives) n'est pas prêt, une fonctionnalité peut cesser de fonctionner ou l'application peut planter sur certains téléphones. La mise en œuvre est en cours d'intensification, il est donc temps de prévoir une solution.
Important : À compter du 1er novembre 2025, tous les nouveaux applications et les mises à jour des applications existantes soumises sur Google Play et ciblant les appareils Android 15+ doivent supporter les tailles de page 16 KB sur les appareils 64 bits.
Cette guide garde les choses simples : recherchez le plugin qui ne fonctionne pas, vérifiez si une mise à jour facile est disponible, et si le plugin semble non maintenu, demandez à quelqu'un de le maintenir pour vous. Capgo Conseil pour le forker et le maintenir à votre place.
Symptômes sur les appareils Android de 16 KB
- Fonctionne sur certains téléphones Android, ne fonctionne pas sur d'autres (souvent des modèles plus récents).
- Un fonctionnement cesse de fonctionner lorsqu'un plugin spécifique est utilisé (caméra, fichiers, Bluetooth, etc.).
- Déboguer fonctionne parfois, la version de production ne fonctionne pas.
Conseil : Essayez sur un appareil Android récent pour reproduire le problème tôt.
Étape 1 — Assurez-vous qu'il s'agit d'un problème de plugin
- Répétez le problème et notez la fonctionnalité que vous utilisez.
- Masquez temporairement/désactivez cette fonctionnalité dans code. Si le problème disparaît, le plugin lié est probablement la cause.
Étape 2 — Trouvez le plugin qui ne fonctionne pas
- Désactivez les fonctionnalités une par une (ou commentez les appels de plugin) jusqu'à ce que l'application cesse de fonctionner.
- La dernière fonctionnalité que vous avez désactivée avant qu'elle commence à fonctionner à nouveau indique le plugin responsable.
Étape 3 — Recherchez une Solution Rapide
Une fois que vous connaissez le plugin :
- Mettez à jour vers la dernière version du plugin et de vos Capacitor packages.
- Lisez le fichier README/changelog du plugin pour les notes sur Android 16 KB.
- Vérifiez les problèmes ouverts/discussions pour des rapports similaires et des versions recommandées.
Étape 4 — Demandez au Mainteneur
Si la dernière version continue à ne pas fonctionner :
- Ouvrez un problème court et clair : « Ne fonctionne pas sur les appareils Android avec une taille de page de 16 KB ; la fonctionnalité X ne fonctionne plus. »
- Incluez votre version Capacitor, la version du plugin et une description rapide de la reproduction.
- Attendez un peu de réponse — certaines équipes ont besoin de quelques jours.
Étape 5 — Si le Plugin Apparaît Non Entretenu
Signes à surveiller :
- Aucune mise à jour ou réponse du mainteneur depuis des mois.
- Plusieurs problèmes ouverts concernant la compatibilité Android sans réponse.
Vos options :
- Remplacez-le par une alternative maintenue activement.
- Ou demandez à Capgo Conseil de le cloner et de le maintenir afin que votre application reste compatible.
Étape 6 — Contrôles de Santé
Avant de lancer, effectuez des vérifications rapides :
- Testez la fonctionnalité sur au moins un appareil Android récent et un appareil plus ancien.
- Utilisez une version de Release pour un test final.
- Notez la version de l'application, la version du plugin et le modèle de l'appareil qui ont fonctionné.
Étape 7 — Décidez : Mettre à jour, Remplacer ou Forker
- Mettre à jour : meilleur cas — installez les dernières versions du plugin/ de l'application et vous êtes fini.
- Remplacer : passez à une alternative maintenue si elle existe.
- Forker : lorsque vous avez besoin que cela fonctionne et que le plugin ne bouge pas, laissez Capgo Consulting Forker et maintenez-le pour vous.
Sous-ensemble de support (Court et Utile)
Partagez cela pour accélérer l'aide (avec les entreteneurs ou Capgo Consulting):
- Version de l'application/numéro de build
- Capacitor version
- Nom et version du plugin
- Les appareils/versions d'Android affectés
- Ce que vous avez essayé (mise à jour, alternative, etc.)
- Étapes simples pour reproduire
Engagez Capgo: Nous ferons fonctionner cela
Si les appareils de 16 Ko cassent votre application et qu'un plugin n'est pas prêt, discutez avec nous:
- Nous identifions rapidement le plugin en cause et confirmons l'erreur.
- Nous le corrigons : mise à jour, patch ou fork — et nous le maintenons.
- Nous vous aidons à éviter les précipitations de dernière minute lors de la mise en œuvre.
Dites-nous quelles fonctionnalités ne fonctionnent pas et le nom du plugin (si vous le savez). Nous nous chargerons du reste. Visitez notre page des services : Capgo Consulting
