חתימת אפליקציות אנדרואיד: Keystore, Gradle, CI/CD ו-Play App Signing

חתימת אפליקציות אנדרואיד: Keystore, Gradle, CI/CD ו-Play App Signing

אובדן קובץ ה-keystore הוא בלתי הפיך. אם המפתח הפרטי אבד, עדכון האפליקציה הקיימת שלך ב-Google Play הופך לבלתי אפשרי. תצטרך לפרסם אפליקציה חדשה עם שם חבילה חדש, ולאבד את כל הביקורות, היסטוריית ההורדות ודירוגי החיפוש. מניסיוננו, אירועים כאלה עולים למפתחים חודשים של השבתה והפסד הכנסות. כדי למנוע זאת, אנו מגדירים חתימת אפליקציות אנדרואיד מקצה לקצה: מהפקת keystore ועד CI/CD ו-Play App Signing. המהנדסים שלנו מוסמכים על ידי Google עם שנים של ניסיון בפיתוח אנדרואיד. צור קשר להערכת פרויקט חינמית ופתרון אופטימלי.

במדריך זה נסקור יצירת keystore, הגדרת Signing Config ב-Gradle ללא אחסון סיסמאות בקוד, הפעלת Play App Signing ואוטומציה של חתימה ב-CI. ביצוע שלבים אלה יגן על המפתחות שלך וימנע אובדן גישה לאפליקציה שלך.

יצירה ואחסון של ה-Keystore

צור באמצעות keytool:

keytool -genkeypair -v \
 -keystore release.keystore \
 -alias myapp \
 -keyalg RSA \
 -keysize 2048 \
 -validity 10000 \
 -storetype JKS

keytool -genkeypair -v \ -keystore release.keystore \ -alias myapp \ -keyalg RSA \ -keysize 2048 \ -validity 10000 \ -storetype JKS הוא כ-27 שנים. Google ממליצה על לפחות 25 שנים עבור אפליקציות ב-Play Store. תקופה קצרה יותר עלולה לגרום ל-Google Play לדחות עדכונים עתידיים. אנו ממליצים להשתמש בפורמט PKCS12 (-validity 10000) — מאובטח יותר ותואם יותר.

אין לאחסן את ה-keystore במאגר Git, אפילו לא פרטי. כללי אחסון: גיבוי מוצפן לפחות בשני אחסוני ענן, עותק פיזי מחוץ לאתר, וסיסמאות בנפרד מהקובץ.

פרמטרי Keystore: המלצות

כיצד להגדיר Signing Config ב-Gradle ללא סיסמאות

קידוד נתיבים וסיסמאות ב--storetype PKCS12 הוא אנטי-תבנית:

// ТАК НЕ ДЕЛАТЬ — пароли в репозитории
signingConfigs {
    release {
        storeFile file("../keys/release.keystore")
        storePassword "mysecretpassword" // в git попадёт
        keyAlias "myapp"
        keyPassword "mysecretpassword"
    }
}

הגישה הנכונה היא באמצעות משתני סביבה או build.gradle:

// build.gradle (app)
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('keystore.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {
    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias'] ?: System.getenv('KEY_ALIAS')
            keyPassword keystoreProperties['keyPassword'] ?: System.getenv('KEY_PASSWORD')
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword'] ?: System.getenv('STORE_PASSWORD')
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

// ТАК НЕ ДЕЛАТЬ — пароли в репозитории signingConfigs { release { storeFile file("../keys/release.keystore") storePassword "mysecretpassword" // в git попадёт keyAlias "myapp" keyPassword "mysecretpassword" } } צריך להיות ב-local.properties. ב-CI, העבר משתני סביבה ישירות. עבור Kotlin DSL, התצורה דומה באמצעות // build.gradle (app) def keystoreProperties = new Properties() def keystorePropertiesFile = rootProject.file('keystore.properties') if (keystorePropertiesFile.exists()) { keystoreProperties.load(new FileInputStream(keystorePropertiesFile)) } android { signingConfigs { release { keyAlias keystoreProperties['keyAlias'] ?: System.getenv('KEY_ALIAS') keyPassword keystoreProperties['keyPassword'] ?: System.getenv('KEY_PASSWORD') storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null storePassword keystoreProperties['storePassword'] ?: System.getenv('STORE_PASSWORD') } } buildTypes { release { signingConfig signingConfigs.release minifyEnabled true proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } } . למידע נוסף על Signing Config.

keytool -list -v -keystore release.keystore -alias myapp 

---
- name: Sign APK
  env:
    KEYSTORE_BASE64: ${{ secrets.KEYSTORE_BASE64 }}
    KEY_ALIAS: ${{ secrets.KEY_ALIAS }}
    KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}
    STORE_PASSWORD: ${{ secrets.STORE_PASSWORD }}
  run: |
    echo "$KEYSTORE_BASE64" | base64 --decode > release.keystore
    ./gradlew bundleRelease \
      -Pandroid.injected.signing.store.file=$(pwd)/release.keystore \
      -Pandroid.injected.signing.store.password=$STORE_PASSWORD \
      -Pandroid.injected.signing.key.alias=$KEY_ALIAS \
      -Pandroid.injected.signing.key.password=$KEY_PASSWORD