Android Studio est un bon IDE, mais il n'est pas indispensable pour produire un build Android prêt pour les stores. Le android/ dossier généré dans un projet Capacitor contient un Gradle wrapper qui permet de compiler et signer depuis n'importe quel terminal. C'est important pour les serveurs Linux sans affichage, les machines Windows où Studio est lent, et pour la CI.
Ce guide compile un AAB signé uniquement en ligne de commande, puis présente la variante cloud avec Build Capgo pour les équipes qui ne veulent pas de keystores sur leurs portables.
Prerequisites
- JDK 21 (
java -versionaffiche 21). - l’outil en ligne de commande Android SDK avec
platform-tools,build-toolset la plateforme correspondant à votre version Capacitor (API 36 pour Capacitor 8, API 35 pour Capacitor 7). Le Guide Linux et Guide Windows couvrent l’installation. ANDROID_HOMEexporté, ouandroid/local.propertiesparsdk.dir=....- Une application Capacitor avec
android/généré parbunx cap add android.
1) Créer le keystore de signature
keytool fait partie du JDK sur toutes les plateformes :
keytool -genkeypair -v \
-keystore release.jks \
-keyalg RSA -keysize 2048 -validity 10000 \
-alias release
Répondez aux prompts et choisissez un mot de passe de store et un mot de passe de clé. Enregistrez le fichier et les deux mots de passe dans votre gestionnaire de mots de passe ou coffre-fort de secrets dès maintenant. Ne committez jamais release.jks.
Activez Play App Signing lors de la création de l’application dans Play Console. Google conserve alors la clé de signature finale et votre keystore devient une clé d’upload, qui peut être réinitialisée en cas de perte.
2) Indiquer à Gradle comment signer
les secrets hors de build.gradle. Créez android/keystore.properties (gitignored) :
storeFile=/absolute/path/to/release.jks
storePassword=your-store-password
keyAlias=release
keyPassword=your-key-password
Puis référez-vous à android/app/build.gradle:
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file("keystore.properties")
if (keystorePropertiesFile.exists()) {
keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}
android {
signingConfigs {
release {
if (keystorePropertiesFile.exists()) {
storeFile file(keystoreProperties['storeFile'])
storePassword keystoreProperties['storePassword']
keyAlias keystoreProperties['keyAlias']
keyPassword keystoreProperties['keyPassword']
}
}
}
buildTypes {
release {
signingConfig signingConfigs.release
minifyEnabled false
}
}
}
Ajoutez android/keystore.properties et *.jks vers .gitignore.
3) Incrémenter la version
Google Play rejette les uploads avec un versionCode qu’il a déjà vu. Modifier android/app/build.gradle:
defaultConfig {
versionCode 12
versionName "1.4.0"
}
Les équipes dérivent généralement versionCode des numéros d’exécution CI ou du nombre de commits git pour éviter les modifications manuelles.
4) Compiler l’AAB depuis le terminal
bun run build
bunx cap sync android
cd android
./gradlew bundleRelease
Sous Windows, utilisez .\gradlew.bat bundleRelease. Le bundle signé est écrit dans android/app/build/outputs/bundle/release/app-release.aab.
Besoin d'un APK pour des installations directes via adb ? ./gradlew assembleRelease produit app-release.apk sous outputs/apk/release/. Installez-l’avec adb install; le guide d'installation adb couvre les cas particuliers.
5) Vérifier la signature
$ANDROID_HOME/build-tools/36.0.0/apksigner verify --print-certs app/build/outputs/apk/release/app-release.apk
Pour un AAB, jarsigner -verify -verbose app-release.aab confirme la signature et l'empreinte du certificat. Comparez le SHA-256 avec celui affiché dans la Play Console sous Intégrité de l'application.
6) Envoyer vers Google Play depuis la ligne de commande
L'upload manuel via la Play Console fonctionne. Pour l'automatisation, créez un compte de service dans Google Cloud, accordez-lui l'accès dans la Play Console sous Utilisateurs et permissions, et téléchargez sa clé JSON. Ensuite, effectuez l'upload avec l'API Google Play Developer ou un outil comme fastlane supply :
bundle exec fastlane supply --aab android/app/build/outputs/bundle/release/app-release.aab \
--track internal --json_key play-service-account.json --package_name com.example.app
Le premier upload d’une nouvelle application doit être effectué manuellement dans Play Console ; API n’accepte que les builds pour des applications qui existent déjà.
7) L’alternative cloud : Capgo Build pour Android
Tout ce qui précède fonctionne, mais cela laisse un keystore sur chaque machine qui compile. Capgo Build conserve le keystore dans un coffre-fort chiffré et compile à partir du android/ projet que vous envoyez, et peut pousser l’AAB vers une piste Play.
Enregistrez les identifiants une seule fois :
bunx @capgo/cli@latest build credentials save --platform android \
--keystore ./release.jks \
--keystore-alias "release" \
--keystore-key-password "key-password" \
--keystore-store-password "store-password" \
--play-config ./play-service-account.json
Ou laissez bunx @capgo/cli@latest build init --platform android vous guider. Ensuite, chaque release est :
bun run build
bunx cap sync android
bunx @capgo/cli@latest build request com.example.app --platform android --build-mode release
Les logs s’affichent dans le terminal. Ajoutez --output-upload pour obtenir un lien de téléchargement de l’AAB ou de l’APK, et --ai-analytics pour qu’un build échoué soit expliqué automatiquement. La même commande fonctionne sous Windows, Linux, macOS et en CI. Un exemple GitHub Actions se trouve dans le Guide de build Android.
Car Capgo ne reçoit que le projet natif préparé, les registres npm privés et les secrets de build web restent dans votre environnement.
8) Arrêtez de recompiler pour des changements web
Un build natif signé est nécessaire pour les mises à jour de plugins, permissions, icônes et Capacitor. Pour tout dist/, Live Updates Capgo envoyez le nouveau bundle web directement aux applications installées :
bunx @capgo/cli@latest bundle upload --channel production
Cela supprime la plupart des exécutions Gradle de votre semaine.
Troubleshooting
SDK location not found: définissezANDROID_HOMEou créezandroid/local.properties.Keystore was tampered with, or password was incorrect: mot de passe du store incorrect, ou fichier corrompu par une conversion CRLF dans Git. Marquez*.jkssous forme binaire dans.gitattributess'il doit être versionné, ce qui ne devrait pas être le cas.Unsupported class file major version: la version du JDK est supérieure ou inférieure à 21.- Play rejette l'AAB : « signé avec une clé différente »: Play App Signing attend votre clé d'upload. Utilisez le keystore enregistré dans la Play Console ou demandez une réinitialisation de la clé d'upload.
- Le build est lent sur Windows: exclure
~/.gradleet le SDK de Defender, et gardez le projet sur un chemin local court. - Out of memory dans Gradle: ajouter
org.gradle.jvmargs=-Xmx4gversandroid/gradle.properties.
Résumé
Une release Android Capacitor nécessite un JDK, le SDK et le Gradle wrapper, pas Android Studio. Créez le keystore avec keytool, signez via keystore.properties, compilez avec bundleRelease, et effectuez l'upload avec le Play API. Pour sortir le keystore des laptops et garder la même commande sur chaque OS, Capgo Build gère la signature et l'upload depuis le projet préparé.