برنامه Lightbuild خود را منتشر کنید

برای انتشار برنامه‌تان در Google Play، نسخه پخشی از برنامه را به‌صورت «بسته ترکیبی برنامه Android» می‌سازید، آن را با کلید بارگذاری‌تان امضا می‌کنید، و آن را در «کنسول Play» بارگذاری می‌کنید. این صفحه به شما نشان می‌دهد که چگونه امضای نسخه پخش را در پروژه Lightbuild پیکربندی کنید و بااستفاده از Lightbuild CLI، بسته برنامه امضاشده بسازید.

ایجاد کلید بارگذاری

Google Play از امضای برنامه Play برای امضای فایل‌های APK که به کاربران ارائه می‌دهد استفاده می‌کند و شما بسته‌های برنامه‌ای را که بارگذاری می‌کنید با کلید بارگذاری امضا می‌کنید. اگر هنوز کلید بارگذاری ندارید، بااستفاده از keytool که در JDK گنجانده شده است، کلید بارگذاری ایجاد کنید:

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

این فرمان از شما می‌خواهد گذرواژه‌های keystore و کلید را وارد کنید، و سپس فایل keystore با نام upload-keystore.jks را در پوشه فعلی ایجاد می‌کند. مخزن کلید را در مکانی امن خارج از پروژه ذخیره کنید و آن را در کنترل نسخه بررسی نکنید. برای اطلاعات بیشتر، به امضا کردن برنامه مراجعه کنید.

پیکربندی امضای نسخه پخش

در فایل lightbuild.yaml واحد برنامه، بلوک signing را به نمایه release در packaging اضافه کنید. به‌جای نوشتن گذرواژه‌ها در فایل، متغیرهای محیطی را با نحو ${NAME} ارجاع دهید:

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

وقتی ساخت را انجام می‌دهید، Lightbuild هر مقدار را از متغیر محیطی آن می‌خواند، بنابراین گذرواژه‌هایتان در فایل‌های پروژه‌تان ذخیره نمی‌شود. برای اطلاعات بیشتر درباره این تنظیمات، به بسته‌بندی در مرجع پیکربندی Lightbuild مراجعه کنید.

تنظیم متغیرهای محیط

قبل‌از ساختن، متغیرهای محیطی را در پایانه‌ای که Lightbuild CLI را اجرا می‌کنید تنظیم کنید. برای مثال، در macOS یا 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"

در Windows، در 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"

KEYSTORE_PASSWORD و KEY_PASSWORD را با گذرواژه‌هایتان جایگزین کنید. در سیستم CI، گذرواژه‌ها را به‌عنوان اسرار ذخیره کنید و آن‌ها را به‌عنوان متغیرهای محیطی در معرض ساخت خود قرار دهید.

ساختن دسته برنامه امضاشده

قبل‌از هر انتشار، تنظیم versionCode را در فایل lightbuild.yaml واحد برنامه‌تان افزایش دهید و درصورت نیاز versionName را به‌روز کنید. Google Play برای هر بارگذاری به کد نسخه بالاتری نیاز دارد. برای اطلاعات بیشتر، به نسخه‌بندی برنامه مراجعه کنید.

برای ساختن دسته برنامه نسخه پخش امضاشده، این دستور را اجرا کنید:

lightbuild build app:app-release.aab

‫Lightbuild دسته را در app/build/app-release.aab می‌نویسد. برای دیدن اینکه هرکدام از هدف‌های واحد برنامه خروجی‌اش را کجا می‌نویسد، lightbuild query app/... --output=files را اجرا کنید.

بارگذاری برنامه در Google Play

دسته برنامه امضاشده را در «کنسول Play» بارگذاری کنید. برای آزمایش کردن برنامه‌تان قبل‌از اینکه آن را برای کاربران منتشر کنید، ابتدا آن را در دسته هدف آزمایشی داخلی بارگذاری کنید. برای اطلاعات بیشتر، بارگذاری برنامه در «کنسول Play» را ببینید.