Publier votre application Lightbuild

Pour publier votre application sur Google Play, vous devez créer une version de l'application sous la forme d'un Android App Bundle, la signer avec votre clé d'importation, puis l'importer dans la Play Console. Cette page vous explique comment configurer la signature de version dans un projet Lightbuild et comment créer un app bundle signé avec la CLI Lightbuild.

Créer une clé d'importation

Google Play utilise la signature d'application Play pour signer les APK qu'il fournit aux utilisateurs, et vous signez les app bundles que vous importez avec une clé d'importation. Si vous ne disposez pas encore d'une clé d'importation, créez-en une avec keytool, qui est inclus dans le JDK :

keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

La commande vous invite à saisir des mots de passe pour le keystore et la clé, puis crée un fichier keystore nommé upload-keystore.jks dans le répertoire actuel. Stockez le keystore dans un emplacement sécurisé en dehors de votre projet et ne l'enregistrez pas dans le contrôle des versions. Pour en savoir plus, consultez Signer votre application.

Configurer la signature de version

Dans le fichier lightbuild.yaml de votre module d'application, ajoutez un bloc signing au profil release dans packaging. Au lieu d'écrire vos mots de passe dans le fichier, référencez les variables d'environnement avec la syntaxe ${NAME} :

android:
  packaging:
    release:
      signing:
        storeFile: "${RELEASE_STORE_FILE}"
        storePassword: "${RELEASE_STORE_PASSWORD}"
        keyAlias: "${RELEASE_KEY_ALIAS}"
        keyPassword: "${RELEASE_KEY_PASSWORD}"

Lors de la compilation, Lightbuild lit chaque valeur à partir de sa variable d'environnement. Vos mots de passe ne sont donc pas stockés dans les fichiers de votre projet. Pour en savoir plus sur ces paramètres, consultez Packaging dans la documentation de référence sur la configuration de Lightbuild.

Définir les variables d'environnement

Avant de procéder à la compilation, définissez les variables d'environnement dans le terminal où vous exécutez la CLI Lightbuild. Par exemple, sous macOS ou Linux :

export RELEASE_STORE_FILE="$HOME/keystores/upload-keystore.jks"
export RELEASE_STORE_PASSWORD="KEYSTORE_PASSWORD"
export RELEASE_KEY_ALIAS="upload"
export RELEASE_KEY_PASSWORD="KEY_PASSWORD"

Sous Windows, dans PowerShell :

$env:RELEASE_STORE_FILE = "$HOME\keystores\upload-keystore.jks"
$env:RELEASE_STORE_PASSWORD = "KEYSTORE_PASSWORD"
$env:RELEASE_KEY_ALIAS = "upload"
$env:RELEASE_KEY_PASSWORD = "KEY_PASSWORD"

Remplacez KEYSTORE_PASSWORD et KEY_PASSWORD par vos mots de passe. Dans un système d'intégration continue, stockez les mots de passe en tant que secrets et exposez-les à votre build en tant que variables d'environnement.

Créer un app bundle signé

Avant chaque version, augmentez le paramètre versionCode dans le fichier lightbuild.yaml du module de votre application, et mettez à jour versionName si nécessaire. Google Play requiert un code de version supérieur pour chaque importation. Pour en savoir plus, consultez Gérer les versions de votre application.

Pour créer l'app bundle signé, exécutez la commande suivante :

lightbuild build app:app-release.aab

Lightbuild écrit le bundle dans app/build/app-release.aab. Pour voir où chacune des cibles du module d'application écrit sa sortie, exécutez lightbuild query app/... --output=files.

Importer votre application sur Google Play

Importez l'app bundle signé dans la Play Console. Pour tester votre application avant de la publier, importez-la d'abord dans un canal de test interne. Pour en savoir plus, consultez Importer votre application dans la Play Console.